[预览] 删除组

根据组织 ID，从组织中删除多个组。

API 端点

DELETE https://{yourDomain}/identity/api/Group/{partitionGlobalId}

作用域

需要以下作用域：

• PM.Group
• PM.Group.Write

请求标头

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

备注：

To obtain the {access_token}, make sure to authenticate through one of the methods described here.

路径参数

路径参数	数据类型	描述
partitionGlobalId (必填)	字符串	要检索其组的组织的 ID。

请求正文

请求正文包含要从组织中批量删除的自定义组 ID 列表。

{
     "groupIDs": [
          "string",
          "string"
     ]
}

响应

200 OK

将指定的自定义组从组织中删除。

请求示例

假设您收集了构建 API 调用所需的所有信息。

• 您的 {baseURL} 为：https://{yourDomain}/{organizationName}/{tenantName}/
• 您的 {access_token} 为：1234（出于长度考虑）。
• {partitionGlobalId} 为：magic-7
• 要删除的自定义组具有以下 ID：
  • 组 1：group1
  • 组 2：group2

调用应如下所示 (cURL)：

curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group/magic-7' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
     "groupIDs": [
          "group1",
          "group2"
     ]
}'