Partilhar via


Person Directory Operations - Delete Dynamic Person Group

Exclui um Grupo de Pessoas Dinâmicas existente com dynamicPersonGroupId especificado.
A eliminação deste Grupo de Pessoas Dinâmicas elimina apenas as referências a dados pessoais. Para excluir uma pessoa real, consulte o Diretório de Pessoas "Excluir Pessoa".

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

Parâmetros do URI

Name Em Necessário Tipo Description
apiVersion
path True

string

Versão da API

dynamicPersonGroupId
path True

string

ID do grupo dinâmico de pessoas.

Padrão Regex: ^[a-z0-9-_]+$

endpoint
path True

string

uri

Pontos de extremidade de Serviços Cognitivos suportados (protocolo e nome do host, por exemplo: https://{resource-name}.cognitiveservices.azure.com).

Respostas

Name Tipo Description
202 Accepted

Uma chamada bem-sucedida retorna um corpo de resposta vazio. O serviço aceitou o pedido e começará a processar em breve. O cliente pode consultar o status e o resultado da operação usando a URL especificada no cabeçalho de resposta 'Operation-Location'. O URL expira em 48 horas. A URL fornece o status de quando o Diretório de Pessoas "Obter Referências de Grupo de Pessoas Dinâmicas" retornará as alterações feitas nessa solicitação.

Cabeçalhos

operation-Location: string

Other Status Codes

FaceErrorResponse

Uma resposta de erro inesperada.

Cabeçalhos

x-ms-error-code: string

Segurança

Ocp-Apim-Subscription-Key

A chave secreta para sua assinatura do Azure AI Face.

Tipo: apiKey
Em: header

AADToken

O fluxo OAuth2 do Azure Ative Directory

Tipo: oauth2
Fluxo: accessCode
URL de Autorização: https://api.example.com/oauth2/authorize
Token URL: https://api.example.com/oauth2/token

Âmbitos

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

Exemplos

Delete DynamicPersonGroup

Pedido de amostra

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

Resposta da amostra

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

Definições

Name Description
FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

FaceError

O objeto de erro. Para obter detalhes abrangentes sobre códigos de erro e mensagens retornadas pelo Face Service, consulte o seguinte link: https://aka.ms/face-error-codes-and-messages.

Name Tipo Description
code

string

Um de um conjunto de códigos de erro definido pelo servidor.

message

string

Uma representação legível por humanos do erro.

FaceErrorResponse

Uma resposta contendo detalhes do erro.

Name Tipo Description
error

FaceError

O objeto de erro.