Datasets - List
Ottenere un elenco di set di dati registrati.
Codici di stato restituiti:
- 200: Operazione completata correttamente.
- 400: la richiesta è stata malformata.
GET /datasets?api-version=2023-04-01-preview
GET /datasets?skip={skip}&top={top}&api-version=2023-04-01-preview
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
api-version
|
query | True |
string |
Versione dell'API richiesta. |
skip
|
query |
integer int32 |
Numero di set di dati da ignorare. |
|
top
|
query |
integer int32 |
Numero di set di dati da restituire dopo aver ignorato. Il valore massimo consentito è 30. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione completata |
|
Other Status Codes |
Errore Intestazioni x-ms-error-code: string |
Esempio
Datasets_List
Esempio di richiesta
GET /datasets?api-version=2023-04-01-preview
Risposta di esempio
{
"value": [
{
"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 |
---|---|
Annotation |
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. |
Dataset |
Contiene una matrice di risultati che possono essere impaginati. |
Error |
Risposta restituita quando si verifica un errore. |
Error |
Informazioni sull'errore. |
Error |
Errore dettagliato. |
Storage |
Tipo di autenticazione di archiviazione. |
Storage |
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 |
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 |
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. |
DatasetApiModelCollectionApiModel
Contiene una matrice di risultati che possono essere impaginati.
Nome | Tipo | Descrizione |
---|---|---|
nextLink |
string |
Collegamento al set successivo di risultati impaginati, se sono disponibili altri risultati; non presente in caso contrario. |
value |
Dataset[] |
Matrice di risultati. |
ErrorResponse
Risposta restituita quando si verifica un errore.
Nome | Tipo | Descrizione |
---|---|---|
error |
Informazioni sull'errore. |
ErrorResponseDetails
Informazioni sull'errore.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
details |
Elenco degli errori dettagliati. |
|
innererror |
Errore dettagliato. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponseInnerError
Errore dettagliato.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore. |
innererror |
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 |
Tipo di autenticazione di archiviazione. |
|
sasToken |
string |
facoltativo. Token di firma di accesso condiviso per accedere al contenitore. È necessario solo quando Kind = Sas. |