Registry Environment Versions - Get

Servicio:: Machine Learning

Versión de la API:: 2026-03-01

Obtener versión.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}/environments/{environmentName}/versions/{version}?api-version=2026-03-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
environmentName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	El nombre del contenedor. Esto distingue mayúsculas de minúsculas.
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Nombre del registro de Azure Machine Learning. Esto no distingue entre mayúsculas y minúsculas
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
version	path	True	string	Identificador de versión. Esto distingue mayúsculas de minúsculas.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	EnvironmentVersion	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

Get Registry Environment Version.

Solicitud de ejemplo

HTTP

GET 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=2026-03-01

Respuesta de muestra

status code:: 200

{
  "name": "string",
  "type": "string",
  "id": "string",
  "properties": {
    "description": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "condaFile": "string",
    "environmentType": "Curated",
    "image": "docker.io/tensorflow/serving:latest",
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    },
    "isAnonymous": false,
    "properties": {
      "string": "string"
    },
    "tags": {
      "string": "string"
    }
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Definiciones

Nombre	Description
AssetProvisioningState	Estado de aprovisionamiento del activo del Registro.
AutoRebuildSetting	Configuración de AutoRebuild para la imagen derivada
BuildContext	Opciones de configuración para el contexto de compilación de Docker
createdByType	Tipo de identidad que creó el recurso.
EnvironmentType	El tipo de entorno es creado por el usuario o seleccionado por el servicio Azure ML
EnvironmentVersion	Azure Resource Manager resource envelope.
EnvironmentVersionProperties	Detalles de la versión del entorno.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
InferenceContainerProperties
OperatingSystemType	El tipo de sistema operativo.
Route
systemData	Metadatos relativos a la creación y última modificación del recurso.

AssetProvisioningState

Enumeración

Estado de aprovisionamiento del activo del Registro.

Valor	Description
Succeeded
Failed
Canceled
Creating
Updating
Deleting

AutoRebuildSetting

Enumeración

Configuración de AutoRebuild para la imagen derivada

Valor	Description
Disabled
OnBaseImageUpdate

BuildContext

Objeto

Opciones de configuración para el contexto de compilación de Docker

Nombre	Tipo	Valor predeterminado	Description
contextUri	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obligatorio] URI del contexto de compilación de Docker que se usa para compilar la imagen. Admite URI de blob en la creación del entorno y puede devolver los URI de blob o Git. <véasetambién href="https://docs.docker.com/engine/reference/commandline/build/#extended-description" />
dockerfilePath	string	Dockerfile	Ruta de acceso al Dockerfile en el contexto de compilación. <véasetambién href="https://docs.docker.com/engine/reference/builder/" />

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

EnvironmentType

Enumeración

El tipo de entorno es creado por el usuario o seleccionado por el servicio Azure ML

Valor	Description
Curated
UserCreated

EnvironmentVersion

Objeto

Azure Resource Manager resource envelope.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nombre del recurso
properties	EnvironmentVersionProperties	[Obligatorio] Atributos adicionales de la entidad.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

EnvironmentVersionProperties

Objeto

Detalles de la versión del entorno.

Nombre	Tipo	Valor predeterminado	Description
autoRebuild	AutoRebuildSetting	Disabled	Configuración de AutoRebuild para la imagen derivada
build	BuildContext		Opciones de configuración para el contexto de compilación de Docker.
condaFile	string		Archivo de configuración estándar usado por Conda que permite instalar cualquier tipo de paquete, incluyendo paquetes de Python, R y C/C++. <ver href="https://repo2docker.readthedocs.io/en/latest/config_files.html#environment-yml-install-a-conda-environment" />
description	string		Texto de descripción del recurso.
environmentType	EnvironmentType		El tipo de entorno es administrado por el usuario o seleccionado por el servicio <Azure ML see href="https://docs.microsoft.com/en-us/azure/machine-learning/resource-curated-environments" />
image	string		Nombre de la imagen que se usará para el entorno. <véasetambién href="https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-custom-docker-image#use-a-custom-base-image" />
inferenceConfig	InferenceContainerProperties		Define la configuración específica de la inferencia.
isAnonymous	boolean	False	Si la versión del nombre se genera por el sistema (registro anónimo).
isArchived	boolean	False	¿El recurso está archivado?
osType	OperatingSystemType	Linux	El tipo de sistema operativo.
properties	object		Diccionario de propiedades de recurso.
provisioningState	AssetProvisioningState		Estado de aprovisionamiento para la versión del entorno.
stage	string		Fase del ciclo de vida del entorno asignado a este entorno
tags	object		Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	El mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

InferenceContainerProperties

Objeto

Nombre	Tipo	Description
livenessRoute	Route	Ruta para comprobar la ejecución del contenedor del servidor de inferencia.
readinessRoute	Route	Ruta para comprobar la preparación del contenedor del servidor de inferencia.
scoringRoute	Route	Puerto al que se envían las solicitudes de puntuación, dentro del contenedor del servidor de inferencia.
startupRoute	Route	Ruta para comprobar el inicio de la aplicación en el contenedor.

OperatingSystemType

Enumeración

El tipo de sistema operativo.

Valor	Description
Linux
Windows

Route

Objeto

Nombre	Tipo	Description
path	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obligatorio] Ruta de acceso de la ruta.
port	integer (int32)	[Obligatorio] Puerto de la ruta.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.