创建策略

更新时间:2023-10-09 08:04:24下载pdf

本文介绍创建策略的 API。

接口描述

创建策略。

  • 允许操作规则和拒绝操作规则不能全为空。
  • 一个租户最多创建 100 个策略。

接口地址

POST: /v2.0/cloud/iam/policy

请求参数

body 说明

参数名类型参数位置是否必填说明
nameString true策略名称。
allow_actionList false允许操作,用于描述允许的特定操作。
deny_actionList false拒绝操作,用于描述拒绝的特定操作。
descriptionString true策略描述。

返回参数

参数名类型说明
resultLong创建的策略 ID。
successBoolean请求是否成功。
  • true:请求成功。
  • false:请求失败。
error_codeString详见错误码。
error_msgString错误信息,成功时为空。

请求示例

POST: /v2.0/cloud/iam/policy
{
    "name":"策略名称",
    "description":"策略描述",
    "allow_action":["device:get:state"],
    "deny_action":["device:get:shadow"]
}

返回示例

{
    "tid": "16867994844221686799484422",
    "result": 1,
    "t": 1686799484422,
    "success": true
}

错误码

参考 错误码