Registry Model Versions - Create Or Update

Servizio:: Machine Learning

Versione API:: 2025-09-01

Creare o aggiornare la versione.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/models/{modelName}/versions/{version}?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 contenitore.
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.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
properties	True	ModelVersion	[Obbligatorio] Attributi aggiuntivi dell'entità.

Risposte

Nome	Tipo	Descrizione
200 OK	ModelVersionResource	La richiesta di creazione o aggiornamento ha esito positivo.
201 Created	ModelVersionResource	Created Intestazioni x-ms-async-operation-timeout: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Errore

Nome

Tipo

Descrizione

200 OK

ModelVersionResource

La richiesta di creazione o aggiornamento ha esito positivo.

201 Created

ModelVersionResource

Created

Intestazioni

x-ms-async-operation-timeout: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Errore

Esempio

CreateOrUpdate Registry Model Version.

Esempio di richiesta

HTTP

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

{
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "flavors": {
      "string": {
        "data": {
          "string": "string"
        }
      }
    },
    "modelType": "CustomModel",
    "modelUri": "string"
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "flavors": {
      "string": {
        "data": {
          "string": "string"
        }
      }
    },
    "modelType": "CustomModel",
    "modelUri": "string"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Codice di stato:: 201

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "flavors": {
      "string": {
        "data": {
          "string": "string"
        }
      }
    },
    "modelType": "CustomModel",
    "modelUri": "string"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Definizioni

Nome	Descrizione
AssetProvisioningState	Stato di provisioning dell'asset del Registro di sistema.
createdByType	Tipo di identità che ha creato la risorsa.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
FlavorData
ModelVersion	Dettagli della versione dell'asset del modello.
ModelVersionResource	Busta delle risorse di Azure Resource Manager.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

AssetProvisioningState

Enumerazione

Stato di provisioning dell'asset del Registro di sistema.

Valore	Descrizione
Succeeded
Failed
Canceled
Creating
Updating
Deleting

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

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.

FlavorData

Oggetto

Nome	Tipo	Descrizione
data	object	Dati specifici del modello.

ModelVersion

Oggetto

Dettagli della versione dell'asset del modello.

Nome	Tipo	Valore predefinito	Descrizione
description	string		Testo della descrizione dell'asset.
flavors	<string, FlavorData>		Mapping delle versioni del modello alle relative proprietà.
isAnonymous	boolean	False	Se la versione del nome viene generata dal sistema (registrazione anonima).
isArchived	boolean	False	L'asset è archiviato?
jobName	string		Nome del processo di training che ha prodotto questo modello
modelType	string		Formato di archiviazione per questa entità. Utilizzato per NCD.
modelUri	string		Percorso URI del contenuto del modello.
properties	object		Dizionario delle proprietà dell'asset.
provisioningState	AssetProvisioningState		Stato di provisioning per la versione del modello.
stage	string		Fase del ciclo di vita del modello assegnato a questo modello
tags	object		Dizionario tag. I tag possono essere aggiunti, rimossi e aggiornati.

ModelVersionResource

Oggetto

Busta delle risorse di Azure Resource Manager.

Nome	Tipo	Descrizione
id	string	ID risorsa completo per la risorsa. Ad esempio: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nome della risorsa
properties	ModelVersion	[Obbligatorio] Attributi aggiuntivi dell'entità.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.