Datasets - Get

Tjänst:

Azure AI Services

API-version:

2023-04-01-preview

Hämta information om en specifik datauppsättning.

Statuskoder som returneras:

• 200: Åtgärden har slutförts.
• 400: Begäran var felaktig.
• 404: Det gick inte att hitta en datauppsättning med det angivna namnet.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string	Namnet på datauppsättningen som ska hämtas. Reguljärt uttrycksmönster: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Begärd API-version.

Svar

Name	Typ	Description
200 OK	Dataset	Klart
Other Status Codes	ErrorResponse	Fel Sidhuvuden x-ms-error-code: string

Exempel

Datasets_Get

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
AnnotationKind	Den typ av anteckningar som finns i anteckningsfilerna. Till exempel "ImageClassification" för att ange att anteckningsfilen innehåller objektetiketter för träning eller testning av en bildklassificeringsmodell med flera klasser.
Dataset	Beskriver en datauppsättning som representerar en uppsättning bilder och anteckningar som kan användas för att träna eller testa en modell.
ErrorResponse	Svar som returneras när ett fel inträffar.
ErrorResponseDetails	Felinformation.
ErrorResponseInnerError	Detaljerat fel.
StorageAuthenticationKind	Typ av lagringsautentisering.
StorageAuthenticationSettingsApiModel	Beskriver inställningarna för lagringsautentisering.

AnnotationKind

Den typ av anteckningar som finns i anteckningsfilerna. Till exempel "ImageClassification" för att ange att anteckningsfilen innehåller objektetiketter för träning eller testning av en bildklassificeringsmodell med flera klasser.

Name	Typ	Description
imageClassification	string
imageObjectDetection	string

Dataset

Beskriver en datauppsättning som representerar en uppsättning bilder och anteckningar som kan användas för att träna eller testa en modell.

Name	Typ	Description
annotationFileUris	string[]	Lista över absoluta URI:er till anteckningsfiler som var och en måste lagras som en blob i en Azure Storage-blobcontainer. Varje fil måste följa COCO-formatet för angiven AnnotationKind, där varje bildsökväg är en absolut URI för en blob i en blobcontainer. Resursen Visuellt innehåll måste ha behörighet att läsa anteckningsfilerna och alla refererade bildfiler. Detta kan göras genom att aktivera Systemhanterade identiteter för resursen Visuellt innehåll och sedan tilldela identiteten till en roll som har behörighet att läsa från blobcontainern som innehåller antecknings- och bildfilerna.
annotationKind	AnnotationKind	Den typ av anteckningar som finns i anteckningsfilerna. Till exempel "ImageClassification" för att ange att anteckningsfilen innehåller objektetiketter för träning eller testning av en bildklassificeringsmodell med flera klasser.
authentication	StorageAuthenticationSettingsApiModel	Beskriver inställningarna för lagringsautentisering.
createdDateTime	string	Skrivskyddad. Datum och tid då datauppsättningen först registrerades, i UTC.
customProperties	object	Ordlista över godtyckliga nyckel/värde-par som ska användas av programmet. Högst 10 nyckel/värde-par tillåts.
eTag	string	Skrivskyddad. Den senaste ETag för datauppsättningen. Kan användas med rubriken "If-Match" när du uppdaterar eller tar bort en datauppsättning.
name	string	Skrivskyddad. Det namn som används för att unikt identifiera datauppsättningen.
updatedDateTime	string	Skrivskyddad. Datum och tid då datauppsättningen senast uppdaterades, i UTC.

ErrorResponse

Svar som returneras när ett fel inträffar.

Name	Typ	Description
error	ErrorResponseDetails	Felinformation.

ErrorResponseDetails

Felinformation.

Name	Typ	Description
code	string	Felkod.
details	ErrorResponseDetails[]	Lista över detaljerade fel.
innererror	ErrorResponseInnerError	Detaljerat fel.
message	string	Felmeddelande.
target	string	Målet för felet.

ErrorResponseInnerError

Detaljerat fel.

Name	Typ	Description
code	string	Felkod.
innererror	ErrorResponseInnerError	Detaljerat fel.
message	string	Felmeddelande.

StorageAuthenticationKind

Typ av lagringsautentisering.

Name	Typ	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

Beskriver inställningarna för lagringsautentisering.

Name	Typ	Description
kind	StorageAuthenticationKind	Typ av lagringsautentisering.
sasToken	string	Valfritt. Sas-token för att få åtkomst till containern. Behövs bara när Kind = Sas.