创建用户访问授权任务
下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。
参数 | 类型 | 是否必填 | 示例值 | 描述 |
|---|---|---|---|---|
Action | String | 是 | CreateUserProvisioning | 要执行的操作,取值:CreateUserProvisioning。 |
Version | String | 是 | 2023-01-01 | API的版本,取值:2023-01-01。 |
TargetId | String | 是 | 1 | 目标id |
PrincipalType | String | 是 | User | 身份类型 |
PrincipalId | String | 是 | 1 | 身份id |
Description | String | 否 | desc | 任务描述 |
DuplicationStrategy | String | 是 | KeepBoth | 用户名冲突策略 |
DuplicationSuffix | String | 否 | suffix | 本次同步IAM用户名称后缀(冲突策略若选择 KeepBoth 则必填) |
DeletionStrategy | String | 是 | Keep | 删除策略 |
IdentitySourceStrategy | String | 是 | Ignore | 身份源冲突策略 |
下表仅列出本接口特有的返回参数。更多信息请参见返回结构。
参数 | 类型 | 示例值 | 描述 |
|---|---|---|---|
ProvisionStatus | String | Provisioned 授权成功,Provisioning 正在授权,DeleteProvisioning 授权解除中,DeleteProvisioned 授权解除成功 | 授权任务状态 |
Remark | String | ExistDuplicatedIamUser:重名用户、ExistHomologousIamUser:同源用户 | 任务结果说明 |
Description | String | desc | 任务描述 |
TargetId | String | 1 | 目标id |
IdentitySourceStrategy | String | Ignore | 身份源冲突策略 |
DuplicationSuffix | String | suffix | 本次同步IAM用户名称后缀 |
DuplicationStrategy | String | KeepBoth | 用户名冲突策略 |
DeletionStrategy | String | Keep | 删除策略 |
PrincipalType | String | User | 身份类型 |
PrincipalId | String | 1 | 身份id |
UserProvisioningId | String | 1 | IAM 用户同步任务ID |
POST /?Action=CreateUserProvisioning&Version=2023-01-01 HTTP/1.1 Host: https://open.volcengineapi.com Content-Type: application/json; charset=UTF-8 X-Date: 20250310T064306Z X-Content-Sha256: 287e874e******d653b44d21e Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250310/cn-beijing/cloudidentity/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f { "TargetId": "rr4t", "PrincipalType": "User", "PrincipalId": "JEiqlz2T0P", "Description": "KzRwcLnmQG", "DuplicationStrategy": "M", "DuplicationSuffix": "cYXqgs9u", "DeletionStrategy": "RQDuYkD", "IdentitySourceStrategy": "F7U3j3XQ" }
{ "ResponseMetadata": { "RequestId": "202503101443102271550070981EA70F", "Action": "CreateUserProvisioning", "Version": "2023-01-01", "Service": "cloudidentity", "Region": "cn-beijing" }, "Result": { "ProvisionStatus": "Provisioned", "Remark": "ExistDuplicatedIamUser", "Description": "LNlej", "TargetId": "ilgp9YG5", "IdentitySourceStrategy": "Uf", "DuplicationSuffix": "Mn3L", "DuplicationStrategy": "eZ", "DeletionStrategy": "pcdwkcJEEcx", "PrincipalType": "gOz4i4RBC", "PrincipalId": "jWZTbck", "UserProvisioningId": "LfANIBJCe" } }
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。
状态码 | 错误码 | 说明 |
|---|---|---|
400 | PermissionError | 没有接口权限 |
400 | ServiceStatusException | 企业身份中心实例不可用 |
400 | SensitiveWord | 参数重存在敏感词 |
400 | ConcurrentException | 存在请求并发冲突 |
400 | ParamMissing | 参数缺省 |
400 | InvalidParam | 无效参数 |
400 | AccountNotInOrg | 目标账号不是组织成员 |
400 | UserNameLengthExceedLimit | 用户名长度过长 |
400 | ExceedBindPersonalIdpLimit | 已达到最大绑定限制数量 |
400 | InvalidIdentitySourceStatus | 实例状态不符合预期 |
400 | DisplayNameLengthExceedLimit | 显示名过长 |
403 | PermissionDenied | 无权限访问 |
404 | UserGroupNotFound | 用户组不存在 |
409 | UserProvisioningAlreadyExists | 用户同步任务已存在 |
409 | UserNameDuplicatedException | 创建 iam 用户,用户名冲突,且冲突策略无法解决冲突 |
500 | InternalError | 服务内部错误 |