Datasets - Update

Referens

Tjänst:: Azure AI Services

API-version:: 2023-04-01-preview

Uppdatera egenskaperna för en befintlig 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.
412: En If-Match rubrik angavs, men den angivna ETag matchade inte det aktuella ETag-värdet.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
name	path	True	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Namnet på datauppsättningen som ska uppdateras.
api-version	query	True	string	Begärd API-version.

Begärandehuvud

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

Name	Obligatorisk	Typ	Description
If-Match		string	Valfri ETag för datauppsättningen som ska uppdateras. Om en ETag tillhandahålls uppdateras datamängden endast om dess aktuella ETag-värde matchar angiven ETag. Om ETag-värdena inte matchar misslyckas uppdateringsåtgärden med statuskoden 412 (förhandsvillkoret misslyckades). Detta indikerar att datamängden har uppdaterats sedan den senaste gången information för datamängden hämtades. Om en ETag inte har angetts eller om dess värde är *, uppdateras datauppsättningen alltid oavsett det aktuella ETag-värdet.

Begärandetext

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

Name	Typ	Description
annotationFileUris	string[] (uri)	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 anteckningKind, där varje bildsökväg är en absolut URI till 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 (date-time)	Skrivskyddad. Datum och tid då datamängden först registrerades, i UTC.
customProperties	object	Ordlista över godtyckliga nyckel/värde-par för användning av programmet. Högst 10 nyckel/värde-par tillåts.
eTag	string	Skrivskyddad. Den senaste ETag för datamängden. Kan användas med rubriken "If-Match" när du uppdaterar eller tar bort en datauppsättning.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Skrivskyddad. Namnet som används för att unikt identifiera datauppsättningen.
updatedDateTime	string (date-time)	Skrivskyddad. Datum och tid då datamängden senast uppdaterades, i UTC.

Svar

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

Name

Typ

Description

200 OK

Dataset

Framgång

Other Status Codes

ErrorResponse

Fel

Sidhuvuden

x-ms-error-code: string

Exempel

Datasets_Update

Exempelbegäran

HTTP

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

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

Exempelsvar

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

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 träning eller testning av en modell.
ErrorResponse	Svaret returnerades när ett fel inträffar.
ErrorResponseDetails	Felinformation.
ErrorResponseInnerError	Detaljerat fel.
StorageAuthenticationKind	Typ av lagringsautentisering.
StorageAuthenticationSettingsApiModel	Beskriver inställningarna för lagringsautentisering.

AnnotationKind

Uppräkning

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.

Värde	Description
imageClassification
imageObjectDetection

Dataset

Objekt

Beskriver en datauppsättning som representerar en uppsättning bilder och anteckningar som kan användas för träning eller testning av en modell.

Name	Typ	Description
annotationFileUris	string[] (uri)	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 anteckningKind, där varje bildsökväg är en absolut URI till 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 (date-time)	Skrivskyddad. Datum och tid då datamängden först registrerades, i UTC.
customProperties	object	Ordlista över godtyckliga nyckel/värde-par för användning av programmet. Högst 10 nyckel/värde-par tillåts.
eTag	string	Skrivskyddad. Den senaste ETag för datamängden. Kan användas med rubriken "If-Match" när du uppdaterar eller tar bort en datauppsättning.
name	string maxLength: 255 pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]*$	Skrivskyddad. Namnet som används för att unikt identifiera datauppsättningen.
updatedDateTime	string (date-time)	Skrivskyddad. Datum och tid då datamängden senast uppdaterades, i UTC.

ErrorResponse

Objekt

Svaret returnerades när ett fel inträffar.

Name	Typ	Description
error	ErrorResponseDetails	Felinformation.

ErrorResponseDetails

Objekt

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

Objekt

Detaljerat fel.

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

StorageAuthenticationKind

Uppräkning

Typ av lagringsautentisering.

Värde	Description
managedIdentity
none
sas

StorageAuthenticationSettingsApiModel

Objekt

Beskriver inställningarna för lagringsautentisering.

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

Dela via

Datasets - Update

URI-parametrar

Begärandehuvud

Begärandetext

Svar

Exempel

Datasets_Update

Exempelbegäran

Exempelsvar

Definitioner

AnnotationKind

Dataset

ErrorResponse

ErrorResponseDetails

ErrorResponseInnerError

StorageAuthenticationKind

StorageAuthenticationSettingsApiModel

Ytterligare resurser