Registry Environment Versions - Get

服務:: Machine Learning

API 版本:: 2026-05-01

取得版本。

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

URI 參數

名稱	位於	必要	類型	Description
environmentName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$	容器名稱。這是區分大小寫的。
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Azure Machine Learning 登錄的名稱。這是不區分大小寫的
resourceGroupName	path	True	string minLength: 1 maxLength: 90	資源群組的名稱。名稱不區分大小寫。
subscriptionId	path	True	string minLength: 1	目標訂用帳戶的標識碼。
version	path	True	string	版本識別碼。這是區分大小寫的。
api-version	query	True	string minLength: 1	用於此作業的 API 版本。

回應

名稱	類型	Description
200 OK	EnvironmentVersion	Azure 運作順利完成。
Other Status Codes	ErrorResponse	未預期的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	冒用您的使用者帳戶

範例

Get Registry Environment Version.

範例要求

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

範例回覆

狀態碼:: 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"
  }
}

定義

名稱	Description
AssetProvisioningState	註冊表資產的佈建狀態。
AutoRebuildSetting	衍生映像的自動重建設定
BuildContext	Docker 建置內容的組態設定
createdByType	建立此資源的身分識別類型。
EnvironmentType	環境類型是由 Azure ML 服務所建立或策劃的使用者
EnvironmentVersion	Azure Resource Manager 資源信封。
EnvironmentVersionProperties	環境版本詳細資料。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細資料。
ErrorResponse	錯誤回應
InferenceContainerProperties
OperatingSystemType	作業系統的類別。
Route
systemData	與建立和上次修改資源相關的元數據。

AssetProvisioningState

列舉型別

註冊表資產的佈建狀態。

值	Description
Succeeded
Failed
Canceled
Creating
Updating
Deleting

AutoRebuildSetting

列舉型別

衍生映像的自動重建設定

值	Description
Disabled
OnBaseImageUpdate

BuildContext

Object

Docker 建置內容的組態設定

名稱	類型	預設值	Description
contextUri	string minLength: 1 pattern: [a-zA-Z0-9_]		[必要]用來建置映像的 Docker 組建內容的 URI。支持環境建立上的 Blob URI，而且可能會傳回 Blob 或 Git URI。 <seealso href=“https://docs.docker.com/engine/reference/commandline/build/#extended-description"/>
dockerfilePath	string	Dockerfile	組建內容中 Dockerfile 的路徑。 <seealso href=“https://docs.docker.com/engine/reference/builder/"/>

createdByType

列舉型別

建立此資源的身分識別類型。

值	Description
User
Application
ManagedIdentity
Key

EnvironmentType

列舉型別

環境類型是由 Azure ML 服務所建立或策劃的使用者

值	Description
Curated
UserCreated

EnvironmentVersion

Object

Azure Resource Manager 資源信封。

名稱	類型	Description
id	string	資源的完整資源標識碼。範例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	資源的名稱
properties	EnvironmentVersionProperties	[必要]實體的其他屬性。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
type	string	資源的類型。例如：「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」

EnvironmentVersionProperties

Object

環境版本詳細資料。

名稱	類型	預設值	Description
autoRebuild	AutoRebuildSetting	Disabled	衍生映像的自動重建設定
build	BuildContext		Docker 建置內容的組態設定。
condaFile	string		Conda 所使用的標準元件檔，可讓您安裝任何類型的套件，包括 Python、R 和 C/C++ 套件。 <請參閱 href=“https://repo2docker.readthedocs.io/en/latest/config_files.html#environment-yml-install-a-conda-environment"/>
description	string		資產描述文字。
environmentType	EnvironmentType		環境類型是由使用者管理或由 Azure ML 服務 <策劃，請參閱 href=“https://docs.microsoft.com/en-us/azure/machine-learning/resource-curated-environments" />
image	string		將用於環境的映像名稱。 <seealso href=“https://docs.microsoft.com/en-us/azure/machine-learning/how-to-deploy-custom-docker-image#use-a-custom-base-image"/>
inferenceConfig	InferenceContainerProperties		定義推斷特有的組態。
isAnonymous	boolean	False	如果名稱版本是系統產生的（匿名註冊）。
isArchived	boolean	False	資產是否已封存？
osType	OperatingSystemType	Linux	作業系統的類別。
properties	object		資產屬性字典。
provisioningState	AssetProvisioningState		環境版本的佈建狀態。
stage	string		指派給此環境之環境生命週期中的階段
tags	object		標記字典。標記可以新增、移除和更新。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細資料。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤的其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳情
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

InferenceContainerProperties

Object

名稱	類型	Description
livenessRoute	Route	檢查推斷伺服器容器活躍度路由。
readinessRoute	Route	檢查推斷伺服器容器整備程度的路由。
scoringRoute	Route	將評分要求傳送至推斷伺服器容器內的埠。
startupRoute	Route	檢查容器中應用程式啟動的路由。

OperatingSystemType

列舉型別

作業系統的類別。

值	Description
Linux
Windows

Route

Object

名稱	類型	Description
path	string minLength: 1 pattern: [a-zA-Z0-9_]	[必要]路由的路徑。
port	integer (int32)	[必要]路由的埠。

systemData

Object

與建立和上次修改資源相關的元數據。

名稱	類型	Description
createdAt	string (date-time)	資源建立的時間戳（UTC）。
createdBy	string	建立此資源的身分。
createdByType	createdByType	建立此資源的身分識別類型。
lastModifiedAt	string (date-time)	上次修改的資源時間戳（UTC）
lastModifiedBy	string	上次修改資源的身分識別。
lastModifiedByType	createdByType	上次修改資源的身分識別類型。