Snapshot - Get

Referencia

Servicio:: Azure AI Services

Versión de la API:: 1.0

Recupere información sobre una instantánea. La instantánea solo es accesible para la suscripción de origen que la tomó y las suscripciones de destino incluidas en applyScope en Snapshot - Take.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
Endpoint	path	True	string	Puntos de conexión de Cognitive Services admitidos (protocolo y nombre de host, por ejemplo: https://westus.api.cognitive.microsoft.com).
snapshotId	path	True	string uuid	Identificador que hace referencia a una instantánea determinada.

Encabezado de la solicitud

Nombre	Requerido	Tipo	Description
Ocp-Apim-Subscription-Key	True	string

Respuestas

Nombre	Tipo	Description
200 OK	Snapshot	Una llamada correcta devuelve la información de la instantánea.
Other Status Codes	APIError	Respuesta de error.

Seguridad

Ocp-Apim-Subscription-Key

Tipo: apiKey
En: header

Ejemplos

Get snapshot example

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

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

Definiciones

Nombre	Description
APIError	Información de error devuelta por la API
Error	Cuerpo del error.
Snapshot	Objeto Snapshot. Snapshot API moverá los datos fuera de la ubicación geográfica que seleccione para el recurso a Oeste de EE. UU., Oeste de Europa y Sudeste de Asia.
SnapshotObjectType	Tipo del objeto de origen en la instantánea, especificado por el suscriptor que creó la instantánea al llamar a Snapshot - Take. Actualmente se admiten FaceList, PersonGroup, LargeFaceList y LargePersonGroup.

APIError

Información de error devuelta por la API

Nombre	Tipo	Description
error	Error	Cuerpo del error.

Error

Cuerpo del error.

Nombre	Tipo	Description
code	string
message	string

Snapshot

Objeto Snapshot. Snapshot API moverá los datos fuera de la ubicación geográfica que seleccione para el recurso a Oeste de EE. UU., Oeste de Europa y Sudeste de Asia.

Nombre	Tipo	Description
account	string	Identificador de la cuenta de Face de Azure Cognitive Service del suscriptor que creó la instantánea mediante Snapshot - Take.
applyScope	string[]	Matriz de los identificadores de suscripción de Face de destino para la instantánea, especificados por el usuario que creó la instantánea al llamar a Snapshot - Take. Para cada instantánea, solo las suscripciones incluidas en applyScope of Snapshot - Take pueden aplicarla.
createdTime	string	Cadena de fecha y hora UTC combinada que describe la hora de creación de la instantánea. Por ejemplo, 2018-12-25T11:41:02.2331413Z.
id	string	Id. de instantánea.
lastUpdateTime	string	Cadena de fecha y hora UTC combinada que describe la última vez que la instantánea se creó o actualizó mediante Snapshot - Update. Por ejemplo, 2018-12-25T11:51:27.8705696Z.
type	SnapshotObjectType	Tipo del objeto de origen en la instantánea, especificado por el suscriptor que creó la instantánea al llamar a Snapshot - Take. Actualmente se admiten FaceList, PersonGroup, LargeFaceList y LargePersonGroup.
userData	string	Los datos especificados por el usuario sobre la instantánea para cualquier propósito. La longitud no debe superar los 16 KB.

SnapshotObjectType

Tipo del objeto de origen en la instantánea, especificado por el suscriptor que creó la instantánea al llamar a Snapshot - Take. Actualmente se admiten FaceList, PersonGroup, LargeFaceList y LargePersonGroup.

Nombre	Tipo	Description
FaceList	string
LargeFaceList	string
LargePersonGroup	string
PersonGroup	string

Compartir a través de