@alicloud/agentcore20260804 2.6.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (144) hide show
  1. package/dist/client.d.ts +577 -119
  2. package/dist/client.js +729 -123
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateIdentityProviderRequest.d.ts +6 -6
  5. package/dist/models/CreateIdentityProviderResponseBody.d.ts +20 -52
  6. package/dist/models/CreateIdentityProviderResponseBody.js +0 -8
  7. package/dist/models/CreateIdentityProviderResponseBody.js.map +1 -1
  8. package/dist/models/CreateIdentityProviderScimcredentialRequest.d.ts +13 -0
  9. package/dist/models/CreateIdentityProviderScimcredentialRequest.js +54 -0
  10. package/dist/models/CreateIdentityProviderScimcredentialRequest.js.map +1 -0
  11. package/dist/models/CreateIdentityProviderScimcredentialResponse.d.ts +19 -0
  12. package/dist/models/CreateIdentityProviderScimcredentialResponse.js +69 -0
  13. package/dist/models/CreateIdentityProviderScimcredentialResponse.js.map +1 -0
  14. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.d.ts +157 -0
  15. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.js +146 -0
  16. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.js.map +1 -0
  17. package/dist/models/CreateWorkspaceRequest.d.ts +23 -7
  18. package/dist/models/CreateWorkspaceRequest.js +4 -0
  19. package/dist/models/CreateWorkspaceRequest.js.map +1 -1
  20. package/dist/models/CreateWorkspaceResponseBody.d.ts +11 -11
  21. package/dist/models/CreateWorkspaceShrinkRequest.d.ts +1 -1
  22. package/dist/models/DeleteIdentityProviderResponseBody.d.ts +15 -47
  23. package/dist/models/DeleteIdentityProviderResponseBody.js +0 -8
  24. package/dist/models/DeleteIdentityProviderResponseBody.js.map +1 -1
  25. package/dist/models/DeleteIdentityProviderScimcredentialRequest.d.ts +13 -0
  26. package/dist/models/DeleteIdentityProviderScimcredentialRequest.js +54 -0
  27. package/dist/models/DeleteIdentityProviderScimcredentialRequest.js.map +1 -0
  28. package/dist/models/DeleteIdentityProviderScimcredentialResponse.d.ts +19 -0
  29. package/dist/models/DeleteIdentityProviderScimcredentialResponse.js +69 -0
  30. package/dist/models/DeleteIdentityProviderScimcredentialResponse.js.map +1 -0
  31. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.d.ts +50 -0
  32. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.js +66 -0
  33. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.js.map +1 -0
  34. package/dist/models/GetIdentityProviderResponseBody.d.ts +23 -55
  35. package/dist/models/GetIdentityProviderResponseBody.js +0 -8
  36. package/dist/models/GetIdentityProviderResponseBody.js.map +1 -1
  37. package/dist/models/GetIdentityProviderScimrequest.d.ts +13 -0
  38. package/dist/models/GetIdentityProviderScimrequest.js +54 -0
  39. package/dist/models/GetIdentityProviderScimrequest.js.map +1 -0
  40. package/dist/models/GetIdentityProviderScimresponse.d.ts +19 -0
  41. package/dist/models/GetIdentityProviderScimresponse.js +69 -0
  42. package/dist/models/GetIdentityProviderScimresponse.js.map +1 -0
  43. package/dist/models/GetIdentityProviderScimresponseBody.d.ts +123 -0
  44. package/dist/models/GetIdentityProviderScimresponseBody.js +118 -0
  45. package/dist/models/GetIdentityProviderScimresponseBody.js.map +1 -0
  46. package/dist/models/GetIdentityProviderServiceProviderRequest.d.ts +23 -0
  47. package/dist/models/GetIdentityProviderServiceProviderRequest.js +58 -0
  48. package/dist/models/GetIdentityProviderServiceProviderRequest.js.map +1 -0
  49. package/dist/models/GetIdentityProviderServiceProviderResponse.d.ts +19 -0
  50. package/dist/models/GetIdentityProviderServiceProviderResponse.js +69 -0
  51. package/dist/models/GetIdentityProviderServiceProviderResponse.js.map +1 -0
  52. package/dist/models/GetIdentityProviderServiceProviderResponseBody.d.ts +99 -0
  53. package/dist/models/GetIdentityProviderServiceProviderResponseBody.js +96 -0
  54. package/dist/models/GetIdentityProviderServiceProviderResponseBody.js.map +1 -0
  55. package/dist/models/ListIdentityProviderDepartmentsRequest.d.ts +2 -2
  56. package/dist/models/ListIdentityProviderDepartmentsResponseBody.d.ts +9 -9
  57. package/dist/models/ListIdentityProviderScimcredentialsRequest.d.ts +13 -0
  58. package/dist/models/ListIdentityProviderScimcredentialsRequest.js +54 -0
  59. package/dist/models/ListIdentityProviderScimcredentialsRequest.js.map +1 -0
  60. package/dist/models/ListIdentityProviderScimcredentialsResponse.d.ts +19 -0
  61. package/dist/models/ListIdentityProviderScimcredentialsResponse.js +69 -0
  62. package/dist/models/ListIdentityProviderScimcredentialsResponse.js.map +1 -0
  63. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.d.ts +99 -0
  64. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.js +96 -0
  65. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.js.map +1 -0
  66. package/dist/models/ListIdentityProvidersRequest.d.ts +2 -2
  67. package/dist/models/ListIdentityProvidersResponseBody.d.ts +25 -69
  68. package/dist/models/ListIdentityProvidersResponseBody.js +0 -8
  69. package/dist/models/ListIdentityProvidersResponseBody.js.map +1 -1
  70. package/dist/models/PrepareIdentityProviderScimrequest.d.ts +13 -0
  71. package/dist/models/PrepareIdentityProviderScimrequest.js +54 -0
  72. package/dist/models/PrepareIdentityProviderScimrequest.js.map +1 -0
  73. package/dist/models/PrepareIdentityProviderScimresponse.d.ts +19 -0
  74. package/dist/models/PrepareIdentityProviderScimresponse.js +69 -0
  75. package/dist/models/PrepareIdentityProviderScimresponse.js.map +1 -0
  76. package/dist/models/PrepareIdentityProviderScimresponseBody.d.ts +157 -0
  77. package/dist/models/PrepareIdentityProviderScimresponseBody.js +146 -0
  78. package/dist/models/PrepareIdentityProviderScimresponseBody.js.map +1 -0
  79. package/dist/models/UpdateIdentityProviderRequest.d.ts +20 -39
  80. package/dist/models/UpdateIdentityProviderRequest.js +0 -4
  81. package/dist/models/UpdateIdentityProviderRequest.js.map +1 -1
  82. package/dist/models/UpdateIdentityProviderResponseBody.d.ts +35 -60
  83. package/dist/models/UpdateIdentityProviderResponseBody.js +0 -8
  84. package/dist/models/UpdateIdentityProviderResponseBody.js.map +1 -1
  85. package/dist/models/UpdateIdentityProviderScimrequest.d.ts +39 -0
  86. package/dist/models/UpdateIdentityProviderScimrequest.js +80 -0
  87. package/dist/models/UpdateIdentityProviderScimrequest.js.map +1 -0
  88. package/dist/models/UpdateIdentityProviderScimresponse.d.ts +19 -0
  89. package/dist/models/UpdateIdentityProviderScimresponse.js +69 -0
  90. package/dist/models/UpdateIdentityProviderScimresponse.js.map +1 -0
  91. package/dist/models/UpdateIdentityProviderScimresponseBody.d.ts +288 -0
  92. package/dist/models/UpdateIdentityProviderScimresponseBody.js +201 -0
  93. package/dist/models/UpdateIdentityProviderScimresponseBody.js.map +1 -0
  94. package/dist/models/UpdateIdentityProviderScimshrinkRequest.d.ts +20 -0
  95. package/dist/models/UpdateIdentityProviderScimshrinkRequest.js +58 -0
  96. package/dist/models/UpdateIdentityProviderScimshrinkRequest.js.map +1 -0
  97. package/dist/models/UpdateIdentityProviderShrinkRequest.d.ts +1 -1
  98. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationRequest.d.ts +1 -1
  99. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.d.ts +28 -2
  100. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.js.map +1 -1
  101. package/dist/models/model.d.ts +37 -0
  102. package/dist/models/model.js +100 -25
  103. package/dist/models/model.js.map +1 -1
  104. package/package.json +1 -1
  105. package/src/client.ts +746 -123
  106. package/src/models/CreateIdentityProviderRequest.ts +6 -6
  107. package/src/models/CreateIdentityProviderResponseBody.ts +20 -60
  108. package/src/models/CreateIdentityProviderScimcredentialRequest.ts +24 -0
  109. package/src/models/CreateIdentityProviderScimcredentialResponse.ts +40 -0
  110. package/src/models/CreateIdentityProviderScimcredentialResponseBody.ts +231 -0
  111. package/src/models/CreateWorkspaceRequest.ts +27 -7
  112. package/src/models/CreateWorkspaceResponseBody.ts +11 -11
  113. package/src/models/CreateWorkspaceShrinkRequest.ts +1 -1
  114. package/src/models/DeleteIdentityProviderResponseBody.ts +15 -55
  115. package/src/models/DeleteIdentityProviderScimcredentialRequest.ts +24 -0
  116. package/src/models/DeleteIdentityProviderScimcredentialResponse.ts +40 -0
  117. package/src/models/DeleteIdentityProviderScimcredentialResponseBody.ts +71 -0
  118. package/src/models/GetIdentityProviderResponseBody.ts +23 -63
  119. package/src/models/GetIdentityProviderScimrequest.ts +24 -0
  120. package/src/models/GetIdentityProviderScimresponse.ts +40 -0
  121. package/src/models/GetIdentityProviderScimresponseBody.ts +178 -0
  122. package/src/models/GetIdentityProviderServiceProviderRequest.ts +36 -0
  123. package/src/models/GetIdentityProviderServiceProviderResponse.ts +40 -0
  124. package/src/models/GetIdentityProviderServiceProviderResponseBody.ts +141 -0
  125. package/src/models/ListIdentityProviderDepartmentsRequest.ts +2 -2
  126. package/src/models/ListIdentityProviderDepartmentsResponseBody.ts +9 -9
  127. package/src/models/ListIdentityProviderScimcredentialsRequest.ts +24 -0
  128. package/src/models/ListIdentityProviderScimcredentialsResponse.ts +40 -0
  129. package/src/models/ListIdentityProviderScimcredentialsResponseBody.ts +141 -0
  130. package/src/models/ListIdentityProvidersRequest.ts +2 -2
  131. package/src/models/ListIdentityProvidersResponseBody.ts +25 -77
  132. package/src/models/PrepareIdentityProviderScimrequest.ts +24 -0
  133. package/src/models/PrepareIdentityProviderScimresponse.ts +40 -0
  134. package/src/models/PrepareIdentityProviderScimresponseBody.ts +231 -0
  135. package/src/models/UpdateIdentityProviderRequest.ts +20 -43
  136. package/src/models/UpdateIdentityProviderResponseBody.ts +35 -68
  137. package/src/models/UpdateIdentityProviderScimrequest.ts +65 -0
  138. package/src/models/UpdateIdentityProviderScimresponse.ts +40 -0
  139. package/src/models/UpdateIdentityProviderScimresponseBody.ts +408 -0
  140. package/src/models/UpdateIdentityProviderScimshrinkRequest.ts +33 -0
  141. package/src/models/UpdateIdentityProviderShrinkRequest.ts +1 -1
  142. package/src/models/VerifyAgentCodePackageOssRamAuthorizationRequest.ts +1 -1
  143. package/src/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.ts +28 -2
  144. package/src/models/model.ts +37 -0
package/dist/client.js CHANGED
@@ -670,15 +670,15 @@ class Client extends openapi_core_1.default {
670
670
  return await this.createExternalAgentBootstrapTokenWithOptions(workspaceId, agentId, request, headers, runtime);
671
671
  }
672
672
  /**
673
- * Binds an external identity provider to a specified workspace for single sign-on and organization member synchronization of workspace users. You can bind up to one external identity provider to each workspace. The binding is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
673
+ * Binds an external identity provider to a specified workspace for single sign-on and organization member synchronization of workspace users. A maximum of one external identity provider can be bound to each workspace. The binding is an asynchronous operation. After the API returns, you can query the status by calling GetIdentityProvider to track the progress.
674
674
  *
675
675
  * @remarks
676
676
  * ## Features and prerequisites
677
- * A workspace can be bound to only one external identity provider. The identityProviderType parameter supports DingTalk, Feishu, and CustomSSO. CustomSSO only initializes the shared user pool. Do not pass non-empty metadata, and do not pass true for loginEnabled or syncEnabled. By default, both switches are turned off. Protocols and SAML configurations are saved by calling UpdateIdentityProvider. SCIM is configured through a separate API. You do not need to save SAML first. After the request is accepted and CONFIGURED is returned, call GetIdentityProvider and wait for the user pool initialization to complete. READY only indicates that the resource is ready, not that SAML is configured. If the same CustomSSO binding is in the CONFIGURED or READY state, the existing binding can be returned. You cannot treat all states as repeatable creations.
678
- * For DingTalk, the metadata parameter requires appKey, appSecret, and corpId. For Feishu, appId and appSecret are required. The vendor logon switch is enabled by default, and the synchronization switch is disabled by default. When synchronization is enabled, encryptKey and verificationToken are also required. The vendor syncOnBind and syncScope parameters retain the existing department-based synchronization definitions. Do not use these vendor pull parameters to replace SCIM configurations during CustomSSO initialization.
677
+ * A workspace can be bound to only one external identity provider. The identityProviderType parameter supports DingTalk, Feishu, and CustomSSO. CustomSSO only initializes the shared user pool. Do not pass non-empty metadata, and do not pass true for loginEnabled or syncEnabled. By default, both switches are turned off. Protocols and SAML configurations are saved by calling UpdateIdentityProvider. SCIM is configured through a separate API. Saving SAML first is not required. After the request is accepted and CONFIGURED is returned, call GetIdentityProvider and wait for the user pool initialization to complete. READY only indicates that the resource is ready, not that SAML is configured. If the same CustomSSO binding is in the CONFIGURED or READY state, the existing binding may be returned. Not all states can be treated as repeatedly creatable.
678
+ * For DingTalk, appKey, appSecret, and corpId are required in metadata. For Feishu, appId and appSecret are required. The vendor login switch is enabled by default. The synchronization switch is disabled by default. When synchronization is enabled, encryptKey and verificationToken are also required. The vendor syncOnBind and syncScope parameters retain the existing department-based synchronization definitions. Do not use these vendor pull parameters to replace SCIM configurations during CustomSSO initialization.
679
679
  * ## Requests and examples
680
680
  * POST /workspaces/{workspaceId}/identity-providers
681
- * Call conventions: Call the API based on the region of the target workspace. Use an AccessKey pair or STS token that has permissions on the identity provider resources of the corresponding workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
681
+ * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
682
682
  * ```text
683
683
  * POST /workspaces/ws-example/identity-providers
684
684
  * {"identityProviderType": "CustomSSO"}
@@ -696,7 +696,7 @@ class Client extends openapi_core_1.default {
696
696
  * }
697
697
  * ```
698
698
  * ## Errors and handling
699
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream service may return 503 IdentityProviderProvisioningUnavailable if it fails. Keep the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
699
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to an upstream service may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
700
700
  * 409 IdentityProviderAlreadyBound: An external binding already exists. Query and reuse the correct binding first. Do not automatically unbind the entire binding. Asynchronous initialization failure does not equal HTTP request failure. You must continue to query the status.
701
701
  *
702
702
  * @param tmpReq - CreateIdentityProviderRequest
@@ -733,15 +733,15 @@ class Client extends openapi_core_1.default {
733
733
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateIdentityProviderResponse({}));
734
734
  }
735
735
  /**
736
- * Binds an external identity provider to a specified workspace for single sign-on and organization member synchronization of workspace users. You can bind up to one external identity provider to each workspace. The binding is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
736
+ * Binds an external identity provider to a specified workspace for single sign-on and organization member synchronization of workspace users. A maximum of one external identity provider can be bound to each workspace. The binding is an asynchronous operation. After the API returns, you can query the status by calling GetIdentityProvider to track the progress.
737
737
  *
738
738
  * @remarks
739
739
  * ## Features and prerequisites
740
- * A workspace can be bound to only one external identity provider. The identityProviderType parameter supports DingTalk, Feishu, and CustomSSO. CustomSSO only initializes the shared user pool. Do not pass non-empty metadata, and do not pass true for loginEnabled or syncEnabled. By default, both switches are turned off. Protocols and SAML configurations are saved by calling UpdateIdentityProvider. SCIM is configured through a separate API. You do not need to save SAML first. After the request is accepted and CONFIGURED is returned, call GetIdentityProvider and wait for the user pool initialization to complete. READY only indicates that the resource is ready, not that SAML is configured. If the same CustomSSO binding is in the CONFIGURED or READY state, the existing binding can be returned. You cannot treat all states as repeatable creations.
741
- * For DingTalk, the metadata parameter requires appKey, appSecret, and corpId. For Feishu, appId and appSecret are required. The vendor logon switch is enabled by default, and the synchronization switch is disabled by default. When synchronization is enabled, encryptKey and verificationToken are also required. The vendor syncOnBind and syncScope parameters retain the existing department-based synchronization definitions. Do not use these vendor pull parameters to replace SCIM configurations during CustomSSO initialization.
740
+ * A workspace can be bound to only one external identity provider. The identityProviderType parameter supports DingTalk, Feishu, and CustomSSO. CustomSSO only initializes the shared user pool. Do not pass non-empty metadata, and do not pass true for loginEnabled or syncEnabled. By default, both switches are turned off. Protocols and SAML configurations are saved by calling UpdateIdentityProvider. SCIM is configured through a separate API. Saving SAML first is not required. After the request is accepted and CONFIGURED is returned, call GetIdentityProvider and wait for the user pool initialization to complete. READY only indicates that the resource is ready, not that SAML is configured. If the same CustomSSO binding is in the CONFIGURED or READY state, the existing binding may be returned. Not all states can be treated as repeatedly creatable.
741
+ * For DingTalk, appKey, appSecret, and corpId are required in metadata. For Feishu, appId and appSecret are required. The vendor login switch is enabled by default. The synchronization switch is disabled by default. When synchronization is enabled, encryptKey and verificationToken are also required. The vendor syncOnBind and syncScope parameters retain the existing department-based synchronization definitions. Do not use these vendor pull parameters to replace SCIM configurations during CustomSSO initialization.
742
742
  * ## Requests and examples
743
743
  * POST /workspaces/{workspaceId}/identity-providers
744
- * Call conventions: Call the API based on the region of the target workspace. Use an AccessKey pair or STS token that has permissions on the identity provider resources of the corresponding workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
744
+ * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
745
745
  * ```text
746
746
  * POST /workspaces/ws-example/identity-providers
747
747
  * {"identityProviderType": "CustomSSO"}
@@ -759,7 +759,7 @@ class Client extends openapi_core_1.default {
759
759
  * }
760
760
  * ```
761
761
  * ## Errors and handling
762
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream service may return 503 IdentityProviderProvisioningUnavailable if it fails. Keep the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
762
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to an upstream service may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
763
763
  * 409 IdentityProviderAlreadyBound: An external binding already exists. Query and reuse the correct binding first. Do not automatically unbind the entire binding. Asynchronous initialization failure does not equal HTTP request failure. You must continue to query the status.
764
764
  *
765
765
  * @param request - CreateIdentityProviderRequest
@@ -770,6 +770,111 @@ class Client extends openapi_core_1.default {
770
770
  let headers = {};
771
771
  return await this.createIdentityProviderWithOptions(workspaceId, request, headers, runtime);
772
772
  }
773
+ /**
774
+ * Issues a SCIM credential explicitly and returns the plaintext token only for the current call. A maximum of two credentials are allowed in the same pool. This operation does not automatically revoke old credentials or enable AC user synchronization.
775
+ *
776
+ * @remarks
777
+ * ## Features and prerequisites
778
+ * Issues a new credential explicitly. This requires an available shared pool and the AgentIdentity SCIM reception to be Enabled. This operation does not automatically enable reception. If it is not enabled, call prepare first. Returns the configuration, credential summary, and the current token. The limit of a maximum of two credentials is enforced by AgentIdentity. An existing available token does not prevent users from explicitly creating a second one. Old credentials are not automatically revoked, and no extended rotation process is provided.
779
+ * The token is returned only once and cannot be retrieved again in subsequent list and query operations. Do not automatically retry the issuance. If the response is lost, check the list first to verify whether it has been created. Creating a credential does not enable AC syncEnabled, start a full user import, or switch SAML logon. Deleting an old token should be performed explicitly after the user confirms the actual usage of the external provisioning system.
780
+ * ## Request and examples
781
+ * POST /workspaces/{workspaceId}/scim-provisioning/credentials
782
+ * Call conventions: Call the operation in the region of the target workspace, using an AK/STS identity that has permissions for the identity source resources of the corresponding workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameter content of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log the key. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
783
+ * ```text
784
+ * POST /workspaces/ws-example/scim-provisioning/credentials
785
+ * No business request body.
786
+ * ```
787
+ * ## Response example
788
+ * ```json
789
+ * {
790
+ * "data": {
791
+ * "configuration": {
792
+ * "status": "Enabled",
793
+ * "baseUrl": "https://example.com/scim/v2"
794
+ * },
795
+ * "credential": {
796
+ * "credentialId": "credential-example",
797
+ * "status": "Enabled",
798
+ * "expireTime": "<Upstream expiration time>"
799
+ * },
800
+ * "token": "<Newly issued token for the current request>"
801
+ * }
802
+ * }
803
+ * ```
804
+ * ## Errors and handling
805
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that there is no binding of the matching type. Synchronous calls to the upstream may fail and return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
806
+ * 400 LimitExceeded.ScimCredential: A maximum of two credentials are allowed. Delete one before you can continue to create. 400 InvalidParameter: Reception is not enabled or the shared pool is unavailable. Do not retry quota errors as system failures.
807
+ * ## Call relationships and usage boundaries
808
+ * After creation, securely save the token that is returned only once and configure it in the external provisioning system. Existing tokens remain valid. Only DeleteIdentityProviderSCIMCredential revokes the specified credential. Do not automatically retry when the response is lost. Call ListIdentityProviderSCIMCredentials to check first. This operation does not provide automatic rotation or scaling.
809
+ *
810
+ * @param request - CreateIdentityProviderSCIMCredentialRequest
811
+ * @param headers - map
812
+ * @param runtime - runtime options for this request RuntimeOptions
813
+ * @returns CreateIdentityProviderSCIMCredentialResponse
814
+ */
815
+ async createIdentityProviderSCIMCredentialWithOptions(workspaceId, request, headers, runtime) {
816
+ request.validate();
817
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
818
+ headers: headers,
819
+ });
820
+ let params = new openapi_core_2.$OpenApiUtil.Params({
821
+ action: "CreateIdentityProviderSCIMCredential",
822
+ version: "2026-08-04",
823
+ protocol: "HTTPS",
824
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials`,
825
+ method: "POST",
826
+ authType: "AK",
827
+ style: "ROA",
828
+ reqBodyType: "json",
829
+ bodyType: "json",
830
+ });
831
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateIdentityProviderSCIMCredentialResponse({}));
832
+ }
833
+ /**
834
+ * Issues a SCIM credential explicitly and returns the plaintext token only for the current call. A maximum of two credentials are allowed in the same pool. This operation does not automatically revoke old credentials or enable AC user synchronization.
835
+ *
836
+ * @remarks
837
+ * ## Features and prerequisites
838
+ * Issues a new credential explicitly. This requires an available shared pool and the AgentIdentity SCIM reception to be Enabled. This operation does not automatically enable reception. If it is not enabled, call prepare first. Returns the configuration, credential summary, and the current token. The limit of a maximum of two credentials is enforced by AgentIdentity. An existing available token does not prevent users from explicitly creating a second one. Old credentials are not automatically revoked, and no extended rotation process is provided.
839
+ * The token is returned only once and cannot be retrieved again in subsequent list and query operations. Do not automatically retry the issuance. If the response is lost, check the list first to verify whether it has been created. Creating a credential does not enable AC syncEnabled, start a full user import, or switch SAML logon. Deleting an old token should be performed explicitly after the user confirms the actual usage of the external provisioning system.
840
+ * ## Request and examples
841
+ * POST /workspaces/{workspaceId}/scim-provisioning/credentials
842
+ * Call conventions: Call the operation in the region of the target workspace, using an AK/STS identity that has permissions for the identity source resources of the corresponding workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameter content of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log the key. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
843
+ * ```text
844
+ * POST /workspaces/ws-example/scim-provisioning/credentials
845
+ * No business request body.
846
+ * ```
847
+ * ## Response example
848
+ * ```json
849
+ * {
850
+ * "data": {
851
+ * "configuration": {
852
+ * "status": "Enabled",
853
+ * "baseUrl": "https://example.com/scim/v2"
854
+ * },
855
+ * "credential": {
856
+ * "credentialId": "credential-example",
857
+ * "status": "Enabled",
858
+ * "expireTime": "<Upstream expiration time>"
859
+ * },
860
+ * "token": "<Newly issued token for the current request>"
861
+ * }
862
+ * }
863
+ * ```
864
+ * ## Errors and handling
865
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that there is no binding of the matching type. Synchronous calls to the upstream may fail and return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
866
+ * 400 LimitExceeded.ScimCredential: A maximum of two credentials are allowed. Delete one before you can continue to create. 400 InvalidParameter: Reception is not enabled or the shared pool is unavailable. Do not retry quota errors as system failures.
867
+ * ## Call relationships and usage boundaries
868
+ * After creation, securely save the token that is returned only once and configure it in the external provisioning system. Existing tokens remain valid. Only DeleteIdentityProviderSCIMCredential revokes the specified credential. Do not automatically retry when the response is lost. Call ListIdentityProviderSCIMCredentials to check first. This operation does not provide automatic rotation or scaling.
869
+ *
870
+ * @param request - CreateIdentityProviderSCIMCredentialRequest
871
+ * @returns CreateIdentityProviderSCIMCredentialResponse
872
+ */
873
+ async createIdentityProviderSCIMCredential(workspaceId, request) {
874
+ let runtime = new $dara.RuntimeOptions({});
875
+ let headers = {};
876
+ return await this.createIdentityProviderSCIMCredentialWithOptions(workspaceId, request, headers, runtime);
877
+ }
773
878
  /**
774
879
  * Initiates a manual synchronization of an identity provider.
775
880
  *
@@ -1728,15 +1833,15 @@ class Client extends openapi_core_1.default {
1728
1833
  return await this.deleteExternalAgentWithOptions(workspaceId, agentId, request, headers, runtime);
1729
1834
  }
1730
1835
  /**
1731
- * Disconnects the external identity provider from a specified workspace and cleans up the users synchronized by the identity provider. The disconnection is an asynchronous operation. After the API returns a response, you can call GetIdentityProvider to query the status and track the progress.
1836
+ * Disconnects the identity source integration of a workspace. For CustomSSO, this operation clears the shared user pool and related SAML and SCIM resources. To disable only logon or synchronization, use the corresponding switch API operations.
1732
1837
  *
1733
1838
  * @remarks
1734
1839
  * ## Features and prerequisites
1735
- * This is a complete disconnection, not just disabling logon. Disconnecting CustomSSO cleans up the AC users imported from this identity source, remote shared user pools and related resources, logon publishing configurations, and bindings. Therefore, both SAML and SCIM are affected. It does not delete the enterprise applications created by users on external platforms such as Azure. The system first checks the references between users and Teams. If references exist, the disconnection is rejected.
1736
- * After the request is accepted, the system returns DISCONNECTING. You can call GetIdentityProvider to query the status. The cleanup is complete only when the binding does not exist (IdentityProviderNotFound). The binding should also no longer appear in the list. DISCONNECT_FAILED indicates that a partial cleanup may have occurred and the state cannot be restored to a brand new unconfigured state. You can retry based on the returned status. If the binding does not exist in the first place, the API returns a placeholder result indicating no binding without creating new resources. An ongoing disconnection task may return the current binding. Do not use this API as a substitute for setting loginEnabled=false, syncEnabled=false, or deleting a single token.
1840
+ * This operation completely disconnects the integration, rather than simply disabling logon. Disconnecting CustomSSO clears the AC users imported from this identity source, the remote shared user pool and related resources, and the logon publishing configurations and bindings. Therefore, both SAML and SCIM are affected. However, this operation does not delete the enterprise applications created by users on external platforms such as Azure. Before disconnecting, the system checks for references between users and teams. If references exist, the disconnection is rejected.
1841
+ * After the request is accepted, the status returned is DISCONNECTING. You can query the status by calling GetIdentityProvider. The cleanup is complete only when the binding no longer exists (IdentityProviderNotFound). The binding should also no longer appear in the list. DISCONNECT_FAILED indicates that partial cleanup may have occurred, and the state cannot be restored to a completely unconfigured state. You can retry based on the returned status. If the binding does not exist in the first place, the API operation returns a placeholder result indicating no binding without creating new resources. An ongoing disconnection task may return the current binding. Do not use this API operation as a substitute for setting loginEnabled=false, syncEnabled=false, or deleting a single token.
1737
1842
  * ## Requests and examples
1738
1843
  * DELETE /workspaces/{workspaceId}/identity-providers/{identityProviderType}
1739
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS credential that has permissions on the identity source resources of the workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameter content of the public API, not the extra body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
1844
+ * Calling conventions: Call the API operation in the region of the target workspace, using an AK/STS identity that has the corresponding workspace identity source resource permissions. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
1740
1845
  * ```text
1741
1846
  * DELETE /workspaces/ws-example/identity-providers/CustomSSO
1742
1847
  * ```
@@ -1751,8 +1856,10 @@ class Client extends openapi_core_1.default {
1751
1856
  * }
1752
1857
  * ```
1753
1858
  * ## Errors and handling
1754
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to the upstream may return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
1755
- * 409 IdentityProvider.Disconnect.Conflict: Users of this identity source still belong to a Team. Remove the references first. 409 IdentityProviderOperationConflict: The current status does not allow disconnection. 404 IdentityProviderNotFound: An external binding exists but the type does not match. An asynchronous failure may result in a partial cleanup. You cannot claim completion based solely on the first response.
1859
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
1860
+ * 409 IdentityProvider.Disconnect.Conflict: Users of this identity source still belong to a team. Remove the references first. 409 IdentityProviderOperationConflict: The current status does not allow disconnection. 404 IdentityProviderNotFound: An external binding exists but the type does not match. Asynchronous failures may result in partial cleanup. You cannot claim completion based solely on the first response.
1861
+ * ## Calling relationships and usage boundaries
1862
+ * If you only need to disable a specific capability: To disable SAML logon, use UpdateIdentityProvider and set loginEnabled=false. To disable SCIM, use UpdateIdentityProviderSCIM and set syncEnabled=false. To revoke a single token, use DeleteIdentityProviderSCIMCredential. Call this API operation only when you need to completely disconnect the integration.
1756
1863
  *
1757
1864
  * @param request - DeleteIdentityProviderRequest
1758
1865
  * @param headers - map
@@ -1783,15 +1890,15 @@ class Client extends openapi_core_1.default {
1783
1890
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteIdentityProviderResponse({}));
1784
1891
  }
1785
1892
  /**
1786
- * Disconnects the external identity provider from a specified workspace and cleans up the users synchronized by the identity provider. The disconnection is an asynchronous operation. After the API returns a response, you can call GetIdentityProvider to query the status and track the progress.
1893
+ * Disconnects the identity source integration of a workspace. For CustomSSO, this operation clears the shared user pool and related SAML and SCIM resources. To disable only logon or synchronization, use the corresponding switch API operations.
1787
1894
  *
1788
1895
  * @remarks
1789
1896
  * ## Features and prerequisites
1790
- * This is a complete disconnection, not just disabling logon. Disconnecting CustomSSO cleans up the AC users imported from this identity source, remote shared user pools and related resources, logon publishing configurations, and bindings. Therefore, both SAML and SCIM are affected. It does not delete the enterprise applications created by users on external platforms such as Azure. The system first checks the references between users and Teams. If references exist, the disconnection is rejected.
1791
- * After the request is accepted, the system returns DISCONNECTING. You can call GetIdentityProvider to query the status. The cleanup is complete only when the binding does not exist (IdentityProviderNotFound). The binding should also no longer appear in the list. DISCONNECT_FAILED indicates that a partial cleanup may have occurred and the state cannot be restored to a brand new unconfigured state. You can retry based on the returned status. If the binding does not exist in the first place, the API returns a placeholder result indicating no binding without creating new resources. An ongoing disconnection task may return the current binding. Do not use this API as a substitute for setting loginEnabled=false, syncEnabled=false, or deleting a single token.
1897
+ * This operation completely disconnects the integration, rather than simply disabling logon. Disconnecting CustomSSO clears the AC users imported from this identity source, the remote shared user pool and related resources, and the logon publishing configurations and bindings. Therefore, both SAML and SCIM are affected. However, this operation does not delete the enterprise applications created by users on external platforms such as Azure. Before disconnecting, the system checks for references between users and teams. If references exist, the disconnection is rejected.
1898
+ * After the request is accepted, the status returned is DISCONNECTING. You can query the status by calling GetIdentityProvider. The cleanup is complete only when the binding no longer exists (IdentityProviderNotFound). The binding should also no longer appear in the list. DISCONNECT_FAILED indicates that partial cleanup may have occurred, and the state cannot be restored to a completely unconfigured state. You can retry based on the returned status. If the binding does not exist in the first place, the API operation returns a placeholder result indicating no binding without creating new resources. An ongoing disconnection task may return the current binding. Do not use this API operation as a substitute for setting loginEnabled=false, syncEnabled=false, or deleting a single token.
1792
1899
  * ## Requests and examples
1793
1900
  * DELETE /workspaces/{workspaceId}/identity-providers/{identityProviderType}
1794
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS credential that has permissions on the identity source resources of the workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameter content of the public API, not the extra body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
1901
+ * Calling conventions: Call the API operation in the region of the target workspace, using an AK/STS identity that has the corresponding workspace identity source resource permissions. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
1795
1902
  * ```text
1796
1903
  * DELETE /workspaces/ws-example/identity-providers/CustomSSO
1797
1904
  * ```
@@ -1806,8 +1913,10 @@ class Client extends openapi_core_1.default {
1806
1913
  * }
1807
1914
  * ```
1808
1915
  * ## Errors and handling
1809
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to the upstream may return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
1810
- * 409 IdentityProvider.Disconnect.Conflict: Users of this identity source still belong to a Team. Remove the references first. 409 IdentityProviderOperationConflict: The current status does not allow disconnection. 404 IdentityProviderNotFound: An external binding exists but the type does not match. An asynchronous failure may result in a partial cleanup. You cannot claim completion based solely on the first response.
1916
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
1917
+ * 409 IdentityProvider.Disconnect.Conflict: Users of this identity source still belong to a team. Remove the references first. 409 IdentityProviderOperationConflict: The current status does not allow disconnection. 404 IdentityProviderNotFound: An external binding exists but the type does not match. Asynchronous failures may result in partial cleanup. You cannot claim completion based solely on the first response.
1918
+ * ## Calling relationships and usage boundaries
1919
+ * If you only need to disable a specific capability: To disable SAML logon, use UpdateIdentityProvider and set loginEnabled=false. To disable SCIM, use UpdateIdentityProviderSCIM and set syncEnabled=false. To revoke a single token, use DeleteIdentityProviderSCIMCredential. Call this API operation only when you need to completely disconnect the integration.
1811
1920
  *
1812
1921
  * @param request - DeleteIdentityProviderRequest
1813
1922
  * @returns DeleteIdentityProviderResponse
@@ -1817,6 +1926,49 @@ class Client extends openapi_core_1.default {
1817
1926
  let headers = {};
1818
1927
  return await this.deleteIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
1819
1928
  }
1929
+ /**
1930
+ * 删除 SCIM 凭据
1931
+ *
1932
+ * @remarks
1933
+ * ## 功能与前提\n撤销指定凭据,credentialId 必填且非空,从凭据列表取得。要求共享池可用,但不要求 SAML 已配置或 SCIM 接收为 Enabled。删除后使用该 Token 的外部预配请求会失效;只影响选定凭据,不自动关闭接收、不自动关闭 AC syncEnabled,也不影响另一枚凭据或 SAML。\n即使删除最后一枚凭据,也不自动回写同步开关或重发新 Token;用户应按需要先停用外部预配或更换其使用的 Token。成功返回公共响应,无业务 data 内容;刷新列表确认。对未知或已删除 ID 的结果由上游决定,不承诺统一 404 或无条件幂等成功。\n\n## 请求与示例\nDELETE /workspaces/{workspaceId}/scim-provisioning/credentials/{credentialId}\n调用约定:按目标 Workspace 的地域调用,使用有相应 Workspace 身份源资源权限的 AK/STS 身份。下文示例中的 ws-example、URL、证书和 Token 均为占位值,需替换为真实值。请求体示例表示公开 API 的 body 参数内容,不是后端直连接口额外的 body 包装。返回示例只展示业务部分,外层还包括 requestId、success、code、message、httpStatusCode;排障请保留 requestId,不记录密钥。业务任务异步不意味着 HTTP 请求长连接等待完成。\n```text\nDELETE /workspaces/ws-example/scim-provisioning/credentials/credential-example\n```\n\n## 返回示例\n```json\n{\n "success": true,\n "httpStatusCode": 200\n}\n```\n\n## 错误与处理\n错误处理:400 InvalidParameter 表示参数或当前配置前提不满足;404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable;保留请求 ID 排查,不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 InvalidParameter:credentialId 为空或共享池不可用。404 IdentityProviderNotFound 指绑定不存在,不代表所有未知凭据 ID 都返回该码。其他删除错误按上游结果处理,失败时刷新列表核对,不自动创建替代 Token。\n\n## 调用关系与使用边界\n使用 ListIdentityProviderSCIMCredentials 取得 credentialId 后删除指定凭据。若外部预配系统仍使用该 Token,后续预配可能鉴权失败,因此应先确认实际使用情况。删除后不会自动创建新凭据、关闭 AC 同步开关或关闭 SAML 登录。
1934
+ *
1935
+ * @param request - DeleteIdentityProviderSCIMCredentialRequest
1936
+ * @param headers - map
1937
+ * @param runtime - runtime options for this request RuntimeOptions
1938
+ * @returns DeleteIdentityProviderSCIMCredentialResponse
1939
+ */
1940
+ async deleteIdentityProviderSCIMCredentialWithOptions(workspaceId, credentialId, request, headers, runtime) {
1941
+ request.validate();
1942
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
1943
+ headers: headers,
1944
+ });
1945
+ let params = new openapi_core_2.$OpenApiUtil.Params({
1946
+ action: "DeleteIdentityProviderSCIMCredential",
1947
+ version: "2026-08-04",
1948
+ protocol: "HTTPS",
1949
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials/${$dara.URL.percentEncode(credentialId)}`,
1950
+ method: "DELETE",
1951
+ authType: "AK",
1952
+ style: "ROA",
1953
+ reqBodyType: "json",
1954
+ bodyType: "json",
1955
+ });
1956
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteIdentityProviderSCIMCredentialResponse({}));
1957
+ }
1958
+ /**
1959
+ * 删除 SCIM 凭据
1960
+ *
1961
+ * @remarks
1962
+ * ## 功能与前提\n撤销指定凭据,credentialId 必填且非空,从凭据列表取得。要求共享池可用,但不要求 SAML 已配置或 SCIM 接收为 Enabled。删除后使用该 Token 的外部预配请求会失效;只影响选定凭据,不自动关闭接收、不自动关闭 AC syncEnabled,也不影响另一枚凭据或 SAML。\n即使删除最后一枚凭据,也不自动回写同步开关或重发新 Token;用户应按需要先停用外部预配或更换其使用的 Token。成功返回公共响应,无业务 data 内容;刷新列表确认。对未知或已删除 ID 的结果由上游决定,不承诺统一 404 或无条件幂等成功。\n\n## 请求与示例\nDELETE /workspaces/{workspaceId}/scim-provisioning/credentials/{credentialId}\n调用约定:按目标 Workspace 的地域调用,使用有相应 Workspace 身份源资源权限的 AK/STS 身份。下文示例中的 ws-example、URL、证书和 Token 均为占位值,需替换为真实值。请求体示例表示公开 API 的 body 参数内容,不是后端直连接口额外的 body 包装。返回示例只展示业务部分,外层还包括 requestId、success、code、message、httpStatusCode;排障请保留 requestId,不记录密钥。业务任务异步不意味着 HTTP 请求长连接等待完成。\n```text\nDELETE /workspaces/ws-example/scim-provisioning/credentials/credential-example\n```\n\n## 返回示例\n```json\n{\n "success": true,\n "httpStatusCode": 200\n}\n```\n\n## 错误与处理\n错误处理:400 InvalidParameter 表示参数或当前配置前提不满足;404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable;保留请求 ID 排查,不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 InvalidParameter:credentialId 为空或共享池不可用。404 IdentityProviderNotFound 指绑定不存在,不代表所有未知凭据 ID 都返回该码。其他删除错误按上游结果处理,失败时刷新列表核对,不自动创建替代 Token。\n\n## 调用关系与使用边界\n使用 ListIdentityProviderSCIMCredentials 取得 credentialId 后删除指定凭据。若外部预配系统仍使用该 Token,后续预配可能鉴权失败,因此应先确认实际使用情况。删除后不会自动创建新凭据、关闭 AC 同步开关或关闭 SAML 登录。
1963
+ *
1964
+ * @param request - DeleteIdentityProviderSCIMCredentialRequest
1965
+ * @returns DeleteIdentityProviderSCIMCredentialResponse
1966
+ */
1967
+ async deleteIdentityProviderSCIMCredential(workspaceId, credentialId, request) {
1968
+ let runtime = new $dara.RuntimeOptions({});
1969
+ let headers = {};
1970
+ return await this.deleteIdentityProviderSCIMCredentialWithOptions(workspaceId, credentialId, request, headers, runtime);
1971
+ }
1820
1972
  /**
1821
1973
  * Deletes an image cache.
1822
1974
  *
@@ -3136,19 +3288,19 @@ class Client extends openapi_core_1.default {
3136
3288
  return await this.getExternalAgentBootstrapOptionsWithOptions(workspaceId, agentId, request, headers, runtime);
3137
3289
  }
3138
3290
  /**
3139
- * Queries the binding details of an external identity provider for a specified workspace, including the binding status, application configurations, and the callback URL to be configured on the identity provider side. Application secret configurations are not returned.
3291
+ * Queries the binding and expected configuration of a specified identity provider. When CustomSSO is configured with SAML, this operation reads back the actual upstream SSO configuration. The SCIM status is queried through a separate API operation.
3140
3292
  *
3141
3293
  * @remarks
3142
3294
  * ## Features and prerequisites
3143
- * Reads existing bindings by type. For CustomSSO, the API returns the saved protocol, standardized SAML, expected loginEnabled, syncEnabled, and shared binding status. If SAML is not configured, the saml and configuration fields may not be returned. If SAML is configured, the API additionally queries AgentIdentity, and the configuration field represents the actual SSO/JIT configuration. The saml field serves as the data source for the edit form. The status switches in the configuration field are Enabled and Disabled. If the upstream query fails, an error is returned. This failure must not be treated as an unconfigured state.
3144
- * Only this API reads back the actual SAML configuration. The list and write APIs do not guarantee that the configuration field is returned. A READY user pool does not indicate that SAML is configured. The UPDATING and UPDATE_FAILED statuses describe logon configuration tasks, not SCIM tasks. The vendor callback URL for CustomSSO is empty. Use GetIdentityProviderSCIM.operationStatus to query SCIM operation results.
3145
- * ## Requests and examples
3295
+ * Reads existing bindings by type. CustomSSO returns the saved protocol, standardized saml, expected loginEnabled, syncEnabled, and shared binding status. If SAML is not configured, the saml and configuration fields may not be returned. When saml is configured, the system additionally queries AgentIdentity, and configuration represents the actual SSO configuration. The saml field is the data source for the edit form. The status switch for configuration can be Enabled or Disabled. If the upstream query fails, an error is reported. Do not treat this as an unconfigured state.
3296
+ * Only this operation reads back the actual SAML configuration. List and write operations do not guarantee that configuration is returned. A user pool in the READY state does not indicate that SAML is configured. UPDATING and UPDATE_FAILED describe logon configuration tasks, not SCIM tasks. The vendor callback URL for CustomSSO is empty. Use GetIdentityProviderSCIM.operationStatus to query SCIM operation results.
3297
+ * ## Request and examples
3146
3298
  * GET /workspaces/{workspaceId}/identity-providers/{identityProviderType}
3147
- * Calling convention: Call this API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity source resources of the workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, rather than the extra body wrapper of the backend direct-connection API. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not imply that the HTTP request uses a persistent connection to wait for completion.
3299
+ * Calling conventions: Call the API operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log keys. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
3148
3300
  * ```text
3149
3301
  * GET /workspaces/ws-example/identity-providers/CustomSSO
3150
3302
  * ```
3151
- * ## Response example
3303
+ * ## Response examples
3152
3304
  * ```json
3153
3305
  * {
3154
3306
  * "data": {
@@ -3161,8 +3313,10 @@ class Client extends openapi_core_1.default {
3161
3313
  * }
3162
3314
  * ```
3163
3315
  * ## Errors and handling
3164
- * Error handling: A 400 InvalidParameter error indicates that the parameters or current configuration prerequisites are not met. A 404 IdentityProviderNotFound error indicates that no binding of the specified type exists. Synchronous calls to the upstream service may return a 503 IdentityProviderProvisioningUnavailable error if they fail. Retain the request ID for troubleshooting and do not interpret read failures as an unconfigured state. Authentication errors and workspace-not-found errors follow common error handling procedures.
3165
- * 404 IdentityProviderNotFound: No binding exists, or the specified type is inconsistent with the current binding. If SAML is already configured, an upstream read failure does not degrade to a successful empty configuration.
3316
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream service may fail and return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret a read failure as an unconfigured state. Actual authentication and workspace not found errors follow common error handling.
3317
+ * 404 IdentityProviderNotFound: No binding exists, or the input type is inconsistent with the current binding. If SAML is already configured, an upstream readback failure does not degrade to a successful empty configuration.
3318
+ * ## Call relationships and usage boundaries
3319
+ * SAML configuration completion and logon enabling are independent operations. protocol=SAML and the presence of saml indicate that the logon configuration has been submitted, and loginEnabled indicates the expected logon switch. Check the effective status based on the actual SSO status in configuration. SCIM uses an independent query API operation. Do not use status=READY of this API operation as the basis for successful SCIM synchronization. Currently, OIDC, JIT configuration, or JIT status fields are not provided.
3166
3320
  *
3167
3321
  * @param request - GetIdentityProviderRequest
3168
3322
  * @param headers - map
@@ -3188,19 +3342,19 @@ class Client extends openapi_core_1.default {
3188
3342
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderResponse({}));
3189
3343
  }
3190
3344
  /**
3191
- * Queries the binding details of an external identity provider for a specified workspace, including the binding status, application configurations, and the callback URL to be configured on the identity provider side. Application secret configurations are not returned.
3345
+ * Queries the binding and expected configuration of a specified identity provider. When CustomSSO is configured with SAML, this operation reads back the actual upstream SSO configuration. The SCIM status is queried through a separate API operation.
3192
3346
  *
3193
3347
  * @remarks
3194
3348
  * ## Features and prerequisites
3195
- * Reads existing bindings by type. For CustomSSO, the API returns the saved protocol, standardized SAML, expected loginEnabled, syncEnabled, and shared binding status. If SAML is not configured, the saml and configuration fields may not be returned. If SAML is configured, the API additionally queries AgentIdentity, and the configuration field represents the actual SSO/JIT configuration. The saml field serves as the data source for the edit form. The status switches in the configuration field are Enabled and Disabled. If the upstream query fails, an error is returned. This failure must not be treated as an unconfigured state.
3196
- * Only this API reads back the actual SAML configuration. The list and write APIs do not guarantee that the configuration field is returned. A READY user pool does not indicate that SAML is configured. The UPDATING and UPDATE_FAILED statuses describe logon configuration tasks, not SCIM tasks. The vendor callback URL for CustomSSO is empty. Use GetIdentityProviderSCIM.operationStatus to query SCIM operation results.
3197
- * ## Requests and examples
3349
+ * Reads existing bindings by type. CustomSSO returns the saved protocol, standardized saml, expected loginEnabled, syncEnabled, and shared binding status. If SAML is not configured, the saml and configuration fields may not be returned. When saml is configured, the system additionally queries AgentIdentity, and configuration represents the actual SSO configuration. The saml field is the data source for the edit form. The status switch for configuration can be Enabled or Disabled. If the upstream query fails, an error is reported. Do not treat this as an unconfigured state.
3350
+ * Only this operation reads back the actual SAML configuration. List and write operations do not guarantee that configuration is returned. A user pool in the READY state does not indicate that SAML is configured. UPDATING and UPDATE_FAILED describe logon configuration tasks, not SCIM tasks. The vendor callback URL for CustomSSO is empty. Use GetIdentityProviderSCIM.operationStatus to query SCIM operation results.
3351
+ * ## Request and examples
3198
3352
  * GET /workspaces/{workspaceId}/identity-providers/{identityProviderType}
3199
- * Calling convention: Call this API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity source resources of the workspace. The ws-example, URLs, certificates, and tokens in the following examples are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, rather than the extra body wrapper of the backend direct-connection API. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not imply that the HTTP request uses a persistent connection to wait for completion.
3353
+ * Calling conventions: Call the API operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log keys. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
3200
3354
  * ```text
3201
3355
  * GET /workspaces/ws-example/identity-providers/CustomSSO
3202
3356
  * ```
3203
- * ## Response example
3357
+ * ## Response examples
3204
3358
  * ```json
3205
3359
  * {
3206
3360
  * "data": {
@@ -3213,8 +3367,10 @@ class Client extends openapi_core_1.default {
3213
3367
  * }
3214
3368
  * ```
3215
3369
  * ## Errors and handling
3216
- * Error handling: A 400 InvalidParameter error indicates that the parameters or current configuration prerequisites are not met. A 404 IdentityProviderNotFound error indicates that no binding of the specified type exists. Synchronous calls to the upstream service may return a 503 IdentityProviderProvisioningUnavailable error if they fail. Retain the request ID for troubleshooting and do not interpret read failures as an unconfigured state. Authentication errors and workspace-not-found errors follow common error handling procedures.
3217
- * 404 IdentityProviderNotFound: No binding exists, or the specified type is inconsistent with the current binding. If SAML is already configured, an upstream read failure does not degrade to a successful empty configuration.
3370
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream service may fail and return 503 IdentityProviderProvisioningUnavailable. Keep the request ID for troubleshooting and do not interpret a read failure as an unconfigured state. Actual authentication and workspace not found errors follow common error handling.
3371
+ * 404 IdentityProviderNotFound: No binding exists, or the input type is inconsistent with the current binding. If SAML is already configured, an upstream readback failure does not degrade to a successful empty configuration.
3372
+ * ## Call relationships and usage boundaries
3373
+ * SAML configuration completion and logon enabling are independent operations. protocol=SAML and the presence of saml indicate that the logon configuration has been submitted, and loginEnabled indicates the expected logon switch. Check the effective status based on the actual SSO status in configuration. SCIM uses an independent query API operation. Do not use status=READY of this API operation as the basis for successful SCIM synchronization. Currently, OIDC, JIT configuration, or JIT status fields are not provided.
3218
3374
  *
3219
3375
  * @param request - GetIdentityProviderRequest
3220
3376
  * @returns GetIdentityProviderResponse
@@ -3224,6 +3380,149 @@ class Client extends openapi_core_1.default {
3224
3380
  let headers = {};
3225
3381
  return await this.getIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
3226
3382
  }
3383
+ /**
3384
+ * Queries the actual SCIM receiving configuration, the expected AC synchronization switch, and the status of the most recent independent SCIM task. Prior SAML configuration is not required.
3385
+ *
3386
+ * @remarks
3387
+ * ## Features and prerequisites
3388
+ * The shared CustomSSO user pool must be created and must not be in the overall dissociation process or have failed to be dissociated. Prior SAML configuration is not required. SAML updates in progress or failed SAML updates do not block the query. The configuration.status and baseUrl parameters are obtained from AgentIdentity. The syncEnabled parameter is the expected AC synchronization switch. The operationStatus parameter indicates the most recent independent SCIM switch and the first full import task when the switch is enabled. The presence of a URL does not mean that external provisioning is complete, nor does it mean that AC synchronization is enabled.
3389
+ * operationStatus: PENDING (waiting), RUNNING (in progress), PAUSED (paused), SUCCESS (succeeded), FAILED (failed), CANCELED (canceled). If there are no historical tasks, it returns null or is not returned. You can poll when the status is PENDING or RUNNING. Stop polling when a terminal state is reached. You can manually refresh when the status is PAUSED. This operation does not provide taskId or failure details, and does not indicate credential issuance, external provisioning connection tests, or the health of continuous incremental synchronization. After it is disabled, the URL, credentials, and historical task records may still be retained.
3390
+ * ## Requests and examples
3391
+ * GET /workspaces/{workspaceId}/scim-provisioning
3392
+ * Calling conventions: Call this operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
3393
+ * ```text
3394
+ * GET /workspaces/ws-example/scim-provisioning
3395
+ * ```
3396
+ * ## Response example
3397
+ * ```json
3398
+ * {
3399
+ * "data": {
3400
+ * "configuration": {
3401
+ * "status": "Enabled",
3402
+ * "baseUrl": "https://example.com/scim/v2"
3403
+ * },
3404
+ * "syncEnabled": true,
3405
+ * "operationStatus": "SUCCESS"
3406
+ * }
3407
+ * }
3408
+ * ```
3409
+ * ## Errors and handling
3410
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that there is no binding of the matching type. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
3411
+ * 400 InvalidParameter: The shared user pool is unavailable, being dissociated, or failed to be dissociated. If there is no binding, 404 IdentityProviderNotFound is returned. Upstream read failures must retain the error and cannot be mapped to Disabled, unconfigured, or synchronization success.
3412
+ * ## Call relationships and usage boundaries
3413
+ * SCIM configuration sequence: After preparing the shared pool, call PrepareIdentityProviderSCIM and configure the returned baseUrl and newly issued token to the provisioning system of the external IdP. After completing the external connection test, call UpdateIdentityProviderSCIM to enable synchronization, and then call this operation to query operationStatus. SUCCESS only indicates that the most recent SCIM task is completed, and does not represent the health of continuous incremental synchronization or the success of the external provisioning connection test.
3414
+ *
3415
+ * @param request - GetIdentityProviderSCIMRequest
3416
+ * @param headers - map
3417
+ * @param runtime - runtime options for this request RuntimeOptions
3418
+ * @returns GetIdentityProviderSCIMResponse
3419
+ */
3420
+ async getIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime) {
3421
+ request.validate();
3422
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
3423
+ headers: headers,
3424
+ });
3425
+ let params = new openapi_core_2.$OpenApiUtil.Params({
3426
+ action: "GetIdentityProviderSCIM",
3427
+ version: "2026-08-04",
3428
+ protocol: "HTTPS",
3429
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning`,
3430
+ method: "GET",
3431
+ authType: "AK",
3432
+ style: "ROA",
3433
+ reqBodyType: "json",
3434
+ bodyType: "json",
3435
+ });
3436
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderSCIMResponse({}));
3437
+ }
3438
+ /**
3439
+ * Queries the actual SCIM receiving configuration, the expected AC synchronization switch, and the status of the most recent independent SCIM task. Prior SAML configuration is not required.
3440
+ *
3441
+ * @remarks
3442
+ * ## Features and prerequisites
3443
+ * The shared CustomSSO user pool must be created and must not be in the overall dissociation process or have failed to be dissociated. Prior SAML configuration is not required. SAML updates in progress or failed SAML updates do not block the query. The configuration.status and baseUrl parameters are obtained from AgentIdentity. The syncEnabled parameter is the expected AC synchronization switch. The operationStatus parameter indicates the most recent independent SCIM switch and the first full import task when the switch is enabled. The presence of a URL does not mean that external provisioning is complete, nor does it mean that AC synchronization is enabled.
3444
+ * operationStatus: PENDING (waiting), RUNNING (in progress), PAUSED (paused), SUCCESS (succeeded), FAILED (failed), CANCELED (canceled). If there are no historical tasks, it returns null or is not returned. You can poll when the status is PENDING or RUNNING. Stop polling when a terminal state is reached. You can manually refresh when the status is PAUSED. This operation does not provide taskId or failure details, and does not indicate credential issuance, external provisioning connection tests, or the health of continuous incremental synchronization. After it is disabled, the URL, credentials, and historical task records may still be retained.
3445
+ * ## Requests and examples
3446
+ * GET /workspaces/{workspaceId}/scim-provisioning
3447
+ * Calling conventions: Call this operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
3448
+ * ```text
3449
+ * GET /workspaces/ws-example/scim-provisioning
3450
+ * ```
3451
+ * ## Response example
3452
+ * ```json
3453
+ * {
3454
+ * "data": {
3455
+ * "configuration": {
3456
+ * "status": "Enabled",
3457
+ * "baseUrl": "https://example.com/scim/v2"
3458
+ * },
3459
+ * "syncEnabled": true,
3460
+ * "operationStatus": "SUCCESS"
3461
+ * }
3462
+ * }
3463
+ * ```
3464
+ * ## Errors and handling
3465
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that there is no binding of the matching type. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
3466
+ * 400 InvalidParameter: The shared user pool is unavailable, being dissociated, or failed to be dissociated. If there is no binding, 404 IdentityProviderNotFound is returned. Upstream read failures must retain the error and cannot be mapped to Disabled, unconfigured, or synchronization success.
3467
+ * ## Call relationships and usage boundaries
3468
+ * SCIM configuration sequence: After preparing the shared pool, call PrepareIdentityProviderSCIM and configure the returned baseUrl and newly issued token to the provisioning system of the external IdP. After completing the external connection test, call UpdateIdentityProviderSCIM to enable synchronization, and then call this operation to query operationStatus. SUCCESS only indicates that the most recent SCIM task is completed, and does not represent the health of continuous incremental synchronization or the success of the external provisioning connection test.
3469
+ *
3470
+ * @param request - GetIdentityProviderSCIMRequest
3471
+ * @returns GetIdentityProviderSCIMResponse
3472
+ */
3473
+ async getIdentityProviderSCIM(workspaceId, request) {
3474
+ let runtime = new $dara.RuntimeOptions({});
3475
+ let headers = {};
3476
+ return await this.getIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
3477
+ }
3478
+ /**
3479
+ * 查询 SAML 服务提供商信息
3480
+ *
3481
+ * @remarks
3482
+ * ## 功能与前提\n要求已有可用 CustomSSO 共享用户池,identityProviderType=CustomSSO,protocol 必填且仅支持精确值 SAML;不要求先上传 IdP Metadata。返回我方 SP 的 entityId、acsUrl、metadataXml,供用户配置外部 IdP。它们不是外部 IdP 的登录 URL 或 IdP Entity ID,不能将 SP XML 作为 IdP XML 提交 UpdateIdentityProvider。\n本接口只读取,不启用登录、不开启 SCIM、不创建凭据、不执行登录连接测试。共享池初始化中、解绑中或解绑失败时不可读取。\n\n## 请求与示例\nGET /workspaces/{workspaceId}/identity-providers/{identityProviderType}/service-provider\n调用约定:按目标 Workspace 的地域调用,使用有相应 Workspace 身份源资源权限的 AK/STS 身份。下文示例中的 ws-example、URL、证书和 Token 均为占位值,需替换为真实值。请求体示例表示公开 API 的 body 参数内容,不是后端直连接口额外的 body 包装。返回示例只展示业务部分,外层还包括 requestId、success、code、message、httpStatusCode;排障请保留 requestId,不记录密钥。业务任务异步不意味着 HTTP 请求长连接等待完成。\n```text\nGET /workspaces/ws-example/identity-providers/CustomSSO/service-provider?protocol=SAML\n```\n\n## 返回示例\n```json\n{\n "data": {\n "protocol": "SAML",\n "entityId": "<我方 SP Entity ID>",\n "acsUrl": "https://example.com/saml/acs",\n "metadataXml": "<我方 SP Metadata XML>"\n }\n}\n```\n\n## 错误与处理\n错误处理:400 InvalidParameter 表示参数或当前配置前提不满足;404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable;保留请求 ID 排查,不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 InvalidParameter:identityProviderType 或 protocol 不支持。404 IdentityProviderNotFound:尚无 CustomSSO 绑定。409 IdentityProviderOperationConflict:用户池未准备好、解绑中或解绑失败。\n\n## 调用关系与使用边界\nSAML 配置顺序:CreateIdentityProvider 初始化 CustomSSO 共享池,等待 GetIdentityProvider 返回 READY;调用本接口取得 SP 信息并配置到外部 IdP;再将外部 IdP Metadata XML 或完整手填配置提交 UpdateIdentityProvider。保存后按需单独启用 loginEnabled。SP 信息查询不会完成外部 IdP 配置或验证登录。
3483
+ *
3484
+ * @param request - GetIdentityProviderServiceProviderRequest
3485
+ * @param headers - map
3486
+ * @param runtime - runtime options for this request RuntimeOptions
3487
+ * @returns GetIdentityProviderServiceProviderResponse
3488
+ */
3489
+ async getIdentityProviderServiceProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime) {
3490
+ request.validate();
3491
+ let query = {};
3492
+ if (!$dara.isNull(request.protocol)) {
3493
+ query["protocol"] = request.protocol;
3494
+ }
3495
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
3496
+ headers: headers,
3497
+ query: openapi_core_2.OpenApiUtil.query(query),
3498
+ });
3499
+ let params = new openapi_core_2.$OpenApiUtil.Params({
3500
+ action: "GetIdentityProviderServiceProvider",
3501
+ version: "2026-08-04",
3502
+ protocol: "HTTPS",
3503
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/service-provider`,
3504
+ method: "GET",
3505
+ authType: "AK",
3506
+ style: "ROA",
3507
+ reqBodyType: "json",
3508
+ bodyType: "json",
3509
+ });
3510
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderServiceProviderResponse({}));
3511
+ }
3512
+ /**
3513
+ * 查询 SAML 服务提供商信息
3514
+ *
3515
+ * @remarks
3516
+ * ## 功能与前提\n要求已有可用 CustomSSO 共享用户池,identityProviderType=CustomSSO,protocol 必填且仅支持精确值 SAML;不要求先上传 IdP Metadata。返回我方 SP 的 entityId、acsUrl、metadataXml,供用户配置外部 IdP。它们不是外部 IdP 的登录 URL 或 IdP Entity ID,不能将 SP XML 作为 IdP XML 提交 UpdateIdentityProvider。\n本接口只读取,不启用登录、不开启 SCIM、不创建凭据、不执行登录连接测试。共享池初始化中、解绑中或解绑失败时不可读取。\n\n## 请求与示例\nGET /workspaces/{workspaceId}/identity-providers/{identityProviderType}/service-provider\n调用约定:按目标 Workspace 的地域调用,使用有相应 Workspace 身份源资源权限的 AK/STS 身份。下文示例中的 ws-example、URL、证书和 Token 均为占位值,需替换为真实值。请求体示例表示公开 API 的 body 参数内容,不是后端直连接口额外的 body 包装。返回示例只展示业务部分,外层还包括 requestId、success、code、message、httpStatusCode;排障请保留 requestId,不记录密钥。业务任务异步不意味着 HTTP 请求长连接等待完成。\n```text\nGET /workspaces/ws-example/identity-providers/CustomSSO/service-provider?protocol=SAML\n```\n\n## 返回示例\n```json\n{\n "data": {\n "protocol": "SAML",\n "entityId": "<我方 SP Entity ID>",\n "acsUrl": "https://example.com/saml/acs",\n "metadataXml": "<我方 SP Metadata XML>"\n }\n}\n```\n\n## 错误与处理\n错误处理:400 InvalidParameter 表示参数或当前配置前提不满足;404 IdentityProviderNotFound 表示没有匹配类型的绑定。同步调用上游失败可能返回 503 IdentityProviderProvisioningUnavailable;保留请求 ID 排查,不把读取失败解释为未配置。实际鉴权和 Workspace 不存在错误沿用公共错误处理。\n400 InvalidParameter:identityProviderType 或 protocol 不支持。404 IdentityProviderNotFound:尚无 CustomSSO 绑定。409 IdentityProviderOperationConflict:用户池未准备好、解绑中或解绑失败。\n\n## 调用关系与使用边界\nSAML 配置顺序:CreateIdentityProvider 初始化 CustomSSO 共享池,等待 GetIdentityProvider 返回 READY;调用本接口取得 SP 信息并配置到外部 IdP;再将外部 IdP Metadata XML 或完整手填配置提交 UpdateIdentityProvider。保存后按需单独启用 loginEnabled。SP 信息查询不会完成外部 IdP 配置或验证登录。
3517
+ *
3518
+ * @param request - GetIdentityProviderServiceProviderRequest
3519
+ * @returns GetIdentityProviderServiceProviderResponse
3520
+ */
3521
+ async getIdentityProviderServiceProvider(workspaceId, identityProviderType, request) {
3522
+ let runtime = new $dara.RuntimeOptions({});
3523
+ let headers = {};
3524
+ return await this.getIdentityProviderServiceProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
3525
+ }
3227
3526
  /**
3228
3527
  * Queries an identity provider synchronization task.
3229
3528
  *
@@ -4910,7 +5209,31 @@ class Client extends openapi_core_1.default {
4910
5209
  * Queries the departments of an identity provider by page.
4911
5210
  *
4912
5211
  * @remarks
4913
- * Queries DingTalk or Feishu departments by hierarchy and page. Prerequisites include a bound identity provider, a user pool, valid application credentials, and address book read authorization. If you do not specify parentDepartmentId, the root hierarchy is queried. When expanding a node, specify the ID of the node to query its direct child departments. The hasChildren field indicates whether the node can be expanded and does not mean that child nodes are returned. The nextToken field is used only to query the next page of child departments under the current parent department. This query only reads the directory. It does not save the synchronization scope or import users. If a new department is added to a DingTalk or Feishu organization, re-query the corresponding parent department because the previous list does not reflect the latest directory.\\n\\nAuthorization information: The RAM action is agentcore:ListIdentityProviderDepartments, the access level is List, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is required for authorization.\\n\\nIdempotency and retry: This operation is read-only and can be called repeatedly.\\n\\nCalling this API is free of charge. Operation records support ActionTrail auditing.\\n\\nResponse example:\\n```json\\n{\\n "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",\\n "message": "success",\\n "httpStatusCode": 200,\\n "code": "SUCCESS",\\n "success": true,\\n "maxResults": 50,\\n "nextToken": "",\\n "items": [\\n {\\n "id": "10001",\\n "name": "R&D Department",\\n "parentId": "1",\\n "memberCount": 12,\\n "hasChildren": true\\n }\\n ]\\n}\\n```
5212
+ * Queries DingTalk or Lark departments by hierarchy and page. Prerequisites include an existing identity provider binding, a user pool, valid application credentials, and address book read authorization. If parentDepartmentId is not specified, the root hierarchy is queried. When expanding a node, use the ID of the node to query its direct child departments. The hasChildren field is used to determine expandability and does not indicate that child nodes have been returned. The nextToken field is only used to continue querying the next page under the current parent department. The query only reads the directory, does not save the synchronization scope, and does not import users. After a new department is added to a DingTalk or Lark organization, re-query the corresponding parent department because the old list does not represent the latest directory.
5213
+ * Authorization information: The RAM operation is agentcore:ListIdentityProviderDepartments, the access level is List, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource requires authorization.
5214
+ * Idempotence and retry: This operation is read-only and can be invoked repeatedly.
5215
+ * It is free of charge to invoke this API operation, and operation records support ActionTrail auditing.
5216
+ * Sample response:
5217
+ * ```json
5218
+ * {
5219
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
5220
+ * "message": "success",
5221
+ * "httpStatusCode": 200,
5222
+ * "code": "SUCCESS",
5223
+ * "success": true,
5224
+ * "maxResults": 50,
5225
+ * "nextToken": "",
5226
+ * "items": [
5227
+ * {
5228
+ * "id": "10001",
5229
+ * "name": "R&D Department",
5230
+ * "parentId": "1",
5231
+ * "memberCount": 12,
5232
+ * "hasChildren": true
5233
+ * }
5234
+ * ]
5235
+ * }
5236
+ * ```
4914
5237
  *
4915
5238
  * @param request - ListIdentityProviderDepartmentsRequest
4916
5239
  * @param headers - map
@@ -4950,7 +5273,31 @@ class Client extends openapi_core_1.default {
4950
5273
  * Queries the departments of an identity provider by page.
4951
5274
  *
4952
5275
  * @remarks
4953
- * Queries DingTalk or Feishu departments by hierarchy and page. Prerequisites include a bound identity provider, a user pool, valid application credentials, and address book read authorization. If you do not specify parentDepartmentId, the root hierarchy is queried. When expanding a node, specify the ID of the node to query its direct child departments. The hasChildren field indicates whether the node can be expanded and does not mean that child nodes are returned. The nextToken field is used only to query the next page of child departments under the current parent department. This query only reads the directory. It does not save the synchronization scope or import users. If a new department is added to a DingTalk or Feishu organization, re-query the corresponding parent department because the previous list does not reflect the latest directory.\\n\\nAuthorization information: The RAM action is agentcore:ListIdentityProviderDepartments, the access level is List, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is required for authorization.\\n\\nIdempotency and retry: This operation is read-only and can be called repeatedly.\\n\\nCalling this API is free of charge. Operation records support ActionTrail auditing.\\n\\nResponse example:\\n```json\\n{\\n "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",\\n "message": "success",\\n "httpStatusCode": 200,\\n "code": "SUCCESS",\\n "success": true,\\n "maxResults": 50,\\n "nextToken": "",\\n "items": [\\n {\\n "id": "10001",\\n "name": "R&D Department",\\n "parentId": "1",\\n "memberCount": 12,\\n "hasChildren": true\\n }\\n ]\\n}\\n```
5276
+ * Queries DingTalk or Lark departments by hierarchy and page. Prerequisites include an existing identity provider binding, a user pool, valid application credentials, and address book read authorization. If parentDepartmentId is not specified, the root hierarchy is queried. When expanding a node, use the ID of the node to query its direct child departments. The hasChildren field is used to determine expandability and does not indicate that child nodes have been returned. The nextToken field is only used to continue querying the next page under the current parent department. The query only reads the directory, does not save the synchronization scope, and does not import users. After a new department is added to a DingTalk or Lark organization, re-query the corresponding parent department because the old list does not represent the latest directory.
5277
+ * Authorization information: The RAM operation is agentcore:ListIdentityProviderDepartments, the access level is List, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource requires authorization.
5278
+ * Idempotence and retry: This operation is read-only and can be invoked repeatedly.
5279
+ * It is free of charge to invoke this API operation, and operation records support ActionTrail auditing.
5280
+ * Sample response:
5281
+ * ```json
5282
+ * {
5283
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
5284
+ * "message": "success",
5285
+ * "httpStatusCode": 200,
5286
+ * "code": "SUCCESS",
5287
+ * "success": true,
5288
+ * "maxResults": 50,
5289
+ * "nextToken": "",
5290
+ * "items": [
5291
+ * {
5292
+ * "id": "10001",
5293
+ * "name": "R&D Department",
5294
+ * "parentId": "1",
5295
+ * "memberCount": 12,
5296
+ * "hasChildren": true
5297
+ * }
5298
+ * ]
5299
+ * }
5300
+ * ```
4954
5301
  *
4955
5302
  * @param request - ListIdentityProviderDepartmentsRequest
4956
5303
  * @returns ListIdentityProviderDepartmentsResponse
@@ -4961,19 +5308,114 @@ class Client extends openapi_core_1.default {
4961
5308
  return await this.listIdentityProviderDepartmentsWithOptions(workspaceId, identityProviderType, request, headers, runtime);
4962
5309
  }
4963
5310
  /**
4964
- * Queries the external identity providers bound to a specified workspace. Each workspace can be bound to at most one external identity provider, so the response returns at most one record. Application secret configurations are not returned.
5311
+ * Queries the complete summary list of up to two SCIM credentials in the shared user pool, without returning plaintext tokens or supporting pagination.
5312
+ *
5313
+ * @remarks
5314
+ * ## Features and prerequisites
5315
+ * Retrieves the current credential summary list from AgentIdentity and returns a data array. Each item contains credentialId, status, createTime, and expireTime. If no credentials exist, an empty array is returned. This operation does not support maxResults, nextToken, or pagination. Do not call this operation with fake pagination fields. The list never returns plaintext tokens, nor does it enable the receiving or issuing of new credentials.
5316
+ * Receiving is not required to be enabled, but the shared pool must be available. A credential is considered available if its status is Enabled and its expireTime is later than the current time. The maximum limit of two credentials is determined by AgentIdentity. Client-side counting is for reference only. The list may contain unavailable or expired credentials. Do not use this list to claim that available tokens exist.
5317
+ * ## Requests and examples
5318
+ * GET /workspaces/{workspaceId}/scim-provisioning/credentials
5319
+ * Call conventions: Call this operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity source resources of the workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
5320
+ * ```text
5321
+ * GET /workspaces/ws-example/scim-provisioning/credentials
5322
+ * ```
5323
+ * ## Response examples
5324
+ * ```json
5325
+ * {
5326
+ * "data": [
5327
+ * {
5328
+ * "credentialId": "credential-example",
5329
+ * "status": "Enabled",
5330
+ * "createTime": "<Upstream creation time>",
5331
+ * "expireTime": "<Upstream expiration time>"
5332
+ * }
5333
+ * ]
5334
+ * }
5335
+ * ```
5336
+ * ## Errors and handling
5337
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream service that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling process.
5338
+ * 400 InvalidParameter: The shared user pool is unavailable. 404 IdentityProviderNotFound: No corresponding binding exists. Upstream query failures cannot be replaced with an empty list, which may mislead users into repeatedly creating credentials.
5339
+ * ## Call relationships and usage boundaries
5340
+ * Used for configuration recovery and credential management: Existing plaintext tokens cannot be queried and retrieved again. The list provides only credential summaries. To obtain a new token, call CreateIdentityProviderSCIMCredential. To revoke a credential, submit the credentialId from the list to DeleteIdentityProviderSCIMCredential. A maximum of two credentials are allowed in the same pool. This operation returns the complete array and does not support or fabricate pagination parameters.
5341
+ *
5342
+ * @param request - ListIdentityProviderSCIMCredentialsRequest
5343
+ * @param headers - map
5344
+ * @param runtime - runtime options for this request RuntimeOptions
5345
+ * @returns ListIdentityProviderSCIMCredentialsResponse
5346
+ */
5347
+ async listIdentityProviderSCIMCredentialsWithOptions(workspaceId, request, headers, runtime) {
5348
+ request.validate();
5349
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
5350
+ headers: headers,
5351
+ });
5352
+ let params = new openapi_core_2.$OpenApiUtil.Params({
5353
+ action: "ListIdentityProviderSCIMCredentials",
5354
+ version: "2026-08-04",
5355
+ protocol: "HTTPS",
5356
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials`,
5357
+ method: "GET",
5358
+ authType: "AK",
5359
+ style: "ROA",
5360
+ reqBodyType: "json",
5361
+ bodyType: "json",
5362
+ });
5363
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListIdentityProviderSCIMCredentialsResponse({}));
5364
+ }
5365
+ /**
5366
+ * Queries the complete summary list of up to two SCIM credentials in the shared user pool, without returning plaintext tokens or supporting pagination.
5367
+ *
5368
+ * @remarks
5369
+ * ## Features and prerequisites
5370
+ * Retrieves the current credential summary list from AgentIdentity and returns a data array. Each item contains credentialId, status, createTime, and expireTime. If no credentials exist, an empty array is returned. This operation does not support maxResults, nextToken, or pagination. Do not call this operation with fake pagination fields. The list never returns plaintext tokens, nor does it enable the receiving or issuing of new credentials.
5371
+ * Receiving is not required to be enabled, but the shared pool must be available. A credential is considered available if its status is Enabled and its expireTime is later than the current time. The maximum limit of two credentials is determined by AgentIdentity. Client-side counting is for reference only. The list may contain unavailable or expired credentials. Do not use this list to claim that available tokens exist.
5372
+ * ## Requests and examples
5373
+ * GET /workspaces/{workspaceId}/scim-provisioning/credentials
5374
+ * Call conventions: Call this operation in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity source resources of the workspace. The ws-example, URL, certificate, and token in the following examples are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business data. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
5375
+ * ```text
5376
+ * GET /workspaces/ws-example/scim-provisioning/credentials
5377
+ * ```
5378
+ * ## Response examples
5379
+ * ```json
5380
+ * {
5381
+ * "data": [
5382
+ * {
5383
+ * "credentialId": "credential-example",
5384
+ * "status": "Enabled",
5385
+ * "createTime": "<Upstream creation time>",
5386
+ * "expireTime": "<Upstream expiration time>"
5387
+ * }
5388
+ * ]
5389
+ * }
5390
+ * ```
5391
+ * ## Errors and handling
5392
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream service that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling process.
5393
+ * 400 InvalidParameter: The shared user pool is unavailable. 404 IdentityProviderNotFound: No corresponding binding exists. Upstream query failures cannot be replaced with an empty list, which may mislead users into repeatedly creating credentials.
5394
+ * ## Call relationships and usage boundaries
5395
+ * Used for configuration recovery and credential management: Existing plaintext tokens cannot be queried and retrieved again. The list provides only credential summaries. To obtain a new token, call CreateIdentityProviderSCIMCredential. To revoke a credential, submit the credentialId from the list to DeleteIdentityProviderSCIMCredential. A maximum of two credentials are allowed in the same pool. This operation returns the complete array and does not support or fabricate pagination parameters.
5396
+ *
5397
+ * @param request - ListIdentityProviderSCIMCredentialsRequest
5398
+ * @returns ListIdentityProviderSCIMCredentialsResponse
5399
+ */
5400
+ async listIdentityProviderSCIMCredentials(workspaceId, request) {
5401
+ let runtime = new $dara.RuntimeOptions({});
5402
+ let headers = {};
5403
+ return await this.listIdentityProviderSCIMCredentialsWithOptions(workspaceId, request, headers, runtime);
5404
+ }
5405
+ /**
5406
+ * Queries the summary of existing identity provider bindings for a workspace, including CustomSSO. Returns local binding information without querying the actual upstream SAML or SCIM configurations.
4965
5407
  *
4966
5408
  * @remarks
4967
5409
  * ## Features and prerequisites
4968
- * Returns the local binding summary without querying the actual SAML or SCIM configurations of AgentIdentity. If no binding exists, items is an empty array. A workspace currently supports only one external binding. The default value of maxResults is 10, and the valid range is 1 to 100. Currently, nextToken must be omitted or left empty. A non-empty value returns InvalidParameter, and fictitious multi-page results are not supported.
4969
- * The status of CustomSSO indicates the task status of shared resources and logon configurations. You must check protocol and saml to determine whether SAML is configured. To query SCIM configurations, independently call GetIdentityProviderSCIM. The list operation does not issue tokens and does not return the vendor appSecret, encryptKey, or verificationToken.
5410
+ * Returns the local binding summary without querying the actual SAML and SCIM configurations of AgentIdentity. If no bindings exist, items is an empty array. A workspace currently supports only one external binding. The default value of maxResults is 10, and the valid values are 1 to 100. Currently, nextToken must be omitted or left empty. A non-empty value returns InvalidParameter, and multi-page results cannot be fabricated.
5411
+ * The status of CustomSSO indicates the task status of shared resources and logon configurations. You must combine protocol and saml to determine whether SAML is configured. SCIM queries are independently performed by using GetIdentityProviderSCIM. The list does not issue tokens and does not return the vendor appSecret, encryptKey, or verificationToken.
4970
5412
  * ## Requests and examples
4971
5413
  * GET /workspaces/{workspaceId}/identity-providers
4972
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or Security Token Service (STS) token that has the required permissions on the identity source resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
5414
+ * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
4973
5415
  * ```text
4974
5416
  * GET /workspaces/ws-example/identity-providers?maxResults=10
4975
5417
  * ```
4976
- * ## Response examples
5418
+ * ## Response example
4977
5419
  * ```json
4978
5420
  * {
4979
5421
  * "items": [
@@ -4990,8 +5432,10 @@ class Client extends openapi_core_1.default {
4990
5432
  * }
4991
5433
  * ```
4992
5434
  * ## Errors and handling
4993
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
4994
- * 400 InvalidParameter: maxResults is out of bounds, or nextToken is not empty, which is currently not supported. If a query fails, an error is displayed instead of resetting the status to unconfigured.
5435
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to the upstream may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
5436
+ * 400 InvalidParameter: maxResults is out of bounds or nextToken is non-empty, which is currently not supported. When a query fails, an error is displayed instead of being cleared as unconfigured.
5437
+ * ## Call relationships and usage boundaries
5438
+ * This API is used to discover current bindings. The specific SAML configuration of CustomSSO is queried by using GetIdentityProvider. The SP address is queried by using GetIdentityProviderServiceProvider. The actual SCIM configuration and independent operation results are queried by using GetIdentityProviderSCIM.
4995
5439
  *
4996
5440
  * @param request - ListIdentityProvidersRequest
4997
5441
  * @param headers - map
@@ -5025,19 +5469,19 @@ class Client extends openapi_core_1.default {
5025
5469
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListIdentityProvidersResponse({}));
5026
5470
  }
5027
5471
  /**
5028
- * Queries the external identity providers bound to a specified workspace. Each workspace can be bound to at most one external identity provider, so the response returns at most one record. Application secret configurations are not returned.
5472
+ * Queries the summary of existing identity provider bindings for a workspace, including CustomSSO. Returns local binding information without querying the actual upstream SAML or SCIM configurations.
5029
5473
  *
5030
5474
  * @remarks
5031
5475
  * ## Features and prerequisites
5032
- * Returns the local binding summary without querying the actual SAML or SCIM configurations of AgentIdentity. If no binding exists, items is an empty array. A workspace currently supports only one external binding. The default value of maxResults is 10, and the valid range is 1 to 100. Currently, nextToken must be omitted or left empty. A non-empty value returns InvalidParameter, and fictitious multi-page results are not supported.
5033
- * The status of CustomSSO indicates the task status of shared resources and logon configurations. You must check protocol and saml to determine whether SAML is configured. To query SCIM configurations, independently call GetIdentityProviderSCIM. The list operation does not issue tokens and does not return the vendor appSecret, encryptKey, or verificationToken.
5476
+ * Returns the local binding summary without querying the actual SAML and SCIM configurations of AgentIdentity. If no bindings exist, items is an empty array. A workspace currently supports only one external binding. The default value of maxResults is 10, and the valid values are 1 to 100. Currently, nextToken must be omitted or left empty. A non-empty value returns InvalidParameter, and multi-page results cannot be fabricated.
5477
+ * The status of CustomSSO indicates the task status of shared resources and logon configurations. You must combine protocol and saml to determine whether SAML is configured. SCIM queries are independently performed by using GetIdentityProviderSCIM. The list does not issue tokens and does not return the vendor appSecret, encryptKey, or verificationToken.
5034
5478
  * ## Requests and examples
5035
5479
  * GET /workspaces/{workspaceId}/identity-providers
5036
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or Security Token Service (STS) token that has the required permissions on the identity source resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
5480
+ * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
5037
5481
  * ```text
5038
5482
  * GET /workspaces/ws-example/identity-providers?maxResults=10
5039
5483
  * ```
5040
- * ## Response examples
5484
+ * ## Response example
5041
5485
  * ```json
5042
5486
  * {
5043
5487
  * "items": [
@@ -5054,8 +5498,10 @@ class Client extends openapi_core_1.default {
5054
5498
  * }
5055
5499
  * ```
5056
5500
  * ## Errors and handling
5057
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to upstream services that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
5058
- * 400 InvalidParameter: maxResults is out of bounds, or nextToken is not empty, which is currently not supported. If a query fails, an error is displayed instead of resetting the status to unconfigured.
5501
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call failure to the upstream may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
5502
+ * 400 InvalidParameter: maxResults is out of bounds or nextToken is non-empty, which is currently not supported. When a query fails, an error is displayed instead of being cleared as unconfigured.
5503
+ * ## Call relationships and usage boundaries
5504
+ * This API is used to discover current bindings. The specific SAML configuration of CustomSSO is queried by using GetIdentityProvider. The SP address is queried by using GetIdentityProviderServiceProvider. The actual SCIM configuration and independent operation results are queried by using GetIdentityProviderSCIM.
5059
5505
  *
5060
5506
  * @param request - ListIdentityProvidersRequest
5061
5507
  * @returns ListIdentityProvidersResponse
@@ -6420,6 +6866,111 @@ class Client extends openapi_core_1.default {
6420
6866
  let headers = {};
6421
6867
  return await this.precheckSkillUploadViaOssWithOptions(workspaceId, request, headers, runtime);
6422
6868
  }
6869
+ /**
6870
+ * Prepares the SCIM receiving configuration, and returns the provisioning URL and credential summary. Issues a token if no available credentials exist and returns the plaintext only in the current response. Does not automatically enable user synchronization.
6871
+ *
6872
+ * @remarks
6873
+ * ## Features and prerequisites
6874
+ * A CustomSSO shared user pool must be available. This operation does not depend on SAML metadata and is not blocked by SAML updating or update failure states. It synchronously calls AgentIdentity to enable SCIM receiving, and reads the configuration and credential list. If a credential in the Enabled state that has not expired already exists, its summary is returned and the token is set to null. If no available credentials exist, a new credential is created and the token is returned only in the current response. Existing invalid or expired credentials are not automatically deleted and may still trigger the upstream limit of up to two credentials.
6875
+ * The prepare operation has the side effects of enabling receiving and potentially issuing credentials, but it does not set the AC syncEnabled parameter, initiate the first import, or indicate that the external provisioning connection test has passed. After configuring the baseUrl and the current token in the external provisioning system, call UpdateIdentityProviderSCIM to confirm and enable synchronization. Existing tokens cannot be retrieved again. If the response is lost, query the credential list first. Tokens are not automatically reissued. Tokens must not be logged or persisted in frontend caches.
6876
+ * ## Requests and examples
6877
+ * POST /workspaces/{workspaceId}/scim-provisioning/prepare
6878
+ * Calling conventions: Call this operation in the region of the target workspace by using an AccessKey ID/STS identity that has permissions on the identity source resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
6879
+ * ```text
6880
+ * POST /workspaces/ws-example/scim-provisioning/prepare
6881
+ * No business request body.
6882
+ * ```
6883
+ * ## Response examples
6884
+ * ```json
6885
+ * {
6886
+ * "data": {
6887
+ * "configuration": {
6888
+ * "status": "Enabled",
6889
+ * "baseUrl": "https://example.com/scim/v2"
6890
+ * },
6891
+ * "credential": {
6892
+ * "credentialId": "credential-example",
6893
+ * "status": "Enabled",
6894
+ * "expireTime": "<Expiration time returned by the upstream service>"
6895
+ * },
6896
+ * "token": "<Token issued only in the current response; null if an available credential already exists>"
6897
+ * }
6898
+ * }
6899
+ * ```
6900
+ * ## Errors and handling
6901
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream service that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace not found errors follow the common error handling process.
6902
+ * 400 LimitExceeded.ScimCredential: The maximum limit of two credentials has been reached. You must explicitly delete one credential and try again. Credentials are not automatically deleted, rotated, or expanded. 400 InvalidParameter: The shared pool is unavailable. This call may have enabled upstream receiving and then reported an error due to issuance failure. The error does not mean that the operation has been automatically rolled back.
6903
+ * ## Call relationships and usage boundaries
6904
+ * The shared pool is created by using CreateIdentityProvider with identityProviderType set to CustomSSO. SAML configuration is not required. If an existing credential is reused and token is null, use the token that the user has already saved. Do not configure a null value in the external system. If the token is lost, call ListIdentityProviderSCIMCredentials to check first, and then explicitly call CreateIdentityProviderSCIMCredential to issue a new token. When the limit of two credentials is reached, the user must confirm and delete the unused credential.
6905
+ *
6906
+ * @param request - PrepareIdentityProviderSCIMRequest
6907
+ * @param headers - map
6908
+ * @param runtime - runtime options for this request RuntimeOptions
6909
+ * @returns PrepareIdentityProviderSCIMResponse
6910
+ */
6911
+ async prepareIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime) {
6912
+ request.validate();
6913
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
6914
+ headers: headers,
6915
+ });
6916
+ let params = new openapi_core_2.$OpenApiUtil.Params({
6917
+ action: "PrepareIdentityProviderSCIM",
6918
+ version: "2026-08-04",
6919
+ protocol: "HTTPS",
6920
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/prepare`,
6921
+ method: "POST",
6922
+ authType: "AK",
6923
+ style: "ROA",
6924
+ reqBodyType: "json",
6925
+ bodyType: "json",
6926
+ });
6927
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.PrepareIdentityProviderSCIMResponse({}));
6928
+ }
6929
+ /**
6930
+ * Prepares the SCIM receiving configuration, and returns the provisioning URL and credential summary. Issues a token if no available credentials exist and returns the plaintext only in the current response. Does not automatically enable user synchronization.
6931
+ *
6932
+ * @remarks
6933
+ * ## Features and prerequisites
6934
+ * A CustomSSO shared user pool must be available. This operation does not depend on SAML metadata and is not blocked by SAML updating or update failure states. It synchronously calls AgentIdentity to enable SCIM receiving, and reads the configuration and credential list. If a credential in the Enabled state that has not expired already exists, its summary is returned and the token is set to null. If no available credentials exist, a new credential is created and the token is returned only in the current response. Existing invalid or expired credentials are not automatically deleted and may still trigger the upstream limit of up to two credentials.
6935
+ * The prepare operation has the side effects of enabling receiving and potentially issuing credentials, but it does not set the AC syncEnabled parameter, initiate the first import, or indicate that the external provisioning connection test has passed. After configuring the baseUrl and the current token in the external provisioning system, call UpdateIdentityProviderSCIM to confirm and enable synchronization. Existing tokens cannot be retrieved again. If the response is lost, query the credential list first. Tokens are not automatically reissued. Tokens must not be logged or persisted in frontend caches.
6936
+ * ## Requests and examples
6937
+ * POST /workspaces/{workspaceId}/scim-provisioning/prepare
6938
+ * Calling conventions: Call this operation in the region of the target workspace by using an AccessKey ID/STS identity that has permissions on the identity source resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API operation, not the extra body wrapper of the backend direct connection API operation. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a persistent connection to wait for completion.
6939
+ * ```text
6940
+ * POST /workspaces/ws-example/scim-provisioning/prepare
6941
+ * No business request body.
6942
+ * ```
6943
+ * ## Response examples
6944
+ * ```json
6945
+ * {
6946
+ * "data": {
6947
+ * "configuration": {
6948
+ * "status": "Enabled",
6949
+ * "baseUrl": "https://example.com/scim/v2"
6950
+ * },
6951
+ * "credential": {
6952
+ * "credentialId": "credential-example",
6953
+ * "status": "Enabled",
6954
+ * "expireTime": "<Expiration time returned by the upstream service>"
6955
+ * },
6956
+ * "token": "<Token issued only in the current response; null if an available credential already exists>"
6957
+ * }
6958
+ * }
6959
+ * ```
6960
+ * ## Errors and handling
6961
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream service that fail may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace not found errors follow the common error handling process.
6962
+ * 400 LimitExceeded.ScimCredential: The maximum limit of two credentials has been reached. You must explicitly delete one credential and try again. Credentials are not automatically deleted, rotated, or expanded. 400 InvalidParameter: The shared pool is unavailable. This call may have enabled upstream receiving and then reported an error due to issuance failure. The error does not mean that the operation has been automatically rolled back.
6963
+ * ## Call relationships and usage boundaries
6964
+ * The shared pool is created by using CreateIdentityProvider with identityProviderType set to CustomSSO. SAML configuration is not required. If an existing credential is reused and token is null, use the token that the user has already saved. Do not configure a null value in the external system. If the token is lost, call ListIdentityProviderSCIMCredentials to check first, and then explicitly call CreateIdentityProviderSCIMCredential to issue a new token. When the limit of two credentials is reached, the user must confirm and delete the unused credential.
6965
+ *
6966
+ * @param request - PrepareIdentityProviderSCIMRequest
6967
+ * @returns PrepareIdentityProviderSCIMResponse
6968
+ */
6969
+ async prepareIdentityProviderSCIM(workspaceId, request) {
6970
+ let runtime = new $dara.RuntimeOptions({});
6971
+ let headers = {};
6972
+ return await this.prepareIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
6973
+ }
6423
6974
  /**
6424
6975
  * Publishes a specified Skill version to transition it to the published state.
6425
6976
  *
@@ -7215,32 +7766,95 @@ class Client extends openapi_core_1.default {
7215
7766
  return await this.updateExternalAgentWithOptions(workspaceId, agentId, request, headers, runtime);
7216
7767
  }
7217
7768
  /**
7218
- * Updates the logon switch, member synchronization switch, or application configuration of a specified external identity provider for a workspace. Unspecified properties remain unchanged. The update is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
7769
+ * Modifies the logon configuration of a bound identity provider in a specified workspace. DingTalk and Lark support logon switches, incremental synchronization switches, application configurations, and synchronization scopes. CustomSSO supports SAML configurations and logon switches. Actual updates take effect asynchronously. Call GetIdentityProvider to query the status.
7770
+ *
7771
+ * @remarks
7772
+ * ### Prerequisites and update methods
7773
+ * The workspace must be bound to an identity provider of the corresponding type. For DingTalk and Lark, you must submit at least one of loginEnabled, syncEnabled, metadata, and syncScope. protocol and saml are not accepted. For CustomSSO, use protocol, saml, and loginEnabled. metadata, syncEnabled, and syncScope are not accepted. The SCIM synchronization switch is managed separately through UpdateIdentityProviderSCIM.
7774
+ * ### DingTalk and Lark
7775
+ * The metadata is merged by field. Submit only the fields that need to be updated. Omitted fields and existing keys remain unchanged. Explicitly submitting null, empty strings, or blank strings will be rejected. The server validates the complete configuration after merging. When incremental synchronization is enabled, the merged configuration must include encryptKey and verificationToken.
7776
+ * syncEnabled controls subsequent address book change events and does not control the initial synchronization or manual synchronization. syncScope applies only to DingTalk and Lark. If it is omitted or set to null, the current scope is retained. Saving the scope does not automatically trigger a full synchronization. To perform manual synchronization, call CreateIdentityProviderSyncJob after saving and waiting for the identity provider to be ready, and then call GetIdentityProviderSyncJob to query the task result.
7777
+ * ### Custom SAML identity provider
7778
+ * CustomSSO currently supports only SAML. The saml parameter supports two mutually exclusive methods: providing metadataXml, or providing the four manual configuration fields: entityId, loginUrl, bindingType, and x509Certificates.
7779
+ * metadataXml is a single IdP EntityDescriptor XML text of up to 1 MiB, not a URL or file path. DTDs and external entities are prohibited. For manual configuration, entityId must be non-empty and up to 2,048 characters, and cannot be changed after saving. loginUrl must be an absolute HTTPS URL without user credentials and fragments. bindingType must be HTTP-Redirect or HTTP-POST. Certificates must be valid X.509 signing certificates, with a maximum of 10 certificates.
7780
+ * jitProvisionEnabled controls the automatic creation of users during the initial logon, and jitUpdateEnabled controls whether user information is updated during logon. Omitting these switches during an update retains the existing values. Modifying only the JIT switches also requires an existing valid SAML configuration. Saving the SAML configuration does not automatically enable logon. A valid configuration must exist before enabling logon. Setting loginEnabled to false only triggers a shutdown of logon and does not delete the saved SAML or SCIM configurations.
7781
+ * ### Asynchronous results and retries
7782
+ * When actual changes exist, the expected configuration and the UPDATING status of the identity provider are returned. The CONFIGURED status may also be returned when resource configurations are restored. Call GetIdentityProvider to wait for the READY status. If the operation fails, check for statuses such as UPDATE_FAILED. If the configuration is identical and no restoration is required, the current binding may be returned directly without generating a new task. A successful HTTP request does not indicate that the background task or upstream configuration has taken effect.
7783
+ * Operation conflicts occur when in-flight operations exist. If a submission times out, query the configuration and status before deciding whether to retry. The status parameter describes the status of the identity provider resource and logon configuration. The SCIM operation results for CustomSSO must be queried through GetIdentityProviderSCIM and cannot be inferred from this operation.
7784
+ *
7785
+ * @param tmpReq - UpdateIdentityProviderRequest
7786
+ * @param headers - map
7787
+ * @param runtime - runtime options for this request RuntimeOptions
7788
+ * @returns UpdateIdentityProviderResponse
7789
+ */
7790
+ async updateIdentityProviderWithOptions(workspaceId, identityProviderType, tmpReq, headers, runtime) {
7791
+ tmpReq.validate();
7792
+ let request = new $_model.UpdateIdentityProviderShrinkRequest({});
7793
+ openapi_core_2.OpenApiUtil.convert(tmpReq, request);
7794
+ if (!$dara.isNull(tmpReq.body)) {
7795
+ request.bodyShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.body, "body", "json");
7796
+ }
7797
+ let body = {};
7798
+ if (!$dara.isNull(request.bodyShrink)) {
7799
+ body["body"] = request.bodyShrink;
7800
+ }
7801
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
7802
+ headers: headers,
7803
+ body: openapi_core_2.OpenApiUtil.parseToMap(body),
7804
+ });
7805
+ let params = new openapi_core_2.$OpenApiUtil.Params({
7806
+ action: "UpdateIdentityProvider",
7807
+ version: "2026-08-04",
7808
+ protocol: "HTTPS",
7809
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}`,
7810
+ method: "PUT",
7811
+ authType: "AK",
7812
+ style: "ROA",
7813
+ reqBodyType: "formData",
7814
+ bodyType: "json",
7815
+ });
7816
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateIdentityProviderResponse({}));
7817
+ }
7818
+ /**
7819
+ * Modifies the logon configuration of a bound identity provider in a specified workspace. DingTalk and Lark support logon switches, incremental synchronization switches, application configurations, and synchronization scopes. CustomSSO supports SAML configurations and logon switches. Actual updates take effect asynchronously. Call GetIdentityProvider to query the status.
7820
+ *
7821
+ * @remarks
7822
+ * ### Prerequisites and update methods
7823
+ * The workspace must be bound to an identity provider of the corresponding type. For DingTalk and Lark, you must submit at least one of loginEnabled, syncEnabled, metadata, and syncScope. protocol and saml are not accepted. For CustomSSO, use protocol, saml, and loginEnabled. metadata, syncEnabled, and syncScope are not accepted. The SCIM synchronization switch is managed separately through UpdateIdentityProviderSCIM.
7824
+ * ### DingTalk and Lark
7825
+ * The metadata is merged by field. Submit only the fields that need to be updated. Omitted fields and existing keys remain unchanged. Explicitly submitting null, empty strings, or blank strings will be rejected. The server validates the complete configuration after merging. When incremental synchronization is enabled, the merged configuration must include encryptKey and verificationToken.
7826
+ * syncEnabled controls subsequent address book change events and does not control the initial synchronization or manual synchronization. syncScope applies only to DingTalk and Lark. If it is omitted or set to null, the current scope is retained. Saving the scope does not automatically trigger a full synchronization. To perform manual synchronization, call CreateIdentityProviderSyncJob after saving and waiting for the identity provider to be ready, and then call GetIdentityProviderSyncJob to query the task result.
7827
+ * ### Custom SAML identity provider
7828
+ * CustomSSO currently supports only SAML. The saml parameter supports two mutually exclusive methods: providing metadataXml, or providing the four manual configuration fields: entityId, loginUrl, bindingType, and x509Certificates.
7829
+ * metadataXml is a single IdP EntityDescriptor XML text of up to 1 MiB, not a URL or file path. DTDs and external entities are prohibited. For manual configuration, entityId must be non-empty and up to 2,048 characters, and cannot be changed after saving. loginUrl must be an absolute HTTPS URL without user credentials and fragments. bindingType must be HTTP-Redirect or HTTP-POST. Certificates must be valid X.509 signing certificates, with a maximum of 10 certificates.
7830
+ * jitProvisionEnabled controls the automatic creation of users during the initial logon, and jitUpdateEnabled controls whether user information is updated during logon. Omitting these switches during an update retains the existing values. Modifying only the JIT switches also requires an existing valid SAML configuration. Saving the SAML configuration does not automatically enable logon. A valid configuration must exist before enabling logon. Setting loginEnabled to false only triggers a shutdown of logon and does not delete the saved SAML or SCIM configurations.
7831
+ * ### Asynchronous results and retries
7832
+ * When actual changes exist, the expected configuration and the UPDATING status of the identity provider are returned. The CONFIGURED status may also be returned when resource configurations are restored. Call GetIdentityProvider to wait for the READY status. If the operation fails, check for statuses such as UPDATE_FAILED. If the configuration is identical and no restoration is required, the current binding may be returned directly without generating a new task. A successful HTTP request does not indicate that the background task or upstream configuration has taken effect.
7833
+ * Operation conflicts occur when in-flight operations exist. If a submission times out, query the configuration and status before deciding whether to retry. The status parameter describes the status of the identity provider resource and logon configuration. The SCIM operation results for CustomSSO must be queried through GetIdentityProviderSCIM and cannot be inferred from this operation.
7834
+ *
7835
+ * @param request - UpdateIdentityProviderRequest
7836
+ * @returns UpdateIdentityProviderResponse
7837
+ */
7838
+ async updateIdentityProvider(workspaceId, identityProviderType, request) {
7839
+ let runtime = new $dara.RuntimeOptions({});
7840
+ let headers = {};
7841
+ return await this.updateIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
7842
+ }
7843
+ /**
7844
+ * Enables or disables SCIM user synchronization independently. When enabled, the initial full import is executed asynchronously. You can query the result by calling GetIdentityProviderSCIM. The SAML logon configuration is retained.
7219
7845
  *
7220
7846
  * @remarks
7221
7847
  * ## Features and prerequisites
7222
- * CustomSSO uses protocol=SAML and saml to save logon configurations. It does not accept legacy metadata or syncEnabled. To toggle the SCIM switch, you must call UpdateIdentityProviderSCIM. OIDC is not supported. You can either import XML or manually enter fields. If you import XML, metadataXml must be a single IdP EntityDescriptor XML text of up to 1 MiB. URLs or file paths are not accepted, and DTDs or external entities are prohibited. If you manually enter fields, you must provide entityId, loginUrl, bindingType, and a non-empty x509Certificates array at the same time. The entityId must be non-empty and up to 2,048 characters in length, and cannot be replaced after configuration. The loginUrl must be an absolute HTTPS URL without user credentials or fragments. The bindingType must be HTTP-Redirect or HTTP-POST. Signing certificates must be valid X.509 certificates, and up to 10 certificates are supported.
7223
- * Saving the configuration does not automatically enable logon. A valid SAML configuration must exist before you enable logon. Setting loginEnabled=false only disables logon and does not clear SAML or SCIM configurations. You can independently pass Boolean values for jitProvisionEnabled and jitUpdateEnabled. If omitted, the existing values are retained. If omitted for the first time, the default value is false. Updating only the JIT switches also requires a valid SAML configuration. If the request is unchanged, the current binding may be returned directly without generating a new task. A successful update returns UPDATING. You can call GetIdentityProvider and wait for READY or UPDATE_FAILED. If the update fails, you can resubmit the request. An HTTP success response does not indicate that the upstream configuration has taken effect.
7224
- * DingTalk and Feishu continue to use vendor metadata and logon or synchronization switches. They do not accept protocol or saml. Updating vendor metadata supports partial updates. You only need to submit the fields to be modified. Unsubmitted fields and saved credentials remain unchanged. The server merges the new and old values and then validates the complete configuration. Explicitly submitted fields cannot be null, empty strings, or blank strings. For example, you can submit only appSecret to update the secret. The existing vendor semantics of syncScope are retained. Saving the scope does not automatically trigger full synchronization.
7225
- * ## Request and examples
7226
- * PUT /workspaces/{workspaceId}/identity-providers/{identityProviderType}
7227
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
7848
+ * The syncEnabled parameter is required. If you set this parameter to true, a task is submitted to independently enable SCIM and perform the initial full user import. During execution, the AgentIdentity receiving status must be Enabled, and an enabled and unexpired credential must exist. Therefore, you must first call the prepare operation and complete the URL and token configuration in the external system. If you set this parameter to false, a task is submitted to disable synchronization and upstream receiving. Existing users, credentials, and SAML logon configurations are retained. If you re-enable synchronization later and receiving is disabled, you must call the prepare operation again.
7849
+ * Request acceptance only saves the expected switch status in AC and submits the task. The returned data is still the shared binding and does not contain the SCIM taskId. The status is not overwritten by this task and may be READY or UPDATE_FAILED from a previous logon task. Neither can be used to determine the success or failure of SCIM. Query GetIdentityProviderSCIM.operationStatus to wait for the result. Prerequisite checks for enabling are executed within the task. If the prerequisites are not met, you may receive a successful request response first, and then operationStatus=FAILED. A failure does not automatically roll back the expected switch status.
7850
+ * SCIM does not depend on SAML configuration and does not affect the SAML status or switch. A successful task and a successful full import of empty users do not prove that continuous incremental synchronization is healthy. Whether users exist depends on whether the external system has actually pre-provisioned them.
7851
+ * ## Requests and examples
7852
+ * PUT /workspaces/{workspaceId}/scim-provisioning
7853
+ * Call conventions: Call the API in the region of the target workspace by using an AK/STS identity that has permissions on the identity provider resources of the corresponding workspace. In the following examples, ws-example, URL, certificate, and Token are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the additional body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
7228
7854
  * ```text
7229
- * PUT /workspaces/ws-example/identity-providers/CustomSSO
7230
- * {
7231
- * "protocol": "SAML",
7232
- * "saml": {
7233
- * "entityId": "https://idp.example.com/entity",
7234
- * "loginUrl": "https://idp.example.com/sso",
7235
- * "bindingType": "HTTP-Redirect",
7236
- * "x509Certificates": [
7237
- * "<Valid PEM X.509 certificate text>"
7238
- * ],
7239
- * "jitProvisionEnabled": false,
7240
- * "jitUpdateEnabled": false
7241
- * }
7242
- * }
7243
- * Toggle logon only: {"loginEnabled": true}
7855
+ * PUT /workspaces/ws-example/scim-provisioning
7856
+ * {"syncEnabled": true}
7857
+ * To disable: {"syncEnabled": false}
7244
7858
  * ```
7245
7859
  * ## Response example
7246
7860
  * ```json
@@ -7248,25 +7862,26 @@ class Client extends openapi_core_1.default {
7248
7862
  * "data": {
7249
7863
  * "workspaceId": "ws-example",
7250
7864
  * "identityProviderType": "CustomSSO",
7251
- * "protocol": "SAML",
7865
+ * "status": "READY",
7252
7866
  * "loginEnabled": false,
7253
- * "syncEnabled": false,
7254
- * "status": "UPDATING"
7867
+ * "syncEnabled": true
7255
7868
  * }
7256
7869
  * }
7257
7870
  * ```
7258
7871
  * ## Errors and handling
7259
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream may return 503 IdentityProviderProvisioningUnavailable if they fail. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
7260
- * 400 InvalidParameter: XML and manual entry are mixed, manual entry items are missing, certificates are invalid, the protocol is not supported, entityId is changed, logon is enabled without configuration, or CustomSSO submits metadata or syncEnabled. 409 IdentityProviderOperationConflict: The current binding does not allow updates. CustomSSO supports resubmitting configurations from UPDATE_FAILED.
7872
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream system that fails may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
7873
+ * 400 InvalidParameter: syncEnabled is missing. 404 IdentityProviderNotFound: No CustomSSO binding exists. 409 IdentityProviderOperationConflict: The user pool is not ready, is being unbound, failed to unbind, or has a concurrent status conflict. Upstream not being enabled or having no valid credentials may manifest as an asynchronous FAILED after acceptance. You cannot only handle HTTP errors.
7874
+ * ## Call relationships and usage boundaries
7875
+ * The call example for enabling is body={"syncEnabled":true}, and for disabling is body={"syncEnabled":false}. This API returns a snapshot of the shared binding, and its status is not the status of this SCIM task. After acceptance, use GetIdentityProviderSCIM to query operationStatus. Pre-provisioning tests or user assignments for external IdPs must still be completed in the external system. AC does not configure external IdPs for users.
7261
7876
  *
7262
- * @param tmpReq - UpdateIdentityProviderRequest
7877
+ * @param tmpReq - UpdateIdentityProviderSCIMRequest
7263
7878
  * @param headers - map
7264
7879
  * @param runtime - runtime options for this request RuntimeOptions
7265
- * @returns UpdateIdentityProviderResponse
7880
+ * @returns UpdateIdentityProviderSCIMResponse
7266
7881
  */
7267
- async updateIdentityProviderWithOptions(workspaceId, identityProviderType, tmpReq, headers, runtime) {
7882
+ async updateIdentityProviderSCIMWithOptions(workspaceId, tmpReq, headers, runtime) {
7268
7883
  tmpReq.validate();
7269
- let request = new $_model.UpdateIdentityProviderShrinkRequest({});
7884
+ let request = new $_model.UpdateIdentityProviderSCIMShrinkRequest({});
7270
7885
  openapi_core_2.OpenApiUtil.convert(tmpReq, request);
7271
7886
  if (!$dara.isNull(tmpReq.body)) {
7272
7887
  request.bodyShrink = openapi_core_2.OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.body, "body", "json");
@@ -7280,45 +7895,33 @@ class Client extends openapi_core_1.default {
7280
7895
  body: openapi_core_2.OpenApiUtil.parseToMap(body),
7281
7896
  });
7282
7897
  let params = new openapi_core_2.$OpenApiUtil.Params({
7283
- action: "UpdateIdentityProvider",
7898
+ action: "UpdateIdentityProviderSCIM",
7284
7899
  version: "2026-08-04",
7285
7900
  protocol: "HTTPS",
7286
- pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}`,
7901
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning`,
7287
7902
  method: "PUT",
7288
7903
  authType: "AK",
7289
7904
  style: "ROA",
7290
7905
  reqBodyType: "formData",
7291
7906
  bodyType: "json",
7292
7907
  });
7293
- return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateIdentityProviderResponse({}));
7908
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateIdentityProviderSCIMResponse({}));
7294
7909
  }
7295
7910
  /**
7296
- * Updates the logon switch, member synchronization switch, or application configuration of a specified external identity provider for a workspace. Unspecified properties remain unchanged. The update is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
7911
+ * Enables or disables SCIM user synchronization independently. When enabled, the initial full import is executed asynchronously. You can query the result by calling GetIdentityProviderSCIM. The SAML logon configuration is retained.
7297
7912
  *
7298
7913
  * @remarks
7299
7914
  * ## Features and prerequisites
7300
- * CustomSSO uses protocol=SAML and saml to save logon configurations. It does not accept legacy metadata or syncEnabled. To toggle the SCIM switch, you must call UpdateIdentityProviderSCIM. OIDC is not supported. You can either import XML or manually enter fields. If you import XML, metadataXml must be a single IdP EntityDescriptor XML text of up to 1 MiB. URLs or file paths are not accepted, and DTDs or external entities are prohibited. If you manually enter fields, you must provide entityId, loginUrl, bindingType, and a non-empty x509Certificates array at the same time. The entityId must be non-empty and up to 2,048 characters in length, and cannot be replaced after configuration. The loginUrl must be an absolute HTTPS URL without user credentials or fragments. The bindingType must be HTTP-Redirect or HTTP-POST. Signing certificates must be valid X.509 certificates, and up to 10 certificates are supported.
7301
- * Saving the configuration does not automatically enable logon. A valid SAML configuration must exist before you enable logon. Setting loginEnabled=false only disables logon and does not clear SAML or SCIM configurations. You can independently pass Boolean values for jitProvisionEnabled and jitUpdateEnabled. If omitted, the existing values are retained. If omitted for the first time, the default value is false. Updating only the JIT switches also requires a valid SAML configuration. If the request is unchanged, the current binding may be returned directly without generating a new task. A successful update returns UPDATING. You can call GetIdentityProvider and wait for READY or UPDATE_FAILED. If the update fails, you can resubmit the request. An HTTP success response does not indicate that the upstream configuration has taken effect.
7302
- * DingTalk and Feishu continue to use vendor metadata and logon or synchronization switches. They do not accept protocol or saml. Updating vendor metadata supports partial updates. You only need to submit the fields to be modified. Unsubmitted fields and saved credentials remain unchanged. The server merges the new and old values and then validates the complete configuration. Explicitly submitted fields cannot be null, empty strings, or blank strings. For example, you can submit only appSecret to update the secret. The existing vendor semantics of syncScope are retained. Saving the scope does not automatically trigger full synchronization.
7303
- * ## Request and examples
7304
- * PUT /workspaces/{workspaceId}/identity-providers/{identityProviderType}
7305
- * Call conventions: Call the API in the region of the target workspace by using an AccessKey pair or STS token that has permissions on the identity provider resources of the workspace. In the following examples, ws-example, URLs, certificates, and tokens are placeholder values and must be replaced with actual values. The request body example shows the body parameters of the public API, not the extra body wrapper of the backend direct connection API. The response example shows only the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Keep the requestId for troubleshooting and do not log secrets. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
7915
+ * The syncEnabled parameter is required. If you set this parameter to true, a task is submitted to independently enable SCIM and perform the initial full user import. During execution, the AgentIdentity receiving status must be Enabled, and an enabled and unexpired credential must exist. Therefore, you must first call the prepare operation and complete the URL and token configuration in the external system. If you set this parameter to false, a task is submitted to disable synchronization and upstream receiving. Existing users, credentials, and SAML logon configurations are retained. If you re-enable synchronization later and receiving is disabled, you must call the prepare operation again.
7916
+ * Request acceptance only saves the expected switch status in AC and submits the task. The returned data is still the shared binding and does not contain the SCIM taskId. The status is not overwritten by this task and may be READY or UPDATE_FAILED from a previous logon task. Neither can be used to determine the success or failure of SCIM. Query GetIdentityProviderSCIM.operationStatus to wait for the result. Prerequisite checks for enabling are executed within the task. If the prerequisites are not met, you may receive a successful request response first, and then operationStatus=FAILED. A failure does not automatically roll back the expected switch status.
7917
+ * SCIM does not depend on SAML configuration and does not affect the SAML status or switch. A successful task and a successful full import of empty users do not prove that continuous incremental synchronization is healthy. Whether users exist depends on whether the external system has actually pre-provisioned them.
7918
+ * ## Requests and examples
7919
+ * PUT /workspaces/{workspaceId}/scim-provisioning
7920
+ * Call conventions: Call the API in the region of the target workspace by using an AK/STS identity that has permissions on the identity provider resources of the corresponding workspace. In the following examples, ws-example, URL, certificate, and Token are placeholder values and must be replaced with actual values. The request body example represents the body parameters of the public API, not the additional body wrapper of the backend direct connection API. The response example only shows the business part. The outer layer also includes requestId, success, code, message, and httpStatusCode. Retain the requestId for troubleshooting and do not record keys. Asynchronous business tasks do not mean that the HTTP request uses a long connection to wait for completion.
7306
7921
  * ```text
7307
- * PUT /workspaces/ws-example/identity-providers/CustomSSO
7308
- * {
7309
- * "protocol": "SAML",
7310
- * "saml": {
7311
- * "entityId": "https://idp.example.com/entity",
7312
- * "loginUrl": "https://idp.example.com/sso",
7313
- * "bindingType": "HTTP-Redirect",
7314
- * "x509Certificates": [
7315
- * "<Valid PEM X.509 certificate text>"
7316
- * ],
7317
- * "jitProvisionEnabled": false,
7318
- * "jitUpdateEnabled": false
7319
- * }
7320
- * }
7321
- * Toggle logon only: {"loginEnabled": true}
7922
+ * PUT /workspaces/ws-example/scim-provisioning
7923
+ * {"syncEnabled": true}
7924
+ * To disable: {"syncEnabled": false}
7322
7925
  * ```
7323
7926
  * ## Response example
7324
7927
  * ```json
@@ -7326,24 +7929,25 @@ class Client extends openapi_core_1.default {
7326
7929
  * "data": {
7327
7930
  * "workspaceId": "ws-example",
7328
7931
  * "identityProviderType": "CustomSSO",
7329
- * "protocol": "SAML",
7932
+ * "status": "READY",
7330
7933
  * "loginEnabled": false,
7331
- * "syncEnabled": false,
7332
- * "status": "UPDATING"
7934
+ * "syncEnabled": true
7333
7935
  * }
7334
7936
  * }
7335
7937
  * ```
7336
7938
  * ## Errors and handling
7337
- * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. Synchronous calls to the upstream may return 503 IdentityProviderProvisioningUnavailable if they fail. Keep the request ID for troubleshooting and do not interpret read failures as unconfigured. Actual authentication and workspace non-existence errors follow common error handling.
7338
- * 400 InvalidParameter: XML and manual entry are mixed, manual entry items are missing, certificates are invalid, the protocol is not supported, entityId is changed, logon is enabled without configuration, or CustomSSO submits metadata or syncEnabled. 409 IdentityProviderOperationConflict: The current binding does not allow updates. CustomSSO supports resubmitting configurations from UPDATE_FAILED.
7939
+ * Error handling: 400 InvalidParameter indicates that the parameters or current configuration prerequisites are not met. 404 IdentityProviderNotFound indicates that no binding of the matching type exists. A synchronous call to the upstream system that fails may return 503 IdentityProviderProvisioningUnavailable. Retain the request ID for troubleshooting and do not interpret a read failure as unconfigured. Actual authentication and workspace non-existence errors follow the common error handling.
7940
+ * 400 InvalidParameter: syncEnabled is missing. 404 IdentityProviderNotFound: No CustomSSO binding exists. 409 IdentityProviderOperationConflict: The user pool is not ready, is being unbound, failed to unbind, or has a concurrent status conflict. Upstream not being enabled or having no valid credentials may manifest as an asynchronous FAILED after acceptance. You cannot only handle HTTP errors.
7941
+ * ## Call relationships and usage boundaries
7942
+ * The call example for enabling is body={"syncEnabled":true}, and for disabling is body={"syncEnabled":false}. This API returns a snapshot of the shared binding, and its status is not the status of this SCIM task. After acceptance, use GetIdentityProviderSCIM to query operationStatus. Pre-provisioning tests or user assignments for external IdPs must still be completed in the external system. AC does not configure external IdPs for users.
7339
7943
  *
7340
- * @param request - UpdateIdentityProviderRequest
7341
- * @returns UpdateIdentityProviderResponse
7944
+ * @param request - UpdateIdentityProviderSCIMRequest
7945
+ * @returns UpdateIdentityProviderSCIMResponse
7342
7946
  */
7343
- async updateIdentityProvider(workspaceId, identityProviderType, request) {
7947
+ async updateIdentityProviderSCIM(workspaceId, request) {
7344
7948
  let runtime = new $dara.RuntimeOptions({});
7345
7949
  let headers = {};
7346
- return await this.updateIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
7950
+ return await this.updateIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
7347
7951
  }
7348
7952
  /**
7349
7953
  * Updates the configuration of a specified managed agent.
@@ -8236,10 +8840,11 @@ class Client extends openapi_core_1.default {
8236
8840
  return await this.validateAgentCodePackageFromOssWithOptions(workspaceId, request, headers, runtime);
8237
8841
  }
8238
8842
  /**
8239
- * 检查智能体代码包 OSS RAM 授权状态
8843
+ * Checks the OSS RAM authorization status of the agent code package.
8240
8844
  *
8241
8845
  * @remarks
8242
- * 检查当前 Workspace 角色是否绑定所选源 Bucket 对应的自定义 RAM 策略,复用已有挂载授权。仅返回策略绑定状态,不验证代码包存在或可读、不修改默认桶。授权状态不能替代 ValidateAgentCodePackageFromOss 的实际对象读取校验。
8846
+ * Queries the binding status of the authorization policy for a specified source bucket to the current workspace role. AUTHORIZED indicates that the policy is bound. UNAUTHORIZED indicates that the policy is not bound. A bound policy does not indicate that a specific code package object exists or is readable.
8847
+ * To check a specific object, call ValidateAgentCodePackageFromOss. This operation does not copy code packages or modify the default OSS binding of the workspace.
8243
8848
  *
8244
8849
  * @param request - VerifyAgentCodePackageOssRamAuthorizationRequest
8245
8850
  * @param headers - map
@@ -8270,10 +8875,11 @@ class Client extends openapi_core_1.default {
8270
8875
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.VerifyAgentCodePackageOssRamAuthorizationResponse({}));
8271
8876
  }
8272
8877
  /**
8273
- * 检查智能体代码包 OSS RAM 授权状态
8878
+ * Checks the OSS RAM authorization status of the agent code package.
8274
8879
  *
8275
8880
  * @remarks
8276
- * 检查当前 Workspace 角色是否绑定所选源 Bucket 对应的自定义 RAM 策略,复用已有挂载授权。仅返回策略绑定状态,不验证代码包存在或可读、不修改默认桶。授权状态不能替代 ValidateAgentCodePackageFromOss 的实际对象读取校验。
8881
+ * Queries the binding status of the authorization policy for a specified source bucket to the current workspace role. AUTHORIZED indicates that the policy is bound. UNAUTHORIZED indicates that the policy is not bound. A bound policy does not indicate that a specific code package object exists or is readable.
8882
+ * To check a specific object, call ValidateAgentCodePackageFromOss. This operation does not copy code packages or modify the default OSS binding of the workspace.
8277
8883
  *
8278
8884
  * @param request - VerifyAgentCodePackageOssRamAuthorizationRequest
8279
8885
  * @returns VerifyAgentCodePackageOssRamAuthorizationResponse