Datasets - Update

Referencia

Servicio:: Azure AI Services

Versión de la API:: 2023-04-01-preview

Permite actualizar las propiedades de un conjunto de datos existente.

Códigos de estado devueltos:

200: Operación completada correctamente.
400: La solicitud tiene un formato incorrecto.
404: No se encontró un conjunto de datos con el nombre especificado.
412: se proporcionó un encabezado de If-Match, pero la ETag especificada no coincidía con el valor de ETag actual.

PATCH /datasets/{name}?api-version=2023-04-01-preview

Parámetros de identificador URI

Nombre En Requerido Tipo Description

Nombre	En	Requerido	Tipo	Description
name	path	True	string	Nombre del conjunto de datos que se va a actualizar. Patrón de Regex: `^[a-zA-Z0-9][a-zA-Z0-9._-]*$`
api-version	query	True	string	Versión de API solicitada.

name

path

True

string

Nombre del conjunto de datos que se va a actualizar.

Patrón de Regex: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version

query

True

string

Versión de API solicitada.

Encabezado de la solicitud

Media Types: "application/json-patch+json"

Nombre	Requerido	Tipo	Description
If-Match		string	ETag opcional para que el conjunto de datos se actualice. Si se proporciona una ETag, el conjunto de datos se actualizará solo si su valor ETag actual coincide con el ETag especificado. Si los valores de ETag no coinciden, se producirá un error en la operación de actualización con el código de estado 412 (error de condición previa). Esto indica que el conjunto de datos se ha actualizado desde la última vez que se obtuvo la información del conjunto de datos. Si no se proporciona una ETag o su valor es '*', el conjunto de datos siempre se actualizará independientemente del valor de ETag actual.

Cuerpo de la solicitud

Media Types: "application/json-patch+json"

Nombre	Tipo	Description
annotationFileUris	string[]	Lista de URI absolutos para los archivos de anotación, cada uno de los cuales debe almacenarse como un blob en un contenedor de blobs de Azure Storage. Cada archivo debe seguir el formato COCO para el AnnotationKind especificado, con cada ruta de acceso de imagen siendo un URI absoluto para un blob en un contenedor de blobs. El recurso de Computer Vision debe tener permiso para leer los archivos de anotación y todos los archivos de imagen a los que se hace referencia. Para ello, active Identidades administradas del sistema para el recurso de Computer Vision y, a continuación, asigne la identidad a un rol que tenga permiso para leer desde el contenedor de blobs que contiene los archivos de anotación e imagen.
annotationKind	AnnotationKind	Tipo de anotaciones contenidas en los archivos de anotación. Por ejemplo, "ImageClassification" para especificar que el archivo de anotación contenga etiquetas de objeto para entrenar o probar un modelo de clasificación de imágenes multiclase.
authentication	StorageAuthenticationSettingsApiModel	Describe la configuración de autenticación de almacenamiento.
createdDateTime	string	Solo lectura. Fecha y hora en que el conjunto de datos se registró por primera vez, en UTC.
customProperties	object	Diccionario de pares clave-valor arbitrarios para su uso por parte de la aplicación. Se permite un máximo de 10 pares clave-valor.
eTag	string	Solo lectura. ETag más reciente del conjunto de datos. Se puede usar con el encabezado "If-Match" al actualizar o eliminar un conjunto de datos.
name	string	Solo lectura. Nombre que se usa para identificar de forma única el conjunto de datos.
updatedDateTime	string	Solo lectura. Fecha y hora en que se actualizó por última vez el conjunto de datos, en UTC.

Respuestas

Nombre	Tipo	Description
200 OK	Dataset	Correcto
Other Status Codes	ErrorResponse	Error Encabezados x-ms-error-code: string

Nombre

Tipo

Description

200 OK

Dataset

Correcto

Other Status Codes

ErrorResponse

Error

Encabezados

x-ms-error-code: string

Ejemplos

Datasets_Update

Solicitud de ejemplo

HTTP

PATCH /datasets/my_dataset_name?api-version=2023-04-01-preview

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ]
}

Respuesta de muestra

status code:: 200

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ],
  "name": "my_dataset_name",
  "createdDateTime": "2023-01-13T20:46:20.189Z",
  "updatedDateTime": "2023-01-13T20:46:20.189Z",
  "eTag": "kzktjgnqkjagdlkualdzikaseg"
}

Definiciones

Nombre	Description
AnnotationKind	Tipo de anotaciones contenidas en los archivos de anotación. Por ejemplo, "ImageClassification" para especificar que el archivo de anotación contenga etiquetas de objeto para entrenar o probar un modelo de clasificación de imágenes multiclase.
Dataset	Describe un conjunto de datos, que representa un conjunto de imágenes y anotaciones que se pueden usar para entrenar o probar un modelo.
ErrorResponse	Respuesta devuelta cuando se produce un error.
ErrorResponseDetails	Información de error.
ErrorResponseInnerError	Error detallado.
StorageAuthenticationKind	Tipo de autenticación de almacenamiento.
StorageAuthenticationSettingsApiModel	Describe la configuración de autenticación de almacenamiento.

AnnotationKind

Tipo de anotaciones contenidas en los archivos de anotación. Por ejemplo, "ImageClassification" para especificar que el archivo de anotación contenga etiquetas de objeto para entrenar o probar un modelo de clasificación de imágenes multiclase.

Nombre	Tipo	Description
imageClassification	string
imageObjectDetection	string

Dataset

Describe un conjunto de datos, que representa un conjunto de imágenes y anotaciones que se pueden usar para entrenar o probar un modelo.

Nombre	Tipo	Description
annotationFileUris	string[]	Lista de URI absolutos para los archivos de anotación, cada uno de los cuales debe almacenarse como un blob en un contenedor de blobs de Azure Storage. Cada archivo debe seguir el formato COCO para el AnnotationKind especificado, con cada ruta de acceso de imagen siendo un URI absoluto para un blob en un contenedor de blobs. El recurso de Computer Vision debe tener permiso para leer los archivos de anotación y todos los archivos de imagen a los que se hace referencia. Para ello, active Identidades administradas del sistema para el recurso de Computer Vision y, a continuación, asigne la identidad a un rol que tenga permiso para leer desde el contenedor de blobs que contiene los archivos de anotación e imagen.
annotationKind	AnnotationKind	Tipo de anotaciones contenidas en los archivos de anotación. Por ejemplo, "ImageClassification" para especificar que el archivo de anotación contenga etiquetas de objeto para entrenar o probar un modelo de clasificación de imágenes multiclase.
authentication	StorageAuthenticationSettingsApiModel	Describe la configuración de autenticación de almacenamiento.
createdDateTime	string	Solo lectura. Fecha y hora en que el conjunto de datos se registró por primera vez, en UTC.
customProperties	object	Diccionario de pares clave-valor arbitrarios para su uso por parte de la aplicación. Se permite un máximo de 10 pares clave-valor.
eTag	string	Solo lectura. ETag más reciente del conjunto de datos. Se puede usar con el encabezado "If-Match" al actualizar o eliminar un conjunto de datos.
name	string	Solo lectura. Nombre que se usa para identificar de forma única el conjunto de datos.
updatedDateTime	string	Solo lectura. Fecha y hora en que se actualizó por última vez el conjunto de datos, en UTC.

ErrorResponse

Respuesta devuelta cuando se produce un error.

Nombre	Tipo	Description
error	ErrorResponseDetails	Información de error.

ErrorResponseDetails

Información de error.

Nombre	Tipo	Description
code	string	Código de error.
details	ErrorResponseDetails[]	Lista de errores detallados.
innererror	ErrorResponseInnerError	Error detallado.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponseInnerError

Error detallado.

Nombre	Tipo	Description
code	string	Código de error.
innererror	ErrorResponseInnerError	Error detallado.
message	string	Mensaje de error.

StorageAuthenticationKind

Tipo de autenticación de almacenamiento.

Nombre	Tipo	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Describe la configuración de autenticación de almacenamiento.

Nombre	Tipo	Description
kind	StorageAuthenticationKind	Tipo de autenticación de almacenamiento.
sasToken	string	Opcional. Token sas para acceder al contenedor. Solo es necesario cuando Kind = Sas.

Compartir a través de

Datasets - Update

Parámetros de identificador URI

Encabezado de la solicitud

Cuerpo de la solicitud

Respuestas

Ejemplos

Datasets_Update

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Recursos adicionales