Sdílet prostřednictvím


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).

snapshotId
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

Snapshot

Úspěšné volání vrátí informace o snímku.

Other Status Codes

APIError

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.

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.

APIError

Informace o chybě vrácené rozhraním API

Name Typ Description
error

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

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.

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