[Vista previa] Eliminar grupos

Elimina múltiples grupos de una organización según el ID de la organización.

Punto final de API

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

Ámbitos

Necesita los siguientes ámbitos:

• PM.Group
• PM.Group.Write

Solicitar encabezados.

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

Nota: para obtener el {access_token}, asegúrate de autenticar a través de uno de los métodos descritos aquí.

Parámetros de ruta

Parámetros de ruta	Tipo de datos	Descripción
partitionGlobalId (obligatorio)	Cadena	El ID de la organización para el que desea recuperar los grupos.

Solicitar cuerpo

El cuerpo de la solicitud contiene la lista de ID de grupos personalizados que deseas eliminar en masa de la organización.

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

Respuesta

200 OK

Los grupos personalizados indicados se eliminarán de la organización.

Solicitud de ejemplo

Supongamos que has recopilado toda la información necesaria para crear la llamada a la API.

• Tu {baseURL} es: https://{yourDomain}/{organizationName}/{tenantName}/
• Tu {access_token} es: 1234 (para consideraciones de longitud)
• El {partitionGlobalId} es: magic-7

• Los grupos personalizados que quieres eliminar tienen los siguientes ID:

  • Grupo 1: group1
  • Grupo 2: group2

La llamada debe ser similar a lo que mostramos a continuación (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"
     ]
}'