[Visualizar] Excluir grupos

Exclui vários grupos de uma organização, com base na ID da organização.

Ponto de Extremidade da API

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

Escopos

Requer os seguintes escopos:

• PM.Group
• PM.Group.Write

Cabeçalhos de solicitação.

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

Observação: para obter o {access_token}, certifique-se de se autenticar por meio de um dos métodos descritos aqui.

Parâmetros do caminho

Parâmetro do caminho	Tipo de dados	Description
partitionGlobalId (obrigatório)	String	O ID do grupo a ser excluído.

Corpo da Solicitação

O corpo da solicitação contém a lista de IDs de grupos personalizados que você deseja excluir em massa da organização.

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

Resposta

200 OK

Os grupos personalizados indicados são excluídos da organização.

Exemplo de solicitação

Digamos que você reuniu todas as informações necessárias para criar a chamada de API.

• Seu {baseURL} é: https://{yourDomain}/{organizationName}/{tenantName}/
• Seu {access_token} é: 1234 (para considerações de comprimento).
• O {partitionGlobalId} é: magic-7

• Os grupos personalizados que você deseja excluir têm as seguintes IDs:

  • Grupo 1: group1
  • Grupo group2

A chamada deve ter a seguinte aparência (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"
     ]
}'