@alicloud/agentcore20260804 2.5.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 (329) hide show
  1. package/dist/client.d.ts +1222 -72
  2. package/dist/client.js +1609 -72
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AddMemoriesRequest.d.ts +10 -10
  5. package/dist/models/AddMemoriesResponseBody.d.ts +4 -4
  6. package/dist/models/AddMemoriesShrinkRequest.d.ts +1 -1
  7. package/dist/models/CreateCustomAgentRequest.d.ts +43 -43
  8. package/dist/models/CreateCustomAgentResponseBody.d.ts +118 -61
  9. package/dist/models/CreateCustomAgentResponseBody.js +33 -1
  10. package/dist/models/CreateCustomAgentResponseBody.js.map +1 -1
  11. package/dist/models/CreateIdentityProviderRequest.d.ts +51 -10
  12. package/dist/models/CreateIdentityProviderRequest.js +32 -1
  13. package/dist/models/CreateIdentityProviderRequest.js.map +1 -1
  14. package/dist/models/CreateIdentityProviderResponseBody.d.ts +150 -8
  15. package/dist/models/CreateIdentityProviderResponseBody.js +95 -1
  16. package/dist/models/CreateIdentityProviderResponseBody.js.map +1 -1
  17. package/dist/models/CreateIdentityProviderScimcredentialRequest.d.ts +13 -0
  18. package/dist/models/CreateIdentityProviderScimcredentialRequest.js +54 -0
  19. package/dist/models/CreateIdentityProviderScimcredentialRequest.js.map +1 -0
  20. package/dist/models/CreateIdentityProviderScimcredentialResponse.d.ts +19 -0
  21. package/dist/models/CreateIdentityProviderScimcredentialResponse.js +69 -0
  22. package/dist/models/CreateIdentityProviderScimcredentialResponse.js.map +1 -0
  23. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.d.ts +157 -0
  24. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.js +146 -0
  25. package/dist/models/CreateIdentityProviderScimcredentialResponseBody.js.map +1 -0
  26. package/dist/models/CreateIdentityProviderShrinkRequest.d.ts +1 -1
  27. package/dist/models/CreateIdentityProviderSyncJobRequest.d.ts +13 -0
  28. package/dist/models/CreateIdentityProviderSyncJobRequest.js +54 -0
  29. package/dist/models/CreateIdentityProviderSyncJobRequest.js.map +1 -0
  30. package/dist/models/CreateIdentityProviderSyncJobResponse.d.ts +19 -0
  31. package/dist/models/CreateIdentityProviderSyncJobResponse.js +69 -0
  32. package/dist/models/CreateIdentityProviderSyncJobResponse.js.map +1 -0
  33. package/dist/models/CreateIdentityProviderSyncJobResponseBody.d.ts +121 -0
  34. package/dist/models/CreateIdentityProviderSyncJobResponseBody.js +100 -0
  35. package/dist/models/CreateIdentityProviderSyncJobResponseBody.js.map +1 -0
  36. package/dist/models/CreateMemoryStoreRequest.d.ts +6 -6
  37. package/dist/models/CreateMemoryStoreResponseBody.d.ts +7 -7
  38. package/dist/models/CreateMemoryStoreShrinkRequest.d.ts +2 -2
  39. package/dist/models/CreateWorkspaceRequest.d.ts +23 -7
  40. package/dist/models/CreateWorkspaceRequest.js +4 -0
  41. package/dist/models/CreateWorkspaceRequest.js.map +1 -1
  42. package/dist/models/CreateWorkspaceResponseBody.d.ts +11 -11
  43. package/dist/models/CreateWorkspaceShrinkRequest.d.ts +1 -1
  44. package/dist/models/DeleteIdentityProviderResponseBody.d.ts +110 -17
  45. package/dist/models/DeleteIdentityProviderResponseBody.js +66 -1
  46. package/dist/models/DeleteIdentityProviderResponseBody.js.map +1 -1
  47. package/dist/models/DeleteIdentityProviderScimcredentialRequest.d.ts +13 -0
  48. package/dist/models/DeleteIdentityProviderScimcredentialRequest.js +54 -0
  49. package/dist/models/DeleteIdentityProviderScimcredentialRequest.js.map +1 -0
  50. package/dist/models/DeleteIdentityProviderScimcredentialResponse.d.ts +19 -0
  51. package/dist/models/DeleteIdentityProviderScimcredentialResponse.js +69 -0
  52. package/dist/models/DeleteIdentityProviderScimcredentialResponse.js.map +1 -0
  53. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.d.ts +50 -0
  54. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.js +66 -0
  55. package/dist/models/DeleteIdentityProviderScimcredentialResponseBody.js.map +1 -0
  56. package/dist/models/DeleteMemoryStoreResponseBody.d.ts +3 -3
  57. package/dist/models/GetAgentCodePackageDownloadUrlRequest.d.ts +13 -0
  58. package/dist/models/GetAgentCodePackageDownloadUrlRequest.js +54 -0
  59. package/dist/models/GetAgentCodePackageDownloadUrlRequest.js.map +1 -0
  60. package/dist/models/GetAgentCodePackageDownloadUrlResponse.d.ts +19 -0
  61. package/dist/models/GetAgentCodePackageDownloadUrlResponse.js +69 -0
  62. package/dist/models/GetAgentCodePackageDownloadUrlResponse.js.map +1 -0
  63. package/dist/models/GetAgentCodePackageDownloadUrlResponseBody.d.ts +131 -0
  64. package/dist/models/GetAgentCodePackageDownloadUrlResponseBody.js +104 -0
  65. package/dist/models/GetAgentCodePackageDownloadUrlResponseBody.js.map +1 -0
  66. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlRequest.d.ts +23 -0
  67. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlRequest.js +58 -0
  68. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlRequest.js.map +1 -0
  69. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponse.d.ts +19 -0
  70. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponse.js +69 -0
  71. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponse.js.map +1 -0
  72. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponseBody.d.ts +99 -0
  73. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponseBody.js +96 -0
  74. package/dist/models/GetAgentCodePackageOssRamAuthorizeUrlResponseBody.js.map +1 -0
  75. package/dist/models/GetAgentCodePackageUploadUrlRequest.d.ts +62 -0
  76. package/dist/models/GetAgentCodePackageUploadUrlRequest.js +84 -0
  77. package/dist/models/GetAgentCodePackageUploadUrlRequest.js.map +1 -0
  78. package/dist/models/GetAgentCodePackageUploadUrlResponse.d.ts +19 -0
  79. package/dist/models/GetAgentCodePackageUploadUrlResponse.js +69 -0
  80. package/dist/models/GetAgentCodePackageUploadUrlResponse.js.map +1 -0
  81. package/dist/models/GetAgentCodePackageUploadUrlResponseBody.d.ts +114 -0
  82. package/dist/models/GetAgentCodePackageUploadUrlResponseBody.js +103 -0
  83. package/dist/models/GetAgentCodePackageUploadUrlResponseBody.js.map +1 -0
  84. package/dist/models/GetAgentCodePackageUploadUrlShrinkRequest.d.ts +20 -0
  85. package/dist/models/GetAgentCodePackageUploadUrlShrinkRequest.js +58 -0
  86. package/dist/models/GetAgentCodePackageUploadUrlShrinkRequest.js.map +1 -0
  87. package/dist/models/GetCustomAgentResponseBody.d.ts +105 -48
  88. package/dist/models/GetCustomAgentResponseBody.js +33 -1
  89. package/dist/models/GetCustomAgentResponseBody.js.map +1 -1
  90. package/dist/models/GetIdentityProviderResponseBody.d.ts +183 -9
  91. package/dist/models/GetIdentityProviderResponseBody.js +103 -1
  92. package/dist/models/GetIdentityProviderResponseBody.js.map +1 -1
  93. package/dist/models/GetIdentityProviderScimrequest.d.ts +13 -0
  94. package/dist/models/GetIdentityProviderScimrequest.js +54 -0
  95. package/dist/models/GetIdentityProviderScimrequest.js.map +1 -0
  96. package/dist/models/GetIdentityProviderScimresponse.d.ts +19 -0
  97. package/dist/models/GetIdentityProviderScimresponse.js +69 -0
  98. package/dist/models/GetIdentityProviderScimresponse.js.map +1 -0
  99. package/dist/models/GetIdentityProviderScimresponseBody.d.ts +123 -0
  100. package/dist/models/GetIdentityProviderScimresponseBody.js +118 -0
  101. package/dist/models/GetIdentityProviderScimresponseBody.js.map +1 -0
  102. package/dist/models/GetIdentityProviderServiceProviderRequest.d.ts +23 -0
  103. package/dist/models/GetIdentityProviderServiceProviderRequest.js +58 -0
  104. package/dist/models/GetIdentityProviderServiceProviderRequest.js.map +1 -0
  105. package/dist/models/GetIdentityProviderServiceProviderResponse.d.ts +19 -0
  106. package/dist/models/GetIdentityProviderServiceProviderResponse.js +69 -0
  107. package/dist/models/GetIdentityProviderServiceProviderResponse.js.map +1 -0
  108. package/dist/models/GetIdentityProviderServiceProviderResponseBody.d.ts +99 -0
  109. package/dist/models/GetIdentityProviderServiceProviderResponseBody.js +96 -0
  110. package/dist/models/GetIdentityProviderServiceProviderResponseBody.js.map +1 -0
  111. package/dist/models/GetIdentityProviderSyncJobRequest.d.ts +13 -0
  112. package/dist/models/GetIdentityProviderSyncJobRequest.js +54 -0
  113. package/dist/models/GetIdentityProviderSyncJobRequest.js.map +1 -0
  114. package/dist/models/GetIdentityProviderSyncJobResponse.d.ts +19 -0
  115. package/dist/models/GetIdentityProviderSyncJobResponse.js +69 -0
  116. package/dist/models/GetIdentityProviderSyncJobResponse.js.map +1 -0
  117. package/dist/models/GetIdentityProviderSyncJobResponseBody.d.ts +128 -0
  118. package/dist/models/GetIdentityProviderSyncJobResponseBody.js +100 -0
  119. package/dist/models/GetIdentityProviderSyncJobResponseBody.js.map +1 -0
  120. package/dist/models/GetIdentityProviderSyncScopeRequest.d.ts +13 -0
  121. package/dist/models/GetIdentityProviderSyncScopeRequest.js +54 -0
  122. package/dist/models/GetIdentityProviderSyncScopeRequest.js.map +1 -0
  123. package/dist/models/GetIdentityProviderSyncScopeResponse.d.ts +19 -0
  124. package/dist/models/GetIdentityProviderSyncScopeResponse.js +69 -0
  125. package/dist/models/GetIdentityProviderSyncScopeResponse.js.map +1 -0
  126. package/dist/models/GetIdentityProviderSyncScopeResponseBody.d.ts +177 -0
  127. package/dist/models/GetIdentityProviderSyncScopeResponseBody.js +151 -0
  128. package/dist/models/GetIdentityProviderSyncScopeResponseBody.js.map +1 -0
  129. package/dist/models/GetMemoryResponseBody.d.ts +4 -4
  130. package/dist/models/GetMemoryStoreResponseBody.d.ts +3 -3
  131. package/dist/models/ListAgentCodeRuntimesRequest.d.ts +29 -0
  132. package/dist/models/ListAgentCodeRuntimesRequest.js +60 -0
  133. package/dist/models/ListAgentCodeRuntimesRequest.js.map +1 -0
  134. package/dist/models/ListAgentCodeRuntimesResponse.d.ts +19 -0
  135. package/dist/models/ListAgentCodeRuntimesResponse.js +69 -0
  136. package/dist/models/ListAgentCodeRuntimesResponse.js.map +1 -0
  137. package/dist/models/ListAgentCodeRuntimesResponseBody.d.ts +115 -0
  138. package/dist/models/ListAgentCodeRuntimesResponseBody.js +100 -0
  139. package/dist/models/ListAgentCodeRuntimesResponseBody.js.map +1 -0
  140. package/dist/models/ListCustomAgentsRequest.d.ts +2 -2
  141. package/dist/models/ListCustomAgentsResponseBody.d.ts +221 -25
  142. package/dist/models/ListCustomAgentsResponseBody.js +119 -1
  143. package/dist/models/ListCustomAgentsResponseBody.js.map +1 -1
  144. package/dist/models/ListIdentityProviderDepartmentsRequest.d.ts +37 -0
  145. package/dist/models/ListIdentityProviderDepartmentsRequest.js +62 -0
  146. package/dist/models/ListIdentityProviderDepartmentsRequest.js.map +1 -0
  147. package/dist/models/ListIdentityProviderDepartmentsResponse.d.ts +19 -0
  148. package/dist/models/ListIdentityProviderDepartmentsResponse.js +69 -0
  149. package/dist/models/ListIdentityProviderDepartmentsResponse.js.map +1 -0
  150. package/dist/models/ListIdentityProviderDepartmentsResponseBody.d.ts +137 -0
  151. package/dist/models/ListIdentityProviderDepartmentsResponseBody.js +104 -0
  152. package/dist/models/ListIdentityProviderDepartmentsResponseBody.js.map +1 -0
  153. package/dist/models/ListIdentityProviderScimcredentialsRequest.d.ts +13 -0
  154. package/dist/models/ListIdentityProviderScimcredentialsRequest.js +54 -0
  155. package/dist/models/ListIdentityProviderScimcredentialsRequest.js.map +1 -0
  156. package/dist/models/ListIdentityProviderScimcredentialsResponse.d.ts +19 -0
  157. package/dist/models/ListIdentityProviderScimcredentialsResponse.js +69 -0
  158. package/dist/models/ListIdentityProviderScimcredentialsResponse.js.map +1 -0
  159. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.d.ts +99 -0
  160. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.js +96 -0
  161. package/dist/models/ListIdentityProviderScimcredentialsResponseBody.js.map +1 -0
  162. package/dist/models/ListIdentityProvidersResponseBody.d.ts +187 -25
  163. package/dist/models/ListIdentityProvidersResponseBody.js +103 -1
  164. package/dist/models/ListIdentityProvidersResponseBody.js.map +1 -1
  165. package/dist/models/ListMemoriesResponseBody.d.ts +1 -1
  166. package/dist/models/ListMemorySessionMessagesRequest.d.ts +3 -3
  167. package/dist/models/ListMemorySessionsRequest.d.ts +2 -2
  168. package/dist/models/ListMemorySessionsResponseBody.d.ts +1 -1
  169. package/dist/models/ListMemoryStoresResponseBody.d.ts +2 -2
  170. package/dist/models/PrepareIdentityProviderScimrequest.d.ts +13 -0
  171. package/dist/models/PrepareIdentityProviderScimrequest.js +54 -0
  172. package/dist/models/PrepareIdentityProviderScimrequest.js.map +1 -0
  173. package/dist/models/PrepareIdentityProviderScimresponse.d.ts +19 -0
  174. package/dist/models/PrepareIdentityProviderScimresponse.js +69 -0
  175. package/dist/models/PrepareIdentityProviderScimresponse.js.map +1 -0
  176. package/dist/models/PrepareIdentityProviderScimresponseBody.d.ts +157 -0
  177. package/dist/models/PrepareIdentityProviderScimresponseBody.js +146 -0
  178. package/dist/models/PrepareIdentityProviderScimresponseBody.js.map +1 -0
  179. package/dist/models/SearchMemoriesRequest.d.ts +3 -3
  180. package/dist/models/SearchMemoriesResponseBody.d.ts +3 -3
  181. package/dist/models/UpdateCustomAgentRequest.d.ts +49 -49
  182. package/dist/models/UpdateCustomAgentResponseBody.d.ts +124 -77
  183. package/dist/models/UpdateCustomAgentResponseBody.js +33 -1
  184. package/dist/models/UpdateCustomAgentResponseBody.js.map +1 -1
  185. package/dist/models/UpdateCustomAgentShrinkRequest.d.ts +1 -1
  186. package/dist/models/UpdateIdentityProviderRequest.d.ts +111 -10
  187. package/dist/models/UpdateIdentityProviderRequest.js +67 -1
  188. package/dist/models/UpdateIdentityProviderRequest.js.map +1 -1
  189. package/dist/models/UpdateIdentityProviderResponseBody.d.ts +159 -19
  190. package/dist/models/UpdateIdentityProviderResponseBody.js +95 -1
  191. package/dist/models/UpdateIdentityProviderResponseBody.js.map +1 -1
  192. package/dist/models/UpdateIdentityProviderScimrequest.d.ts +39 -0
  193. package/dist/models/UpdateIdentityProviderScimrequest.js +80 -0
  194. package/dist/models/UpdateIdentityProviderScimrequest.js.map +1 -0
  195. package/dist/models/UpdateIdentityProviderScimresponse.d.ts +19 -0
  196. package/dist/models/UpdateIdentityProviderScimresponse.js +69 -0
  197. package/dist/models/UpdateIdentityProviderScimresponse.js.map +1 -0
  198. package/dist/models/UpdateIdentityProviderScimresponseBody.d.ts +288 -0
  199. package/dist/models/UpdateIdentityProviderScimresponseBody.js +201 -0
  200. package/dist/models/UpdateIdentityProviderScimresponseBody.js.map +1 -0
  201. package/dist/models/UpdateIdentityProviderScimshrinkRequest.d.ts +20 -0
  202. package/dist/models/UpdateIdentityProviderScimshrinkRequest.js +58 -0
  203. package/dist/models/UpdateIdentityProviderScimshrinkRequest.js.map +1 -0
  204. package/dist/models/UpdateIdentityProviderShrinkRequest.d.ts +1 -1
  205. package/dist/models/UpdateMemoryRequest.d.ts +3 -3
  206. package/dist/models/UpdateMemoryShrinkRequest.d.ts +1 -1
  207. package/dist/models/UpdateMemoryStoreRequest.d.ts +2 -2
  208. package/dist/models/UpdateMemoryStoreResponseBody.d.ts +1 -1
  209. package/dist/models/ValidateAgentCodePackageFromOssRequest.d.ts +52 -0
  210. package/dist/models/ValidateAgentCodePackageFromOssRequest.js +82 -0
  211. package/dist/models/ValidateAgentCodePackageFromOssRequest.js.map +1 -0
  212. package/dist/models/ValidateAgentCodePackageFromOssResponse.d.ts +19 -0
  213. package/dist/models/ValidateAgentCodePackageFromOssResponse.js +69 -0
  214. package/dist/models/ValidateAgentCodePackageFromOssResponse.js.map +1 -0
  215. package/dist/models/ValidateAgentCodePackageFromOssResponseBody.d.ts +99 -0
  216. package/dist/models/ValidateAgentCodePackageFromOssResponseBody.js +96 -0
  217. package/dist/models/ValidateAgentCodePackageFromOssResponseBody.js.map +1 -0
  218. package/dist/models/ValidateAgentCodePackageFromOssShrinkRequest.d.ts +20 -0
  219. package/dist/models/ValidateAgentCodePackageFromOssShrinkRequest.js +58 -0
  220. package/dist/models/ValidateAgentCodePackageFromOssShrinkRequest.js.map +1 -0
  221. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationRequest.d.ts +23 -0
  222. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationRequest.js +58 -0
  223. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationRequest.js.map +1 -0
  224. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponse.d.ts +19 -0
  225. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponse.js +69 -0
  226. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponse.js.map +1 -0
  227. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.d.ts +99 -0
  228. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.js +96 -0
  229. package/dist/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.js.map +1 -0
  230. package/dist/models/model.d.ts +107 -0
  231. package/dist/models/model.js +328 -112
  232. package/dist/models/model.js.map +1 -1
  233. package/package.json +1 -1
  234. package/src/client.ts +1666 -81
  235. package/src/models/AddMemoriesRequest.ts +10 -10
  236. package/src/models/AddMemoriesResponseBody.ts +4 -4
  237. package/src/models/AddMemoriesShrinkRequest.ts +1 -1
  238. package/src/models/CreateCustomAgentRequest.ts +43 -43
  239. package/src/models/CreateCustomAgentResponseBody.ts +141 -61
  240. package/src/models/CreateIdentityProviderRequest.ts +73 -10
  241. package/src/models/CreateIdentityProviderResponseBody.ts +217 -8
  242. package/src/models/CreateIdentityProviderScimcredentialRequest.ts +24 -0
  243. package/src/models/CreateIdentityProviderScimcredentialResponse.ts +40 -0
  244. package/src/models/CreateIdentityProviderScimcredentialResponseBody.ts +231 -0
  245. package/src/models/CreateIdentityProviderShrinkRequest.ts +1 -1
  246. package/src/models/CreateIdentityProviderSyncJobRequest.ts +24 -0
  247. package/src/models/CreateIdentityProviderSyncJobResponse.ts +40 -0
  248. package/src/models/CreateIdentityProviderSyncJobResponseBody.ts +167 -0
  249. package/src/models/CreateMemoryStoreRequest.ts +6 -6
  250. package/src/models/CreateMemoryStoreResponseBody.ts +7 -7
  251. package/src/models/CreateMemoryStoreShrinkRequest.ts +2 -2
  252. package/src/models/CreateWorkspaceRequest.ts +27 -7
  253. package/src/models/CreateWorkspaceResponseBody.ts +11 -11
  254. package/src/models/CreateWorkspaceShrinkRequest.ts +1 -1
  255. package/src/models/DeleteIdentityProviderResponseBody.ts +157 -17
  256. package/src/models/DeleteIdentityProviderScimcredentialRequest.ts +24 -0
  257. package/src/models/DeleteIdentityProviderScimcredentialResponse.ts +40 -0
  258. package/src/models/DeleteIdentityProviderScimcredentialResponseBody.ts +71 -0
  259. package/src/models/DeleteMemoryStoreResponseBody.ts +3 -3
  260. package/src/models/GetAgentCodePackageDownloadUrlRequest.ts +24 -0
  261. package/src/models/GetAgentCodePackageDownloadUrlResponse.ts +40 -0
  262. package/src/models/GetAgentCodePackageDownloadUrlResponseBody.ts +181 -0
  263. package/src/models/GetAgentCodePackageOssRamAuthorizeUrlRequest.ts +36 -0
  264. package/src/models/GetAgentCodePackageOssRamAuthorizeUrlResponse.ts +40 -0
  265. package/src/models/GetAgentCodePackageOssRamAuthorizeUrlResponseBody.ts +141 -0
  266. package/src/models/GetAgentCodePackageUploadUrlRequest.ts +92 -0
  267. package/src/models/GetAgentCodePackageUploadUrlResponse.ts +40 -0
  268. package/src/models/GetAgentCodePackageUploadUrlResponseBody.ts +161 -0
  269. package/src/models/GetAgentCodePackageUploadUrlShrinkRequest.ts +33 -0
  270. package/src/models/GetCustomAgentResponseBody.ts +128 -48
  271. package/src/models/GetIdentityProviderResponseBody.ts +258 -9
  272. package/src/models/GetIdentityProviderScimrequest.ts +24 -0
  273. package/src/models/GetIdentityProviderScimresponse.ts +40 -0
  274. package/src/models/GetIdentityProviderScimresponseBody.ts +178 -0
  275. package/src/models/GetIdentityProviderServiceProviderRequest.ts +36 -0
  276. package/src/models/GetIdentityProviderServiceProviderResponse.ts +40 -0
  277. package/src/models/GetIdentityProviderServiceProviderResponseBody.ts +141 -0
  278. package/src/models/GetIdentityProviderSyncJobRequest.ts +24 -0
  279. package/src/models/GetIdentityProviderSyncJobResponse.ts +40 -0
  280. package/src/models/GetIdentityProviderSyncJobResponseBody.ts +174 -0
  281. package/src/models/GetIdentityProviderSyncScopeRequest.ts +24 -0
  282. package/src/models/GetIdentityProviderSyncScopeResponse.ts +40 -0
  283. package/src/models/GetIdentityProviderSyncScopeResponseBody.ts +256 -0
  284. package/src/models/GetMemoryResponseBody.ts +4 -4
  285. package/src/models/GetMemoryStoreResponseBody.ts +3 -3
  286. package/src/models/ListAgentCodeRuntimesRequest.ts +44 -0
  287. package/src/models/ListAgentCodeRuntimesResponse.ts +40 -0
  288. package/src/models/ListAgentCodeRuntimesResponseBody.ts +161 -0
  289. package/src/models/ListCustomAgentsRequest.ts +2 -2
  290. package/src/models/ListCustomAgentsResponseBody.ts +303 -25
  291. package/src/models/ListIdentityProviderDepartmentsRequest.ts +54 -0
  292. package/src/models/ListIdentityProviderDepartmentsResponse.ts +40 -0
  293. package/src/models/ListIdentityProviderDepartmentsResponseBody.ts +187 -0
  294. package/src/models/ListIdentityProviderScimcredentialsRequest.ts +24 -0
  295. package/src/models/ListIdentityProviderScimcredentialsResponse.ts +40 -0
  296. package/src/models/ListIdentityProviderScimcredentialsResponseBody.ts +141 -0
  297. package/src/models/ListIdentityProvidersResponseBody.ts +262 -25
  298. package/src/models/ListMemoriesResponseBody.ts +1 -1
  299. package/src/models/ListMemorySessionMessagesRequest.ts +3 -3
  300. package/src/models/ListMemorySessionsRequest.ts +2 -2
  301. package/src/models/ListMemorySessionsResponseBody.ts +1 -1
  302. package/src/models/ListMemoryStoresResponseBody.ts +2 -2
  303. package/src/models/PrepareIdentityProviderScimrequest.ts +24 -0
  304. package/src/models/PrepareIdentityProviderScimresponse.ts +40 -0
  305. package/src/models/PrepareIdentityProviderScimresponseBody.ts +231 -0
  306. package/src/models/SearchMemoriesRequest.ts +3 -3
  307. package/src/models/SearchMemoriesResponseBody.ts +3 -3
  308. package/src/models/UpdateCustomAgentRequest.ts +49 -49
  309. package/src/models/UpdateCustomAgentResponseBody.ts +147 -77
  310. package/src/models/UpdateCustomAgentShrinkRequest.ts +1 -1
  311. package/src/models/UpdateIdentityProviderRequest.ts +159 -10
  312. package/src/models/UpdateIdentityProviderResponseBody.ts +226 -19
  313. package/src/models/UpdateIdentityProviderScimrequest.ts +65 -0
  314. package/src/models/UpdateIdentityProviderScimresponse.ts +40 -0
  315. package/src/models/UpdateIdentityProviderScimresponseBody.ts +408 -0
  316. package/src/models/UpdateIdentityProviderScimshrinkRequest.ts +33 -0
  317. package/src/models/UpdateIdentityProviderShrinkRequest.ts +1 -1
  318. package/src/models/UpdateMemoryRequest.ts +3 -3
  319. package/src/models/UpdateMemoryShrinkRequest.ts +1 -1
  320. package/src/models/UpdateMemoryStoreRequest.ts +2 -2
  321. package/src/models/UpdateMemoryStoreResponseBody.ts +1 -1
  322. package/src/models/ValidateAgentCodePackageFromOssRequest.ts +80 -0
  323. package/src/models/ValidateAgentCodePackageFromOssResponse.ts +40 -0
  324. package/src/models/ValidateAgentCodePackageFromOssResponseBody.ts +141 -0
  325. package/src/models/ValidateAgentCodePackageFromOssShrinkRequest.ts +33 -0
  326. package/src/models/VerifyAgentCodePackageOssRamAuthorizationRequest.ts +36 -0
  327. package/src/models/VerifyAgentCodePackageOssRamAuthorizationResponse.ts +40 -0
  328. package/src/models/VerifyAgentCodePackageOssRamAuthorizationResponseBody.ts +141 -0
  329. package/src/models/model.ts +107 -0
package/src/client.ts CHANGED
@@ -30,10 +30,10 @@ export default class Client extends OpenApi {
30
30
  }
31
31
 
32
32
  /**
33
- * Writes messages or text to a memory store. By default, sync is set to true, which synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId that can be queried by using GetMemoryTask.
33
+ * Writes messages or text to a memory store. By default, sync is set to true, which means the operation synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId, which you can query by calling GetMemoryTask.
34
34
  *
35
35
  * @remarks
36
- * Writes messages or text to a memory store. By default, sync is set to true, which synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId that can be queried by using GetMemoryTask.
36
+ * Writes messages or text to a memory store. By default, sync is set to true, which means the operation synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId, which you can query by calling GetMemoryTask.
37
37
  *
38
38
  * @param tmpReq - AddMemoriesRequest
39
39
  * @param headers - map
@@ -72,10 +72,10 @@ export default class Client extends OpenApi {
72
72
  }
73
73
 
74
74
  /**
75
- * Writes messages or text to a memory store. By default, sync is set to true, which synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId that can be queried by using GetMemoryTask.
75
+ * Writes messages or text to a memory store. By default, sync is set to true, which means the operation synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId, which you can query by calling GetMemoryTask.
76
76
  *
77
77
  * @remarks
78
- * Writes messages or text to a memory store. By default, sync is set to true, which synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId that can be queried by using GetMemoryTask.
78
+ * Writes messages or text to a memory store. By default, sync is set to true, which means the operation synchronously waits for extraction and returns only memories (an empty array is allowed). If sync is set to false, the operation returns only a taskId, which you can query by calling GetMemoryTask.
79
79
  *
80
80
  * @param request - AddMemoriesRequest
81
81
  * @returns AddMemoriesResponse
@@ -498,13 +498,15 @@ export default class Client extends OpenApi {
498
498
  }
499
499
 
500
500
  /**
501
- * Creates a custom agent in a specified workspace and submits a container image deployment configuration. The creation is an asynchronous process. You can call GetCustomAgent to query the deployment result.
501
+ * Creates a custom agent in a specified workspace. Container image and code package deployments are supported. The creation process is asynchronous. You can call GetCustomAgent to query the deployment result.
502
502
  *
503
503
  * @remarks
504
- * Before you call this operation, prepare a writable workspace, a RAM role ARN, an ACR container image, and a runtime configuration. You must specify name, artifact, roleArn, and runtime. The runtime parameter must include both compute and sessionPolicy.
505
- * Currently, only ACR container image deployment is supported. Use artifact.container and specify the service listening port in artifact.port. Omit artifact.code. The image must have the required access permissions and be accessible over the network allowed by the workspace.
506
- * The creation is an asynchronous process. A successful response indicates that the request is accepted. Use the returned agentId to call GetCustomAgent and check latestVersionStatus, latestExecutionError, and status for the corresponding latestSpecVersion to confirm the deployment result. After the deployment is ready, you can call CreateServiceEndpoint to configure an access endpoint.
507
- * The clientToken parameter does not currently provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold parameter for health checks does not currently take effect. Omit this parameter.
504
+ * Before you call this operation, prepare a writable workspace, a RAM role ARN, a container image or code package, and runtime configurations. You must specify name, artifact, roleArn, and runtime. The runtime parameter must include both compute and sessionPolicy.
505
+ * In container mode, use artifact.container and specify artifact.port. The image must have the required access permissions and be accessible over the network allowed by the workspace.
506
+ * In code package pattern, specify artifact.port, and the sourceUri, languageRuntime, and entrypoint of artifact.code. Do not specify container at the same time. Dependencies must be packaged by the user. ZIP and TAR.GZ formats are supported. The compressed package size cannot exceed 500,000,000 bytes. You can call ListAgentCodeRuntimes to query the runtime environment identity. The sourceUri parameter supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including signed URLs. For local files, call GetAgentCodePackageUploadUrl to obtain an upload URL, upload the file directly, and then commit the returned sourceUri.
507
+ * When you submit a new code package source, the backend rechecks the read permissions, object, and size. The configuration is saved only after the transfer succeeds. If the transfer fails, the configuration is not saved. Saved fixed packages can be reused. Set the client timeout to 210 seconds for code package requests. Archive integrity and secure decompression are checked at startup. A successful acceptance does not mean that the agent is ready to run.
508
+ * The creation process is asynchronous. A successful response indicates that the request is accepted. You can use the returned agentId to call GetCustomAgent and check the latestVersionStatus, latestExecutionError, and status corresponding to latestSpecVersion to confirm the deployment result. After the deployment is ready, you can call CreateServiceEndpoint to configure the access endpoint.
509
+ * The clientToken parameter does not provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold parameter for health checks does not take effect. Omit this parameter.
508
510
  *
509
511
  * @param tmpReq - CreateCustomAgentRequest
510
512
  * @param headers - map
@@ -549,13 +551,15 @@ export default class Client extends OpenApi {
549
551
  }
550
552
 
551
553
  /**
552
- * Creates a custom agent in a specified workspace and submits a container image deployment configuration. The creation is an asynchronous process. You can call GetCustomAgent to query the deployment result.
554
+ * Creates a custom agent in a specified workspace. Container image and code package deployments are supported. The creation process is asynchronous. You can call GetCustomAgent to query the deployment result.
553
555
  *
554
556
  * @remarks
555
- * Before you call this operation, prepare a writable workspace, a RAM role ARN, an ACR container image, and a runtime configuration. You must specify name, artifact, roleArn, and runtime. The runtime parameter must include both compute and sessionPolicy.
556
- * Currently, only ACR container image deployment is supported. Use artifact.container and specify the service listening port in artifact.port. Omit artifact.code. The image must have the required access permissions and be accessible over the network allowed by the workspace.
557
- * The creation is an asynchronous process. A successful response indicates that the request is accepted. Use the returned agentId to call GetCustomAgent and check latestVersionStatus, latestExecutionError, and status for the corresponding latestSpecVersion to confirm the deployment result. After the deployment is ready, you can call CreateServiceEndpoint to configure an access endpoint.
558
- * The clientToken parameter does not currently provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold parameter for health checks does not currently take effect. Omit this parameter.
557
+ * Before you call this operation, prepare a writable workspace, a RAM role ARN, a container image or code package, and runtime configurations. You must specify name, artifact, roleArn, and runtime. The runtime parameter must include both compute and sessionPolicy.
558
+ * In container mode, use artifact.container and specify artifact.port. The image must have the required access permissions and be accessible over the network allowed by the workspace.
559
+ * In code package pattern, specify artifact.port, and the sourceUri, languageRuntime, and entrypoint of artifact.code. Do not specify container at the same time. Dependencies must be packaged by the user. ZIP and TAR.GZ formats are supported. The compressed package size cannot exceed 500,000,000 bytes. You can call ListAgentCodeRuntimes to query the runtime environment identity. The sourceUri parameter supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including signed URLs. For local files, call GetAgentCodePackageUploadUrl to obtain an upload URL, upload the file directly, and then commit the returned sourceUri.
560
+ * When you submit a new code package source, the backend rechecks the read permissions, object, and size. The configuration is saved only after the transfer succeeds. If the transfer fails, the configuration is not saved. Saved fixed packages can be reused. Set the client timeout to 210 seconds for code package requests. Archive integrity and secure decompression are checked at startup. A successful acceptance does not mean that the agent is ready to run.
561
+ * The creation process is asynchronous. A successful response indicates that the request is accepted. You can use the returned agentId to call GetCustomAgent and check the latestVersionStatus, latestExecutionError, and status corresponding to latestSpecVersion to confirm the deployment result. After the deployment is ready, you can call CreateServiceEndpoint to configure the access endpoint.
562
+ * The clientToken parameter does not provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold parameter for health checks does not take effect. Omit this parameter.
559
563
  *
560
564
  * @param request - CreateCustomAgentRequest
561
565
  * @returns CreateCustomAgentResponse
@@ -681,7 +685,34 @@ export default class Client extends OpenApi {
681
685
  }
682
686
 
683
687
  /**
684
- * Binds an external identity provider to a specified workspace to enable single sign-on and organization member synchronization for workspace users. Each workspace can be bound to a maximum of one external identity provider. This is an asynchronous operation. After the API call returns, you can call GetIdentityProvider to query the status and track the progress.
688
+ * 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.
689
+ *
690
+ * @remarks
691
+ * ## Features and prerequisites
692
+ * 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.
693
+ * 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.
694
+ * ## Requests and examples
695
+ * POST /workspaces/{workspaceId}/identity-providers
696
+ * 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.
697
+ * ```text
698
+ * POST /workspaces/ws-example/identity-providers
699
+ * {"identityProviderType": "CustomSSO"}
700
+ * ```
701
+ * ## Response example
702
+ * ```json
703
+ * {
704
+ * "data": {
705
+ * "workspaceId": "ws-example",
706
+ * "identityProviderType": "CustomSSO",
707
+ * "loginEnabled": false,
708
+ * "syncEnabled": false,
709
+ * "status": "CONFIGURED"
710
+ * }
711
+ * }
712
+ * ```
713
+ * ## Errors and handling
714
+ * 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.
715
+ * 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.
685
716
  *
686
717
  * @param tmpReq - CreateIdentityProviderRequest
687
718
  * @param headers - map
@@ -720,7 +751,34 @@ export default class Client extends OpenApi {
720
751
  }
721
752
 
722
753
  /**
723
- * Binds an external identity provider to a specified workspace to enable single sign-on and organization member synchronization for workspace users. Each workspace can be bound to a maximum of one external identity provider. This is an asynchronous operation. After the API call returns, you can call GetIdentityProvider to query the status and track the progress.
754
+ * 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.
755
+ *
756
+ * @remarks
757
+ * ## Features and prerequisites
758
+ * 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.
759
+ * 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.
760
+ * ## Requests and examples
761
+ * POST /workspaces/{workspaceId}/identity-providers
762
+ * 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.
763
+ * ```text
764
+ * POST /workspaces/ws-example/identity-providers
765
+ * {"identityProviderType": "CustomSSO"}
766
+ * ```
767
+ * ## Response example
768
+ * ```json
769
+ * {
770
+ * "data": {
771
+ * "workspaceId": "ws-example",
772
+ * "identityProviderType": "CustomSSO",
773
+ * "loginEnabled": false,
774
+ * "syncEnabled": false,
775
+ * "status": "CONFIGURED"
776
+ * }
777
+ * }
778
+ * ```
779
+ * ## Errors and handling
780
+ * 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.
781
+ * 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.
724
782
  *
725
783
  * @param request - CreateIdentityProviderRequest
726
784
  * @returns CreateIdentityProviderResponse
@@ -731,6 +789,194 @@ export default class Client extends OpenApi {
731
789
  return await this.createIdentityProviderWithOptions(workspaceId, request, headers, runtime);
732
790
  }
733
791
 
792
+ /**
793
+ * 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.
794
+ *
795
+ * @remarks
796
+ * ## Features and prerequisites
797
+ * 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.
798
+ * 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.
799
+ * ## Request and examples
800
+ * POST /workspaces/{workspaceId}/scim-provisioning/credentials
801
+ * 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.
802
+ * ```text
803
+ * POST /workspaces/ws-example/scim-provisioning/credentials
804
+ * No business request body.
805
+ * ```
806
+ * ## Response example
807
+ * ```json
808
+ * {
809
+ * "data": {
810
+ * "configuration": {
811
+ * "status": "Enabled",
812
+ * "baseUrl": "https://example.com/scim/v2"
813
+ * },
814
+ * "credential": {
815
+ * "credentialId": "credential-example",
816
+ * "status": "Enabled",
817
+ * "expireTime": "<Upstream expiration time>"
818
+ * },
819
+ * "token": "<Newly issued token for the current request>"
820
+ * }
821
+ * }
822
+ * ```
823
+ * ## Errors and handling
824
+ * 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.
825
+ * 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.
826
+ * ## Call relationships and usage boundaries
827
+ * 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.
828
+ *
829
+ * @param request - CreateIdentityProviderSCIMCredentialRequest
830
+ * @param headers - map
831
+ * @param runtime - runtime options for this request RuntimeOptions
832
+ * @returns CreateIdentityProviderSCIMCredentialResponse
833
+ */
834
+ async createIdentityProviderSCIMCredentialWithOptions(workspaceId: string, request: $_model.CreateIdentityProviderSCIMCredentialRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.CreateIdentityProviderSCIMCredentialResponse> {
835
+ request.validate();
836
+ let req = new $OpenApiUtil.OpenApiRequest({
837
+ headers: headers,
838
+ });
839
+ let params = new $OpenApiUtil.Params({
840
+ action: "CreateIdentityProviderSCIMCredential",
841
+ version: "2026-08-04",
842
+ protocol: "HTTPS",
843
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials`,
844
+ method: "POST",
845
+ authType: "AK",
846
+ style: "ROA",
847
+ reqBodyType: "json",
848
+ bodyType: "json",
849
+ });
850
+ return $dara.cast<$_model.CreateIdentityProviderSCIMCredentialResponse>(await this.callApi(params, req, runtime), new $_model.CreateIdentityProviderSCIMCredentialResponse({}));
851
+ }
852
+
853
+ /**
854
+ * 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.
855
+ *
856
+ * @remarks
857
+ * ## Features and prerequisites
858
+ * 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.
859
+ * 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.
860
+ * ## Request and examples
861
+ * POST /workspaces/{workspaceId}/scim-provisioning/credentials
862
+ * 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.
863
+ * ```text
864
+ * POST /workspaces/ws-example/scim-provisioning/credentials
865
+ * No business request body.
866
+ * ```
867
+ * ## Response example
868
+ * ```json
869
+ * {
870
+ * "data": {
871
+ * "configuration": {
872
+ * "status": "Enabled",
873
+ * "baseUrl": "https://example.com/scim/v2"
874
+ * },
875
+ * "credential": {
876
+ * "credentialId": "credential-example",
877
+ * "status": "Enabled",
878
+ * "expireTime": "<Upstream expiration time>"
879
+ * },
880
+ * "token": "<Newly issued token for the current request>"
881
+ * }
882
+ * }
883
+ * ```
884
+ * ## Errors and handling
885
+ * 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.
886
+ * 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.
887
+ * ## Call relationships and usage boundaries
888
+ * 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.
889
+ *
890
+ * @param request - CreateIdentityProviderSCIMCredentialRequest
891
+ * @returns CreateIdentityProviderSCIMCredentialResponse
892
+ */
893
+ async createIdentityProviderSCIMCredential(workspaceId: string, request: $_model.CreateIdentityProviderSCIMCredentialRequest): Promise<$_model.CreateIdentityProviderSCIMCredentialResponse> {
894
+ let runtime = new $dara.RuntimeOptions({ });
895
+ let headers : {[key: string ]: string} = { };
896
+ return await this.createIdentityProviderSCIMCredentialWithOptions(workspaceId, request, headers, runtime);
897
+ }
898
+
899
+ /**
900
+ * Initiates a manual synchronization of an identity provider.
901
+ *
902
+ * @remarks
903
+ * Initiates a one-time user synchronization based on the saved scope without saving the configuration or requiring syncEnabled=true. Prerequisites: the identity provider is in the READY or SYNC_FAILED state, a user pool exists, and no other pending identity provider operations are in progress. The returned taskId only indicates that the request is accepted. Call GetIdentityProviderSyncJob to poll the status until it reaches SUCCESS, FAILED, or CANCELED. If the task fails, check the failureReason. The workspace user quota still applies, and previously synchronized users are not automatically deleted if the scope is reduced.
904
+ * Authorization information: RAM action agentcore:CreateIdentityProviderSyncJob, access level Write, resource ARN: acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is required for authorization.
905
+ * Idempotency and retry: This operation does not provide a ClientToken parameter for conditional idempotency. Repeated submissions do not guarantee the same task is returned. If an operation is already in progress, an operation conflict is returned. Submitting again after the task ends creates a new synchronization task. If a submission times out, query the identity provider status first to avoid blindly resubmitting the request.
906
+ * Calling this API is free of charge, and operation records support ActionTrail auditing.
907
+ * Initial selective synchronization process: CreateIdentityProvider (syncOnBind=false, it is recommended to keep syncEnabled=false initially) → GetIdentityProvider and wait for READY → ListIdentityProviderDepartments to select departments → UpdateIdentityProvider to save syncScope and wait for READY → CreateIdentityProviderSyncJob → GetIdentityProviderSyncJob to query the terminal state. If incremental synchronization is required, configure callbacks and event subscriptions, and then update syncEnabled=true.
908
+ * Response example:
909
+ * ```json
910
+ * {
911
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
912
+ * "message": "success",
913
+ * "httpStatusCode": 200,
914
+ * "code": "SUCCESS",
915
+ * "success": true,
916
+ * "data": {
917
+ * "taskId": "12345678-1234-4234-8234-123456789abc",
918
+ * "status": "PENDING"
919
+ * }
920
+ * }
921
+ * ```
922
+ *
923
+ * @param request - CreateIdentityProviderSyncJobRequest
924
+ * @param headers - map
925
+ * @param runtime - runtime options for this request RuntimeOptions
926
+ * @returns CreateIdentityProviderSyncJobResponse
927
+ */
928
+ async createIdentityProviderSyncJobWithOptions(workspaceId: string, identityProviderType: string, request: $_model.CreateIdentityProviderSyncJobRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.CreateIdentityProviderSyncJobResponse> {
929
+ request.validate();
930
+ let req = new $OpenApiUtil.OpenApiRequest({
931
+ headers: headers,
932
+ });
933
+ let params = new $OpenApiUtil.Params({
934
+ action: "CreateIdentityProviderSyncJob",
935
+ version: "2026-08-04",
936
+ protocol: "HTTPS",
937
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/sync-jobs`,
938
+ method: "POST",
939
+ authType: "AK",
940
+ style: "ROA",
941
+ reqBodyType: "json",
942
+ bodyType: "json",
943
+ });
944
+ return $dara.cast<$_model.CreateIdentityProviderSyncJobResponse>(await this.callApi(params, req, runtime), new $_model.CreateIdentityProviderSyncJobResponse({}));
945
+ }
946
+
947
+ /**
948
+ * Initiates a manual synchronization of an identity provider.
949
+ *
950
+ * @remarks
951
+ * Initiates a one-time user synchronization based on the saved scope without saving the configuration or requiring syncEnabled=true. Prerequisites: the identity provider is in the READY or SYNC_FAILED state, a user pool exists, and no other pending identity provider operations are in progress. The returned taskId only indicates that the request is accepted. Call GetIdentityProviderSyncJob to poll the status until it reaches SUCCESS, FAILED, or CANCELED. If the task fails, check the failureReason. The workspace user quota still applies, and previously synchronized users are not automatically deleted if the scope is reduced.
952
+ * Authorization information: RAM action agentcore:CreateIdentityProviderSyncJob, access level Write, resource ARN: acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is required for authorization.
953
+ * Idempotency and retry: This operation does not provide a ClientToken parameter for conditional idempotency. Repeated submissions do not guarantee the same task is returned. If an operation is already in progress, an operation conflict is returned. Submitting again after the task ends creates a new synchronization task. If a submission times out, query the identity provider status first to avoid blindly resubmitting the request.
954
+ * Calling this API is free of charge, and operation records support ActionTrail auditing.
955
+ * Initial selective synchronization process: CreateIdentityProvider (syncOnBind=false, it is recommended to keep syncEnabled=false initially) → GetIdentityProvider and wait for READY → ListIdentityProviderDepartments to select departments → UpdateIdentityProvider to save syncScope and wait for READY → CreateIdentityProviderSyncJob → GetIdentityProviderSyncJob to query the terminal state. If incremental synchronization is required, configure callbacks and event subscriptions, and then update syncEnabled=true.
956
+ * Response example:
957
+ * ```json
958
+ * {
959
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
960
+ * "message": "success",
961
+ * "httpStatusCode": 200,
962
+ * "code": "SUCCESS",
963
+ * "success": true,
964
+ * "data": {
965
+ * "taskId": "12345678-1234-4234-8234-123456789abc",
966
+ * "status": "PENDING"
967
+ * }
968
+ * }
969
+ * ```
970
+ *
971
+ * @param request - CreateIdentityProviderSyncJobRequest
972
+ * @returns CreateIdentityProviderSyncJobResponse
973
+ */
974
+ async createIdentityProviderSyncJob(workspaceId: string, identityProviderType: string, request: $_model.CreateIdentityProviderSyncJobRequest): Promise<$_model.CreateIdentityProviderSyncJobResponse> {
975
+ let runtime = new $dara.RuntimeOptions({ });
976
+ let headers : {[key: string ]: string} = { };
977
+ return await this.createIdentityProviderSyncJobWithOptions(workspaceId, identityProviderType, request, headers, runtime);
978
+ }
979
+
734
980
  /**
735
981
  * Creates an image cache.
736
982
  *
@@ -1679,7 +1925,33 @@ export default class Client extends OpenApi {
1679
1925
  }
1680
1926
 
1681
1927
  /**
1682
- * Unbinds the external identity provider from a specified workspace and cleans up users synchronized by that identity provider. The unbinding is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
1928
+ * 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.
1929
+ *
1930
+ * @remarks
1931
+ * ## Features and prerequisites
1932
+ * 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.
1933
+ * 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.
1934
+ * ## Requests and examples
1935
+ * DELETE /workspaces/{workspaceId}/identity-providers/{identityProviderType}
1936
+ * 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.
1937
+ * ```text
1938
+ * DELETE /workspaces/ws-example/identity-providers/CustomSSO
1939
+ * ```
1940
+ * ## Response examples
1941
+ * ```json
1942
+ * {
1943
+ * "data": {
1944
+ * "workspaceId": "ws-example",
1945
+ * "identityProviderType": "CustomSSO",
1946
+ * "status": "DISCONNECTING"
1947
+ * }
1948
+ * }
1949
+ * ```
1950
+ * ## Errors and handling
1951
+ * 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.
1952
+ * 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.
1953
+ * ## Calling relationships and usage boundaries
1954
+ * 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.
1683
1955
  *
1684
1956
  * @param request - DeleteIdentityProviderRequest
1685
1957
  * @param headers - map
@@ -1712,7 +1984,33 @@ export default class Client extends OpenApi {
1712
1984
  }
1713
1985
 
1714
1986
  /**
1715
- * Unbinds the external identity provider from a specified workspace and cleans up users synchronized by that identity provider. The unbinding is an asynchronous operation. After the API returns, you can call GetIdentityProvider to query the status and track the progress.
1987
+ * 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.
1988
+ *
1989
+ * @remarks
1990
+ * ## Features and prerequisites
1991
+ * 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.
1992
+ * 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.
1993
+ * ## Requests and examples
1994
+ * DELETE /workspaces/{workspaceId}/identity-providers/{identityProviderType}
1995
+ * 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.
1996
+ * ```text
1997
+ * DELETE /workspaces/ws-example/identity-providers/CustomSSO
1998
+ * ```
1999
+ * ## Response examples
2000
+ * ```json
2001
+ * {
2002
+ * "data": {
2003
+ * "workspaceId": "ws-example",
2004
+ * "identityProviderType": "CustomSSO",
2005
+ * "status": "DISCONNECTING"
2006
+ * }
2007
+ * }
2008
+ * ```
2009
+ * ## Errors and handling
2010
+ * 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.
2011
+ * 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.
2012
+ * ## Calling relationships and usage boundaries
2013
+ * 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.
1716
2014
  *
1717
2015
  * @param request - DeleteIdentityProviderRequest
1718
2016
  * @returns DeleteIdentityProviderResponse
@@ -1723,6 +2021,51 @@ export default class Client extends OpenApi {
1723
2021
  return await this.deleteIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
1724
2022
  }
1725
2023
 
2024
+ /**
2025
+ * 删除 SCIM 凭据
2026
+ *
2027
+ * @remarks
2028
+ * ## 功能与前提\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 登录。
2029
+ *
2030
+ * @param request - DeleteIdentityProviderSCIMCredentialRequest
2031
+ * @param headers - map
2032
+ * @param runtime - runtime options for this request RuntimeOptions
2033
+ * @returns DeleteIdentityProviderSCIMCredentialResponse
2034
+ */
2035
+ async deleteIdentityProviderSCIMCredentialWithOptions(workspaceId: string, credentialId: string, request: $_model.DeleteIdentityProviderSCIMCredentialRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteIdentityProviderSCIMCredentialResponse> {
2036
+ request.validate();
2037
+ let req = new $OpenApiUtil.OpenApiRequest({
2038
+ headers: headers,
2039
+ });
2040
+ let params = new $OpenApiUtil.Params({
2041
+ action: "DeleteIdentityProviderSCIMCredential",
2042
+ version: "2026-08-04",
2043
+ protocol: "HTTPS",
2044
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials/${$dara.URL.percentEncode(credentialId)}`,
2045
+ method: "DELETE",
2046
+ authType: "AK",
2047
+ style: "ROA",
2048
+ reqBodyType: "json",
2049
+ bodyType: "json",
2050
+ });
2051
+ return $dara.cast<$_model.DeleteIdentityProviderSCIMCredentialResponse>(await this.callApi(params, req, runtime), new $_model.DeleteIdentityProviderSCIMCredentialResponse({}));
2052
+ }
2053
+
2054
+ /**
2055
+ * 删除 SCIM 凭据
2056
+ *
2057
+ * @remarks
2058
+ * ## 功能与前提\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 登录。
2059
+ *
2060
+ * @param request - DeleteIdentityProviderSCIMCredentialRequest
2061
+ * @returns DeleteIdentityProviderSCIMCredentialResponse
2062
+ */
2063
+ async deleteIdentityProviderSCIMCredential(workspaceId: string, credentialId: string, request: $_model.DeleteIdentityProviderSCIMCredentialRequest): Promise<$_model.DeleteIdentityProviderSCIMCredentialResponse> {
2064
+ let runtime = new $dara.RuntimeOptions({ });
2065
+ let headers : {[key: string ]: string} = { };
2066
+ return await this.deleteIdentityProviderSCIMCredentialWithOptions(workspaceId, credentialId, request, headers, runtime);
2067
+ }
2068
+
1726
2069
  /**
1727
2070
  * Deletes an image cache.
1728
2071
  *
@@ -1910,10 +2253,10 @@ export default class Client extends OpenApi {
1910
2253
  }
1911
2254
 
1912
2255
  /**
1913
- * Asynchronously deletes a MemoryStore and all its long-term memory.
2256
+ * Asynchronously deletes a MemoryStore and all long-term memory within it.
1914
2257
  *
1915
2258
  * @remarks
1916
- * Asynchronously deletes a MemoryStore and all its long-term memory.
2259
+ * Asynchronously deletes a MemoryStore and all long-term memory within it.
1917
2260
  *
1918
2261
  * @param request - DeleteMemoryStoreRequest
1919
2262
  * @param headers - map
@@ -1940,10 +2283,10 @@ export default class Client extends OpenApi {
1940
2283
  }
1941
2284
 
1942
2285
  /**
1943
- * Asynchronously deletes a MemoryStore and all its long-term memory.
2286
+ * Asynchronously deletes a MemoryStore and all long-term memory within it.
1944
2287
  *
1945
2288
  * @remarks
1946
- * Asynchronously deletes a MemoryStore and all its long-term memory.
2289
+ * Asynchronously deletes a MemoryStore and all long-term memory within it.
1947
2290
  *
1948
2291
  * @param request - DeleteMemoryStoreRequest
1949
2292
  * @returns DeleteMemoryStoreResponse
@@ -2534,6 +2877,163 @@ export default class Client extends OpenApi {
2534
2877
  return await this.forcePublishSkillVersionWithOptions(workspaceId, skillName, skillVersion, request, headers, runtime);
2535
2878
  }
2536
2879
 
2880
+ /**
2881
+ * Retrieves the download URL for the saved code package of an agent.
2882
+ *
2883
+ * @remarks
2884
+ * Generates a time-limited, read-only download URL for the code package referenced by the currently saved agent configuration. This applies to code packages uploaded locally or imported from Object Storage Service (OSS). The operation uses workspaceId and agentId for locating and does not accept arbitrary bucket, object key, or historical version parameters. The current configuration must reference an available, fixed code package, and does not require waiting for a running instance to be ready. An error is returned if the code package does not exist, has changed, or is unreadable. The link is valid for up to 10 minutes and does not exceed the underlying credential expiration time. Call the operation again after it expires. The resourceVersionId indicates the saved configuration version corresponding to this download. The sample download link is redacted. Use the downloadUrl in the response.
2885
+ *
2886
+ * @param request - GetAgentCodePackageDownloadUrlRequest
2887
+ * @param headers - map
2888
+ * @param runtime - runtime options for this request RuntimeOptions
2889
+ * @returns GetAgentCodePackageDownloadUrlResponse
2890
+ */
2891
+ async getAgentCodePackageDownloadUrlWithOptions(workspaceId: string, agentId: string, request: $_model.GetAgentCodePackageDownloadUrlRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetAgentCodePackageDownloadUrlResponse> {
2892
+ request.validate();
2893
+ let req = new $OpenApiUtil.OpenApiRequest({
2894
+ headers: headers,
2895
+ });
2896
+ let params = new $OpenApiUtil.Params({
2897
+ action: "GetAgentCodePackageDownloadUrl",
2898
+ version: "2026-08-04",
2899
+ protocol: "HTTPS",
2900
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/custom-agents/${$dara.URL.percentEncode(agentId)}/code-package/download-url`,
2901
+ method: "GET",
2902
+ authType: "AK",
2903
+ style: "ROA",
2904
+ reqBodyType: "json",
2905
+ bodyType: "json",
2906
+ });
2907
+ return $dara.cast<$_model.GetAgentCodePackageDownloadUrlResponse>(await this.callApi(params, req, runtime), new $_model.GetAgentCodePackageDownloadUrlResponse({}));
2908
+ }
2909
+
2910
+ /**
2911
+ * Retrieves the download URL for the saved code package of an agent.
2912
+ *
2913
+ * @remarks
2914
+ * Generates a time-limited, read-only download URL for the code package referenced by the currently saved agent configuration. This applies to code packages uploaded locally or imported from Object Storage Service (OSS). The operation uses workspaceId and agentId for locating and does not accept arbitrary bucket, object key, or historical version parameters. The current configuration must reference an available, fixed code package, and does not require waiting for a running instance to be ready. An error is returned if the code package does not exist, has changed, or is unreadable. The link is valid for up to 10 minutes and does not exceed the underlying credential expiration time. Call the operation again after it expires. The resourceVersionId indicates the saved configuration version corresponding to this download. The sample download link is redacted. Use the downloadUrl in the response.
2915
+ *
2916
+ * @param request - GetAgentCodePackageDownloadUrlRequest
2917
+ * @returns GetAgentCodePackageDownloadUrlResponse
2918
+ */
2919
+ async getAgentCodePackageDownloadUrl(workspaceId: string, agentId: string, request: $_model.GetAgentCodePackageDownloadUrlRequest): Promise<$_model.GetAgentCodePackageDownloadUrlResponse> {
2920
+ let runtime = new $dara.RuntimeOptions({ });
2921
+ let headers : {[key: string ]: string} = { };
2922
+ return await this.getAgentCodePackageDownloadUrlWithOptions(workspaceId, agentId, request, headers, runtime);
2923
+ }
2924
+
2925
+ /**
2926
+ * Retrieves the OSS RAM authorization URL for the agent code package.
2927
+ *
2928
+ * @remarks
2929
+ * Generates a RAM authorization URL for the resource role of the current workspace for a specified source bucket. The client cannot specify or override the role. After you open the authorizeUrl and confirm the authorization, call VerifyAgentCodePackageOssRamAuthorization to check the policy binding, and call ValidateAgentCodePackageFromOss to check specific objects.
2930
+ * This authorization reuses the OSSObjectRestoreCustom template, which includes permissions to read, write, and delete objects, and is not a read-only authorization. Retrieving the URL itself does not complete the authorization, transfer the code package, or modify the default OSS binding of the workspace. Existing authorizations for the same role and bucket can be reused. The example URL is provided to demonstrate the format. Use the actual authorization URL returned by the API operation.
2931
+ *
2932
+ * @param request - GetAgentCodePackageOssRamAuthorizeUrlRequest
2933
+ * @param headers - map
2934
+ * @param runtime - runtime options for this request RuntimeOptions
2935
+ * @returns GetAgentCodePackageOssRamAuthorizeUrlResponse
2936
+ */
2937
+ async getAgentCodePackageOssRamAuthorizeUrlWithOptions(workspaceId: string, request: $_model.GetAgentCodePackageOssRamAuthorizeUrlRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetAgentCodePackageOssRamAuthorizeUrlResponse> {
2938
+ request.validate();
2939
+ let query : {[key: string ]: any} = { };
2940
+ if (!$dara.isNull(request.ossBucketName)) {
2941
+ query["ossBucketName"] = request.ossBucketName;
2942
+ }
2943
+
2944
+ let req = new $OpenApiUtil.OpenApiRequest({
2945
+ headers: headers,
2946
+ query: OpenApiUtil.query(query),
2947
+ });
2948
+ let params = new $OpenApiUtil.Params({
2949
+ action: "GetAgentCodePackageOssRamAuthorizeUrl",
2950
+ version: "2026-08-04",
2951
+ protocol: "HTTPS",
2952
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agent-code-packages/oss/authorize`,
2953
+ method: "GET",
2954
+ authType: "AK",
2955
+ style: "ROA",
2956
+ reqBodyType: "json",
2957
+ bodyType: "json",
2958
+ });
2959
+ return $dara.cast<$_model.GetAgentCodePackageOssRamAuthorizeUrlResponse>(await this.callApi(params, req, runtime), new $_model.GetAgentCodePackageOssRamAuthorizeUrlResponse({}));
2960
+ }
2961
+
2962
+ /**
2963
+ * Retrieves the OSS RAM authorization URL for the agent code package.
2964
+ *
2965
+ * @remarks
2966
+ * Generates a RAM authorization URL for the resource role of the current workspace for a specified source bucket. The client cannot specify or override the role. After you open the authorizeUrl and confirm the authorization, call VerifyAgentCodePackageOssRamAuthorization to check the policy binding, and call ValidateAgentCodePackageFromOss to check specific objects.
2967
+ * This authorization reuses the OSSObjectRestoreCustom template, which includes permissions to read, write, and delete objects, and is not a read-only authorization. Retrieving the URL itself does not complete the authorization, transfer the code package, or modify the default OSS binding of the workspace. Existing authorizations for the same role and bucket can be reused. The example URL is provided to demonstrate the format. Use the actual authorization URL returned by the API operation.
2968
+ *
2969
+ * @param request - GetAgentCodePackageOssRamAuthorizeUrlRequest
2970
+ * @returns GetAgentCodePackageOssRamAuthorizeUrlResponse
2971
+ */
2972
+ async getAgentCodePackageOssRamAuthorizeUrl(workspaceId: string, request: $_model.GetAgentCodePackageOssRamAuthorizeUrlRequest): Promise<$_model.GetAgentCodePackageOssRamAuthorizeUrlResponse> {
2973
+ let runtime = new $dara.RuntimeOptions({ });
2974
+ let headers : {[key: string ]: string} = { };
2975
+ return await this.getAgentCodePackageOssRamAuthorizeUrlWithOptions(workspaceId, request, headers, runtime);
2976
+ }
2977
+
2978
+ /**
2979
+ * Retrieves the upload URL for an agent code package.
2980
+ *
2981
+ * @remarks
2982
+ * Retrieves a time-limited upload URL for a code package without uploading the file content. The fileName must be a ZIP or TAR.GZ filename without directories. The format must match the file extension. The fileSize is in bytes, with valid values ranging from 1 to 500,000,000.
2983
+ * Use the uploadMethod, uploadUrl, and headers from the response to upload the file directly. After the upload is complete, pass the sourceUri to the artifact.code.sourceUri parameter of CreateCustomAgent or UpdateCustomAgent. The actual object and size are verified and a fixed copy is saved during creation or update. The upload URL is valid for up to 10 minutes and does not exceed the expiration time of the underlying temporary credentials. Retrieve a new URL after it expires. The example URL is desensitized and cannot be used for actual uploads. Use the original URL and request headers from this response.
2984
+ *
2985
+ * @param tmpReq - GetAgentCodePackageUploadUrlRequest
2986
+ * @param headers - map
2987
+ * @param runtime - runtime options for this request RuntimeOptions
2988
+ * @returns GetAgentCodePackageUploadUrlResponse
2989
+ */
2990
+ async getAgentCodePackageUploadUrlWithOptions(workspaceId: string, tmpReq: $_model.GetAgentCodePackageUploadUrlRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetAgentCodePackageUploadUrlResponse> {
2991
+ tmpReq.validate();
2992
+ let request = new $_model.GetAgentCodePackageUploadUrlShrinkRequest({ });
2993
+ OpenApiUtil.convert(tmpReq, request);
2994
+ if (!$dara.isNull(tmpReq.body)) {
2995
+ request.bodyShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.body, "body", "json");
2996
+ }
2997
+
2998
+ let body : {[key: string ]: any} = { };
2999
+ if (!$dara.isNull(request.bodyShrink)) {
3000
+ body["body"] = request.bodyShrink;
3001
+ }
3002
+
3003
+ let req = new $OpenApiUtil.OpenApiRequest({
3004
+ headers: headers,
3005
+ body: OpenApiUtil.parseToMap(body),
3006
+ });
3007
+ let params = new $OpenApiUtil.Params({
3008
+ action: "GetAgentCodePackageUploadUrl",
3009
+ version: "2026-08-04",
3010
+ protocol: "HTTPS",
3011
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agent-code-packages/upload-url`,
3012
+ method: "POST",
3013
+ authType: "AK",
3014
+ style: "ROA",
3015
+ reqBodyType: "formData",
3016
+ bodyType: "json",
3017
+ });
3018
+ return $dara.cast<$_model.GetAgentCodePackageUploadUrlResponse>(await this.callApi(params, req, runtime), new $_model.GetAgentCodePackageUploadUrlResponse({}));
3019
+ }
3020
+
3021
+ /**
3022
+ * Retrieves the upload URL for an agent code package.
3023
+ *
3024
+ * @remarks
3025
+ * Retrieves a time-limited upload URL for a code package without uploading the file content. The fileName must be a ZIP or TAR.GZ filename without directories. The format must match the file extension. The fileSize is in bytes, with valid values ranging from 1 to 500,000,000.
3026
+ * Use the uploadMethod, uploadUrl, and headers from the response to upload the file directly. After the upload is complete, pass the sourceUri to the artifact.code.sourceUri parameter of CreateCustomAgent or UpdateCustomAgent. The actual object and size are verified and a fixed copy is saved during creation or update. The upload URL is valid for up to 10 minutes and does not exceed the expiration time of the underlying temporary credentials. Retrieve a new URL after it expires. The example URL is desensitized and cannot be used for actual uploads. Use the original URL and request headers from this response.
3027
+ *
3028
+ * @param request - GetAgentCodePackageUploadUrlRequest
3029
+ * @returns GetAgentCodePackageUploadUrlResponse
3030
+ */
3031
+ async getAgentCodePackageUploadUrl(workspaceId: string, request: $_model.GetAgentCodePackageUploadUrlRequest): Promise<$_model.GetAgentCodePackageUploadUrlResponse> {
3032
+ let runtime = new $dara.RuntimeOptions({ });
3033
+ let headers : {[key: string ]: string} = { };
3034
+ return await this.getAgentCodePackageUploadUrlWithOptions(workspaceId, request, headers, runtime);
3035
+ }
3036
+
2537
3037
  /**
2538
3038
  * Queries the details of a specified agent IM channel.
2539
3039
  *
@@ -2822,8 +3322,8 @@ export default class Client extends OpenApi {
2822
3322
  * Queries the details of a custom agent in a specified workspace, including deployment configurations, the execute status of the latest configuration version, and the running instance status statistics.
2823
3323
  *
2824
3324
  * @remarks
2825
- * After you create or update a custom agent, you can poll this operation to query the execution result of the latest configuration version. `latestVersionStatus` corresponds to `latestSpecVersion`. `latestExecutionError` indicates the cause of the pending or failed status for this version. If `retryable` is true, you can query again later.
2826
- * The returned configuration is the most recently submitted configuration and may not have taken effect. Verify the deployment and running status by checking `latestVersionStatus`, the overall agent status `status`, and the running instance statistics `sandboxPhaseCounts`.
3325
+ * After creating or updating a custom agent, you can poll this operation to query the execution result of the latest configuration version. latestVersionStatus corresponds to latestSpecVersion. latestExecutionError indicates the cause of the pending or failed status for this version. If retryable is true, you can query again later.
3326
+ * The returned configuration is the latest submitted configuration and may not have taken effect. Verify the deployment and running status by checking latestVersionStatus, the overall agent status, and the running instance statistics sandboxPhaseCounts.
2827
3327
  * If the queried custom agent does not exist, has been deleted, or does not belong to the specified workspace, a resource not found error is returned.
2828
3328
  *
2829
3329
  * @param request - GetCustomAgentRequest
@@ -2854,8 +3354,8 @@ export default class Client extends OpenApi {
2854
3354
  * Queries the details of a custom agent in a specified workspace, including deployment configurations, the execute status of the latest configuration version, and the running instance status statistics.
2855
3355
  *
2856
3356
  * @remarks
2857
- * After you create or update a custom agent, you can poll this operation to query the execution result of the latest configuration version. `latestVersionStatus` corresponds to `latestSpecVersion`. `latestExecutionError` indicates the cause of the pending or failed status for this version. If `retryable` is true, you can query again later.
2858
- * The returned configuration is the most recently submitted configuration and may not have taken effect. Verify the deployment and running status by checking `latestVersionStatus`, the overall agent status `status`, and the running instance statistics `sandboxPhaseCounts`.
3357
+ * After creating or updating a custom agent, you can poll this operation to query the execution result of the latest configuration version. latestVersionStatus corresponds to latestSpecVersion. latestExecutionError indicates the cause of the pending or failed status for this version. If retryable is true, you can query again later.
3358
+ * The returned configuration is the latest submitted configuration and may not have taken effect. Verify the deployment and running status by checking latestVersionStatus, the overall agent status, and the running instance statistics sandboxPhaseCounts.
2859
3359
  * If the queried custom agent does not exist, has been deleted, or does not belong to the specified workspace, a resource not found error is returned.
2860
3360
  *
2861
3361
  * @param request - GetCustomAgentRequest
@@ -2958,42 +3458,438 @@ export default class Client extends OpenApi {
2958
3458
  }
2959
3459
 
2960
3460
  /**
2961
- * Queries the binding details of the external identity provider for a specified workspace, including the binding status, application configurations, and callback URLs to be configured on the identity provider side. Application secret configurations are not returned.
3461
+ * 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.
3462
+ *
3463
+ * @remarks
3464
+ * ## Features and prerequisites
3465
+ * 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.
3466
+ * 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.
3467
+ * ## Request and examples
3468
+ * GET /workspaces/{workspaceId}/identity-providers/{identityProviderType}
3469
+ * 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.
3470
+ * ```text
3471
+ * GET /workspaces/ws-example/identity-providers/CustomSSO
3472
+ * ```
3473
+ * ## Response examples
3474
+ * ```json
3475
+ * {
3476
+ * "data": {
3477
+ * "workspaceId": "ws-example",
3478
+ * "identityProviderType": "CustomSSO",
3479
+ * "status": "READY",
3480
+ * "loginEnabled": false,
3481
+ * "syncEnabled": false
3482
+ * }
3483
+ * }
3484
+ * ```
3485
+ * ## Errors and handling
3486
+ * 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.
3487
+ * 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.
3488
+ * ## Call relationships and usage boundaries
3489
+ * 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.
3490
+ *
3491
+ * @param request - GetIdentityProviderRequest
3492
+ * @param headers - map
3493
+ * @param runtime - runtime options for this request RuntimeOptions
3494
+ * @returns GetIdentityProviderResponse
3495
+ */
3496
+ async getIdentityProviderWithOptions(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderResponse> {
3497
+ request.validate();
3498
+ let req = new $OpenApiUtil.OpenApiRequest({
3499
+ headers: headers,
3500
+ });
3501
+ let params = new $OpenApiUtil.Params({
3502
+ action: "GetIdentityProvider",
3503
+ version: "2026-08-04",
3504
+ protocol: "HTTPS",
3505
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}`,
3506
+ method: "GET",
3507
+ authType: "AK",
3508
+ style: "ROA",
3509
+ reqBodyType: "json",
3510
+ bodyType: "json",
3511
+ });
3512
+ return $dara.cast<$_model.GetIdentityProviderResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderResponse({}));
3513
+ }
3514
+
3515
+ /**
3516
+ * 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.
3517
+ *
3518
+ * @remarks
3519
+ * ## Features and prerequisites
3520
+ * 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.
3521
+ * 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.
3522
+ * ## Request and examples
3523
+ * GET /workspaces/{workspaceId}/identity-providers/{identityProviderType}
3524
+ * 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.
3525
+ * ```text
3526
+ * GET /workspaces/ws-example/identity-providers/CustomSSO
3527
+ * ```
3528
+ * ## Response examples
3529
+ * ```json
3530
+ * {
3531
+ * "data": {
3532
+ * "workspaceId": "ws-example",
3533
+ * "identityProviderType": "CustomSSO",
3534
+ * "status": "READY",
3535
+ * "loginEnabled": false,
3536
+ * "syncEnabled": false
3537
+ * }
3538
+ * }
3539
+ * ```
3540
+ * ## Errors and handling
3541
+ * 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.
3542
+ * 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.
3543
+ * ## Call relationships and usage boundaries
3544
+ * 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.
2962
3545
  *
2963
3546
  * @param request - GetIdentityProviderRequest
3547
+ * @returns GetIdentityProviderResponse
3548
+ */
3549
+ async getIdentityProvider(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderRequest): Promise<$_model.GetIdentityProviderResponse> {
3550
+ let runtime = new $dara.RuntimeOptions({ });
3551
+ let headers : {[key: string ]: string} = { };
3552
+ return await this.getIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
3553
+ }
3554
+
3555
+ /**
3556
+ * 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.
3557
+ *
3558
+ * @remarks
3559
+ * ## Features and prerequisites
3560
+ * 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.
3561
+ * 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.
3562
+ * ## Requests and examples
3563
+ * GET /workspaces/{workspaceId}/scim-provisioning
3564
+ * 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.
3565
+ * ```text
3566
+ * GET /workspaces/ws-example/scim-provisioning
3567
+ * ```
3568
+ * ## Response example
3569
+ * ```json
3570
+ * {
3571
+ * "data": {
3572
+ * "configuration": {
3573
+ * "status": "Enabled",
3574
+ * "baseUrl": "https://example.com/scim/v2"
3575
+ * },
3576
+ * "syncEnabled": true,
3577
+ * "operationStatus": "SUCCESS"
3578
+ * }
3579
+ * }
3580
+ * ```
3581
+ * ## Errors and handling
3582
+ * 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.
3583
+ * 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.
3584
+ * ## Call relationships and usage boundaries
3585
+ * 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.
3586
+ *
3587
+ * @param request - GetIdentityProviderSCIMRequest
3588
+ * @param headers - map
3589
+ * @param runtime - runtime options for this request RuntimeOptions
3590
+ * @returns GetIdentityProviderSCIMResponse
3591
+ */
3592
+ async getIdentityProviderSCIMWithOptions(workspaceId: string, request: $_model.GetIdentityProviderSCIMRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderSCIMResponse> {
3593
+ request.validate();
3594
+ let req = new $OpenApiUtil.OpenApiRequest({
3595
+ headers: headers,
3596
+ });
3597
+ let params = new $OpenApiUtil.Params({
3598
+ action: "GetIdentityProviderSCIM",
3599
+ version: "2026-08-04",
3600
+ protocol: "HTTPS",
3601
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning`,
3602
+ method: "GET",
3603
+ authType: "AK",
3604
+ style: "ROA",
3605
+ reqBodyType: "json",
3606
+ bodyType: "json",
3607
+ });
3608
+ return $dara.cast<$_model.GetIdentityProviderSCIMResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderSCIMResponse({}));
3609
+ }
3610
+
3611
+ /**
3612
+ * 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.
3613
+ *
3614
+ * @remarks
3615
+ * ## Features and prerequisites
3616
+ * 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.
3617
+ * 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.
3618
+ * ## Requests and examples
3619
+ * GET /workspaces/{workspaceId}/scim-provisioning
3620
+ * 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.
3621
+ * ```text
3622
+ * GET /workspaces/ws-example/scim-provisioning
3623
+ * ```
3624
+ * ## Response example
3625
+ * ```json
3626
+ * {
3627
+ * "data": {
3628
+ * "configuration": {
3629
+ * "status": "Enabled",
3630
+ * "baseUrl": "https://example.com/scim/v2"
3631
+ * },
3632
+ * "syncEnabled": true,
3633
+ * "operationStatus": "SUCCESS"
3634
+ * }
3635
+ * }
3636
+ * ```
3637
+ * ## Errors and handling
3638
+ * 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.
3639
+ * 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.
3640
+ * ## Call relationships and usage boundaries
3641
+ * 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.
3642
+ *
3643
+ * @param request - GetIdentityProviderSCIMRequest
3644
+ * @returns GetIdentityProviderSCIMResponse
3645
+ */
3646
+ async getIdentityProviderSCIM(workspaceId: string, request: $_model.GetIdentityProviderSCIMRequest): Promise<$_model.GetIdentityProviderSCIMResponse> {
3647
+ let runtime = new $dara.RuntimeOptions({ });
3648
+ let headers : {[key: string ]: string} = { };
3649
+ return await this.getIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
3650
+ }
3651
+
3652
+ /**
3653
+ * 查询 SAML 服务提供商信息
3654
+ *
3655
+ * @remarks
3656
+ * ## 功能与前提\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 配置或验证登录。
3657
+ *
3658
+ * @param request - GetIdentityProviderServiceProviderRequest
3659
+ * @param headers - map
3660
+ * @param runtime - runtime options for this request RuntimeOptions
3661
+ * @returns GetIdentityProviderServiceProviderResponse
3662
+ */
3663
+ async getIdentityProviderServiceProviderWithOptions(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderServiceProviderRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderServiceProviderResponse> {
3664
+ request.validate();
3665
+ let query : {[key: string ]: any} = { };
3666
+ if (!$dara.isNull(request.protocol)) {
3667
+ query["protocol"] = request.protocol;
3668
+ }
3669
+
3670
+ let req = new $OpenApiUtil.OpenApiRequest({
3671
+ headers: headers,
3672
+ query: OpenApiUtil.query(query),
3673
+ });
3674
+ let params = new $OpenApiUtil.Params({
3675
+ action: "GetIdentityProviderServiceProvider",
3676
+ version: "2026-08-04",
3677
+ protocol: "HTTPS",
3678
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/service-provider`,
3679
+ method: "GET",
3680
+ authType: "AK",
3681
+ style: "ROA",
3682
+ reqBodyType: "json",
3683
+ bodyType: "json",
3684
+ });
3685
+ return $dara.cast<$_model.GetIdentityProviderServiceProviderResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderServiceProviderResponse({}));
3686
+ }
3687
+
3688
+ /**
3689
+ * 查询 SAML 服务提供商信息
3690
+ *
3691
+ * @remarks
3692
+ * ## 功能与前提\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 配置或验证登录。
3693
+ *
3694
+ * @param request - GetIdentityProviderServiceProviderRequest
3695
+ * @returns GetIdentityProviderServiceProviderResponse
3696
+ */
3697
+ async getIdentityProviderServiceProvider(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderServiceProviderRequest): Promise<$_model.GetIdentityProviderServiceProviderResponse> {
3698
+ let runtime = new $dara.RuntimeOptions({ });
3699
+ let headers : {[key: string ]: string} = { };
3700
+ return await this.getIdentityProviderServiceProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
3701
+ }
3702
+
3703
+ /**
3704
+ * Queries an identity provider synchronization task.
3705
+ *
3706
+ * @remarks
3707
+ * Queries the status, current step, number of processed users, and failure cause of a manual synchronization task by using the local taskId of AgentCore. The taskId must be obtained from CreateIdentityProviderSyncJob in the same workspace and identity provider. It is not the synchronizationJobId of AgentIdentity. Poll the task until the status is SUCCESS, FAILED, or CANCELED. The PENDING, RUNNING, and PAUSED statuses do not indicate completion. The syncedUserCount includes updated existing users and does not equal the number of newly added users or the progress percentage.
3708
+ * Authorization information: The RAM operation is agentcore:GetIdentityProviderSyncJob, the access level is Read, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is a required authorization resource.
3709
+ * Idempotence and retry: This operation is read-only and can be repeatedly queried.
3710
+ * Calling this API operation is free of charge, and operation records support ActionTrail auditing.
3711
+ * Response example:
3712
+ * ```json
3713
+ * {
3714
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
3715
+ * "message": "success",
3716
+ * "httpStatusCode": 200,
3717
+ * "code": "SUCCESS",
3718
+ * "success": true,
3719
+ * "data": {
3720
+ * "taskId": "12345678-1234-4234-8234-123456789abc",
3721
+ * "status": "SUCCESS",
3722
+ * "currentStep": "SYNC",
3723
+ * "synchronizationJobId": "syncjob_0123456789abcdef0123456789abcdef",
3724
+ * "syncedUserCount": 12
3725
+ * }
3726
+ * }
3727
+ * ```
3728
+ *
3729
+ * @param request - GetIdentityProviderSyncJobRequest
3730
+ * @param headers - map
3731
+ * @param runtime - runtime options for this request RuntimeOptions
3732
+ * @returns GetIdentityProviderSyncJobResponse
3733
+ */
3734
+ async getIdentityProviderSyncJobWithOptions(workspaceId: string, identityProviderType: string, taskId: string, request: $_model.GetIdentityProviderSyncJobRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderSyncJobResponse> {
3735
+ request.validate();
3736
+ let req = new $OpenApiUtil.OpenApiRequest({
3737
+ headers: headers,
3738
+ });
3739
+ let params = new $OpenApiUtil.Params({
3740
+ action: "GetIdentityProviderSyncJob",
3741
+ version: "2026-08-04",
3742
+ protocol: "HTTPS",
3743
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/sync-jobs/${$dara.URL.percentEncode(taskId)}`,
3744
+ method: "GET",
3745
+ authType: "AK",
3746
+ style: "ROA",
3747
+ reqBodyType: "json",
3748
+ bodyType: "json",
3749
+ });
3750
+ return $dara.cast<$_model.GetIdentityProviderSyncJobResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderSyncJobResponse({}));
3751
+ }
3752
+
3753
+ /**
3754
+ * Queries an identity provider synchronization task.
3755
+ *
3756
+ * @remarks
3757
+ * Queries the status, current step, number of processed users, and failure cause of a manual synchronization task by using the local taskId of AgentCore. The taskId must be obtained from CreateIdentityProviderSyncJob in the same workspace and identity provider. It is not the synchronizationJobId of AgentIdentity. Poll the task until the status is SUCCESS, FAILED, or CANCELED. The PENDING, RUNNING, and PAUSED statuses do not indicate completion. The syncedUserCount includes updated existing users and does not equal the number of newly added users or the progress percentage.
3758
+ * Authorization information: The RAM operation is agentcore:GetIdentityProviderSyncJob, the access level is Read, and the resource ARN is acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is a required authorization resource.
3759
+ * Idempotence and retry: This operation is read-only and can be repeatedly queried.
3760
+ * Calling this API operation is free of charge, and operation records support ActionTrail auditing.
3761
+ * Response example:
3762
+ * ```json
3763
+ * {
3764
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
3765
+ * "message": "success",
3766
+ * "httpStatusCode": 200,
3767
+ * "code": "SUCCESS",
3768
+ * "success": true,
3769
+ * "data": {
3770
+ * "taskId": "12345678-1234-4234-8234-123456789abc",
3771
+ * "status": "SUCCESS",
3772
+ * "currentStep": "SYNC",
3773
+ * "synchronizationJobId": "syncjob_0123456789abcdef0123456789abcdef",
3774
+ * "syncedUserCount": 12
3775
+ * }
3776
+ * }
3777
+ * ```
3778
+ *
3779
+ * @param request - GetIdentityProviderSyncJobRequest
3780
+ * @returns GetIdentityProviderSyncJobResponse
3781
+ */
3782
+ async getIdentityProviderSyncJob(workspaceId: string, identityProviderType: string, taskId: string, request: $_model.GetIdentityProviderSyncJobRequest): Promise<$_model.GetIdentityProviderSyncJobResponse> {
3783
+ let runtime = new $dara.RuntimeOptions({ });
3784
+ let headers : {[key: string ]: string} = { };
3785
+ return await this.getIdentityProviderSyncJobWithOptions(workspaceId, identityProviderType, taskId, request, headers, runtime);
3786
+ }
3787
+
3788
+ /**
3789
+ * Queries the synchronization scope of an identity provider.
3790
+ *
3791
+ * @remarks
3792
+ * Queries the saved synchronization scope, the validity of selected departments, and the estimated user count downstream of the identity provider. This operation is not used for real-time estimation of unsaved selections. AllAuthorized indicates the address book scope authorized for the application, which is not equivalent to the entire enterprise organization. An empty selectedDepartments array does not prove that the organization has no sub-departments. The estimation can be used only when estimateStatus is Ready and a count is returned. A missing count does not indicate 0.
3793
+ * Authorization information: RAM operation agentcore:GetIdentityProviderSyncScope, access level Read, resource ARN: acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is a required authorization resource.
3794
+ * Idempotence and retry: This operation is read-only and can be queried repeatedly.
3795
+ * Calling this API operation is free of charge. Operation records support ActionTrail auditing.
3796
+ * Sample response:
3797
+ * ```json
3798
+ * {
3799
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
3800
+ * "message": "success",
3801
+ * "httpStatusCode": 200,
3802
+ * "code": "SUCCESS",
3803
+ * "success": true,
3804
+ * "data": {
3805
+ * "syncScope": {
3806
+ * "mode": "SelectedDepartments",
3807
+ * "departmentIds": [
3808
+ * "10001"
3809
+ * ]
3810
+ * },
3811
+ * "selectedDepartments": [
3812
+ * {
3813
+ * "id": "10001",
3814
+ * "name": "R&D Department",
3815
+ * "exists": true
3816
+ * }
3817
+ * ],
3818
+ * "estimateStatus": "Ready",
3819
+ * "expandedDepartmentCount": 2,
3820
+ * "estimatedUserCount": 12
3821
+ * }
3822
+ * }
3823
+ * ```
3824
+ *
3825
+ * @param request - GetIdentityProviderSyncScopeRequest
2964
3826
  * @param headers - map
2965
3827
  * @param runtime - runtime options for this request RuntimeOptions
2966
- * @returns GetIdentityProviderResponse
3828
+ * @returns GetIdentityProviderSyncScopeResponse
2967
3829
  */
2968
- async getIdentityProviderWithOptions(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderResponse> {
3830
+ async getIdentityProviderSyncScopeWithOptions(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderSyncScopeRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.GetIdentityProviderSyncScopeResponse> {
2969
3831
  request.validate();
2970
3832
  let req = new $OpenApiUtil.OpenApiRequest({
2971
3833
  headers: headers,
2972
3834
  });
2973
3835
  let params = new $OpenApiUtil.Params({
2974
- action: "GetIdentityProvider",
3836
+ action: "GetIdentityProviderSyncScope",
2975
3837
  version: "2026-08-04",
2976
3838
  protocol: "HTTPS",
2977
- pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}`,
3839
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/sync-scope`,
2978
3840
  method: "GET",
2979
3841
  authType: "AK",
2980
3842
  style: "ROA",
2981
3843
  reqBodyType: "json",
2982
3844
  bodyType: "json",
2983
3845
  });
2984
- return $dara.cast<$_model.GetIdentityProviderResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderResponse({}));
3846
+ return $dara.cast<$_model.GetIdentityProviderSyncScopeResponse>(await this.callApi(params, req, runtime), new $_model.GetIdentityProviderSyncScopeResponse({}));
2985
3847
  }
2986
3848
 
2987
3849
  /**
2988
- * Queries the binding details of the external identity provider for a specified workspace, including the binding status, application configurations, and callback URLs to be configured on the identity provider side. Application secret configurations are not returned.
3850
+ * Queries the synchronization scope of an identity provider.
2989
3851
  *
2990
- * @param request - GetIdentityProviderRequest
2991
- * @returns GetIdentityProviderResponse
3852
+ * @remarks
3853
+ * Queries the saved synchronization scope, the validity of selected departments, and the estimated user count downstream of the identity provider. This operation is not used for real-time estimation of unsaved selections. AllAuthorized indicates the address book scope authorized for the application, which is not equivalent to the entire enterprise organization. An empty selectedDepartments array does not prove that the organization has no sub-departments. The estimation can be used only when estimateStatus is Ready and a count is returned. A missing count does not indicate 0.
3854
+ * Authorization information: RAM operation agentcore:GetIdentityProviderSyncScope, access level Read, resource ARN: acs:agentcore:{regionId}:{accountId}:workspace/{workspaceId}/identityProvider/{identityProviderType}. This resource is a required authorization resource.
3855
+ * Idempotence and retry: This operation is read-only and can be queried repeatedly.
3856
+ * Calling this API operation is free of charge. Operation records support ActionTrail auditing.
3857
+ * Sample response:
3858
+ * ```json
3859
+ * {
3860
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
3861
+ * "message": "success",
3862
+ * "httpStatusCode": 200,
3863
+ * "code": "SUCCESS",
3864
+ * "success": true,
3865
+ * "data": {
3866
+ * "syncScope": {
3867
+ * "mode": "SelectedDepartments",
3868
+ * "departmentIds": [
3869
+ * "10001"
3870
+ * ]
3871
+ * },
3872
+ * "selectedDepartments": [
3873
+ * {
3874
+ * "id": "10001",
3875
+ * "name": "R&D Department",
3876
+ * "exists": true
3877
+ * }
3878
+ * ],
3879
+ * "estimateStatus": "Ready",
3880
+ * "expandedDepartmentCount": 2,
3881
+ * "estimatedUserCount": 12
3882
+ * }
3883
+ * }
3884
+ * ```
3885
+ *
3886
+ * @param request - GetIdentityProviderSyncScopeRequest
3887
+ * @returns GetIdentityProviderSyncScopeResponse
2992
3888
  */
2993
- async getIdentityProvider(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderRequest): Promise<$_model.GetIdentityProviderResponse> {
3889
+ async getIdentityProviderSyncScope(workspaceId: string, identityProviderType: string, request: $_model.GetIdentityProviderSyncScopeRequest): Promise<$_model.GetIdentityProviderSyncScopeResponse> {
2994
3890
  let runtime = new $dara.RuntimeOptions({ });
2995
3891
  let headers : {[key: string ]: string} = { };
2996
- return await this.getIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
3892
+ return await this.getIdentityProviderSyncScopeWithOptions(workspaceId, identityProviderType, request, headers, runtime);
2997
3893
  }
2998
3894
 
2999
3895
  /**
@@ -4048,6 +4944,63 @@ export default class Client extends OpenApi {
4048
4944
  return await this.installWorkspacePluginWithOptions(workspaceId, pluginName, request, headers, runtime);
4049
4945
  }
4050
4946
 
4947
+ /**
4948
+ * Queries the runtime environments supported for code deployment.
4949
+ *
4950
+ * @remarks
4951
+ * Queries the directories in the current workspace that can be used to create code package agents or switch runtime environments. Runtime environments are dynamically provided based on the current version configuration, and internal image addresses are not returned.
4952
+ * If maxResults is omitted or set to 0, the default value is 10. If the value is greater than 100, it is processed as 100. Omit nextToken in the first request. For subsequent requests, use the token returned in the previous response as is, and keep the workspace unchanged. If a directory change invalidates the token, query from the first page again. An empty nextToken indicates that there are no more pages. Existing agents continue to use the saved images for restarts, scaling, and regular updates.
4953
+ *
4954
+ * @param request - ListAgentCodeRuntimesRequest
4955
+ * @param headers - map
4956
+ * @param runtime - runtime options for this request RuntimeOptions
4957
+ * @returns ListAgentCodeRuntimesResponse
4958
+ */
4959
+ async listAgentCodeRuntimesWithOptions(workspaceId: string, request: $_model.ListAgentCodeRuntimesRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListAgentCodeRuntimesResponse> {
4960
+ request.validate();
4961
+ let query : {[key: string ]: any} = { };
4962
+ if (!$dara.isNull(request.maxResults)) {
4963
+ query["maxResults"] = request.maxResults;
4964
+ }
4965
+
4966
+ if (!$dara.isNull(request.nextToken)) {
4967
+ query["nextToken"] = request.nextToken;
4968
+ }
4969
+
4970
+ let req = new $OpenApiUtil.OpenApiRequest({
4971
+ headers: headers,
4972
+ query: OpenApiUtil.query(query),
4973
+ });
4974
+ let params = new $OpenApiUtil.Params({
4975
+ action: "ListAgentCodeRuntimes",
4976
+ version: "2026-08-04",
4977
+ protocol: "HTTPS",
4978
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agent-code-runtimes`,
4979
+ method: "GET",
4980
+ authType: "AK",
4981
+ style: "ROA",
4982
+ reqBodyType: "json",
4983
+ bodyType: "json",
4984
+ });
4985
+ return $dara.cast<$_model.ListAgentCodeRuntimesResponse>(await this.callApi(params, req, runtime), new $_model.ListAgentCodeRuntimesResponse({}));
4986
+ }
4987
+
4988
+ /**
4989
+ * Queries the runtime environments supported for code deployment.
4990
+ *
4991
+ * @remarks
4992
+ * Queries the directories in the current workspace that can be used to create code package agents or switch runtime environments. Runtime environments are dynamically provided based on the current version configuration, and internal image addresses are not returned.
4993
+ * If maxResults is omitted or set to 0, the default value is 10. If the value is greater than 100, it is processed as 100. Omit nextToken in the first request. For subsequent requests, use the token returned in the previous response as is, and keep the workspace unchanged. If a directory change invalidates the token, query from the first page again. An empty nextToken indicates that there are no more pages. Existing agents continue to use the saved images for restarts, scaling, and regular updates.
4994
+ *
4995
+ * @param request - ListAgentCodeRuntimesRequest
4996
+ * @returns ListAgentCodeRuntimesResponse
4997
+ */
4998
+ async listAgentCodeRuntimes(workspaceId: string, request: $_model.ListAgentCodeRuntimesRequest): Promise<$_model.ListAgentCodeRuntimesResponse> {
4999
+ let runtime = new $dara.RuntimeOptions({ });
5000
+ let headers : {[key: string ]: string} = { };
5001
+ return await this.listAgentCodeRuntimesWithOptions(workspaceId, request, headers, runtime);
5002
+ }
5003
+
4051
5004
  /**
4052
5005
  * Queries the list of IM channels for a specified agent.
4053
5006
  *
@@ -4429,12 +5382,12 @@ export default class Client extends OpenApi {
4429
5382
  }
4430
5383
 
4431
5384
  /**
4432
- * Queries the summaries of custom agents in a specified workspace by using paging. For the complete configuration and the execution results of the latest version, call GetCustomAgent.
5385
+ * Performs a paged query for paging through the custom agent summary in a specified workspace. For the complete configuration and the latest execute results, call GetCustomAgent.
4433
5386
  *
4434
5387
  * @remarks
4435
- * The default value of maxResults is 20, and the maximum value is 100. If this parameter is omitted or set to 0, the default value is used.
4436
- * Omit nextToken in the first request. In subsequent requests, pass the nextToken value returned in the previous response as is, and keep the same workspace. The nextToken is an opaque token. Do not parse or construct it. If the token in the response is empty, it indicates that no more pages are available.
4437
- * This operation returns the summaries of the current page and does not return the complete deployment configuration or the execution errors of the latest version. To obtain this information, call GetCustomAgent by using the agentId in items.
5388
+ * The default value of maxResults is 20 and the maximum value is 100. If this parameter is omitted or set to 0, the default value is used.
5389
+ * Omit nextToken in the first request. For subsequent requests, pass the nextToken returned in the previous response as is and keep the same workspace. The nextToken is an opaque token. Do not parse or construct it. An empty token in the response indicates that there are no more pages.
5390
+ * This operation returns the summaries of the current page and does not return the complete deployment configurations or the execution errors of the latest version. To obtain this information, call GetCustomAgent by using the agentId in items.
4438
5391
  *
4439
5392
  * @param request - ListCustomAgentsRequest
4440
5393
  * @param headers - map
@@ -4471,12 +5424,12 @@ export default class Client extends OpenApi {
4471
5424
  }
4472
5425
 
4473
5426
  /**
4474
- * Queries the summaries of custom agents in a specified workspace by using paging. For the complete configuration and the execution results of the latest version, call GetCustomAgent.
5427
+ * Performs a paged query for paging through the custom agent summary in a specified workspace. For the complete configuration and the latest execute results, call GetCustomAgent.
4475
5428
  *
4476
5429
  * @remarks
4477
- * The default value of maxResults is 20, and the maximum value is 100. If this parameter is omitted or set to 0, the default value is used.
4478
- * Omit nextToken in the first request. In subsequent requests, pass the nextToken value returned in the previous response as is, and keep the same workspace. The nextToken is an opaque token. Do not parse or construct it. If the token in the response is empty, it indicates that no more pages are available.
4479
- * This operation returns the summaries of the current page and does not return the complete deployment configuration or the execution errors of the latest version. To obtain this information, call GetCustomAgent by using the agentId in items.
5430
+ * The default value of maxResults is 20 and the maximum value is 100. If this parameter is omitted or set to 0, the default value is used.
5431
+ * Omit nextToken in the first request. For subsequent requests, pass the nextToken returned in the previous response as is and keep the same workspace. The nextToken is an opaque token. Do not parse or construct it. An empty token in the response indicates that there are no more pages.
5432
+ * This operation returns the summaries of the current page and does not return the complete deployment configurations or the execution errors of the latest version. To obtain this information, call GetCustomAgent by using the agentId in items.
4480
5433
  *
4481
5434
  * @param request - ListCustomAgentsRequest
4482
5435
  * @returns ListCustomAgentsResponse
@@ -4543,7 +5496,243 @@ export default class Client extends OpenApi {
4543
5496
  }
4544
5497
 
4545
5498
  /**
4546
- * 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.
5499
+ * Queries the departments of an identity provider by page.
5500
+ *
5501
+ * @remarks
5502
+ * 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.
5503
+ * 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.
5504
+ * Idempotence and retry: This operation is read-only and can be invoked repeatedly.
5505
+ * It is free of charge to invoke this API operation, and operation records support ActionTrail auditing.
5506
+ * Sample response:
5507
+ * ```json
5508
+ * {
5509
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
5510
+ * "message": "success",
5511
+ * "httpStatusCode": 200,
5512
+ * "code": "SUCCESS",
5513
+ * "success": true,
5514
+ * "maxResults": 50,
5515
+ * "nextToken": "",
5516
+ * "items": [
5517
+ * {
5518
+ * "id": "10001",
5519
+ * "name": "R&D Department",
5520
+ * "parentId": "1",
5521
+ * "memberCount": 12,
5522
+ * "hasChildren": true
5523
+ * }
5524
+ * ]
5525
+ * }
5526
+ * ```
5527
+ *
5528
+ * @param request - ListIdentityProviderDepartmentsRequest
5529
+ * @param headers - map
5530
+ * @param runtime - runtime options for this request RuntimeOptions
5531
+ * @returns ListIdentityProviderDepartmentsResponse
5532
+ */
5533
+ async listIdentityProviderDepartmentsWithOptions(workspaceId: string, identityProviderType: string, request: $_model.ListIdentityProviderDepartmentsRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListIdentityProviderDepartmentsResponse> {
5534
+ request.validate();
5535
+ let query : {[key: string ]: any} = { };
5536
+ if (!$dara.isNull(request.maxResults)) {
5537
+ query["maxResults"] = request.maxResults;
5538
+ }
5539
+
5540
+ if (!$dara.isNull(request.nextToken)) {
5541
+ query["nextToken"] = request.nextToken;
5542
+ }
5543
+
5544
+ if (!$dara.isNull(request.parentDepartmentId)) {
5545
+ query["parentDepartmentId"] = request.parentDepartmentId;
5546
+ }
5547
+
5548
+ let req = new $OpenApiUtil.OpenApiRequest({
5549
+ headers: headers,
5550
+ query: OpenApiUtil.query(query),
5551
+ });
5552
+ let params = new $OpenApiUtil.Params({
5553
+ action: "ListIdentityProviderDepartments",
5554
+ version: "2026-08-04",
5555
+ protocol: "HTTPS",
5556
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/identity-providers/${$dara.URL.percentEncode(identityProviderType)}/departments`,
5557
+ method: "GET",
5558
+ authType: "AK",
5559
+ style: "ROA",
5560
+ reqBodyType: "json",
5561
+ bodyType: "json",
5562
+ });
5563
+ return $dara.cast<$_model.ListIdentityProviderDepartmentsResponse>(await this.callApi(params, req, runtime), new $_model.ListIdentityProviderDepartmentsResponse({}));
5564
+ }
5565
+
5566
+ /**
5567
+ * Queries the departments of an identity provider by page.
5568
+ *
5569
+ * @remarks
5570
+ * 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.
5571
+ * 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.
5572
+ * Idempotence and retry: This operation is read-only and can be invoked repeatedly.
5573
+ * It is free of charge to invoke this API operation, and operation records support ActionTrail auditing.
5574
+ * Sample response:
5575
+ * ```json
5576
+ * {
5577
+ * "requestId": "01234567-89AB-CDEF-0123-456789ABCDEF",
5578
+ * "message": "success",
5579
+ * "httpStatusCode": 200,
5580
+ * "code": "SUCCESS",
5581
+ * "success": true,
5582
+ * "maxResults": 50,
5583
+ * "nextToken": "",
5584
+ * "items": [
5585
+ * {
5586
+ * "id": "10001",
5587
+ * "name": "R&D Department",
5588
+ * "parentId": "1",
5589
+ * "memberCount": 12,
5590
+ * "hasChildren": true
5591
+ * }
5592
+ * ]
5593
+ * }
5594
+ * ```
5595
+ *
5596
+ * @param request - ListIdentityProviderDepartmentsRequest
5597
+ * @returns ListIdentityProviderDepartmentsResponse
5598
+ */
5599
+ async listIdentityProviderDepartments(workspaceId: string, identityProviderType: string, request: $_model.ListIdentityProviderDepartmentsRequest): Promise<$_model.ListIdentityProviderDepartmentsResponse> {
5600
+ let runtime = new $dara.RuntimeOptions({ });
5601
+ let headers : {[key: string ]: string} = { };
5602
+ return await this.listIdentityProviderDepartmentsWithOptions(workspaceId, identityProviderType, request, headers, runtime);
5603
+ }
5604
+
5605
+ /**
5606
+ * Queries the complete summary list of up to two SCIM credentials in the shared user pool, without returning plaintext tokens or supporting pagination.
5607
+ *
5608
+ * @remarks
5609
+ * ## Features and prerequisites
5610
+ * 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.
5611
+ * 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.
5612
+ * ## Requests and examples
5613
+ * GET /workspaces/{workspaceId}/scim-provisioning/credentials
5614
+ * 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.
5615
+ * ```text
5616
+ * GET /workspaces/ws-example/scim-provisioning/credentials
5617
+ * ```
5618
+ * ## Response examples
5619
+ * ```json
5620
+ * {
5621
+ * "data": [
5622
+ * {
5623
+ * "credentialId": "credential-example",
5624
+ * "status": "Enabled",
5625
+ * "createTime": "<Upstream creation time>",
5626
+ * "expireTime": "<Upstream expiration time>"
5627
+ * }
5628
+ * ]
5629
+ * }
5630
+ * ```
5631
+ * ## Errors and handling
5632
+ * 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.
5633
+ * 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.
5634
+ * ## Call relationships and usage boundaries
5635
+ * 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.
5636
+ *
5637
+ * @param request - ListIdentityProviderSCIMCredentialsRequest
5638
+ * @param headers - map
5639
+ * @param runtime - runtime options for this request RuntimeOptions
5640
+ * @returns ListIdentityProviderSCIMCredentialsResponse
5641
+ */
5642
+ async listIdentityProviderSCIMCredentialsWithOptions(workspaceId: string, request: $_model.ListIdentityProviderSCIMCredentialsRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ListIdentityProviderSCIMCredentialsResponse> {
5643
+ request.validate();
5644
+ let req = new $OpenApiUtil.OpenApiRequest({
5645
+ headers: headers,
5646
+ });
5647
+ let params = new $OpenApiUtil.Params({
5648
+ action: "ListIdentityProviderSCIMCredentials",
5649
+ version: "2026-08-04",
5650
+ protocol: "HTTPS",
5651
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/credentials`,
5652
+ method: "GET",
5653
+ authType: "AK",
5654
+ style: "ROA",
5655
+ reqBodyType: "json",
5656
+ bodyType: "json",
5657
+ });
5658
+ return $dara.cast<$_model.ListIdentityProviderSCIMCredentialsResponse>(await this.callApi(params, req, runtime), new $_model.ListIdentityProviderSCIMCredentialsResponse({}));
5659
+ }
5660
+
5661
+ /**
5662
+ * Queries the complete summary list of up to two SCIM credentials in the shared user pool, without returning plaintext tokens or supporting pagination.
5663
+ *
5664
+ * @remarks
5665
+ * ## Features and prerequisites
5666
+ * 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.
5667
+ * 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.
5668
+ * ## Requests and examples
5669
+ * GET /workspaces/{workspaceId}/scim-provisioning/credentials
5670
+ * 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.
5671
+ * ```text
5672
+ * GET /workspaces/ws-example/scim-provisioning/credentials
5673
+ * ```
5674
+ * ## Response examples
5675
+ * ```json
5676
+ * {
5677
+ * "data": [
5678
+ * {
5679
+ * "credentialId": "credential-example",
5680
+ * "status": "Enabled",
5681
+ * "createTime": "<Upstream creation time>",
5682
+ * "expireTime": "<Upstream expiration time>"
5683
+ * }
5684
+ * ]
5685
+ * }
5686
+ * ```
5687
+ * ## Errors and handling
5688
+ * 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.
5689
+ * 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.
5690
+ * ## Call relationships and usage boundaries
5691
+ * 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.
5692
+ *
5693
+ * @param request - ListIdentityProviderSCIMCredentialsRequest
5694
+ * @returns ListIdentityProviderSCIMCredentialsResponse
5695
+ */
5696
+ async listIdentityProviderSCIMCredentials(workspaceId: string, request: $_model.ListIdentityProviderSCIMCredentialsRequest): Promise<$_model.ListIdentityProviderSCIMCredentialsResponse> {
5697
+ let runtime = new $dara.RuntimeOptions({ });
5698
+ let headers : {[key: string ]: string} = { };
5699
+ return await this.listIdentityProviderSCIMCredentialsWithOptions(workspaceId, request, headers, runtime);
5700
+ }
5701
+
5702
+ /**
5703
+ * 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.
5704
+ *
5705
+ * @remarks
5706
+ * ## Features and prerequisites
5707
+ * 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.
5708
+ * 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.
5709
+ * ## Requests and examples
5710
+ * GET /workspaces/{workspaceId}/identity-providers
5711
+ * 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.
5712
+ * ```text
5713
+ * GET /workspaces/ws-example/identity-providers?maxResults=10
5714
+ * ```
5715
+ * ## Response example
5716
+ * ```json
5717
+ * {
5718
+ * "items": [
5719
+ * {
5720
+ * "workspaceId": "ws-example",
5721
+ * "identityProviderType": "CustomSSO",
5722
+ * "status": "READY",
5723
+ * "loginEnabled": false,
5724
+ * "syncEnabled": false
5725
+ * }
5726
+ * ],
5727
+ * "maxResults": 10,
5728
+ * "totalCount": 1
5729
+ * }
5730
+ * ```
5731
+ * ## Errors and handling
5732
+ * 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.
5733
+ * 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.
5734
+ * ## Call relationships and usage boundaries
5735
+ * 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.
4547
5736
  *
4548
5737
  * @param request - ListIdentityProvidersRequest
4549
5738
  * @param headers - map
@@ -4580,7 +5769,39 @@ export default class Client extends OpenApi {
4580
5769
  }
4581
5770
 
4582
5771
  /**
4583
- * 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.
5772
+ * 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.
5773
+ *
5774
+ * @remarks
5775
+ * ## Features and prerequisites
5776
+ * 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.
5777
+ * 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.
5778
+ * ## Requests and examples
5779
+ * GET /workspaces/{workspaceId}/identity-providers
5780
+ * 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.
5781
+ * ```text
5782
+ * GET /workspaces/ws-example/identity-providers?maxResults=10
5783
+ * ```
5784
+ * ## Response example
5785
+ * ```json
5786
+ * {
5787
+ * "items": [
5788
+ * {
5789
+ * "workspaceId": "ws-example",
5790
+ * "identityProviderType": "CustomSSO",
5791
+ * "status": "READY",
5792
+ * "loginEnabled": false,
5793
+ * "syncEnabled": false
5794
+ * }
5795
+ * ],
5796
+ * "maxResults": 10,
5797
+ * "totalCount": 1
5798
+ * }
5799
+ * ```
5800
+ * ## Errors and handling
5801
+ * 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.
5802
+ * 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.
5803
+ * ## Call relationships and usage boundaries
5804
+ * 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.
4584
5805
  *
4585
5806
  * @param request - ListIdentityProvidersRequest
4586
5807
  * @returns ListIdentityProvidersResponse
@@ -4943,10 +6164,10 @@ export default class Client extends OpenApi {
4943
6164
  }
4944
6165
 
4945
6166
  /**
4946
- * Performs a paged query on long-term memory. Paging is supported, and you can filter the results independently by user ID, agent ID, and session ID.
6167
+ * Performs a paged query on long-term memory records. The results can be filtered independently by user ID, agent ID, and session ID. Paging is supported.
4947
6168
  *
4948
6169
  * @remarks
4949
- * Performs a paged query on long-term memory. Paging is supported, and you can filter the results independently by user ID, agent ID, and session ID.
6170
+ * Performs a paged query on long-term memory records. The results can be filtered independently by user ID, agent ID, and session ID. Paging is supported.
4950
6171
  *
4951
6172
  * @param request - ListMemoriesRequest
4952
6173
  * @param headers - map
@@ -4995,10 +6216,10 @@ export default class Client extends OpenApi {
4995
6216
  }
4996
6217
 
4997
6218
  /**
4998
- * Performs a paged query on long-term memory. Paging is supported, and you can filter the results independently by user ID, agent ID, and session ID.
6219
+ * Performs a paged query on long-term memory records. The results can be filtered independently by user ID, agent ID, and session ID. Paging is supported.
4999
6220
  *
5000
6221
  * @remarks
5001
- * Performs a paged query on long-term memory. Paging is supported, and you can filter the results independently by user ID, agent ID, and session ID.
6222
+ * Performs a paged query on long-term memory records. The results can be filtered independently by user ID, agent ID, and session ID. Paging is supported.
5002
6223
  *
5003
6224
  * @param request - ListMemoriesRequest
5004
6225
  * @returns ListMemoriesResponse
@@ -5010,10 +6231,10 @@ export default class Client extends OpenApi {
5010
6231
  }
5011
6232
 
5012
6233
  /**
5013
- * Performs a paged query for raw messages by exact scope with paging. SessionId is required, and at least one of UserId and AgentId must be provided.
6234
+ * Performs a paging query for raw messages by exact scope. SessionId is required, and at least one of UserId and AgentId must be provided.
5014
6235
  *
5015
6236
  * @remarks
5016
- * Performs a paged query for raw messages by exact scope with paging. SessionId is required, and at least one of UserId and AgentId must be provided.
6237
+ * Performs a paging query for raw messages by exact scope. SessionId is required, and at least one of UserId and AgentId must be provided.
5017
6238
  *
5018
6239
  * @param request - ListMemorySessionMessagesRequest
5019
6240
  * @param headers - map
@@ -5062,10 +6283,10 @@ export default class Client extends OpenApi {
5062
6283
  }
5063
6284
 
5064
6285
  /**
5065
- * Performs a paged query for raw messages by exact scope with paging. SessionId is required, and at least one of UserId and AgentId must be provided.
6286
+ * Performs a paging query for raw messages by exact scope. SessionId is required, and at least one of UserId and AgentId must be provided.
5066
6287
  *
5067
6288
  * @remarks
5068
- * Performs a paged query for raw messages by exact scope with paging. SessionId is required, and at least one of UserId and AgentId must be provided.
6289
+ * Performs a paging query for raw messages by exact scope. SessionId is required, and at least one of UserId and AgentId must be provided.
5069
6290
  *
5070
6291
  * @param request - ListMemorySessionMessagesRequest
5071
6292
  * @returns ListMemorySessionMessagesResponse
@@ -5077,10 +6298,10 @@ export default class Client extends OpenApi {
5077
6298
  }
5078
6299
 
5079
6300
  /**
5080
- * Performs a paging query for sessions in a MemoryStore, and allows independent filtering by user ID and agent ID.
6301
+ * Performs a paging query for sessions in a MemoryStore. You can filter the sessions independently by user ID and agent ID.
5081
6302
  *
5082
6303
  * @remarks
5083
- * Performs a paging query for sessions in a MemoryStore, and allows independent filtering by user ID and agent ID.
6304
+ * Performs a paging query for sessions in a MemoryStore. You can filter the sessions independently by user ID and agent ID.
5084
6305
  *
5085
6306
  * @param request - ListMemorySessionsRequest
5086
6307
  * @param headers - map
@@ -5125,10 +6346,10 @@ export default class Client extends OpenApi {
5125
6346
  }
5126
6347
 
5127
6348
  /**
5128
- * Performs a paging query for sessions in a MemoryStore, and allows independent filtering by user ID and agent ID.
6349
+ * Performs a paging query for sessions in a MemoryStore. You can filter the sessions independently by user ID and agent ID.
5129
6350
  *
5130
6351
  * @remarks
5131
- * Performs a paging query for sessions in a MemoryStore, and allows independent filtering by user ID and agent ID.
6352
+ * Performs a paging query for sessions in a MemoryStore. You can filter the sessions independently by user ID and agent ID.
5132
6353
  *
5133
6354
  * @param request - ListMemorySessionsRequest
5134
6355
  * @returns ListMemorySessionsResponse
@@ -5140,10 +6361,10 @@ export default class Client extends OpenApi {
5140
6361
  }
5141
6362
 
5142
6363
  /**
5143
- * Queries MemoryStores in a specified workspace by using paging.
6364
+ * Performs a paged query for MemoryStores in a specified workspace with paging.
5144
6365
  *
5145
6366
  * @remarks
5146
- * Queries MemoryStores in a specified workspace by using paging.
6367
+ * Performs a paged query for MemoryStores in a specified workspace with paging.
5147
6368
  *
5148
6369
  * @param request - ListMemoryStoresRequest
5149
6370
  * @param headers - map
@@ -5180,10 +6401,10 @@ export default class Client extends OpenApi {
5180
6401
  }
5181
6402
 
5182
6403
  /**
5183
- * Queries MemoryStores in a specified workspace by using paging.
6404
+ * Performs a paged query for MemoryStores in a specified workspace with paging.
5184
6405
  *
5185
6406
  * @remarks
5186
- * Queries MemoryStores in a specified workspace by using paging.
6407
+ * Performs a paged query for MemoryStores in a specified workspace with paging.
5187
6408
  *
5188
6409
  * @param request - ListMemoryStoresRequest
5189
6410
  * @returns ListMemoryStoresResponse
@@ -6093,6 +7314,113 @@ export default class Client extends OpenApi {
6093
7314
  return await this.precheckSkillUploadViaOssWithOptions(workspaceId, request, headers, runtime);
6094
7315
  }
6095
7316
 
7317
+ /**
7318
+ * 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.
7319
+ *
7320
+ * @remarks
7321
+ * ## Features and prerequisites
7322
+ * 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.
7323
+ * 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.
7324
+ * ## Requests and examples
7325
+ * POST /workspaces/{workspaceId}/scim-provisioning/prepare
7326
+ * 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.
7327
+ * ```text
7328
+ * POST /workspaces/ws-example/scim-provisioning/prepare
7329
+ * No business request body.
7330
+ * ```
7331
+ * ## Response examples
7332
+ * ```json
7333
+ * {
7334
+ * "data": {
7335
+ * "configuration": {
7336
+ * "status": "Enabled",
7337
+ * "baseUrl": "https://example.com/scim/v2"
7338
+ * },
7339
+ * "credential": {
7340
+ * "credentialId": "credential-example",
7341
+ * "status": "Enabled",
7342
+ * "expireTime": "<Expiration time returned by the upstream service>"
7343
+ * },
7344
+ * "token": "<Token issued only in the current response; null if an available credential already exists>"
7345
+ * }
7346
+ * }
7347
+ * ```
7348
+ * ## Errors and handling
7349
+ * 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.
7350
+ * 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.
7351
+ * ## Call relationships and usage boundaries
7352
+ * 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.
7353
+ *
7354
+ * @param request - PrepareIdentityProviderSCIMRequest
7355
+ * @param headers - map
7356
+ * @param runtime - runtime options for this request RuntimeOptions
7357
+ * @returns PrepareIdentityProviderSCIMResponse
7358
+ */
7359
+ async prepareIdentityProviderSCIMWithOptions(workspaceId: string, request: $_model.PrepareIdentityProviderSCIMRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.PrepareIdentityProviderSCIMResponse> {
7360
+ request.validate();
7361
+ let req = new $OpenApiUtil.OpenApiRequest({
7362
+ headers: headers,
7363
+ });
7364
+ let params = new $OpenApiUtil.Params({
7365
+ action: "PrepareIdentityProviderSCIM",
7366
+ version: "2026-08-04",
7367
+ protocol: "HTTPS",
7368
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning/prepare`,
7369
+ method: "POST",
7370
+ authType: "AK",
7371
+ style: "ROA",
7372
+ reqBodyType: "json",
7373
+ bodyType: "json",
7374
+ });
7375
+ return $dara.cast<$_model.PrepareIdentityProviderSCIMResponse>(await this.callApi(params, req, runtime), new $_model.PrepareIdentityProviderSCIMResponse({}));
7376
+ }
7377
+
7378
+ /**
7379
+ * 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.
7380
+ *
7381
+ * @remarks
7382
+ * ## Features and prerequisites
7383
+ * 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.
7384
+ * 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.
7385
+ * ## Requests and examples
7386
+ * POST /workspaces/{workspaceId}/scim-provisioning/prepare
7387
+ * 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.
7388
+ * ```text
7389
+ * POST /workspaces/ws-example/scim-provisioning/prepare
7390
+ * No business request body.
7391
+ * ```
7392
+ * ## Response examples
7393
+ * ```json
7394
+ * {
7395
+ * "data": {
7396
+ * "configuration": {
7397
+ * "status": "Enabled",
7398
+ * "baseUrl": "https://example.com/scim/v2"
7399
+ * },
7400
+ * "credential": {
7401
+ * "credentialId": "credential-example",
7402
+ * "status": "Enabled",
7403
+ * "expireTime": "<Expiration time returned by the upstream service>"
7404
+ * },
7405
+ * "token": "<Token issued only in the current response; null if an available credential already exists>"
7406
+ * }
7407
+ * }
7408
+ * ```
7409
+ * ## Errors and handling
7410
+ * 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.
7411
+ * 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.
7412
+ * ## Call relationships and usage boundaries
7413
+ * 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.
7414
+ *
7415
+ * @param request - PrepareIdentityProviderSCIMRequest
7416
+ * @returns PrepareIdentityProviderSCIMResponse
7417
+ */
7418
+ async prepareIdentityProviderSCIM(workspaceId: string, request: $_model.PrepareIdentityProviderSCIMRequest): Promise<$_model.PrepareIdentityProviderSCIMResponse> {
7419
+ let runtime = new $dara.RuntimeOptions({ });
7420
+ let headers : {[key: string ]: string} = { };
7421
+ return await this.prepareIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
7422
+ }
7423
+
6096
7424
  /**
6097
7425
  * Publishes a specified Skill version to transition it to the published state.
6098
7426
  *
@@ -6334,10 +7662,10 @@ export default class Client extends OpenApi {
6334
7662
  }
6335
7663
 
6336
7664
  /**
6337
- * Retrieves long-term memory from a MemoryStore based on semantics queries.
7665
+ * Retrieves long-term memory from a MemoryStore based on semantics.
6338
7666
  *
6339
7667
  * @remarks
6340
- * Retrieves long-term memory from a MemoryStore based on semantics queries.
7668
+ * Retrieves long-term memory from a MemoryStore based on semantics.
6341
7669
  *
6342
7670
  * @param tmpReq - SearchMemoriesRequest
6343
7671
  * @param headers - map
@@ -6376,10 +7704,10 @@ export default class Client extends OpenApi {
6376
7704
  }
6377
7705
 
6378
7706
  /**
6379
- * Retrieves long-term memory from a MemoryStore based on semantics queries.
7707
+ * Retrieves long-term memory from a MemoryStore based on semantics.
6380
7708
  *
6381
7709
  * @remarks
6382
- * Retrieves long-term memory from a MemoryStore based on semantics queries.
7710
+ * Retrieves long-term memory from a MemoryStore based on semantics.
6383
7711
  *
6384
7712
  * @param request - SearchMemoriesRequest
6385
7713
  * @returns SearchMemoriesResponse
@@ -6817,10 +8145,12 @@ export default class Client extends OpenApi {
6817
8145
  * Updates the configuration of a specified custom agent in a workspace and executes the update asynchronously. Omitted top-level fields retain their original configurations. You can call the GetCustomAgent operation to query the update result.
6818
8146
  *
6819
8147
  * @remarks
6820
- * Specify at least one top-level field to update. Omitted top-level fields retain their original configurations. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole. Pass an empty array [] to clear a list. The agenticFsMounts field does not accept null. Pass null for the description field to clear the description, and pass null for the healthCheck field to remove the health check.
6821
- * When updating an image, you must specify artifact.port and the type, instanceId, namespace, repo, and tag fields of artifact.container. To retain a custom startup command, also provide the entrypoint field. Currently, only ACR container image deployment is supported. Omit the artifact.code field.
6822
- * When providing the runtime field, both compute and sessionPolicy must be present. If you omit hpa or any of its fields, unspecified elastic configurations use default values. To retain the original elastic configurations, provide them all. When providing the network field, omitted access items are treated as allowed, but actual access is still subject to the workspace network restrictions. To retain the original restrictions, provide both accessInternet and accessVpc. When providing healthCheck, you must specify the port field, and other unspecified items use default values. When providing logging.sls, you must specify both project and logstore.
6823
- * The update is an asynchronous process. A successful response indicates that the request is accepted. You can call the GetCustomAgent operation to query latestSpecVersion, latestVersionStatus, and latestExecutionError, and check the status field to confirm the update result.
8148
+ * Provide at least one top-level field to update. Omitted top-level fields retain their original configurations. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole. Pass an empty array [] to clear a list. The agenticFsMounts field does not accept null. Pass null for the description field to clear the description, and pass null for the healthCheck field to remove the health check.
8149
+ * When updating an image, you must specify artifact.port and the type, instanceId, namespace, repo, and tag fields of artifact.container. To retain a custom startup command, also provide the entrypoint field.
8150
+ * In code package pattern, specify artifact.port and the sourceUri, languageRuntime, and entrypoint fields of artifact.code. Do not specify the container field at the same time. Dependencies must be packaged by the user. ZIP and TAR.GZ formats are supported, and the compressed package size cannot exceed 500,000,000 bytes. Query the runtime environment identity by calling the ListAgentCodeRuntimes operation. The sourceUri field supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including signed URLs. For local files, first call the GetAgentCodePackageUploadUrl operation to obtain an upload URL, upload the file directly, and then commit the returned sourceUri.
8151
+ * When submitting a new code package source, the backend rechecks read permissions, objects, and sizes. The configuration is saved only after the transfer succeeds. If the transfer fails, the current configuration is not saved. Saved fixed packages can be reused. Set the client timeout to 210 seconds for code package requests. Archive integrity and secure decompression are checked at startup. A successful acceptance does not indicate that the agent is ready to run.
8152
+ * When providing the runtime field, the compute and sessionPolicy fields must be provided at the same time. If the hpa field or its subfields are omitted, unspecified elastic configurations use default values. To retain the original elastic configurations, provide them together. When providing the network field, omitted access items are treated as allowed, but actual access is still restricted by the workspace network configurations. To retain the original restrictions, provide both accessInternet and accessVpc. When providing the healthCheck field, the port field is required, and other unspecified items use default values. When providing the logging.sls field, both project and logstore must be specified.
8153
+ * The update is an asynchronous process. A successful response indicates that the request is accepted. Call the GetCustomAgent operation to query latestSpecVersion, latestVersionStatus, and latestExecutionError, and check the status field to confirm the update result.
6824
8154
  * The clientToken field currently does not provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold field for health checks currently does not take effect. Omit this field.
6825
8155
  *
6826
8156
  * @param tmpReq - UpdateCustomAgentRequest
@@ -6869,10 +8199,12 @@ export default class Client extends OpenApi {
6869
8199
  * Updates the configuration of a specified custom agent in a workspace and executes the update asynchronously. Omitted top-level fields retain their original configurations. You can call the GetCustomAgent operation to query the update result.
6870
8200
  *
6871
8201
  * @remarks
6872
- * Specify at least one top-level field to update. Omitted top-level fields retain their original configurations. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole. Pass an empty array [] to clear a list. The agenticFsMounts field does not accept null. Pass null for the description field to clear the description, and pass null for the healthCheck field to remove the health check.
6873
- * When updating an image, you must specify artifact.port and the type, instanceId, namespace, repo, and tag fields of artifact.container. To retain a custom startup command, also provide the entrypoint field. Currently, only ACR container image deployment is supported. Omit the artifact.code field.
6874
- * When providing the runtime field, both compute and sessionPolicy must be present. If you omit hpa or any of its fields, unspecified elastic configurations use default values. To retain the original elastic configurations, provide them all. When providing the network field, omitted access items are treated as allowed, but actual access is still subject to the workspace network restrictions. To retain the original restrictions, provide both accessInternet and accessVpc. When providing healthCheck, you must specify the port field, and other unspecified items use default values. When providing logging.sls, you must specify both project and logstore.
6875
- * The update is an asynchronous process. A successful response indicates that the request is accepted. You can call the GetCustomAgent operation to query latestSpecVersion, latestVersionStatus, and latestExecutionError, and check the status field to confirm the update result.
8202
+ * Provide at least one top-level field to update. Omitted top-level fields retain their original configurations. When providing a configuration object, specify its required subfields and include any optional configurations that you want to retain. Arrays are replaced as a whole. Pass an empty array [] to clear a list. The agenticFsMounts field does not accept null. Pass null for the description field to clear the description, and pass null for the healthCheck field to remove the health check.
8203
+ * When updating an image, you must specify artifact.port and the type, instanceId, namespace, repo, and tag fields of artifact.container. To retain a custom startup command, also provide the entrypoint field.
8204
+ * In code package pattern, specify artifact.port and the sourceUri, languageRuntime, and entrypoint fields of artifact.code. Do not specify the container field at the same time. Dependencies must be packaged by the user. ZIP and TAR.GZ formats are supported, and the compressed package size cannot exceed 500,000,000 bytes. Query the runtime environment identity by calling the ListAgentCodeRuntimes operation. The sourceUri field supports oss:// addresses or HTTPS object addresses of standard OSS public domain names, including signed URLs. For local files, first call the GetAgentCodePackageUploadUrl operation to obtain an upload URL, upload the file directly, and then commit the returned sourceUri.
8205
+ * When submitting a new code package source, the backend rechecks read permissions, objects, and sizes. The configuration is saved only after the transfer succeeds. If the transfer fails, the current configuration is not saved. Saved fixed packages can be reused. Set the client timeout to 210 seconds for code package requests. Archive integrity and secure decompression are checked at startup. A successful acceptance does not indicate that the agent is ready to run.
8206
+ * When providing the runtime field, the compute and sessionPolicy fields must be provided at the same time. If the hpa field or its subfields are omitted, unspecified elastic configurations use default values. To retain the original elastic configurations, provide them together. When providing the network field, omitted access items are treated as allowed, but actual access is still restricted by the workspace network configurations. To retain the original restrictions, provide both accessInternet and accessVpc. When providing the healthCheck field, the port field is required, and other unspecified items use default values. When providing the logging.sls field, both project and logstore must be specified.
8207
+ * The update is an asynchronous process. A successful response indicates that the request is accepted. Call the GetCustomAgent operation to query latestSpecVersion, latestVersionStatus, and latestExecutionError, and check the status field to confirm the update result.
6876
8208
  * The clientToken field currently does not provide idempotency guarantees. Do not rely on this parameter to prevent duplicate requests. The healthyThreshold field for health checks currently does not take effect. Omit this field.
6877
8209
  *
6878
8210
  * @param request - UpdateCustomAgentRequest
@@ -6948,7 +8280,21 @@ export default class Client extends OpenApi {
6948
8280
  }
6949
8281
 
6950
8282
  /**
6951
- * Updates the login toggle, member synchronization toggle, or application configuration of a specified external identity provider in 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 progress.
8283
+ * 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.
8284
+ *
8285
+ * @remarks
8286
+ * ### Prerequisites and update methods
8287
+ * 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.
8288
+ * ### DingTalk and Lark
8289
+ * 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.
8290
+ * 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.
8291
+ * ### Custom SAML identity provider
8292
+ * 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.
8293
+ * 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.
8294
+ * 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.
8295
+ * ### Asynchronous results and retries
8296
+ * 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.
8297
+ * 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.
6952
8298
  *
6953
8299
  * @param tmpReq - UpdateIdentityProviderRequest
6954
8300
  * @param headers - map
@@ -6987,7 +8333,21 @@ export default class Client extends OpenApi {
6987
8333
  }
6988
8334
 
6989
8335
  /**
6990
- * Updates the login toggle, member synchronization toggle, or application configuration of a specified external identity provider in 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 progress.
8336
+ * 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.
8337
+ *
8338
+ * @remarks
8339
+ * ### Prerequisites and update methods
8340
+ * 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.
8341
+ * ### DingTalk and Lark
8342
+ * 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.
8343
+ * 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.
8344
+ * ### Custom SAML identity provider
8345
+ * 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.
8346
+ * 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.
8347
+ * 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.
8348
+ * ### Asynchronous results and retries
8349
+ * 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.
8350
+ * 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.
6991
8351
  *
6992
8352
  * @param request - UpdateIdentityProviderRequest
6993
8353
  * @returns UpdateIdentityProviderResponse
@@ -6998,6 +8358,119 @@ export default class Client extends OpenApi {
6998
8358
  return await this.updateIdentityProviderWithOptions(workspaceId, identityProviderType, request, headers, runtime);
6999
8359
  }
7000
8360
 
8361
+ /**
8362
+ * 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.
8363
+ *
8364
+ * @remarks
8365
+ * ## Features and prerequisites
8366
+ * 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.
8367
+ * 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.
8368
+ * 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.
8369
+ * ## Requests and examples
8370
+ * PUT /workspaces/{workspaceId}/scim-provisioning
8371
+ * 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.
8372
+ * ```text
8373
+ * PUT /workspaces/ws-example/scim-provisioning
8374
+ * {"syncEnabled": true}
8375
+ * To disable: {"syncEnabled": false}
8376
+ * ```
8377
+ * ## Response example
8378
+ * ```json
8379
+ * {
8380
+ * "data": {
8381
+ * "workspaceId": "ws-example",
8382
+ * "identityProviderType": "CustomSSO",
8383
+ * "status": "READY",
8384
+ * "loginEnabled": false,
8385
+ * "syncEnabled": true
8386
+ * }
8387
+ * }
8388
+ * ```
8389
+ * ## Errors and handling
8390
+ * 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.
8391
+ * 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.
8392
+ * ## Call relationships and usage boundaries
8393
+ * 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.
8394
+ *
8395
+ * @param tmpReq - UpdateIdentityProviderSCIMRequest
8396
+ * @param headers - map
8397
+ * @param runtime - runtime options for this request RuntimeOptions
8398
+ * @returns UpdateIdentityProviderSCIMResponse
8399
+ */
8400
+ async updateIdentityProviderSCIMWithOptions(workspaceId: string, tmpReq: $_model.UpdateIdentityProviderSCIMRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.UpdateIdentityProviderSCIMResponse> {
8401
+ tmpReq.validate();
8402
+ let request = new $_model.UpdateIdentityProviderSCIMShrinkRequest({ });
8403
+ OpenApiUtil.convert(tmpReq, request);
8404
+ if (!$dara.isNull(tmpReq.body)) {
8405
+ request.bodyShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.body, "body", "json");
8406
+ }
8407
+
8408
+ let body : {[key: string ]: any} = { };
8409
+ if (!$dara.isNull(request.bodyShrink)) {
8410
+ body["body"] = request.bodyShrink;
8411
+ }
8412
+
8413
+ let req = new $OpenApiUtil.OpenApiRequest({
8414
+ headers: headers,
8415
+ body: OpenApiUtil.parseToMap(body),
8416
+ });
8417
+ let params = new $OpenApiUtil.Params({
8418
+ action: "UpdateIdentityProviderSCIM",
8419
+ version: "2026-08-04",
8420
+ protocol: "HTTPS",
8421
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/scim-provisioning`,
8422
+ method: "PUT",
8423
+ authType: "AK",
8424
+ style: "ROA",
8425
+ reqBodyType: "formData",
8426
+ bodyType: "json",
8427
+ });
8428
+ return $dara.cast<$_model.UpdateIdentityProviderSCIMResponse>(await this.callApi(params, req, runtime), new $_model.UpdateIdentityProviderSCIMResponse({}));
8429
+ }
8430
+
8431
+ /**
8432
+ * 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.
8433
+ *
8434
+ * @remarks
8435
+ * ## Features and prerequisites
8436
+ * 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.
8437
+ * 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.
8438
+ * 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.
8439
+ * ## Requests and examples
8440
+ * PUT /workspaces/{workspaceId}/scim-provisioning
8441
+ * 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.
8442
+ * ```text
8443
+ * PUT /workspaces/ws-example/scim-provisioning
8444
+ * {"syncEnabled": true}
8445
+ * To disable: {"syncEnabled": false}
8446
+ * ```
8447
+ * ## Response example
8448
+ * ```json
8449
+ * {
8450
+ * "data": {
8451
+ * "workspaceId": "ws-example",
8452
+ * "identityProviderType": "CustomSSO",
8453
+ * "status": "READY",
8454
+ * "loginEnabled": false,
8455
+ * "syncEnabled": true
8456
+ * }
8457
+ * }
8458
+ * ```
8459
+ * ## Errors and handling
8460
+ * 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.
8461
+ * 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.
8462
+ * ## Call relationships and usage boundaries
8463
+ * 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.
8464
+ *
8465
+ * @param request - UpdateIdentityProviderSCIMRequest
8466
+ * @returns UpdateIdentityProviderSCIMResponse
8467
+ */
8468
+ async updateIdentityProviderSCIM(workspaceId: string, request: $_model.UpdateIdentityProviderSCIMRequest): Promise<$_model.UpdateIdentityProviderSCIMResponse> {
8469
+ let runtime = new $dara.RuntimeOptions({ });
8470
+ let headers : {[key: string ]: string} = { };
8471
+ return await this.updateIdentityProviderSCIMWithOptions(workspaceId, request, headers, runtime);
8472
+ }
8473
+
7001
8474
  /**
7002
8475
  * Updates the configuration of a specified managed agent.
7003
8476
  *
@@ -7188,10 +8661,10 @@ export default class Client extends OpenApi {
7188
8661
  }
7189
8662
 
7190
8663
  /**
7191
- * Updates the long-term memory text or metadata based on the memory ID.
8664
+ * Updates the text or metadata of a long-term memory based on the memory ID.
7192
8665
  *
7193
8666
  * @remarks
7194
- * Updates the long-term memory text or metadata based on the memory ID.
8667
+ * Updates the text or metadata of a long-term memory based on the memory ID.
7195
8668
  *
7196
8669
  * @param tmpReq - UpdateMemoryRequest
7197
8670
  * @param headers - map
@@ -7230,10 +8703,10 @@ export default class Client extends OpenApi {
7230
8703
  }
7231
8704
 
7232
8705
  /**
7233
- * Updates the long-term memory text or metadata based on the memory ID.
8706
+ * Updates the text or metadata of a long-term memory based on the memory ID.
7234
8707
  *
7235
8708
  * @remarks
7236
- * Updates the long-term memory text or metadata based on the memory ID.
8709
+ * Updates the text or metadata of a long-term memory based on the memory ID.
7237
8710
  *
7238
8711
  * @param request - UpdateMemoryRequest
7239
8712
  * @returns UpdateMemoryResponse
@@ -7903,6 +9376,118 @@ export default class Client extends OpenApi {
7903
9376
  return await this.uploadSkillViaOssWithOptions(workspaceId, request, headers, runtime);
7904
9377
  }
7905
9378
 
9379
+ /**
9380
+ * Validates the OSS code package source for an agent.
9381
+ *
9382
+ * @remarks
9383
+ * Uses the current workspace role to check whether the customer\\"s OSS object exists and is readable, and checks the file name extension and compressed size. Returns the sourceUri, file name, size, and format read in this request. The bucket and object key are passed separately, and HTTPS download URLs are not accepted.
9384
+ * The validation uses object metadata and read probing. It does not perform full downloads, transfers, or decompression, nor does it generate a SHA-256 hash. Passing the validation does not mean that the archive content is complete or can be started. When you submit a CreateCustomAgent or UpdateCustomAgent request, the system re-validates and transfers the package. You do not need to invoke this operation in advance as a prerequisite for submission.
9385
+ *
9386
+ * @param tmpReq - ValidateAgentCodePackageFromOssRequest
9387
+ * @param headers - map
9388
+ * @param runtime - runtime options for this request RuntimeOptions
9389
+ * @returns ValidateAgentCodePackageFromOssResponse
9390
+ */
9391
+ async validateAgentCodePackageFromOssWithOptions(workspaceId: string, tmpReq: $_model.ValidateAgentCodePackageFromOssRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.ValidateAgentCodePackageFromOssResponse> {
9392
+ tmpReq.validate();
9393
+ let request = new $_model.ValidateAgentCodePackageFromOssShrinkRequest({ });
9394
+ OpenApiUtil.convert(tmpReq, request);
9395
+ if (!$dara.isNull(tmpReq.body)) {
9396
+ request.bodyShrink = OpenApiUtil.arrayToStringWithSpecifiedStyle(tmpReq.body, "body", "json");
9397
+ }
9398
+
9399
+ let body : {[key: string ]: any} = { };
9400
+ if (!$dara.isNull(request.bodyShrink)) {
9401
+ body["body"] = request.bodyShrink;
9402
+ }
9403
+
9404
+ let req = new $OpenApiUtil.OpenApiRequest({
9405
+ headers: headers,
9406
+ body: OpenApiUtil.parseToMap(body),
9407
+ });
9408
+ let params = new $OpenApiUtil.Params({
9409
+ action: "ValidateAgentCodePackageFromOss",
9410
+ version: "2026-08-04",
9411
+ protocol: "HTTPS",
9412
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agent-code-packages/validate-from-oss`,
9413
+ method: "POST",
9414
+ authType: "AK",
9415
+ style: "ROA",
9416
+ reqBodyType: "formData",
9417
+ bodyType: "json",
9418
+ });
9419
+ return $dara.cast<$_model.ValidateAgentCodePackageFromOssResponse>(await this.callApi(params, req, runtime), new $_model.ValidateAgentCodePackageFromOssResponse({}));
9420
+ }
9421
+
9422
+ /**
9423
+ * Validates the OSS code package source for an agent.
9424
+ *
9425
+ * @remarks
9426
+ * Uses the current workspace role to check whether the customer\\"s OSS object exists and is readable, and checks the file name extension and compressed size. Returns the sourceUri, file name, size, and format read in this request. The bucket and object key are passed separately, and HTTPS download URLs are not accepted.
9427
+ * The validation uses object metadata and read probing. It does not perform full downloads, transfers, or decompression, nor does it generate a SHA-256 hash. Passing the validation does not mean that the archive content is complete or can be started. When you submit a CreateCustomAgent or UpdateCustomAgent request, the system re-validates and transfers the package. You do not need to invoke this operation in advance as a prerequisite for submission.
9428
+ *
9429
+ * @param request - ValidateAgentCodePackageFromOssRequest
9430
+ * @returns ValidateAgentCodePackageFromOssResponse
9431
+ */
9432
+ async validateAgentCodePackageFromOss(workspaceId: string, request: $_model.ValidateAgentCodePackageFromOssRequest): Promise<$_model.ValidateAgentCodePackageFromOssResponse> {
9433
+ let runtime = new $dara.RuntimeOptions({ });
9434
+ let headers : {[key: string ]: string} = { };
9435
+ return await this.validateAgentCodePackageFromOssWithOptions(workspaceId, request, headers, runtime);
9436
+ }
9437
+
9438
+ /**
9439
+ * Checks the OSS RAM authorization status of the agent code package.
9440
+ *
9441
+ * @remarks
9442
+ * 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.
9443
+ * To check a specific object, call ValidateAgentCodePackageFromOss. This operation does not copy code packages or modify the default OSS binding of the workspace.
9444
+ *
9445
+ * @param request - VerifyAgentCodePackageOssRamAuthorizationRequest
9446
+ * @param headers - map
9447
+ * @param runtime - runtime options for this request RuntimeOptions
9448
+ * @returns VerifyAgentCodePackageOssRamAuthorizationResponse
9449
+ */
9450
+ async verifyAgentCodePackageOssRamAuthorizationWithOptions(workspaceId: string, request: $_model.VerifyAgentCodePackageOssRamAuthorizationRequest, headers: {[key: string ]: string}, runtime: $dara.RuntimeOptions): Promise<$_model.VerifyAgentCodePackageOssRamAuthorizationResponse> {
9451
+ request.validate();
9452
+ let query : {[key: string ]: any} = { };
9453
+ if (!$dara.isNull(request.ossBucketName)) {
9454
+ query["ossBucketName"] = request.ossBucketName;
9455
+ }
9456
+
9457
+ let req = new $OpenApiUtil.OpenApiRequest({
9458
+ headers: headers,
9459
+ query: OpenApiUtil.query(query),
9460
+ });
9461
+ let params = new $OpenApiUtil.Params({
9462
+ action: "VerifyAgentCodePackageOssRamAuthorization",
9463
+ version: "2026-08-04",
9464
+ protocol: "HTTPS",
9465
+ pathname: `/workspaces/${$dara.URL.percentEncode(workspaceId)}/agent-code-packages/oss/authorize/verify`,
9466
+ method: "POST",
9467
+ authType: "AK",
9468
+ style: "ROA",
9469
+ reqBodyType: "json",
9470
+ bodyType: "json",
9471
+ });
9472
+ return $dara.cast<$_model.VerifyAgentCodePackageOssRamAuthorizationResponse>(await this.callApi(params, req, runtime), new $_model.VerifyAgentCodePackageOssRamAuthorizationResponse({}));
9473
+ }
9474
+
9475
+ /**
9476
+ * Checks the OSS RAM authorization status of the agent code package.
9477
+ *
9478
+ * @remarks
9479
+ * 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.
9480
+ * To check a specific object, call ValidateAgentCodePackageFromOss. This operation does not copy code packages or modify the default OSS binding of the workspace.
9481
+ *
9482
+ * @param request - VerifyAgentCodePackageOssRamAuthorizationRequest
9483
+ * @returns VerifyAgentCodePackageOssRamAuthorizationResponse
9484
+ */
9485
+ async verifyAgentCodePackageOssRamAuthorization(workspaceId: string, request: $_model.VerifyAgentCodePackageOssRamAuthorizationRequest): Promise<$_model.VerifyAgentCodePackageOssRamAuthorizationResponse> {
9486
+ let runtime = new $dara.RuntimeOptions({ });
9487
+ let headers : {[key: string ]: string} = { };
9488
+ return await this.verifyAgentCodePackageOssRamAuthorizationWithOptions(workspaceId, request, headers, runtime);
9489
+ }
9490
+
7906
9491
  /**
7907
9492
  * Validates whether one or more Qoder Service Account Keys are available at a specified site. This operation does not save keys or modify the Connector status.
7908
9493
  *