文档首页/ 云搜索服务 CSS/ API参考/ API V1/ 集群管理/ 自动创建委托 - CreateAgency
更新时间:2025-10-31 GMT+08:00
分享

自动创建委托 - CreateAgency

功能介绍

当CSS预置委托不存在时,自动创建委托并赋予CSS依赖的权限。

当CSS预置委托存在时,去除依赖的高风险权限,设置为最小化权限。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    css::createServiceAgency

    Write

    -

    -

    -

    • iam:agencies:listAgencies
    • iam:agencies:createAgency
    • iam:permissions:grantRoleToAgency
    • iam:agencies:pass

URI

POST /v1.0/{project_id}/agency/create

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID和名称

约束限制

不涉及

取值范围

账户的项目ID。

默认取值

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

domain_id

String

参数解释

账号ID,请参考查询指定条件下的项目列表

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

domain_name

String

参数解释

账号名称,请参考认证鉴权

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

type

String

参数解释

创建的委托类型。

约束限制

不涉及。

取值范围

  • obs:创建快照及日志备份依赖的委托权限。

  • vpc:版本升级、可用区切换、缩容、替换节点依赖的委托权限。

  • smn:使用alerting告警插件依赖的委托权限。

  • elb:负载均衡功能依赖的委托权限。

默认取值

不涉及。

响应参数

状态码:200

请求已成功。

请求示例

创建快照及日志备份依赖的委托请求示例。

POST https://{Endpoint}/v1.0/{project_id}/agency/create

{
  "domain_id" : "id",
  "domain_name" : "name",
  "type" : "obs"
}

响应示例

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

403

请求被拒绝访问。

返回该状态码,表明请求能够到达服务端,且服务端能够理解用户请求,但是拒绝做更多的事情,因为该请求被设置为拒绝访问,建议直接修改该请求,不要重试该请求。

错误码

请参见错误码

相关文档