Datasets - Get

Služba:

Azure AI Services

Verze rozhraní API:

2023-04-01-preview

Získejte informace o konkrétní datové sadě.

Vrácené stavové kódy:

• 200: Operace byla úspěšně dokončena.
• 400: Žádost byla poškozena.
• 404: Datová sada se zadaným názvem nebyla nalezena.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Název datové sady, která se má získat.
api-version	query	True	string	Požadovaná verze rozhraní API

Odpovědi

Name	Typ	Description
200 OK	Dataset	Úspěch
Other Status Codes	ErrorResponse	Chyba Hlavičky x-ms-error-code: string

Příklady

Datasets_Get

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:

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

Definice

Name	Description
AnnotationKind	Druh poznámek obsažených v souborech poznámek. Například "ImageClassification" určuje, že soubor poznámek obsahuje popisky objektů pro trénování nebo testování modelu klasifikace obrázků s více třídami.
Dataset	Popisuje datovou sadu, která představuje sadu obrázků a poznámek, které lze použít k trénování nebo testování modelu.
ErrorResponse	Odpověď se vrátí, když dojde k chybě.
ErrorResponseDetails	Informace o chybě
ErrorResponseInnerError	Podrobná chyba
StorageAuthenticationKind	Druh ověřování úložiště.
StorageAuthenticationSettingsApiModel	Popisuje nastavení ověřování úložiště.

AnnotationKind

Výčet

Druh poznámek obsažených v souborech poznámek. Například "ImageClassification" určuje, že soubor poznámek obsahuje popisky objektů pro trénování nebo testování modelu klasifikace obrázků s více třídami.

Hodnota	Description
imageClassification
imageObjectDetection

Dataset

Objekt

Popisuje datovou sadu, která představuje sadu obrázků a poznámek, které lze použít k trénování nebo testování modelu.

Name	Typ	Description
annotationFileUris	string[] (uri)	Seznam absolutních identifikátorů URI pro soubory poznámek, z nichž každý musí být uložen jako objekt blob v kontejneru objektů blob služby Azure Storage. Každý soubor musí dodržovat formát COCO pro zadaný AnnotationKind, přičemž každá cesta k obrázku je absolutní identifikátor URI objektu blob v kontejneru objektů blob. Prostředek počítačového zpracování obrazu musí mít oprávnění ke čtení souborů poznámek a všech odkazovaných souborů obrázků. Můžete to provést zapnutím systémových spravovaných identit pro prostředek počítačového zpracování obrazu a následným přiřazením identity k roli, která má oprávnění ke čtení z kontejneru objektů blob obsahujícího soubory poznámek a obrázků.
annotationKind	AnnotationKind	Druh poznámek obsažených v souborech poznámek. Například "ImageClassification" určuje, že soubor poznámek obsahuje popisky objektů pro trénování nebo testování modelu klasifikace obrázků s více třídami.
authentication	StorageAuthenticationSettingsApiModel	Popisuje nastavení ověřování úložiště.
createdDateTime	string (date-time)	Jen pro čtení. Datum a čas, kdy byla datová sada poprvé zaregistrována, v UTC.
customProperties	object	Slovník libovolných párů klíč-hodnota pro použití aplikací. Je povoleno maximálně 10 párů klíč-hodnota.
eTag	string	Jen pro čtení. Nejnovější značky ETag pro datovou sadu. Při aktualizaci nebo odstranění datové sady je možné použít hlavičku If-Match.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Jen pro čtení. Název, který se používá k jednoznačné identifikaci datové sady.
updatedDateTime	string (date-time)	Jen pro čtení. Datum a čas poslední aktualizace datové sady v UTC.

ErrorResponse

Objekt

Odpověď se vrátí, když dojde k chybě.

Name	Typ	Description
error	ErrorResponseDetails	Informace o chybě

ErrorResponseDetails

Objekt

Informace o chybě

Name	Typ	Description
code	string	Kód chyby
details	ErrorResponseDetails[]	Seznam podrobných chyb
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.
target	string	Cíl chyby.

ErrorResponseInnerError

Objekt

Podrobná chyba

Name	Typ	Description
code	string	Kód chyby
innererror	ErrorResponseInnerError	Podrobná chyba
message	string	Zpráva o chybě.

StorageAuthenticationKind

Výčet

Druh ověřování úložiště.

Hodnota	Description
managedIdentity
none
sas

StorageAuthenticationSettingsApiModel

Objekt

Popisuje nastavení ověřování úložiště.

Name	Typ	Description
kind	StorageAuthenticationKind	Druh ověřování úložiště.
sasToken	string	Volitelný. Token SAS pro přístup ke kontejneru. Potřeba je pouze v případě, že Kind = Sas.