Registry Environment Versions - Get

Dienst:: Machine Learning

API-Version:: 2026-05-01

Version abrufen.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
environmentName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	Containername. Bei dieser Groß-/Kleinschreibung wird die Groß-/Kleinschreibung beachtet.
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Name der Azure Machine Learning-Registrierung. Dabei wird zwischen Groß- und Kleinschreibung unterschieden
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
version	path	True	string	Versionsbezeichner. Bei dieser Groß-/Kleinschreibung wird die Groß-/Kleinschreibung beachtet.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	EnvironmentVersion	Azure-Operation erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

Get Registry Environment Version.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
AssetProvisioningState	Bereitstellungsstatus des Registrierungsobjekts.
AutoRebuildSetting	AutoRebuild-Einstellung für das abgeleitete Image
BuildContext	Konfigurationseinstellungen für den Docker-Buildkontext
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
EnvironmentType	Der Umgebungstyp wird entweder vom Benutzer erstellt oder vom Azure ML-Dienst kuratiert
EnvironmentVersion	Ressourcenumschlag des Azure Resource Manager.
EnvironmentVersionProperties	Details zur Umgebungsversion.
ErrorAdditionalInfo	Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.
ErrorDetail	Die Fehlerdetails.
ErrorResponse	Fehlerantwort
InferenceContainerProperties
OperatingSystemType	Der Typ des Betriebssystems.
Route
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AssetProvisioningState

Enumeration

Bereitstellungsstatus des Registrierungsobjekts.

Wert	Beschreibung
Succeeded
Failed
Canceled
Creating
Updating
Deleting

AutoRebuildSetting

Enumeration

AutoRebuild-Einstellung für das abgeleitete Image

Wert	Beschreibung
Disabled
OnBaseImageUpdate

BuildContext

Objekt

Konfigurationseinstellungen für den Docker-Buildkontext

Name	Typ	Standardwert	Beschreibung
contextUri	string minLength: 1 pattern: [a-zA-Z0-9_]		[Erforderlich] URI des Docker-Buildkontexts, der zum Erstellen des Images verwendet wird. Unterstützt BLOB-URIs bei der Umgebungserstellung und kann BLOB- oder Git-URIs zurückgeben. <sieheauch href="https://docs.docker.com/engine/reference/commandline/build/#extended-description" />
dockerfilePath	string	Dockerfile	Pfad zur Dockerfile-Datei im Buildkontext. <sieheauch href="https://docs.docker.com/engine/reference/builder/" />

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

EnvironmentType

Enumeration

Der Umgebungstyp wird entweder vom Benutzer erstellt oder vom Azure ML-Dienst kuratiert

Wert	Beschreibung
Curated
UserCreated

EnvironmentVersion

Objekt

Ressourcenumschlag des Azure Resource Manager.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties	EnvironmentVersionProperties	[Erforderlich] Zusätzliche Attribute der Entität.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

EnvironmentVersionProperties

Objekt

Details zur Umgebungsversion.

Name	Typ	Standardwert	Beschreibung
autoRebuild	AutoRebuildSetting	Disabled	AutoRebuild-Einstellung für das abgeleitete Image
build	BuildContext		Konfigurationseinstellungen für Docker-Buildkontext.
condaFile	string		Standardkonfigurationsdatei, die von Conda verwendet wird, mit der Sie alle Arten von Paketen installieren können, einschließlich Python-, R- und C/C++-Paketen. <siehe href="https://repo2docker.readthedocs.io/en/latest/config_files.html#environment-yml-install-a-conda-environment" />
description	string		Der Text der Objektbeschreibung.
environmentType	EnvironmentType		Der Umgebungstyp wird entweder vom Benutzer verwaltet oder vom Azure ML-Dienst <kuratiert, siehe href="https://docs.microsoft.com/en-us/azure/machine-learning/resource-curated-environments" />
image	string		Der Name des Bilds, das für die Umgebung verwendet wird. <sieheauch href="https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-custom-docker-image#use-a-custom-base-image" />
inferenceConfig	InferenceContainerProperties		Definiert die konfiguration, die für die Ableitung spezifisch ist.
isAnonymous	boolean	False	Wenn die Namensversion vom System generiert wird (anonyme Registrierung).
isArchived	boolean	False	Ist die Ressource archiviert?
osType	OperatingSystemType	Linux	Der Typ des Betriebssystems.
properties	object		Das Objekteigenschaftenverzeichnis.
provisioningState	AssetProvisioningState		Bereitstellungsstatus für die Umgebungsversion.
stage	string		Phase im Umgebungslebenszyklus, die dieser Umgebung zugewiesen ist
tags	object		Tagwörterbuch. Tags können hinzugefügt, entfernt und aktualisiert werden.

ErrorAdditionalInfo

Objekt

Zusätzliche Informationen zum Fehler bei der Ressourcenverwaltung.

Name	Typ	Beschreibung
info	object	Zusätzliche Informationen.
type	string	Typ der Zusatzinformationen.

ErrorDetail

Objekt

Die Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die Zusatzinformationen zum Fehler.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Der Fehlerzielwert.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

InferenceContainerProperties

Objekt

Name	Typ	Beschreibung
livenessRoute	Route	Die Route, um die Liveität des Inference-Servercontainers zu überprüfen.
readinessRoute	Route	Die Route, um die Bereitschaft des Rückschlussservercontainers zu überprüfen.
scoringRoute	Route	Der Port, an den die Bewertungsanforderungen innerhalb des Ableitungsservercontainers gesendet werden sollen.
startupRoute	Route	Die Route, um den Start der Anwendung im Container zu überprüfen.

OperatingSystemType

Enumeration

Der Typ des Betriebssystems.

Wert	Beschreibung
Linux
Windows

Route

Objekt

Name	Typ	Beschreibung
path	string minLength: 1 pattern: [a-zA-Z0-9_]	[Erforderlich] Der Pfad für die Route.
port	integer (int32)	[Erforderlich] Der Port für die Route.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.