Partager via


Snapshot - Get

Récupérer des informations sur un instantané. L’instantané n’est accessible qu’à l’abonnement source qui l’a pris et aux abonnements cibles inclus dans l’applicationScope dans Capture instantanée - Prendre.

GET {Endpoint}/face/v1.0-preview/snapshots/{snapshotId}

Paramètres URI

Nom Dans Obligatoire Type Description
Endpoint
path True

string

Points de terminaison Cognitive Services pris en charge (protocole et nom d’hôte, par exemple : https://westus.api.cognitive.microsoft.com).

snapshotId
path True

string

uuid

ID référençant un instantané particulier.

En-tête de la demande

Nom Obligatoire Type Description
Ocp-Apim-Subscription-Key True

string

Réponses

Nom Type Description
200 OK

Snapshot

Un appel réussi retourne les informations du instantané.

Other Status Codes

APIError

Réponse d’erreur.

Sécurité

Ocp-Apim-Subscription-Key

Type: apiKey
Dans: header

Exemples

Get snapshot example

Exemple de requête

GET {Endpoint}/face/v1.0-preview/snapshots/e58b3f08-1e8b-4165-81df-aa9858f233dc

Exemple de réponse

{
  "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"
}

Définitions

Nom Description
APIError

Informations d’erreur retournées par l’API

Error

Corps de l’erreur.

Snapshot

Objet d’instantané. L’API Instantané déplace vos données en dehors de la zone géographique que vous sélectionnez pour votre ressource vers USA Ouest, Europe Ouest et Asie Sud-Est.

SnapshotObjectType

Type de l’objet source dans le instantané, spécifié par l’abonné qui a créé le instantané lors de l’appel de Capture instantanée - Take. Actuellement, FaceList, PersonGroup, LargeFaceList et LargePersonGroup sont pris en charge.

APIError

Informations d’erreur retournées par l’API

Nom Type Description
error

Error

Corps de l’erreur.

Error

Corps de l’erreur.

Nom Type Description
code

string

message

string

Snapshot

Objet d’instantané. L’API Instantané déplace vos données en dehors de la zone géographique que vous sélectionnez pour votre ressource vers USA Ouest, Europe Ouest et Asie Sud-Est.

Nom Type Description
account

string

Id de compte visage Azure Cognitive Service de l’abonné qui a créé le instantané par capture instantanée - Take.

applyScope

string[]

Tableau des ID d’abonnement Visage cible pour le instantané, spécifié par l’utilisateur qui a créé le instantané lors de l’appel de Capture instantanée - Take. Pour chaque instantané, seuls les abonnements inclus dans le applyScope of Snapshot - Take peuvent l’appliquer.

createdTime

string

Chaîne de date et d’heure UTC combinée qui décrit l’heure de création du instantané. Par exemple, 2018-12-25T11 :41 :02.2331413Z.

id

string

ID d’instantané.

lastUpdateTime

string

Chaîne de date et d’heure UTC combinée qui décrit la dernière fois où le instantané a été créé ou mis à jour par Capture instantanée - Mise à jour. Par exemple, 2018-12-25T11 :51 :27.8705696Z.

type

SnapshotObjectType

Type de l’objet source dans le instantané, spécifié par l’abonné qui a créé le instantané lors de l’appel de Capture instantanée - Take. Actuellement, FaceList, PersonGroup, LargeFaceList et LargePersonGroup sont pris en charge.

userData

string

L’utilisateur a spécifié des données sur le instantané à n’importe quelle fin. La longueur ne doit pas dépasser 16 Ko.

SnapshotObjectType

Type de l’objet source dans le instantané, spécifié par l’abonné qui a créé le instantané lors de l’appel de Capture instantanée - Take. Actuellement, FaceList, PersonGroup, LargeFaceList et LargePersonGroup sont pris en charge.

Nom Type Description
FaceList

string

LargeFaceList

string

LargePersonGroup

string

PersonGroup

string