PrepareIdentityProviderSCIM - 准备 SCIM 接收配置和凭据

功能与前提\n 要求可用 CustomSSO 共享用户池；不依赖 SAML Metadata，也不受 SAML 更新中/更新失败状态锁。同步调用 AgentIdentity 开启 SCIM 接收，读取配置及凭据列表。接收已启用时复用现有配置；重复初始化不重复创建有效凭据，也不自动开启用户同步。如果已有状态 Enabled 且尚未过期的凭据，返回其摘要且 token=null；没有可用凭据时创建一枚并仅当次返回 Token。已有无效或过期凭据不会被自动删除，仍可能触发上游最多两枚凭据的限制。\nprepare 有开启接收和可能签发凭据的副作用，但不设置 AC syncEnabled、不启动首次导入，也不代表外部预配连接测试通过。用户将 baseUrl 和本次 Token 配置到外部预配系统后，再调用 UpdateIdentityProviderSCIM 确认开启同步。不能重取已有 Token；响应丢失时先查询凭据列表，不自动重复签发。Token 不应记录到日志或持久化前端缓存。\n\n## 请求与示例\nPOST /workspaces/{workspaceId}/scim-provisioning/prepare\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/prepare\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；已有可用凭据时为 null>"\n }\n}\n\n\n## 错误与处理\n 错误处理：400 InvalidParameter 表示参数或当前配置前提不满足；404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable；保留请求 ID 排查，不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 LimitExceeded.ScimCredential：已达到最多两枚凭据，需用户明确删除一枚后重试；不自动删除、轮换或扩容。400 InvalidParameter：共享池不可用。此调用可能已开启上游接收再因签发失败报错，错误不代表操作已自动回滚。\n\n## 调用关系与使用边界\n 共享池通过 CreateIdentityProvider 的 identityProviderType=CustomSSO 创建；不需要配置 SAML。若复用了已有凭据而 token=null，应使用用户已经保存的 Token，不能把空值配置到外部系统；Token 丢失时先 ListIdentityProviderSCIMCredentials 核查，再显式 CreateIdentityProviderSCIMCredential 签发；达到两枚上限时由用户确认后删除不再使用的一枚。