Partager via


Person Directory Operations - Delete Dynamic Person Group

Supprime un groupe de personnes dynamiques existant avec dynamicPersonGroupId spécifié.
La suppression de ce groupe de personnes dynamiques supprime uniquement les références aux données des personnes. Pour supprimer une personne réelle, consultez l’annuaire de personnes « Supprimer la personne ».

DELETE {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}

Paramètres URI

Nom Dans Obligatoire Type Description
apiVersion
path True

string

Version de l’API

dynamicPersonGroupId
path True

string

ID du groupe de personnes dynamiques.

Modèle d’expression régulière: ^[a-z0-9-_]+$

endpoint
path True

string

uri

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://{nom-ressource}.cognitiveservices.azure.com).

Réponses

Nom Type Description
202 Accepted

Un appel réussi retourne un corps de réponse vide. Le service a accepté la demande et commencera à traiter bientôt. Le client peut interroger l’état et le résultat de l’opération à l’aide de l’URL spécifiée dans l’en-tête de réponse « Operation-Location ». L’URL expire dans 48 heures. L’URL fournit l’état du moment où l’annuaire de personnes « Obtenir des références de groupe de personnes dynamiques » retourne les modifications apportées dans cette demande.

En-têtes

operation-Location: string

Other Status Codes

FaceErrorResponse

Réponse d’erreur inattendue.

En-têtes

x-ms-error-code: string

Sécurité

Ocp-Apim-Subscription-Key

Clé secrète de votre abonnement Azure AI Face.

Type: apiKey
Dans: header

AADToken

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: accessCode
URL d’autorisation: https://api.example.com/oauth2/authorize
URL du jeton: https://api.example.com/oauth2/token

Étendues

Nom Description
https://cognitiveservices.azure.com/.default

Exemples

Delete DynamicPersonGroup

Exemple de requête

DELETE {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id

Exemple de réponse

location: https://contoso.com/operationstatus
operation-Location: https://contoso.com/operationstatus

Définitions

Nom Description
FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

FaceError

Objet d’erreur. Pour plus d’informations sur les codes d’erreur et les messages retournés par le service Visage, reportez-vous au lien suivant : https://aka.ms/face-error-codes-and-messages.

Nom Type Description
code

string

Un ensemble de codes d’erreur définis par le serveur.

message

string

Représentation lisible par l’homme de l’erreur.

FaceErrorResponse

Réponse contenant les détails de l’erreur.

Nom Type Description
error

FaceError

Objet d’erreur.