更新时间:2024-11-29 GMT+08:00

同步IAM用户和用户组

功能介绍

将IAM用户和用户组同步到Manager,指定用户的情况下,会将该用户关联的IAM用户组也同步到Manager。

URI

POST /v2/{project_id}/clusters/{cluster_id}/iam-sync-user

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目编号。获取方法,请参见获取项目ID

约束限制:

不涉及

取值范围:

只能由英文字母和数字组成,且长度为[1-64]个字符。

默认取值:

不涉及

cluster_id

String

参数解释:

集群ID。如果指定集群ID,则获取该集群做过补丁更新的最新版本元数据。获取方法,请参见获取集群ID

约束限制:

不涉及

取值范围:

只能由英文字母、数字以及“_”和“-”组成,且长度为[1-64]个字符。

默认取值:

不涉及

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

is_all_sync

Boolean

参数解释:

是否是全量同步。

约束限制:

不涉及

取值范围:

  • true:全量同步
  • false:指定用户、用户组同步

默认取值:

false

group_names

Array of strings

参数解释:

指定同步的IAM用户组。

约束限制:

不涉及

user_names

Array of strings

参数解释:

指定同步的IAM用户。

约束限制:

不涉及

响应参数

状态码: 202

表3 响应Body参数

参数

参数类型

描述

state

String

参数解释:

请求下发的结果。

取值范围:

不涉及

请求示例

将group1和user1同步到manager。同时会自动将user1关联的IAM用户组也同步到Manager。

/v2/ff8080828997cb24018a1b2db3440b80/clusters/f7f45c04-4303-411c-9b71-d2cb730dd162/iam-sync-user

{
  "is_all_sync" : false,
  "group_names" : [ "groups1" ],
  "user_names" : [ "user1", "user2" ]
}

响应示例

状态码: 202

同步请求下发的结果

{
  "state" : "synchronizing"
}

状态码

状态码请参见状态码

错误码

请参见错误码