Datasets - Update

Referência

Serviço:: Azure AI Services

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

Atualize as propriedades de um conjunto de dados existente.

Códigos de estado devolvidos:

200: Operação concluída com êxito.
400: O pedido foi mal formado.
404: não foi encontrado um conjunto de dados com o nome especificado.
412: Foi fornecido um cabeçalho If-Match, mas o ETag especificado não corresponde ao valor ETag atual.

PATCH /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	O nome do conjunto de dados a atualizar. 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

O nome do conjunto de dados a atualizar.

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

api-version

query

True

string

Versão da API pedida.

Cabeçalho do Pedido

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

Name	Necessário	Tipo	Description
If-Match		string	ETag opcional para o conjunto de dados atualizar. Se for fornecido um ETag, o conjunto de dados só será atualizado se o respetivo valor ETag atual corresponder ao ETag especificado. Se os valores do ETag não corresponderem, a operação de atualização falhará com o código de estado 412 (Falha na Pré-condição). Isto indica que o conjunto de dados foi atualizado desde a última vez que as informações do conjunto de dados foram obtidas. Se não for fornecido um ETag ou o respetivo valor for "*", o conjunto de dados será sempre atualizado independentemente do valor ETag atual.

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 para a AnnotationKind especificada, sendo 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 preparar ou testar 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. O 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
200 OK	Dataset	Success
Other Status Codes	ErrorResponse	Erro Cabeçalhos x-ms-error-code: string

Name

Tipo

Description

200 OK

Dataset

Success

Other Status Codes

ErrorResponse

Erro

Cabeçalhos

x-ms-error-code: string

Exemplos

Datasets_Update

Pedido de amostra

HTTP

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

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

Resposta da amostra

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

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 preparar ou testar 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 preparar ou testar 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 para a AnnotationKind especificada, sendo 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 preparar ou testar 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. O 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 - Update

Parâmetros do URI

Cabeçalho do Pedido

Corpo do Pedido

Respostas

Exemplos

Datasets_Update

Pedido de amostra

Resposta da amostra

Definições

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Recursos adicionais