Snapshot - Update
Actualice la información de una instantánea. Solo la suscripción de origen que tomó la instantánea puede actualizar la instantánea.
PATCH {Endpoint}/face/v1.0-preview/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). |
snapshot
|
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 |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
applyScope |
string[] |
Matriz de los identificadores de suscripción de Face de destino para la instantánea, especificada 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. |
userData |
string |
Los datos especificados por el usuario sobre la instantánea para cualquier propósito. La longitud no debe superar los 16 KB. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Una llamada correcta devuelve un cuerpo de respuesta vacío. |
|
Other Status Codes |
Respuesta de error. |
Seguridad
Ocp-Apim-Subscription-Key
Tipo:
apiKey
En:
header
Ejemplos
Update snapshot example
Solicitud de ejemplo
PATCH {Endpoint}/face/v1.0-preview/snapshots/e58b3f08-1e8b-4165-81df-aa9858f233dc
{
"applyScope": [
"64084E07-9B7F-4A98-BEA4-9986D3A1EDEB"
],
"userData": "User-provided data attached to the snapshot."
}
Respuesta de muestra
Definiciones
Nombre | Description |
---|---|
APIError |
Información de error devuelta por la API |
Error |
Cuerpo del error. |
Update |
Cuerpo de la solicitud para actualizar una instantánea, con una combinación de los datos especificados por el usuario y el ámbito de aplicación definidos por el usuario. |
APIError
Información de error devuelta por la API
Nombre | Tipo | Description |
---|---|---|
error |
Cuerpo del error. |
Error
Cuerpo del error.
Nombre | Tipo | Description |
---|---|---|
code |
string |
|
message |
string |
UpdateSnapshotRequest
Cuerpo de la solicitud para actualizar una instantánea, con una combinación de los datos especificados por el usuario y el ámbito de aplicación definidos por el usuario.
Nombre | Tipo | Description |
---|---|---|
applyScope |
string[] |
Matriz de los identificadores de suscripción de Face de destino para la instantánea, especificada 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. |
userData |
string |
Los datos especificados por el usuario sobre la instantánea para cualquier propósito. La longitud no debe superar los 16 KB. |