Snapshot - Get
Načte informace o snímku. Snímek je přístupný jenom zdrojovému předplatnému, které ho pořídilo, a cílovým předplatným zahrnutým v části applyScope in Snapshot – Take.
GET {Endpoint}/face/v1.0-preview/snapshots/{snapshotId}
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://westus.api.cognitive.microsoft.com). |
snapshot
|
path | True |
string uuid |
ID odkazující na konkrétní snímek. |
Hlavička požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
Ocp-Apim-Subscription-Key | True |
string |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Úspěšné volání vrátí informace o snímku. |
|
Other Status Codes |
Chybová odpověď. |
Zabezpečení
Ocp-Apim-Subscription-Key
Typ:
apiKey
V:
header
Příklady
Get snapshot example
Ukázkový požadavek
GET {Endpoint}/face/v1.0-preview/snapshots/e58b3f08-1e8b-4165-81df-aa9858f233dc
Ukázková odpověď
{
"id": "e58b3f08-1e8b-4165-81df-aa9858f233dc",
"account": "/subscriptions/f9b96b36-1f5e-4021-8959-51527e26e6d3/resourceGroups/TestRG/providers/Microsoft.CognitiveServices/accounts/FaceTest01",
"type": "FaceList",
"applyScope": [
"35230F59-AA9C-45E0-AB5E-C859BF1A5429",
"64084E07-9B7F-4A98-BEA4-9986D3A1EDEB"
],
"userData": "User-provided data attached to the snapshot.",
"createdTime": "2018-12-25T11:41:02.2331413Z",
"lastUpdateTime": "2018-12-25T11:51:27.8705696Z"
}
Definice
Name | Description |
---|---|
APIError |
Informace o chybě vrácené rozhraním API |
Error |
Text chyby. |
Snapshot |
Snímek objektu. Rozhraní API pro snímky přesune vaše data mimo geografickou oblast, kterou vyberete pro svůj prostředek, do oblastí USA – západ, Západní Evropa a Jihovýchodní Asie. |
Snapshot |
Typ zdrojového objektu ve snímku určený odběratelem, který vytvořil snímek při volání příkazu Snímek – Pořízení. V současné době se podporují FaceList, PersonGroup, LargeFaceList a LargePersonGroup. |
APIError
Informace o chybě vrácené rozhraním API
Name | Typ | Description |
---|---|---|
error |
Text chyby. |
Error
Text chyby.
Name | Typ | Description |
---|---|---|
code |
string |
|
message |
string |
Snapshot
Snímek objektu. Rozhraní API pro snímky přesune vaše data mimo geografickou oblast, kterou vyberete pro svůj prostředek, do oblastí USA – západ, Západní Evropa a Jihovýchodní Asie.
Name | Typ | Description |
---|---|---|
account |
string |
ID účtu rozpoznávání tváře služby Azure Cognitive Service odběratele, který vytvořil snímek podle snímku – Pořízení. |
applyScope |
string[] |
Pole ID cílových předplatných rozpoznávání tváře pro snímek, které určuje uživatel, který vytvořil snímek při volání funkce Snímek – Pořízení. Pro každý snímek ho můžou použít jenom předplatná zahrnutá v applyScope of Snapshot – Take. |
createdTime |
string |
Kombinovaný řetězec data a času UTC, který popisuje čas vytvoření snímku. Například 2018-12-25T11:41:02.2331413Z. |
id |
string |
ID snímku. |
lastUpdateTime |
string |
Kombinovaný řetězec data a času UTC, který popisuje čas posledního vytvoření nebo aktualizace snímku nástrojem Snímek – Aktualizace. Například 2018-12-25T11:51:27.8705696Z. |
type |
Typ zdrojového objektu ve snímku určený odběratelem, který vytvořil snímek při volání příkazu Snímek – Pořízení. V současné době se podporují FaceList, PersonGroup, LargeFaceList a LargePersonGroup. |
|
userData |
string |
Uživatel zadal data o snímku pro libovolný účel. Délka by neměla překročit 16 kB. |
SnapshotObjectType
Typ zdrojového objektu ve snímku určený odběratelem, který vytvořil snímek při volání příkazu Snímek – Pořízení. V současné době se podporují FaceList, PersonGroup, LargeFaceList a LargePersonGroup.
Name | Typ | Description |
---|---|---|
FaceList |
string |
|
LargeFaceList |
string |
|
LargePersonGroup |
string |
|
PersonGroup |
string |