Registry Environment 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}/environments/{environmentName}/versions/{version}?api-version=2025-09-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
environmentName	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	EnvironmentVersion	[Obbligatorio] Attributi aggiuntivi dell'entità.

Risposte

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

Nome

Tipo

Descrizione

200 OK

EnvironmentVersionResource

La richiesta di creazione o aggiornamento ha esito positivo.

201 Created

EnvironmentVersionResource

Created

Intestazioni

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

Other Status Codes

ErrorResponse

Errore

Esempio

CreateOrUpdate Registry Environment 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/environments/string/versions/string?api-version=2025-09-01

{
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  }
}

Risposta di esempio

Codice di stato:: 200

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "environmentType": "Curated",
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  },
  "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,
    "environmentType": "Curated",
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  },
  "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.
AutoRebuildSetting	Impostazione di AutoRebuild per l'immagine derivata
BuildContext	Impostazioni di configurazione per il contesto di compilazione Docker
createdByType	Tipo di identità che ha creato la risorsa.
EnvironmentType	Il tipo di ambiente è creato dall'utente o curato dal servizio Azure ML
EnvironmentVersion	Dettagli sulla versione dell'ambiente.
EnvironmentVersionResource	Busta delle risorse di Azure Resource Manager.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
InferenceContainerProperties
OperatingSystemType	Tipo di sistema operativo.
Route
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

AutoRebuildSetting

Enumerazione

Impostazione di AutoRebuild per l'immagine derivata

Valore	Descrizione
Disabled
OnBaseImageUpdate

BuildContext

Oggetto

Impostazioni di configurazione per il contesto di compilazione Docker

Nome	Tipo	Valore predefinito	Descrizione
contextUri	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obbligatorio] URI del contesto di compilazione Docker usato per compilare l'immagine. Supporta gli URI BLOB durante la creazione dell'ambiente e può restituire BLOB o URI Git. <vedi anche href="https://docs.docker.com/engine/reference/commandline/build/#extended-description" />
dockerfilePath	string	Dockerfile	Percorso del Dockerfile nel contesto di compilazione. <vedi anche href="https://docs.docker.com/engine/reference/builder/" />

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

EnvironmentType

Enumerazione

Il tipo di ambiente è creato dall'utente o curato dal servizio Azure ML

Valore	Descrizione
Curated
UserCreated

EnvironmentVersion

Oggetto

Dettagli sulla versione dell'ambiente.

Nome	Tipo	Valore predefinito	Descrizione
autoRebuild	AutoRebuildSetting	Disabled	Definisce se l'immagine deve essere ricompilata in base alle modifiche dell'immagine di base.
build	BuildContext		Impostazioni di configurazione per il contesto di compilazione Docker.
condaFile	string		File di configurazione standard usato da Conda che consente di installare qualsiasi tipo di pacchetto, inclusi i pacchetti Python, R e C/C++. <vedere href="https://repo2docker.readthedocs.io/en/latest/config_files.html#environment-yml-install-a-conda-environment" />
description	string		Testo della descrizione dell'asset.
environmentType	EnvironmentType		Il tipo di ambiente è gestito dall'utente o curato dal servizio <Azure ML see href="https://docs.microsoft.com/en-us/azure/machine-learning/resource-curated-environments" />
image	string		Nome dell'immagine che verrà usata per l'ambiente. <vedi anche href="https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-custom-docker-image#use-a-custom-base-image" />
inferenceConfig	InferenceContainerProperties		Definisce la configurazione specifica per l'inferenza.
isAnonymous	boolean	False	Se la versione del nome viene generata dal sistema (registrazione anonima).
isArchived	boolean	False	L'asset è archiviato?
osType	OperatingSystemType	Linux	Tipo di sistema operativo dell'ambiente.
properties	object		Dizionario delle proprietà dell'asset.
provisioningState	AssetProvisioningState		Stato di provisioning per la versione dell'ambiente.
stage	string		Fase del ciclo di vita dell'ambiente assegnato a questo ambiente
tags	object		Dizionario tag. I tag possono essere aggiunti, rimossi e aggiornati.

EnvironmentVersionResource

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	EnvironmentVersion	[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"

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.

InferenceContainerProperties

Oggetto

Nome	Tipo	Descrizione
livenessRoute	Route	Route per controllare l'attività del contenitore del server di inferenza.
readinessRoute	Route	Route per verificare l'idoneità del contenitore del server di inferenza.
scoringRoute	Route	Porta a cui inviare le richieste di assegnazione dei punteggi all'interno del contenitore del server di inferenza.
startupRoute	Route	Route per controllare l'avvio dell'applicazione nel contenitore.

OperatingSystemType

Enumerazione

Tipo di sistema operativo.

Valore	Descrizione
Linux
Windows

Route

Oggetto

Nome	Tipo	Descrizione
path	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obbligatorio] Percorso della route.
port	integer (int32)	[Obbligatorio] Porta per la route.

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.