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 è stata malformata.
• 404: non è stato trovato un set di dati con il nome specificato.
• 412: è stata fornita un'intestazione If-Match, ma il valore 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	Nome del set di dati da aggiornare. Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
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	Facoltativo ETag per il set di dati da aggiornare. Se viene fornito un ETag, il set di dati verrà aggiornato solo se il relativo valore ETag corrente corrisponde al valore ETag specificato. Se i valori ETag non corrispondono, l'operazione di aggiornamento avrà esito negativo con il 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 relative al set di dati. Se un ETag non viene fornito 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[]	Elenco di URI assoluti per annotare i file, ognuno dei quali deve essere archiviato come BLOB in un contenitore BLOB di Archiviazione di Azure. Ogni file deve seguire il formato COCO per AnnotationKind specificato, con ogni percorso di immagine che rappresenta un URI assoluto in un BLOB in un contenitore BLOB. La risorsa Visione artificiale deve disporre dell'autorizzazione per leggere i file di annotazione e tutti i file di immagine a cui si fa riferimento. Questa operazione può essere eseguita attivando identità gestite dal sistema per la risorsa Visione artificiale, quindi assegnando l'identità a un ruolo che dispone dell'autorizzazione per la lettura dal contenitore BLOB contenente le annotazioni e i file di 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 di archiviazione.
createdDateTime	string	Sola lettura. Data e ora in cui il set di dati è stato registrato per la prima volta in formato UTC.
customProperties	object	Dizionario delle coppie chiave-valore arbitrarie da usare dall'applicazione. Sono consentiti un massimo di 10 coppie chiave-valore.
eTag	string	Sola lettura. L'ultimo ETag 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	Sola lettura. Nome utilizzato per identificare in modo univoco il set di dati.
updatedDateTime	string	Sola lettura. Data e ora dell'ultimo aggiornamento del set di dati in formato UTC.

Risposte

Nome	Tipo	Descrizione
200 OK	Dataset	Operazione completata
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 di archiviazione.

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.

Nome	Tipo	Descrizione
imageClassification	string
imageObjectDetection	string

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.

Nome	Tipo	Descrizione
annotationFileUris	string[]	Elenco di URI assoluti per annotare i file, ognuno dei quali deve essere archiviato come BLOB in un contenitore BLOB di Archiviazione di Azure. Ogni file deve seguire il formato COCO per AnnotationKind specificato, con ogni percorso di immagine che rappresenta un URI assoluto in un BLOB in un contenitore BLOB. La risorsa Visione artificiale deve disporre dell'autorizzazione per leggere i file di annotazione e tutti i file di immagine a cui si fa riferimento. Questa operazione può essere eseguita attivando identità gestite dal sistema per la risorsa Visione artificiale, quindi assegnando l'identità a un ruolo che dispone dell'autorizzazione per la lettura dal contenitore BLOB contenente le annotazioni e i file di 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 di archiviazione.
createdDateTime	string	Sola lettura. Data e ora in cui il set di dati è stato registrato per la prima volta in formato UTC.
customProperties	object	Dizionario delle coppie chiave-valore arbitrarie da usare dall'applicazione. Sono consentiti un massimo di 10 coppie chiave-valore.
eTag	string	Sola lettura. L'ultimo ETag 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	Sola lettura. Nome utilizzato per identificare in modo univoco il set di dati.
updatedDateTime	string	Sola lettura. Data e ora dell'ultimo aggiornamento del set di dati in formato UTC.

ErrorResponse

Risposta restituita quando si verifica un errore.

Nome	Tipo	Descrizione
error	ErrorResponseDetails	Informazioni sull'errore.

ErrorResponseDetails

Informazioni sull'errore.

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

ErrorResponseInnerError

Errore dettagliato.

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

StorageAuthenticationKind

Tipo di autenticazione di archiviazione.

Nome	Tipo	Descrizione
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Descrive le impostazioni di autenticazione di archiviazione.

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