Datasets - Get

Servizio:

Azure AI Services

Versione API:

2023-04-01-preview

Ottenere informazioni su un set di dati specifico.

Codici di stato restituiti:

• 200: Operazione completata correttamente.
• 400: La richiesta non è riuscita.
• 404: non è stato trovato un set di dati con il nome specificato.

GET /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 ottenere. Criterio di espressione regolare: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Versione dell'API richiesta.

Risposte

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

Esempio

Datasets_Get

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:

200

{
  "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"
}

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 sugli errori.
ErrorResponseInnerError	Errore dettagliato.
StorageAuthenticationKind	Tipo di autenticazione dell'archiviazione.
StorageAuthenticationSettingsApiModel	Descrive le impostazioni di autenticazione dell'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 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'AnnotationKind specificato, con ogni percorso 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. A tale scopo, è possibile attivare 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 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 dell'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 di coppie chiave-valore arbitrarie da usare dall'applicazione. È consentito un massimo di 10 coppie chiave-valore.
eTag	string	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	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 sugli errori.

ErrorResponseDetails

Informazioni sugli errori.

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 dell'archiviazione.

Nome	Tipo	Descrizione
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Descrive le impostazioni di autenticazione dell'archiviazione.

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