
# 权限和授权项
如果您需要对您所拥有的云消息服务进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM）。如果华为云账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用云消息服务的其它功能。
默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略（以JSON格式描述权限集的语言），才能使用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略对云服务进行操作。关于策略的语法结构及示例，请参见[权限管理](https://support.huaweicloud.com/usermanual-koomessage/um050.html)章节。
根据授权的精细程度，分为[角色](https://support.huaweicloud.com/usermanual-iam/iam_01_0601.html)和[策略](https://support.huaweicloud.com/usermanual-iam/iam_01_0017.html)。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。
云消息服务系统策略说明请参考[权限管理](https://support.huaweicloud.com/usermanual-koomessage/um050.html)章节。
![](https://support.huaweicloud.com/api-koomessage/public_sys-resources/note_3.0-zh-cn.png)
如果您需要允许或者禁止某个接口的操作权限，请使用策略。
华为云账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的IAM用户被授予授权项所对应的策略，该用户才能成功调用该接口。例如，IAM用户要调用接口来查询智能信息模板，那么这个IAM用户被授予的策略中必须包含允许"kooMessage:devTemplate:list"的授权项，该接口才能调用成功。
#### 支持的授权项
细粒度策略支持的操作与API相对应，授权项列表说明如下：
- 权限：自定义策略中授权项定义的内容即为权限。
- 对应API接口：自定义策略实际调用的API接口。
- 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。
- 授权范围：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。关于IAM项目与企业项目的区别，详情请参见：[IAM项目和企业项目的区别](https://support.huaweicloud.com/iam_faq/iam_01_0606.html)。
云消息服务管理控制操作相关的授权项，明细如下表所示。用户调用如下API时，需要获取对应的权限。权限获取请参考[统一身份认证服务（IAM）](https://support.huaweicloud.com/productdesc-iam/iam_01_0024.html)的帮助指导。
![](https://support.huaweicloud.com/api-koomessage/public_sys-resources/note_3.0-zh-cn.png)
"√"表示支持，"x"表示暂不支持。
表1云消息服务权限明细 
| 权限描述           | 授权项                                   | 对应的API                                                                                                                                    | IAM项目（Project） | 企业项目（Enterprise Project） |
|:---|:---|:---|:---|:---|
| 查询智能信息模板       | kooMessage:devTemplate:list           | GET /v1/aim/templates                                                                                                                     | √              | ×                        |
| 查询智能信息模板报表     | kooMessage:devTemplateReport:list     | POST /v1/aim/tempalte-reports/query                                                                                                       | √              | ×                        |
| 生成智能信息解析任务     | kooMessage:devResolveTask:create      | POST /v1/aim/resolve-tasks                                                                                                                | √              | ×                        |
| 查询智能信息解析任务     | kooMessage:devResolveTask:list        | GET /v1/aim/resolve-tasks                                                                                                                 | √              | ×                        |
| 查询手机号码智能信息解析能力 | kooMessage:devMobileCapability:check  | POST /v1/aim/mobile-capabilities/check                                                                                                    | √              | ×                        |
| 发送智能信息         | kooMessage:devSendTask:create         | POST /v1/aim/send-tasks POST /v1/aim/sms/messages POST /v1/aim/sms/diff-messages         | √              | ×                        |
| 查询智能信息发送任务     | kooMessage:devSendTask:list           | GET /v1/aim/send-tasks                                                                                                                    | √              | ×                        |
| 查询短信应用         | kooMessage:aimMsgApp:list             | GET /v1/sms/apps GET /v1/sms/apps/{app_id}                                                                       | √              | ×                        |
| 创建短信应用         | kooMessage:aimMsgApp:create           | POST /v1/sms/apps                                                                                                                         | √              | ×                        |
| 修改短信应用         | kooMessage:aimMsgApp:update           | PUT /v1/sms/apps/{app_id}                                                                                                                 | √              | ×                        |
| 查询短信签名         | kooMessage:aimMsgSignature:list       | GET /v1/sms/signatures GET /v1/sms/signatures/{signature_id} GET /v1/sms/signatures/files | √              | ×                        |
| 创建短信签名         | kooMessage:aimMsgSignature:create     | POST /v1/sms/signatures POST /v1/sms/signatures/files                                                              | √              | ×                        |
| 删除短信签名         | kooMessage:aimMsgSignature:delete     | DELETE /v1/sms/signatures/{signature_id}                                                                                                  | √              | ×                        |
| 修改短信签名         | kooMessage:aimMsgSignature:update     | PUT /v1/sms/signatures/{signature_id}                                                                                                     | √              | ×                        |
| 创建短信模板         | kooMessage:aimMsgTemplate:create      | POST /v1/sms/templates                                                                                                                    | √              | ×                        |
| 查询短信模板         | kooMessage:aimMsgTemplate:list        | GET /v1/sms/templates GET /v1/sms/templates/{template_id}                                                        | √              | ×                        |
| 删除短信模板         | kooMessage:aimMsgTemplate:delete      | DELETE /v1/sms/templates/{template_id}                                                                                                    | √              | ×                        |
| 修改短信模板         | kooMessage:aimMsgTemplate:update      | PUT /v1/sms/templates/{template_id}                                                                                                       | √              | ×                        |
| 创建企业基本信息       | kooMessage:aimSaCompany:create        | POST /v1/aim-sa/companies                                                                                                                 | √              | ×                        |
| 查询企业基本信息       | kooMessage:aimSaCompany:list          | GET /v1/aim-sa/companies                                                                                                                  | √              | ×                        |
| 下载企业资料模板       | kooMessage:aimSaCompany:upload        | GET /v1/aim-sa/companies/download                                                                                                         | √              | ×                        |
| 上传企业资料         | kooMessage:aimSaCompany:upload        | POST /v1/aim-sa/companies/upload                                                                                                          | √              | ×                        |
| 更新企业资料         | kooMessage:aimSaCompany:update        | PUT /v1/aim-sa/companies/{company_id}                                                                                                     | √              | ×                        |
| 上传智能信息服务号的资源   | kooMessage:aimSaMedia:upload          | POST /v1/aim-sa/media/upload                                                                                                              | √              | ×                        |
| 查询智能信息服务号的资源   | kooMessage:aimSaMedia:list            | GET /v1/aim-sa/media/upload                                                                                                               | √              | ×                        |
| 创建智能信息服务号的菜单   | kooMessage:aimSaMenu:create           | POST /v1/aim-sa/menu                                                                                                                      | √              | ×                        |
| 更新智能信息服务号的菜单   | kooMessage:aimSaMenu:update           | PUT /v1/aim-sa/menus/{menu_id}                                                                                                            | √              | ×                        |
| 查询智能信息服务号的菜单   | kooMessage:aimSaMenu:list             | GET /v1/aim-sa/menus                                                                                                                      | √              | ×                        |
| 创建智能信息服务号的商家   | kooMessage:aimSaMerchant:create       | POST /v1/aim-sa/merchants                                                                                                                 | √              | ×                        |
| 更新智能信息服务号的商家   | kooMessage:aimSaMerchant:update       | PUT /v1/aim-sa/merchants/{merchant_id}                                                                                                    | √              | ×                        |
| 查询智能信息服务号的商家   | kooMessage:aimSaMerchant:list         | GET /v1/aim-sa/merchants                                                                                                                  | √              | ×                        |
| 创建智能信息服务号的主页   | kooMessage:aimSaPortal:create         | POST /v1/aim-sa/portals                                                                                                                   | √              | ×                        |
| 更新智能信息服务号的主页   | kooMessage:aimSaPortal:update         | PUT /v1/aim-sa/portals/{portal_id}                                                                                                        | √              | ×                        |
| 查询智能信息服务号的主页   | kooMessage:aimSaPortal:list           | GET /v1/aim-sa/portals                                                                                                                    | √              | ×                        |
| 创建智能信息服务号的端口号  | kooMessage:aimSaPort:create           | POST /v1/aim-sa/ports                                                                                                                     | √              | ×                        |
| 查询智能信息服务号的端口号  | kooMessage:aimSaPort:list             | GET /v1/aim-sa/ports                                                                                                                      | √              | ×                        |
| 通道号绑定服务号       | kooMessage:aimSaPortAssociate:create  | POST /v1/aim-sa/ports/associate                                                                                                           | √              | ×                        |
| 通道号解绑服务号       | kooMessage:aimSaPortAssociate:delete  | POST /v1/aim-sa/ports/disassociate                                                                                                        | √              | ×                        |
| 删除通道号          | kooMessage:aimSaPort:delete           | DELETE /v1/aim-sa/ports/{port_id}                                                                                                         | √              | ×                        |
| 创建服务号          | kooMessage:aimSaPub:create            | POST /v1/aim-sa/pubs                                                                                                                      | √              | ×                        |
| 更新服务号          | kooMessage:aimSaPub:update            | POST /v1/aim-sa/pubs/{pub_id}                                                                                                             | √              | ×                        |
| 冻结服务号          | kooMessage:aimSaPub:freeze            | POST /v1/aim-sa/pubs/{pub_id}/freeze                                                                                                      | √              | ×                        |
| 查询服务号          | kooMessage:aimSaPub:list              | GET /v1/aim-sa/pubs                                                                                                                       | √              | ×                        |
| 创建智能信息基础版模板    | kooMessage:devAimBasicTemplate:create | POST /v1/aim-basic/templates                                                                                                              | √              | ×                        |
| 查询智能信息基础版模板    | kooMessage:devAimBasicTemplate:list   | GET /v1/aim-basic/templates                                                                                                               | √              | ×                        |
| 创建智能信息基础版发送任务  | kooMessage:devAimBasicMsgTask:create  | POST /v1/aim-basic/send-tasks                                                                                                             | √              | ×                        |
| 查询智能信息基础版发送任务  | kooMessage:devAimBasicMsgTask:list    | GET /v1/aim-basic/send-tasks                                                                                                              | √              | ×                        |
   
