Datasets - Update

Servizio:: Azure AI Services

Versione API:: 2023-04-01-preview

Aggiornare le proprietà di un set di dati esistente.

Codici di stato restituiti:

200: operazione completata correttamente.
400: La richiesta non è valida.
404: Non è stato trovato un set di dati con il nome specificato.
412: è stata fornita un'intestazione If-Match, ma l'ETag specificato non corrisponde al valore ETag corrente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Nome del set di dati da aggiornare.
api-version	query	True	string	Versione dell'API richiesta.

Intestazione della richiesta

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

Nome	Necessario	Tipo	Descrizione
If-Match		string	ETag facoltativo per il set di dati da aggiornare. Se viene specificato un ETag, il set di dati verrà aggiornato solo se il valore ETag corrente corrisponde all'ETag specificato. Se i valori ETag non corrispondono, l'operazione di aggiornamento avrà esito negativo con codice di stato 412 (precondizione non riuscita). Ciò indica che il set di dati è stato aggiornato dall'ultima volta che sono state ottenute le informazioni per il set di dati. Se non viene specificato un ETag o il relativo valore è '*', il set di dati verrà sempre aggiornato indipendentemente dal valore ETag corrente.

Corpo della richiesta

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

Nome	Tipo	Descrizione
annotationFileUris	string[] (uri)	Elenco di URI assoluti per i file di annotazione, ognuno dei quali deve essere archiviato come BLOB in un contenitore BLOB di Archiviazione di Azure. Ogni file deve seguire il formato COCO per l'oggetto AnnotationKind specificato, con ogni percorso di immagine un URI assoluto per un BLOB in un contenitore BLOB. La risorsa Visione artificiale deve avere l'autorizzazione per leggere i file di annotazione e tutti i file di immagine a cui si fa riferimento. A tale scopo, è possibile attivare le identità gestite dal sistema per la risorsa Visione artificiale, quindi assegnare l'identità a un ruolo che abbia l'autorizzazione per leggere dal contenitore BLOB contenente i file di annotazione e immagine.
annotationKind	AnnotationKind	Tipo di annotazioni contenute nei file di annotazione. Ad esempio, "ImageClassification" per specificare che il file di annotazione contiene etichette oggetto per il training o il test di un modello di classificazione delle immagini multiclasse.
authentication	StorageAuthenticationSettingsApiModel	Descrive le impostazioni di autenticazione dell'archiviazione.
createdDateTime	string (date-time)	Elemento di sola lettura. Data e ora in cui il set di dati è stato registrato per la prima volta, in formato UTC.
customProperties	object	Dizionario di coppie chiave-valore arbitrarie da usare dall'applicazione. È consentito un massimo di 10 coppie chiave-valore.
eTag	string	Elemento di sola lettura. L'ETag più recente per il set di dati. Può essere usato con l'intestazione "If-Match" durante l'aggiornamento o l'eliminazione di un set di dati.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Elemento di sola lettura. Nome utilizzato per identificare in modo univoco il set di dati.
updatedDateTime	string (date-time)	Elemento di sola lettura. Data e ora dell'ultimo aggiornamento del set di dati, in formato UTC.

Risposte

Nome	Tipo	Descrizione
200 OK	Dataset	Successo
Other Status Codes	ErrorResponse	Errore Intestazioni x-ms-error-code: string

Nome

Tipo

Descrizione

200 OK

Dataset

Successo

Other Status Codes

ErrorResponse

Errore

Intestazioni

x-ms-error-code: string

Esempio

Datasets_Update

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
AnnotationKind	Tipo di annotazioni contenute nei file di annotazione. Ad esempio, "ImageClassification" per specificare che il file di annotazione contiene etichette oggetto per il training o il test di un modello di classificazione delle immagini multiclasse.
Dataset	Descrive un set di dati, che rappresenta un set di immagini e annotazioni che possono essere usate per il training o il test di un modello.
ErrorResponse	Risposta restituita quando si verifica un errore.
ErrorResponseDetails	Informazioni sull'errore.
ErrorResponseInnerError	Errore dettagliato.
StorageAuthenticationKind	Tipo di autenticazione di archiviazione.
StorageAuthenticationSettingsApiModel	Descrive le impostazioni di autenticazione dell'archiviazione.

AnnotationKind

Enumerazione

Tipo di annotazioni contenute nei file di annotazione. Ad esempio, "ImageClassification" per specificare che il file di annotazione contiene etichette oggetto per il training o il test di un modello di classificazione delle immagini multiclasse.

Valore	Descrizione
imageClassification
imageObjectDetection

Dataset

Object

Descrive un set di dati, che rappresenta un set di immagini e annotazioni che possono essere usate per il training o il test di un modello.

Nome	Tipo	Descrizione
annotationFileUris	string[] (uri)	Elenco di URI assoluti per i file di annotazione, ognuno dei quali deve essere archiviato come BLOB in un contenitore BLOB di Archiviazione di Azure. Ogni file deve seguire il formato COCO per l'oggetto AnnotationKind specificato, con ogni percorso di immagine un URI assoluto per un BLOB in un contenitore BLOB. La risorsa Visione artificiale deve avere l'autorizzazione per leggere i file di annotazione e tutti i file di immagine a cui si fa riferimento. A tale scopo, è possibile attivare le identità gestite dal sistema per la risorsa Visione artificiale, quindi assegnare l'identità a un ruolo che abbia l'autorizzazione per leggere dal contenitore BLOB contenente i file di annotazione e immagine.
annotationKind	AnnotationKind	Tipo di annotazioni contenute nei file di annotazione. Ad esempio, "ImageClassification" per specificare che il file di annotazione contiene etichette oggetto per il training o il test di un modello di classificazione delle immagini multiclasse.
authentication	StorageAuthenticationSettingsApiModel	Descrive le impostazioni di autenticazione dell'archiviazione.
createdDateTime	string (date-time)	Elemento di sola lettura. Data e ora in cui il set di dati è stato registrato per la prima volta, in formato UTC.
customProperties	object	Dizionario di coppie chiave-valore arbitrarie da usare dall'applicazione. È consentito un massimo di 10 coppie chiave-valore.
eTag	string	Elemento di sola lettura. L'ETag più recente per il set di dati. Può essere usato con l'intestazione "If-Match" durante l'aggiornamento o l'eliminazione di un set di dati.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Elemento di sola lettura. Nome utilizzato per identificare in modo univoco il set di dati.
updatedDateTime	string (date-time)	Elemento di sola lettura. Data e ora dell'ultimo aggiornamento del set di dati, in formato UTC.

ErrorResponse

Object

Risposta restituita quando si verifica un errore.

Nome	Tipo	Descrizione
error	ErrorResponseDetails	Informazioni sull'errore.

ErrorResponseDetails

Object

Informazioni sull'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ErrorResponseDetails[]	Elenco di errori dettagliati.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponseInnerError

Object

Errore dettagliato.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.

StorageAuthenticationKind

Enumerazione

Tipo di autenticazione di archiviazione.

Valore	Descrizione
none
managedIdentity
sas

StorageAuthenticationSettingsApiModel

Object

Descrive le impostazioni di autenticazione dell'archiviazione.

Nome	Tipo	Descrizione
kind	StorageAuthenticationKind	Tipo di autenticazione di archiviazione.
sasToken	string	Opzionale. Token di firma di accesso condiviso per accedere al contenitore. Necessario solo quando Kind = Sas.

Condividi tramite

Datasets - Update

Parametri dell'URI

Intestazione della richiesta

Corpo della richiesta

Risposte

Esempio

Datasets_Update

Esempio di richiesta

Risposta di esempio

Definizioni

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel