文档首页> 消息&短信 MSGSMS> API参考> 策略和授权项说明
更新时间：2024-01-15 GMT+08:00
查看PDF
分享

策略和授权项说明

如果您需要对您所拥有的消息&短信MSGSMS进行精细的权限管理，您可以使用统一身份认证服务（Identity and Access Management，简称IAM），如果账号已经能满足您的要求，不需要创建独立的IAM用户，您可以跳过本章节，不影响您使用消息&短信服务的其它功能。

策略是以JSON格式描述权限集的语言。默认情况下，新建的IAM用户没有任何权限，您需要将其加入用户组，并给用户组授予策略，才能使用户组中的用户获得策略定义的权限，这一过程称为授权。授权后，用户就可以基于策略对云服务进行操作。

根据授权的精细程度，分为角色和策略。角色以服务为粒度，是IAM最初提供的一种根据用户的工作职能定义权限的粗粒度授权机制。策略以API接口为粒度进行权限拆分，授权更加精细，可以精确到某个操作、资源和条件，能够满足企业对权限最小化的安全管控要求。

如果您要允许或是禁止某个接口的操作权限，请使用策略。

账号具备所有接口的调用权限，如果使用账号下的IAM用户发起API请求时，该IAM用户必须具备调用该接口所需的权限，否则，API请求将调用失败。每个接口所需要的权限，与各个接口所对应的授权项相对应，只有发起请求的用户被授予授权项所对应的策略，该用户才能成功调用该接口。

支持的授权项

策略包含系统策略和自定义策略，如果系统策略不满足授权要求，管理员可以创建自定义策略，并通过给用户组授予自定义策略来进行精细的访问控制。策略支持的操作与API相对应，授权项列表说明如下：

  • 权限：允许或拒绝某项操作。
  • 对应API接口：自定义策略实际调用的API接口。
  • 授权项：自定义策略中支持的Action，在自定义策略中的Action中写入授权项，可以实现授权项对应的权限功能。
  • 依赖的授权项：部分Action存在对其他Action的依赖，需要将依赖的Action同时写入授权项，才能实现对应的权限功能。
  • IAM项目(Project)/企业项目(Enterprise Project)：自定义策略的授权范围，包括IAM项目与企业项目。授权范围如果同时支持IAM项目和企业项目，表示此授权项对应的自定义策略，可以在IAM和企业管理两个服务中给用户组授权并生效。如果仅支持IAM项目，不支持企业项目，表示仅能在IAM中给用户组授权并生效，如果在企业管理中授权，则该自定义策略不生效。管理员可以在授权项列表中查看授权项是否支持IAM项目或企业项目，“√”表示支持，“×”表示暂不支持。关于IAM项目与企业项目的区别，详情请参见：IAM与企业管理的区别。

消息&短信的支持自定义策略授权项如表1所示。

表1 消息&短信授权项明细

权限

授权项

对应API接口

依赖的授权项

IAM项目(Project)

企业项目(Enterprise Project)

删除签名

msgsms:signatures:delete

DELETE /v2/{project_id}/msgsms/signatures/{id}
  1. msgsms:service:getServicestatus
  2. msgsms:signatures:getSignature
  3. msgsms:signatures:getType
  4. msgsms:templates:getConfig

√

×

删除短信模板

msgsms:templates:delete

DELETE /v2/{project_id}/msgsms/templates/{id}
  1. msgsms:service:getServicestatus
  2. msgsms:templates:getMsgtemplate

√

×

删除联系人

msgsms:contacts:delete

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:contacts:get

√

×

查询短信应用数量

msgsms:applications:getCount

GET /v2/{project_id}/msgsms/apps-count

msgsms:service:getServicestatus

√

×

查询短信应用

msgsms:applications:getApp
  • GET /v2/{project_id}/msgsms/apps
  • GET /v2/{project_id}/msgsms/apps/{id}

msgsms:service:getServicestatus

√

×

查询权限

msgsms:applications:getAuthority

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信应用密钥

msgsms:applications:getAppsecret

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询租户受限原因

msgsms:applications:getTenant

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询签名信息

msgsms:signatures:getSignature
  • GET /v2/{project_id}/msgsms/signatures
  • GET /v2/{project_id}/msgsms/signatures/{id}

msgsms:service:getServicestatus

√

×

查询短信类型

msgsms:signatures:getType

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询签名名称

msgsms:signatures:getSignatureName

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信模板

msgsms:templates:getMsgtemplate
  • GET /v2/{project_id}/msgsms/templates
  • GET /v2/{project_id}/msgsms/templates/{id}

msgsms:service:getServicestatus

√

×

查询催审配置

msgsms:templates:getConfig

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询校验租户订单状态

msgsms:service:getServicestatus

仅支持Console调用，API方式不支持

-

√

×

查询开发者信息

msgsms:templates:getDeveloper

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信模板名称

msgsms:templates:getMsgtemplateName

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信模板变量

msgsms:templates:getVarilable

GET /v2/{project_id}/msgsms/templates/{id}/varilable

msgsms:service:getServicestatus

√

×

查看群发助手任务名称

msgsms:msgBatchTasks:getMsgbatchtaskName

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询群发助手短信发送任务

msgsms:msgBatchTasks:getMsgbatchtask

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查看群发助手任务结果详情

msgsms:msgBatchTasks:getRecord

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

导出群发助手任务发送号码

msgsms:msgBatchTasks:download

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:msgBatchTasks:getMsgbatchtaskName
  3. msgsms:msgBatchTasks:getMsgbatchtask
  4. msgsms:msgBatchTasks:getRecord

√

×

查询短信限额策略

msgsms:limits:get

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信业务统计数据

msgsms:statistics:getStatistics

GET /v2/{project_id}/msgsms/metric/stat

msgsms:service:getServicestatus

√

×

导出短信业务统计数据

msgsms:statistics:exportStatistics

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:statistics:getStatistics

√

×

查询联系人

msgsms:contacts:get

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询历史请求信息

msgsms:blacklists:getBlacklist

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信总览统计数据

msgsms:statistics:getOverviewStatistics

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询消息提醒

msgsms:notifications:get

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询单条短信价格

msgsms:price:getUnitPrice

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询企业项目

msgsms:enterpriseProjects:get

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询公共配置

msgsms:signatures:getConfig

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询租户企业名称

msgsms:signatures:getTenantEnterpriseName

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询短信发送国家

msgsms:templates:getCountry

GET /v2/{project_id}/msgsms/country

msgsms:service:getServicestatus

√

×

创建短信应用

msgsms:applications:create

POST /v2/{project_id}/msgsms/apps
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getCount
  3. msgsms:applications:getTenant
  4. msgsms:applications:getAuthority
  5. msgsms:enterpriseProjects:get

√

×

发送验证码

msgsms:verifycodes:sendVerifycode

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getCount
  3. msgsms:applications:getApp

√

×

添加签名

msgsms:signatures:addSignature

POST /v2/{project_id}/msgsms/signatures
  1. msgsms:service:getServicestatus
  2. msgsms:signatures:getType
  3. msgsms:templates:getDeveloper
  4. msgsms:applications:getTenant
  5. msgsms:applications:getApp
  6. msgsms:signatures:getConfig
  7. msgsms:signatures:getTenantEnterpriseName

√

×

修改签名

msgsms:signatures:updateSignature

PUT /v2/{project_id}/msgsms/signatures/{id}
  1. msgsms:service:getServicestatus
  2. msgsms:signatures:getSignature
  3. msgsms:signatures:getType
  4. msgsms:templates:getConfig

√

×

签名申请催审

msgsms:signatures:approval

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:signatures:getSignature
  3. msgsms:signatures:getType
  4. msgsms:templates:getConfig

√

×

创建短信模板

msgsms:templates:create

POST /v2/{project_id}/msgsms/templates
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getTenant
  3. msgsms:applications:getApp
  4. msgsms:signatures:getType
  5. msgsms:templates:getDeveloper
  6. msgsms:templates:getMsgtemplateName

√

×

导入群发助手短信发送任务

msgsms:msgBatchTasks:upload

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

创建群发助手短信发送任务

msgsms:msgBatchTasks:create

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getApp
  3. msgsms:signatures:getType
  4. msgsms:msgBatchTasks:upload

√

×

查看短信详情

msgsms:details:get

GET /v2/{project_id}/msgsms/detail

msgsms:service:getServicestatus

√

×

添加联系人

msgsms:contacts:create

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

新增解除黑名单请求

msgsms:blacklists:update

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

更新短信应用密钥

msgsms:applications:updateAppsecret

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getCount
  3. msgsms:applications:getApp
  4. msgsms:verifycodes:sendVerifycode
  5. msgsms:applications:getAppsecret

√

×

修改短信应用

msgsms:applications:updateApp

PUT /v2/{project_id}/msgsms/apps/{id}
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getCount
  3. msgsms:applications:getApp
  4. msgsms:enterpriseProjects:get

√

×

申请激活签名

msgsms:signatures:activate

PUT /v2/{project_id}/msgsms/signatures/{id}/active
  1. msgsms:service:getServicestatus
  2. msgsms:signatures:getSignature
  3. msgsms:signatures:getType
  4. msgsms:signatures:getSignatureName
  5. msgsms:templates:getConfig

√

×

修改短信模板

msgsms:templates:update

PUT /v2/{project_id}/msgsms/templates/{id}
  1. msgsms:service:getServicestatus
  2. msgsms:templates:getMsgtemplate
  3. msgsms:templates:getConfig
  4. msgsms:signatures:getSignature
  5. msgsms:applications:getTenant
  6. msgsms:applications:getApp
  7. msgsms:signatures:getType
  8. msgsms:templates:getDeveloper
  9. msgsms:templates:getMsgtemplateName

√

×

更新群发助手定时任务

msgsms:msgBatchTasks:update

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:applications:getApp
  3. msgsms:signatures:getType

√

×

设置短信限额策略

msgsms:limits:update

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

修改联系人

msgsms:contacts:update

仅支持Console调用，API方式不支持
  1. msgsms:service:getServicestatus
  2. msgsms:contacts:get

√

×

批量导入短信模板

msgsms:templates:import

仅支持Console调用，API方式不支持

msgsms:service:getServicestatus

√

×

查询企业营业执照文件

msgsms:businessLicense:get

GET /v2/{project_id}/msgsms/upload-files

msgsms:service:getServicestatus

√

×

上传企业营业执照文件

msgsms:businessLicense:import

POST /v2/{project_id}/msgsms/upload-files

msgsms:service:getServicestatus

√

×
分享：

    相关文档

    相关产品