Registry Environment Versions - Get

Serviço:: Machine Learning

Versão da API:: 2026-05-01

Obter versão.

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

Parâmetros do URI

Name	Em	Obrigatório	Tipo	Descrição
environmentName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	Nome do contêiner. Isso diferencia maiúsculas de minúsculas.
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Nome do registro do Azure Machine Learning. Isso não diferencia maiúsculas de minúsculas
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	O ID da assinatura de destino.
version	path	True	string	Identificador de versão. Isso diferencia maiúsculas de minúsculas.
api-version	query	True	string minLength: 1	A versão da API a utilizar para esta operação.

Respostas

Name	Tipo	Descrição
200 OK	EnvironmentVersion	Operação do Azure concluída com sucesso.
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Descrição
user_impersonation	assumir a identidade da sua conta de utilizador

Exemplos

Get Registry Environment Version.

Pedido de amostra

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-05-01

Resposta da amostra

Código de estado:: 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"
  }
}

Definições

Name	Descrição
AssetProvisioningState	Estado de provisionamento do ativo de registro.
AutoRebuildSetting	Configuração de reconstrução automática para a imagem derivada
BuildContext	Definições de configuração para o contexto de compilação do Docker
createdByType	O tipo de identidade que criou o recurso.
EnvironmentType	O tipo de ambiente é criado pelo usuário ou selecionado pelo serviço Azure ML
EnvironmentVersion	Envelope de recursos do Azure Resource Manager.
EnvironmentVersionProperties	Detalhes da versão do ambiente.
ErrorAdditionalInfo	Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
InferenceContainerProperties
OperatingSystemType	O tipo de sistema operacional.
Route
systemData	Metadados referentes à criação e última modificação do recurso.

AssetProvisioningState

Enumeração

Estado de provisionamento do ativo de registro.

Valor	Descrição
Succeeded
Failed
Canceled
Creating
Updating
Deleting

AutoRebuildSetting

Enumeração

Configuração de reconstrução automática para a imagem derivada

Valor	Descrição
Disabled
OnBaseImageUpdate

BuildContext

Object

Definições de configuração para o contexto de compilação do Docker

Name	Tipo	Valor predefinido	Descrição
contextUri	string minLength: 1 pattern: [a-zA-Z0-9_]		[Obrigatório] URI do contexto de compilação do Docker usado para criar a imagem. Suporta URIs de blob na criação de ambiente e pode retornar URIs de blob ou Git. <ver também href="https://docs.docker.com/engine/reference/commandline/build/#extended-description" />
dockerfilePath	string	Dockerfile	Caminho para o Dockerfile no contexto de compilação. <ver também href="https://docs.docker.com/engine/reference/builder/" />

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Descrição
User
Application
ManagedIdentity
Key

EnvironmentType

Enumeração

O tipo de ambiente é criado pelo usuário ou selecionado pelo serviço Azure ML

Valor	Descrição
Curated
UserCreated

EnvironmentVersion

Object

Envelope de recursos do Azure Resource Manager.

Name	Tipo	Descrição
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties	EnvironmentVersionProperties	[Obrigatório] Atributos adicionais da entidade.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

EnvironmentVersionProperties

Object

Detalhes da versão do ambiente.

Name	Tipo	Valor predefinido	Descrição
autoRebuild	AutoRebuildSetting	Disabled	Configuração de reconstrução automática para a imagem derivada
build	BuildContext		Definições de configuração para o contexto de compilação do Docker.
condaFile	string		Arquivo de configuração padrão usado pelo Conda que permite instalar qualquer tipo de pacote, incluindo pacotes Python, R e C/C++. <ver href="https://repo2docker.readthedocs.io/en/latest/config_files.html#environment-yml-install-a-conda-environment" />
description	string		O texto da descrição do ativo.
environmentType	EnvironmentType		O tipo de ambiente é gerenciado pelo usuário ou selecionado pelo serviço <Azure ML see href="https://docs.microsoft.com/en-us/azure/machine-learning/resource-curated-environments" />
image	string		Nome da imagem que será usada para o ambiente. <ver também href="https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-custom-docker-image#use-a-custom-base-image" />
inferenceConfig	InferenceContainerProperties		Define a configuração específica para inferência.
isAnonymous	boolean	False	Se a versão do nome for gerada pelo sistema (registo anónimo).
isArchived	boolean	False	O ativo está arquivado?
osType	OperatingSystemType	Linux	O tipo de sistema operacional.
properties	object		O dicionário de propriedades de ativos.
provisioningState	AssetProvisioningState		Estado de provisionamento para a versão do ambiente.
stage	string		Estágio no ciclo de vida do ambiente atribuído a este ambiente
tags	object		Dicionário de tags. As tags podem ser adicionadas, removidas e atualizadas.

ErrorAdditionalInfo

Object

Informações adicionais sobre o erro de gestão de recursos.

Name	Tipo	Descrição
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Descrição
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O alvo do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Descrição
error	ErrorDetail	O objeto de erro.

InferenceContainerProperties

Object

Name	Tipo	Descrição
livenessRoute	Route	A rota para verificar a vida útil do contêiner do servidor de inferência.
readinessRoute	Route	A rota para verificar a prontidão do contêiner do servidor de inferência.
scoringRoute	Route	A porta para a qual enviar as solicitações de pontuação, dentro do contêiner do servidor de inferência.
startupRoute	Route	A rota para verificar a inicialização do aplicativo no contêiner.

OperatingSystemType

Enumeração

O tipo de sistema operacional.

Valor	Descrição
Linux
Windows

Route

Object

Name	Tipo	Descrição
path	string minLength: 1 pattern: [a-zA-Z0-9_]	[Obrigatório] O caminho para a rota.
port	integer (int32)	[Obrigatório] A porta para a rota.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Descrição
createdAt	string (date-time)	A marca temporal da criação do recurso (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	A data e hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.