Datasets - Create

Referencia

Servicio:: Azure AI Services

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

Permite registrar un nuevo conjunto de datos.

Códigos de estado devueltos:

201: Operación completada correctamente.
400: La solicitud tenía un formato incorrecto.
409: ya existe un conjunto de datos con el nombre especificado.

PUT /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 que se puede usar para identificar de forma única el conjunto de datos una vez registrado. 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 que se puede usar para identificar de forma única el conjunto de datos una vez registrado.

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

api-version

query

True

string

Versión de API solicitada.

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 elemento 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 el conjunto de datos se actualizó por última vez, en UTC.

Respuestas

Nombre	Tipo	Description
201 Created	Dataset	Creado
Other Status Codes	ErrorResponse	Error Encabezados x-ms-error-code: string

Nombre

Tipo

Description

201 Created

Dataset

Creado

Other Status Codes

ErrorResponse

Error

Encabezados

x-ms-error-code: string

Ejemplos

RegisterDataset_ImageClassification

Solicitud de ejemplo

HTTP

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

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ]
}

Respuesta de muestra

status code:: 201

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ],
  "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 elemento 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 el conjunto de datos se actualizó por última vez, 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 - Create

Parámetros de identificador URI

Cuerpo de la solicitud

Respuestas

Ejemplos

RegisterDataset_ImageClassification

Solicitud de ejemplo

Respuesta de muestra

Definiciones

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Recursos adicionales