Datasets - Update

Služba:

Azure AI Services

Verze rozhraní API:

2023-04-01-preview

Aktualizujte vlastnosti existující datové sady.

Vráceny stavové kódy:

• 200: Operace byla úspěšně dokončena.
• 400: Požadavek byl poškozen.
• 404: Datová sada se zadaným názvem nebyla nalezena.
• 412: Byla zadána hlavička If-Match, ale daná značka ETag neodpovídá aktuální hodnotě ETag.

PATCH /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 datové sady, která se má aktualizovat. Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$
api-version	query	True	string	Požadovaná verze rozhraní API

Hlavička požadavku

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

Name	Vyžadováno	Typ	Description
If-Match		string	Volitelná značka ETag pro datovou sadu, která se má aktualizovat. Pokud je zadána značka ETag, datová sada se aktualizuje pouze v případě, že aktuální hodnota značky ETag odpovídá dané eTag. Pokud se hodnoty značky ETag neshoduje, operace aktualizace selže se stavovým kódem 412 (Předběžná podmínka selhala). To znamená, že datová sada byla aktualizována od posledního získání informací pro datovou sadu. Pokud není značka ETag zadaná nebo její hodnota je *, bude se datová sada vždy aktualizovat bez ohledu na aktuální hodnotu značky ETag.

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
200 OK	Dataset	Success
Other Status Codes	ErrorResponse	Chybová Hlavičky x-ms-error-code: string

Příklady

Datasets_Update

Ukázkový požadavek

HTTP

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

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ]
}

Ukázková odpověď

Stavový kód:

200

{
  "annotationKind": "imageClassification",
  "annotationFileUris": [
    "https://microsoft.com/a"
  ],
  "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	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponseInnerError

Podrobná chyba.

Name	Typ	Description
code	string	Kód chyby
innererror	ErrorResponseInnerError	Podrobná chyba.
message	string	Chybová zpráva.

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.