CreateIdentityProviderSCIMCredential - 创建 SCIM 凭据

更新时间:
复制 MD 格式

显式签发一枚 SCIM 凭据并仅当次返回 Token 明文。同池最多两枚,不自动撤销旧凭据或开启 AC 用户同步。

接口说明

功能与前提\n 显式签发一枚新凭据,要求可用共享池且 AgentIdentity SCIM 接收已为 Enabled。本接口不会自动开启接收;未开启时先调用 prepare。返回 configuration、credential 摘要及本次 Token。最多两枚限制由 AgentIdentity 执行,已有可用 Token 不阻止用户显式创建第二枚;不自动撤销旧凭据,不提供扩展轮换流程。\nToken 只返回一次,后续列表和查询无法重取。不要自动重试签发;响应丢失时先列表核对是否已创建。创建凭据不启用 AC syncEnabled、不开始用户全量导入,也不切换 SAML 登录。删除旧 Token 应由用户确认外部预配系统的实际使用情况后显式操作。\n\n## 请求与示例\nPOST /workspaces/{workspaceId}/scim-provisioning/credentials\n 调用约定:按目标 Workspace 的地域调用,使用有相应 Workspace 身份源资源权限的 AK/STS 身份。下文示例中的 ws-example、URL、证书和 Token 均为占位值,需替换为真实值。请求体示例表示公开 API 的 body 参数内容,不是后端直连接口额外的 body 包装。返回示例只展示业务部分,外层还包括 requestId、success、code、message、httpStatusCode;排障请保留 requestId,不记录密钥。业务任务异步不意味着 HTTP 请求长连接等待完成。\ntext\nPOST /workspaces/ws-example/scim-provisioning/credentials\n 无业务请求体。\n\n\n## 返回示例\njson\n{\n "data": {\n "configuration": {\n "status": "Enabled",\n "baseUrl": "https://example.com/scim/v2"\n },\n "credential": {\n "credentialId": "credential-example",\n "status": "Enabled",\n "expireTime": "<上游到期时间>"\n },\n "token": "<本次新签发的 Token>"\n }\n}\n\n\n## 错误与处理\n 错误处理:400 InvalidParameter 表示参数或当前配置前提不满足;404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable;保留请求 ID 排查,不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 LimitExceeded.ScimCredential:最多两枚凭据,删除一枚后才能继续创建。400 InvalidParameter:接收尚未开启或共享池不可用。不要把额度错误当作系统故障重试。\n\n## 调用关系与使用边界\n 新建后将仅此一次返回的 Token 安全保存,并由用户配置到外部预配系统。已有 Token 仍有效,只有 DeleteIdentityProviderSCIMCredential 才撤销指定凭据。响应丢失时不自动重试,先调用 ListIdentityProviderSCIMCredentials 核查;本接口不提供自动轮换或扩容。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

agentcore:CreateIdentityProviderSCIMCredential

create

*IdentityProvider

acs:agentcore:{#regionId}:{#accountId}:workspace/{#workspaceId}/identityProvider/CustomSSO

无 无

请求语法

POST /workspaces/{workspaceId}/scim-provisioning/credentials HTTP/1.1

路径参数

名称

类型

必填

描述

示例值

workspaceId

string

是

必填,目标 Workspace 的标识;请求地域需与目标 Workspace 一致。

ws-example

请求参数

名称

类型

必填

描述

示例值

当前API无需请求参数

返回参数

名称

类型

描述

示例值

object

requestId

string

用于关联本次调用与排障,失败时请保留。

request-example

message

string

请求受理或错误消息;异步任务结果需按对应查询接口核对。

success

httpStatusCode

integer

本次请求的处理状态,不等同后台任务最终结果。

200

code

string

失败时结合 HTTP 状态及 message 处理。

SUCCESS

success

boolean

true 表示本次请求处理成功;异步写入仍需继续查询任务结果。

data

object

结果结构见本接口返回字段;异步写接口的返回表示受理,不保证后台任务已完成。

configuration

object

SAML 实际配置只在 GetIdentityProvider 按需回读;SCIM 查询和准备返回实际接收状态及 URL。

status

string

Enabled 表示已开启 SCIM 接收,Disabled 表示关闭;不等同 AC 的 syncEnabled 期望值。

Enabled

baseUrl

string

配置给外部预配系统的 URL;有地址不代表已完成外部配置或开启 AC 同步。

https://example.com/scim/v2

credential

object

credentialId、status、createTime、expireTime;不包含可重复获取的 Token。

credentialId

string

删除时必填非空,使用凭据列表返回的 ID,不是 Token 明文。

credential-example

status

string

仅 Enabled 且尚未过期的凭据视为可用;此字段不是 SCIM 任务 operationStatus。

Enabled

createTime

string

AgentIdentity 返回的创建时间。

2026-10-26T00:00:00Z

expireTime

string

AgentIdentity 返回的到期时间;仅 Enabled 且尚未过期的凭据视为可用。

2027-10-26T00:00:00Z

token

string

新建凭据才返回明文,prepare 复用有效凭据时为 null;列表无法重取。响应丢失应先查询列表,不自动重签发;不写入日志或前端持久化缓存。

example-scim-token

示例

正常返回示例

JSON格式

{
  "requestId": "request-example",
  "message": "success",
  "httpStatusCode": 200,
  "code": "SUCCESS",
  "success": true,
  "data": {
    "configuration": {
      "status": "Enabled",
      "baseUrl": "https://example.com/scim/v2"
    },
    "credential": {
      "credentialId": "credential-example",
      "status": "Enabled",
      "createTime": "2026-10-26T00:00:00Z",
      "expireTime": "2027-10-26T00:00:00Z"
    },
    "token": "example-scim-token"
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。