Sdílet prostřednictvím

Datasets - Create Or Update Version

Služba:
AI Foundry
Verze rozhraní API:
v1

Vytvoření nového nebo aktualizace existujícího souboru DatasetVersion s daným ID verze

PATCH {endpoint}/datasets/{name}/versions/{version}?api-version=v1

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
endpoint
 path True

string (uri)

Koncový bod projektu. Ve tvaru "https://.services.ai.azure.com/api/projects/_project" pokud má váš Foundry Hub pouze jeden Projekt, nebo použít výchozí Projekt ve vašem Hubu. Nebo ve tvaru "https://.services.ai.azure.com/api/projects/" , pokud chcete explicitně zadat název Foundry Project.
name
 path True

string

Název prostředku
version
 path True

string

Konkrétní ID verze DatasetVersion, které chcete vytvořit nebo aktualizovat.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

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

Text žádosti může tvořit:

Name Description
FileDatasetVersion

Definice FileDatasetVersion
FolderDatasetVersion

Definice FileDatasetVersion

FileDatasetVersion

Definice FileDatasetVersion

Name Vyžadováno Typ Description
dataUri True

string

minLength: 1
pattern: [a-zA-Z0-9_]

URI dat. Příklad: https://go.microsoft.com/fwlink/?linkid=2202330
type True string:

uri_file

Typ datové sady
connectionName

string

Název připojení k účtu Azure Storage. Vyžaduje se, pokud startPendingUploadVersion nebyla volána před vytvořením datové sady
description

string

Text popisu prostředku.
tags

object

Označení slovníku Značky je možné přidávat, odebírat a aktualizovat.

FolderDatasetVersion

Definice FileDatasetVersion

Name Vyžadováno Typ Description
dataUri True

string

minLength: 1
pattern: [a-zA-Z0-9_]

URI dat. Příklad: https://go.microsoft.com/fwlink/?linkid=2202330
type True string:

uri_folder

Typ datové sady
connectionName

string

Název připojení k účtu Azure Storage. Vyžaduje se, pokud startPendingUploadVersion nebyla volána před vytvořením datové sady
description

string

Text popisu prostředku.
tags

object

Označení slovníku Značky je možné přidávat, odebírat a aktualizovat.

Odpovědi

Name Typ Description
200 OK DatasetVersion:

Požadavek byl úspěšný.
201 Created DatasetVersion:

Požadavek byl úspěšný a v důsledku toho byl vytvořen nový prostředek.
Other Status Codes

Azure.Core.Foundations.ErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

OAuth2Auth

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Rozsahy

Name Description
https://ai.azure.com/.default

Příklady

Datasets_CreateOrUpdateVersion_MaximumSet
Datasets_CreateOrUpdateVersion_MinimumSet

Datasets_CreateOrUpdateVersion_MaximumSet

Ukázkový požadavek

PATCH {endpoint}/datasets/nsvugzcnsvqodrxiojanhtdymgglnx/versions/utbfmfka?api-version=v1

{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion",
  "description": "grthjigklkewz",
  "tags": {
    "key868": "yjmiiufnnccqfiljtndr"
  }
}

Ukázková odpověď

Stavový kód:
200 
{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion",
  "isReference": true,
  "id": "cfgncrzpcpqbpxefd",
  "name": "zoskzytcqmndtyqwugy",
  "version": "joegai"
}
Stavový kód:
201 
{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion",
  "isReference": true,
  "id": "cfgncrzpcpqbpxefd",
  "name": "zoskzytcqmndtyqwugy",
  "version": "joegai"
}

Datasets_CreateOrUpdateVersion_MinimumSet

Ukázkový požadavek

PATCH {endpoint}/datasets/pluvp/versions/playwidjgezovivciosnkerrdwe?api-version=v1

{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion"
}

Ukázková odpověď

Stavový kód:
200 
{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion",
  "name": "zoskzytcqmndtyqwugy",
  "version": "joegai"
}
Stavový kód:
201 
{
  "dataUri": "Replace this value with a string matching RegExp [a-zA-Z0-9_]",
  "type": "DatasetVersion",
  "name": "zoskzytcqmndtyqwugy",
  "version": "joegai"
}

Definice

Name Description
Azure.Core.Foundations.Error

Objekt chyby.
Azure.Core.Foundations.ErrorResponse

Odpověď obsahující podrobnosti o chybě.
Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.
DatasetType

Výčet určující typ dat.
FileDatasetVersion

Definice FileDatasetVersion
FolderDatasetVersion

Definice FileDatasetVersion

Azure.Core.Foundations.Error

Objekt

Objekt chyby.

Name Typ Description
code

string

Jedna ze serverově definovaných kódů chyb.
details

Azure.Core.Foundations.Error[]

Pole podrobností o konkrétních chybách, které vedly k této nahlášené chybě.
innererror

Azure.Core.Foundations.InnerError

Objekt obsahující konkrétnější informace, než je aktuální objekt o chybě.
message

string

Čitelné znázornění chyby člověkem.
target

string

Cíl chyby.

Azure.Core.Foundations.ErrorResponse

Objekt

Odpověď obsahující podrobnosti o chybě.

Name Typ Description
error

Azure.Core.Foundations.Error

Objekt chyby.

Azure.Core.Foundations.InnerError

Objekt

Objekt obsahující konkrétnější informace o chybě. Podle pokynů k rozhraní API Microsoft One – https://github.com/microsoft/api-guidelines/blob/vNext/azure/Guidelines.md#handling-errors.

Name Typ Description
code

string

Jedna ze serverově definovaných kódů chyb.
innererror

Azure.Core.Foundations.InnerError

Vnitřní chyba.

DatasetType

Výčet

Výčet určující typ dat.

Hodnota Description
uri_file

Soubor identifikátoru URI.
uri_folder

Složka URI.

FileDatasetVersion

Objekt

Definice FileDatasetVersion

Name Typ Description
connectionName

string

Název připojení k účtu Azure Storage. Vyžaduje se, pokud startPendingUploadVersion nebyla volána před vytvořením datové sady
dataUri

string

minLength: 1
pattern: [a-zA-Z0-9_]

URI dat. Příklad: https://go.microsoft.com/fwlink/?linkid=2202330
description

string

Text popisu prostředku.
id

string

ID datového zdroje, jedinečný identifikátor datového zdroje
isReference

boolean

Označuje, zda datová sada obsahuje odkaz na úložiště, nebo zda datová sada spravuje úložiště sama. Pokud je true, podkladová data se při odstranění verze datové sady neodstraní
name

string

Název prostředku
tags

object

Označení slovníku Značky je možné přidávat, odebírat a aktualizovat.
type string:

uri_file

Typ datové sady
version

string

Verze prostředku

FolderDatasetVersion

Objekt

Definice FileDatasetVersion

Name Typ Description
connectionName

string

Název připojení k účtu Azure Storage. Vyžaduje se, pokud startPendingUploadVersion nebyla volána před vytvořením datové sady
dataUri

string

minLength: 1
pattern: [a-zA-Z0-9_]

URI dat. Příklad: https://go.microsoft.com/fwlink/?linkid=2202330
description

string

Text popisu prostředku.
id

string

ID datového zdroje, jedinečný identifikátor datového zdroje
isReference

boolean

Označuje, zda datová sada obsahuje odkaz na úložiště, nebo zda datová sada spravuje úložiště sama. Pokud je true, podkladová data se při odstranění verze datové sady neodstraní
name

string

Název prostředku
tags

object

Označení slovníku Značky je možné přidávat, odebírat a aktualizovat.
type string:

uri_folder

Typ datové sady
version

string

Verze prostředku