Datasets - Create

Služba:

Azure AI Services

Verze rozhraní API:

2023-04-01-preview

Zaregistrujte novou datovou sadu.

Vráceny stavové kódy:

• 201: Operace byla úspěšně dokončena.
• 400: Požadavek byl poškozen.
• 409: Datová sada se zadaným názvem už existuje.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
name	path	True	string	Název, který lze použít k jednoznačné identifikaci datové sady po registraci. Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Požadovaná verze rozhraní API

Text požadavku

Media Types: "application/json-patch+json"

Name	Typ	Description
annotationFileUris	string[]	Seznam absolutních identifikátorů URI souborů 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í mít 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 identit spravovaných systémem 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	Jen pro čtení. Datum a čas, kdy byla datová sada poprvé zaregistrována, ve standardu 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čka ETag pro datovou sadu Při aktualizaci nebo odstraňování datové sady se dá použít s hlavičkou If-Match.
name	string	Jen pro čtení. Název, který slouží k jednoznačné identifikaci datové sady.
updatedDateTime	string	Jen pro čtení. Datum a čas poslední aktualizace datové sady ve standardu UTC.

Odpovědi

Name	Typ	Description
201 Created	Dataset	Vytvořeno
Other Status Codes	ErrorResponse	Chyba Hlavičky x-ms-error-code: string

Příklady

RegisterDataset_ImageClassification

Ukázkový požadavek

HTTP

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

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://example.com/dataset.json"
  ]
}

Ukázková odpověď

Stavový kód:

201

{
  "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ěď vrácená, 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

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.

Name	Typ	Description
imageClassification	string
imageObjectDetection	string

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.

Name	Typ	Description
annotationFileUris	string[]	Seznam absolutních identifikátorů URI souborů 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í mít 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 identit spravovaných systémem 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	Jen pro čtení. Datum a čas, kdy byla datová sada poprvé zaregistrována, ve standardu 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čka ETag pro datovou sadu Při aktualizaci nebo odstraňování datové sady se dá použít s hlavičkou If-Match.
name	string	Jen pro čtení. Název, který slouží k jednoznačné identifikaci datové sady.
updatedDateTime	string	Jen pro čtení. Datum a čas poslední aktualizace datové sady ve standardu UTC.

ErrorResponse

Odpověď vrácená, když dojde k chybě.

Name	Typ	Description
error	ErrorResponseDetails	Informace o chybě.

ErrorResponseDetails

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

Podrobná chyba.

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

StorageAuthenticationKind

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

Name	Typ	Description
managedIdentity	string
none	string
sas	string

StorageAuthenticationSettingsApiModel

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

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