Registry Model Versions - Create Or Get Start Pending Upload

Servizio:: Machine Learning

Versione API:: 2025-09-01

Generare un percorso di archiviazione e credenziali in cui il client può caricare un asset del modello.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/models/{modelName}/versions/{version}/startPendingUpload?api-version=2025-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
modelName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	Nome del modello. Distinzione tra maiuscole e minuscole.
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Nome del registro di Azure Machine Learning. Questo non fa distinzione tra maiuscole e minuscole
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
version	path	True	string	Identificatore della versione. Distinzione tra maiuscole e minuscole.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Tipo	Descrizione
pendingUploadId	string	Se PendingUploadId = null, verrà usato il guid casuale.
pendingUploadType	PendingUploadType	TemporaryBlobReference è l'unico tipo supportato

Risposte

Nome	Tipo	Descrizione
200 OK	PendingUploadResponseDto	Success
Other Status Codes	ErrorResponse	Errore

Esempio

CreateOrGetStartPendingUpload Registry Model Version.

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/registryName/models/string/versions/string/startPendingUpload?api-version=2025-09-01

{
  "pendingUploadId": "string",
  "pendingUploadType": "TemporaryBlobReference"
}

Risposta di esempio

Codice di stato:: 200

{
  "blobReferenceForConsumption": {
    "blobUri": "https://www.contoso.com/example",
    "storageAccountArmId": "string",
    "credential": {
      "credentialType": "SAS",
      "sasUri": "https://www.contoso.com/example"
    }
  },
  "pendingUploadId": "string",
  "pendingUploadType": "None"
}

Definizioni

Nome	Descrizione
BlobReferenceForConsumptionDto
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
PendingUploadCredentialType	Enum per determinare il tipo di credenziali PendingUpload.
PendingUploadRequestDto
PendingUploadResponseDto
PendingUploadType	Tipo di archiviazione da utilizzare per il percorso di caricamento in sospeso
SASCredentialDto

BlobReferenceForConsumptionDto

Oggetto

Nome	Tipo	Descrizione
blobUri	string (uri)	Percorso URI BLOB per il caricamento dei dati da parte del client. Esempio: https://blob.windows.core.net/Container/Path
credential	PendingUploadCredentialDto: SASCredentialDto	Informazioni sulle credenziali per accedere all'account di archiviazione
storageAccountArmId	string	ID ARM dell'account di archiviazione da usare

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

PendingUploadCredentialType

Enumerazione

Enum per determinare il tipo di credenziali PendingUpload.

Valore	Descrizione
SAS

PendingUploadRequestDto

Oggetto

Nome	Tipo	Valore predefinito	Descrizione
pendingUploadId	string		Se PendingUploadId = null, verrà usato il guid casuale.
pendingUploadType	PendingUploadType	TemporaryBlobReference	TemporaryBlobReference è l'unico tipo supportato

PendingUploadResponseDto

Oggetto

Nome	Tipo	Valore predefinito	Descrizione
blobReferenceForConsumption	BlobReferenceForConsumptionDto		Lettura, scrittura, lista di firma di accesso condiviso a livello di contenitore
pendingUploadId	string		ID per questa richiesta di caricamento
pendingUploadType	PendingUploadType	TemporaryBlobReference	TemporaryBlobReference è l'unico tipo supportato

PendingUploadType

Enumerazione

Tipo di archiviazione da utilizzare per il percorso di caricamento in sospeso

Valore	Descrizione
None
TemporaryBlobReference

SASCredentialDto

Oggetto

Nome	Tipo	Descrizione
credentialType	string: SAS	[Obbligatorio] Tipo di credenziale usato per l'autenticazione con l'archiviazione.
sasUri	string (uri)	URI di firma di accesso condiviso completo, inclusi l'archiviazione, il percorso del contenitore/BLOB e il token di firma di accesso condiviso