Person Directory Operations - Create Dynamic Person Group With Person
Hiermee maakt u een nieuwe dynamische persoonsgroep met de opgegeven dynamicPersonGroupId, naam en door de gebruiker verstrekte userData.
Een dynamische persoonsgroep is een container die verwijst naar persoonsdirectory 'Create Person'. Gebruik na het maken de personenlijst 'Dynamische personengroep bijwerken' om personen toe te voegen aan/te verwijderen uit de groep Dynamische personen.
Dynamische persoonsgroep en gebruikersgegevens worden opgeslagen op de server totdat de persoonsdirectory Dynamische persoonsgroep verwijderen wordt aangeroepen. Gebruik 'Identificeren van dynamische persoonsgroep' met de parameter dynamicPersonGroupId om te identificeren tegen personen.
Er wordt geen installatiekopieën opgeslagen. Alleen de uitgepakte gezichtsfuncties van de persoon en userData worden op de server opgeslagen totdat persoonsmap 'Persoon verwijderen' of 'Gezicht van persoon verwijderen' wordt aangeroepen.
'recognitionModel' hoeft niet te worden opgegeven met dynamische persoonsgroepen. Dynamische personengroepen zijn verwijzingen naar persoonsdirectory 'Persoon maken' en werken daarom met de meeste 'recognitionModels'. De faceId's die tijdens 'Identificeren' worden verstrekt, bepalen het gebruikte recognitionModel.
PUT {endpoint}/face/{apiVersion}/dynamicpersongroups/{dynamicPersonGroupId}
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
api
|
path | True |
string |
API-versie |
dynamic
|
path | True |
string |
Id van de dynamische persoonsgroep. Regex-patroon: |
endpoint
|
path | True |
string uri |
Ondersteunde Cognitive Services-eindpunten (protocol en hostnaam, bijvoorbeeld: https://{resource-name}.cognitiveservices.azure.com). |
Aanvraagbody
Name | Vereist | Type | Description |
---|---|---|---|
addPersonIds | True |
string[] |
Matrix van personIds die zijn gemaakt door Person Directory 'Create Person' om toe te voegen. |
name | True |
string |
Door de gebruiker gedefinieerde naam, de maximale lengte is 128. |
userData |
string |
Optionele door de gebruiker gedefinieerde gegevens. De lengte mag niet groter zijn dan 16.000. |
Antwoorden
Name | Type | Description |
---|---|---|
202 Accepted |
Een geslaagde aanroep retourneert een lege antwoordtekst. De service heeft de aanvraag geaccepteerd en wordt binnenkort verwerkt. De client kan een query uitvoeren op de bewerkingsstatus en het resultaat met behulp van de URL die is opgegeven in de antwoordheader Operation-Location. De URL verloopt over 48 uur. De URL geeft de status op wanneer persoonsadreslijst 'Dynamische persoonsgroepverwijzingen ophalen' de wijzigingen retourneert die in deze aanvraag zijn aangebracht. Kopteksten operation-Location: string |
|
Other Status Codes |
Een onverwachte foutreactie. Kopteksten x-ms-error-code: string |
Beveiliging
Ocp-Apim-Subscription-Key
De geheime sleutel voor uw Azure AI Face-abonnement.
Type:
apiKey
In:
header
AADToken
De Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
accessCode
Autorisatie-URL:
https://api.example.com/oauth2/authorize
Token-URL:
https://api.example.com/oauth2/token
Bereiken
Name | Description |
---|---|
https://cognitiveservices.azure.com/.default |
Voorbeelden
Create DynamicPersonGroup
Voorbeeldaanvraag
PUT {endpoint}/face/v1.2-preview.1/dynamicpersongroups/your_dynamic_person_group_id
{
"name": "your_dynamic_person_group_name",
"userData": "your_user_data",
"addPersonIds": [
"85c0c630-c9c9-40f8-8a4e-f9ae4f926ea5"
]
}
Voorbeeldrespons
operation-Location: https://contoso.com/operationstatus
Definities
Name | Description |
---|---|
Face |
Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages. |
Face |
Een antwoord met foutdetails. |
FaceError
Het foutobject. Raadpleeg de volgende koppeling voor uitgebreide informatie over foutcodes en berichten die worden geretourneerd door de Face-service: https://aka.ms/face-error-codes-and-messages.
Name | Type | Description |
---|---|---|
code |
string |
Een van een door de server gedefinieerde set foutcodes. |
message |
string |
Een leesbare weergave van de fout. |
FaceErrorResponse
Een antwoord met foutdetails.
Name | Type | Description |
---|---|---|
error |
Het foutobject. |