Person Directory Operations - Create Dynamic Person Group
Skapar en ny dynamisk persongrupp med angivet dynamicPersonGroupId, namn och användarangivna userData.
En dynamisk persongrupp är en container som refererar till Person Directory "Skapa Person". När du har skapat den använder du Person Directory "Update Dynamic Person Group" (Uppdatera dynamisk persongrupp) för att lägga till/ta bort personer till/från gruppen Dynamisk person.
Dynamisk persongrupp och användardata lagras på servern tills personkatalogen "Ta bort dynamisk persongrupp" anropas. Använd "Identifiera från dynamisk persongrupp" med parametern dynamicPersonGroupId för att identifiera mot personer.
Ingen avbildning kommer att lagras. Endast personens extraherade ansiktsfunktioner och userData lagras på servern tills personkatalogen "Ta bort person" eller "Ta bort personansikte" anropas.
"recognitionModel" behöver inte anges med dynamisk person Grupper. Dynamic Person Grupper är referenser till Person Directory "Skapa Person" och arbetar därför med de flesta "recognitionModels". FaceId:et som angavs under "Identifiera" avgör vilken "recognitionModel" som används.
PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-version |
dynamic
|
path | True |
string |
ID för den dynamiska persongruppen. Reguljärt uttrycksmönster: |
endpoint
|
path | True |
string uri |
Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://{resource-name}.cognitiveservices.azure.com). |
Begärandetext
Name | Obligatorisk | Typ | Description |
---|---|---|---|
name | True |
string |
Användardefinierat namn, maximal längd är 128. |
userData |
string |
Valfria användardefinierade data. Längden får inte överstiga 16 K. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
Begäran har slutförts. |
|
Other Status Codes |
Ett oväntat felsvar. Sidhuvuden x-ms-error-code: string |
Säkerhet
Ocp-Apim-Subscription-Key
Den hemliga nyckeln för din Azure AI Face-prenumeration.
Typ:
apiKey
I:
header
AADToken
The Azure Active Directory OAuth2 Flow
Typ:
oauth2
Flow:
accessCode
Auktoriseringswebbadress:
https://api.example.com/oauth2/authorize
Token-webbadress:
https://api.example.com/oauth2/token
Omfattningar
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Exempel
Create DynamicPersonGroup
Exempelbegäran
PUT {endpoint}/face/v1.1-preview.1/dynamicpersongroups/your_dynamic_person_group_id
{
"name": "your_dynamic_person_group_name",
"userData": "your_user_data"
}
Exempelsvar
Definitioner
Name | Description |
---|---|
Face |
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages. |
Face |
Ett svar som innehåller felinformation. |
FaceError
Felobjektet. Omfattande information om felkoder och meddelanden som returneras av ansiktstjänsten finns i följande länk: https://aka.ms/face-error-codes-and-messages.
Name | Typ | Description |
---|---|---|
code |
string |
En av en serverdefinierad uppsättning felkoder. |
message |
string |
En läsbar återgivning av felet. |
FaceErrorResponse
Ett svar som innehåller felinformation.
Name | Typ | Description |
---|---|---|
error |
Felobjektet. |