Datasets - Create

Referência

Serviço:: Azure AI Services

Versão da API:: 2023-04-01-preview

Registar um novo conjunto de dados.

Códigos de estado devolvidos:

201: Operação concluída com êxito.
400: O pedido foi mal formado.
409: já existe um conjunto de dados com o nome especificado.

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

Parâmetros do URI

Name Em Necessário Tipo Description

Name	Em	Necessário	Tipo	Description
name	path	True	string	Um nome que pode ser utilizado para identificar exclusivamente o conjunto de dados depois de ter sido registado. Padrão Regex: `^[a-zA-Z0-9][a-zA-Z0-9._-]*$`
api-version	query	True	string	Versão da API pedida.

name

path

True

string

Um nome que pode ser utilizado para identificar exclusivamente o conjunto de dados depois de ter sido registado.

Padrão Regex: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$

api-version

query

True

string

Versão da API pedida.

Corpo do Pedido

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

Name	Tipo	Description
annotationFileUris	string[]	Lista de URIs absolutos para ficheiros de anotação, cada um dos quais tem de ser armazenado como um blob num contentor de blobs do Armazenamento do Azure. Cada ficheiro tem de seguir o formato COCO do AnnotationKind especificado, sendo que cada caminho de imagem é um URI absoluto para um blob num contentor de blobs. O recurso de Imagem Digitalizada tem de ter permissão para ler os ficheiros de anotação e todos os ficheiros de imagem referenciados. Isto pode ser feito ao ativar as identidades geridas pelo sistema para o recurso de Imagem Digitalizada e, em seguida, atribuir a identidade a uma função que tenha permissão para ler a partir do contentor de blobs que contém os ficheiros de anotação e imagem.
annotationKind	AnnotationKind	O tipo de anotações contidas nos ficheiros de anotação. Por exemplo, "ImageClassification" para especificar que o ficheiro de anotação contém etiquetas de objeto para preparação ou teste de um modelo de classificação de imagens de várias classes.
authentication	StorageAuthenticationSettingsApiModel	Descreve as definições de autenticação de armazenamento.
createdDateTime	string	Só de leitura. A data e hora em que o conjunto de dados foi registado pela primeira vez, em UTC.
customProperties	object	Dicionário de pares de chave-valor arbitrários para utilização pela aplicação. É permitido um máximo de 10 pares chave-valor.
eTag	string	Só de leitura. A ETag mais recente do conjunto de dados. Pode ser utilizado com o cabeçalho "If-Match" ao atualizar ou eliminar um conjunto de dados.
name	string	Só de leitura. O nome utilizado para identificar exclusivamente o conjunto de dados.
updatedDateTime	string	Só de leitura. A data e hora em que o conjunto de dados foi atualizado pela última vez, em UTC.

Respostas

Name	Tipo	Description
201 Created	Dataset	Criado
Other Status Codes	ErrorResponse	Erro Cabeçalhos x-ms-error-code: string

Name

Tipo

Description

201 Created

Dataset

Criado

Other Status Codes

ErrorResponse

Erro

Cabeçalhos

x-ms-error-code: string

Exemplos

RegisterDataset_ImageClassification

Pedido de amostra

HTTP

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

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

Resposta da amostra

Código de estado:: 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"
}

Definições

Name	Description
AnnotationKind	O tipo de anotações contidas nos ficheiros de anotação. Por exemplo, "ImageClassification" para especificar que o ficheiro de anotação contém etiquetas de objeto para preparação ou teste de um modelo de classificação de imagens de várias classes.
Dataset	Descreve um conjunto de dados, que representa um conjunto de imagens e anotações que podem ser utilizadas para preparar ou testar um modelo.
ErrorResponse	Resposta devolvida quando ocorre um erro.
ErrorResponseDetails	Informações de erro.
ErrorResponseInnerError	Erro detalhado.
StorageAuthenticationKind	O tipo de autenticação de armazenamento.
StorageAuthenticationSettingsApiModel	Descreve as definições de autenticação de armazenamento.

AnnotationKind

O tipo de anotações contidas nos ficheiros de anotação. Por exemplo, "ImageClassification" para especificar que o ficheiro de anotação contém etiquetas de objeto para preparação ou teste de um modelo de classificação de imagens de várias classes.

Name	Tipo	Description
imageClassification	string
imageObjectDetection	string

Dataset

Descreve um conjunto de dados, que representa um conjunto de imagens e anotações que podem ser utilizadas para preparar ou testar um modelo.

Name	Tipo	Description
annotationFileUris	string[]	Lista de URIs absolutos para ficheiros de anotação, cada um dos quais tem de ser armazenado como um blob num contentor de blobs do Armazenamento do Azure. Cada ficheiro tem de seguir o formato COCO do AnnotationKind especificado, sendo que cada caminho de imagem é um URI absoluto para um blob num contentor de blobs. O recurso de Imagem Digitalizada tem de ter permissão para ler os ficheiros de anotação e todos os ficheiros de imagem referenciados. Isto pode ser feito ao ativar as identidades geridas pelo sistema para o recurso de Imagem Digitalizada e, em seguida, atribuir a identidade a uma função que tenha permissão para ler a partir do contentor de blobs que contém os ficheiros de anotação e imagem.
annotationKind	AnnotationKind	O tipo de anotações contidas nos ficheiros de anotação. Por exemplo, "ImageClassification" para especificar que o ficheiro de anotação contém etiquetas de objeto para preparação ou teste de um modelo de classificação de imagens de várias classes.
authentication	StorageAuthenticationSettingsApiModel	Descreve as definições de autenticação de armazenamento.
createdDateTime	string	Só de leitura. A data e hora em que o conjunto de dados foi registado pela primeira vez, em UTC.
customProperties	object	Dicionário de pares de chave-valor arbitrários para utilização pela aplicação. É permitido um máximo de 10 pares chave-valor.
eTag	string	Só de leitura. A ETag mais recente do conjunto de dados. Pode ser utilizado com o cabeçalho "If-Match" ao atualizar ou eliminar um conjunto de dados.
name	string	Só de leitura. O nome utilizado para identificar exclusivamente o conjunto de dados.
updatedDateTime	string	Só de leitura. A data e hora em que o conjunto de dados foi atualizado pela última vez, em UTC.

ErrorResponse

Resposta devolvida quando ocorre um erro.

Name	Tipo	Description
error	ErrorResponseDetails	Informações de erro.

ErrorResponseDetails

Informações de erro.

Name	Tipo	Description
code	string	Código de erro.
details	ErrorResponseDetails[]	Lista de erros detalhados.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.
target	string	Destino do erro.

ErrorResponseInnerError

Erro detalhado.

Name	Tipo	Description
code	string	Código de erro.
innererror	ErrorResponseInnerError	Erro detalhado.
message	string	Mensagem de erro.

StorageAuthenticationKind

O tipo de autenticação de armazenamento.

Name	Tipo	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Descreve as definições de autenticação de armazenamento.

Name	Tipo	Description
kind	StorageAuthenticationKind	O tipo de autenticação de armazenamento.
sasToken	string	Opcional. O token sas para aceder ao contentor. Só é necessário quando Kind = Sas.

Partilhar via

Datasets - Create

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

RegisterDataset_ImageClassification

Pedido de amostra

Resposta da amostra

Definições

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Recursos adicionais