你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Registries - Create Or Update

服务:: Machine Learning

API 版本:: 2025-06-01

创建或更新注册表

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/registries/{registryName}?api-version=2025-06-01

URI 参数

名称	在	必需	类型	说明
registryName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{2,32}$	Azure 机器学习注册表的名称。这是不区分大小写的
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string minLength: 1	目标订阅的 ID。
api-version	query	True	string minLength: 1	用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源所在的地理位置
identity		ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）
kind		string	门户/工具等用于为相同类型的资源呈现不同的 UX 体验的元数据。
properties.discoveryUrl		string	注册表的发现 URL
properties.intellectualPropertyPublisher		string	注册表的 IntellectualPropertyPublisher
properties.managedResourceGroup		ArmResourceId	如果注册表已创建系统，则托管 RG 的 ResourceId
properties.managedResourceGroupSettings		ManagedResourceGroupSettings	托管资源组特定设置
properties.mlFlowRegistryUri		string	注册表的 MLFlow 注册表 URI
properties.publicNetworkAccess		string	注册表是否可从 Internet 访问？可能的值：“Enabled”或“Disabled”
properties.regionDetails		RegistryRegionArmDetails[]	注册表所在的每个区域的详细信息
properties.registryPrivateEndpointConnections		RegistryPrivateEndpointConnection[]	专用终结点连接信息，用于专用链接门户中的挂起连接
sku		Sku	用于自动缩放的 ARM 协定所需的 SKU 详细信息。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	RegistryTrackedResource	成功
201 Created	RegistryTrackedResource	已创建
Other Status Codes	ErrorResponse	错误

示例

CreateOrUpdate Registry with system created accounts.

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/registries/string?api-version=2025-06-01

{
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "None",
    "userAssignedIdentities": {
      "string": {}
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

示例响应

状态代码:: 200

{
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444",
    "userAssignedIdentities": {
      "string": {
        "principalId": "00000000-1111-2222-3333-444444444444",
        "clientId": "00000000-1111-2222-3333-444444444444"
      }
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  },
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:38",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:38",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

状态代码:: 201

{
  "tags": {},
  "location": "string",
  "kind": "string",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "00000000-1111-2222-3333-444444444444",
    "tenantId": "00000000-1111-2222-3333-444444444444",
    "userAssignedIdentities": {
      "string": {
        "principalId": "00000000-1111-2222-3333-444444444444",
        "clientId": "00000000-1111-2222-3333-444444444444"
      }
    }
  },
  "sku": {
    "name": "string",
    "tier": "Free",
    "size": "string",
    "family": "string",
    "capacity": 1
  },
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "regionDetails": [
      {
        "location": "string",
        "storageAccountDetails": [
          {
            "systemCreatedStorageAccount": {
              "storageAccountName": "string",
              "storageAccountType": "string",
              "storageAccountHnsEnabled": false,
              "armResourceId": {
                "resourceId": "string"
              },
              "allowBlobPublicAccess": false
            }
          }
        ],
        "acrDetails": [
          {
            "systemCreatedAcrAccount": {
              "acrAccountName": "string",
              "acrAccountSku": "string",
              "armResourceId": {
                "resourceId": "string"
              }
            }
          }
        ]
      }
    ],
    "intellectualPropertyPublisher": "string",
    "publicNetworkAccess": "string",
    "discoveryUrl": "string",
    "managedResourceGroup": {
      "resourceId": "string"
    },
    "mlFlowRegistryUri": "string",
    "registryPrivateEndpointConnections": [
      {
        "id": "string",
        "location": "string",
        "properties": {
          "provisioningState": "string",
          "privateEndpoint": {
            "id": "string",
            "subnetArmId": "string"
          },
          "registryPrivateLinkServiceConnectionState": {
            "status": "Approved",
            "description": "string",
            "actionsRequired": "string"
          },
          "groupIds": [
            "string"
          ]
        }
      }
    ]
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:38",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:38",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

定义

名称	说明
AcrDetails	要用于注册表的 ACR 帐户的详细信息
ArmResourceId	资源的 ARM ResourceId
createdByType	创建资源的标识的类型。
EndpointServiceConnectionStatus	服务使用者与服务提供商的连接状态
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ManagedResourceGroupAssignedIdentities	托管资源组分配标识的详细信息。
ManagedResourceGroupSettings	托管资源组设置
ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）
ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
PrivateEndpointResource	链接到此 PE 连接的 PE 网络资源。
RegistryPrivateEndpointConnection	专用终结点连接定义。
RegistryPrivateLinkServiceConnectionState	连接状态。
RegistryRegionArmDetails	注册表所在的每个区域的详细信息
RegistryTrackedResource
Sku	表示 SKU 的资源模型定义
SkuTier	如果服务具有多个层，但在 PUT 上不需要，则需要资源提供程序实现此字段。
StorageAccountDetails	要用于注册表的存储帐户的详细信息
SystemCreatedAcrAccount
SystemCreatedStorageAccount
systemData	与创建和上次修改资源相关的元数据。
UserAssignedIdentity	用户分配的标识属性

AcrDetails

Object

要用于注册表的 ACR 帐户的详细信息

名称	类型	说明
systemCreatedAcrAccount	SystemCreatedAcrAccount	系统创建用于注册表的 ACR 帐户的详细信息

ArmResourceId

Object

资源的 ARM ResourceId

名称	类型	说明
resourceId	string	Arm ResourceId 的格式为“/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Storage/storageAccounts/{StorageAccountName}”或“/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.ContainerRegistry/registries/{AcrName}”

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

EndpointServiceConnectionStatus

枚举

服务使用者与服务提供商的连接状态

值	说明
Approved
Disconnected
Pending
Rejected

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ManagedResourceGroupAssignedIdentities

Object

托管资源组分配标识的详细信息。

名称	类型	说明
principalId	string	标识主体 ID

ManagedResourceGroupSettings

Object

托管资源组设置

名称	类型	说明
assignedIdentities	ManagedResourceGroupAssignedIdentities[]	托管资源组的分配标识列表

ManagedServiceIdentity

Object

托管服务标识（系统分配和/或用户分配的标识）

名称	类型	说明
principalId	string (uuid)	系统分配标识的服务主体 ID。此属性仅针对系统分配的标识提供。
tenantId	string (uuid)	系统分配标识的租户 ID。此属性仅针对系统分配的标识提供。
type	ManagedServiceIdentityType	托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned 标识与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。字典值可以是请求中的空对象（{}）。

ManagedServiceIdentityType

枚举

托管服务标识的类型（其中允许 SystemAssigned 和 UserAssigned 类型）。

值	说明
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

PrivateEndpointResource

Object

链接到此 PE 连接的 PE 网络资源。

名称	类型	说明
id	string	专用终结点的 ARM 标识符
subnetArmId	string	专用终结点连接到的 subnetId。

RegistryPrivateEndpointConnection

Object

专用终结点连接定义。

名称	类型	说明
id	string	这是在 SRP 完整资源 ID 上创建的专用终结点连接名称：/subscriptions/{subId}/resourceGroups/{rgName}/providers/Microsoft.MachineLearningServices/{resourceType}/{resourceName}/registryPrivateEndpointConnections/{peConnectionName}
location	string	与工作区位置相同。
properties.groupIds	string[]	组 ID
properties.privateEndpoint	PrivateEndpointResource	链接到此 PE 连接的 PE 网络资源。
properties.provisioningState	string	null、“Succeeded”、“Provisioning”、“Failed”之一。虽然未获得批准，但为 null。
properties.registryPrivateLinkServiceConnectionState	RegistryPrivateLinkServiceConnectionState	连接状态。

RegistryPrivateLinkServiceConnectionState

Object

连接状态。

名称	类型	说明
actionsRequired	string	某些 RP 选择“无”。其他 RP 将此用于区域扩展。
description	string	根据 NRP 文档，用户定义的消息可用于与审批相关的消息。
status	EndpointServiceConnectionStatus	服务使用者与服务提供商的连接状态

RegistryRegionArmDetails

Object

注册表所在的每个区域的详细信息

名称	类型	说明
acrDetails	AcrDetails[]	ACR 帐户列表
location	string	注册表所在的位置
storageAccountDetails	StorageAccountDetails[]	存储帐户列表

RegistryTrackedResource

Object

名称	类型	说明
id	string	资源的完全限定资源 ID。示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	托管服务标识（系统分配和/或用户分配的标识）
kind	string	门户/工具等用于为相同类型的资源呈现不同的 UX 体验的元数据。
location	string	资源所在的地理位置
name	string	资源的名称
properties.discoveryUrl	string	注册表的发现 URL
properties.intellectualPropertyPublisher	string	注册表的 IntellectualPropertyPublisher
properties.managedResourceGroup	ArmResourceId	如果注册表已创建系统，则托管 RG 的 ResourceId
properties.managedResourceGroupSettings	ManagedResourceGroupSettings	托管资源组特定设置
properties.mlFlowRegistryUri	string	注册表的 MLFlow 注册表 URI
properties.publicNetworkAccess	string	注册表是否可从 Internet 访问？可能的值：“Enabled”或“Disabled”
properties.regionDetails	RegistryRegionArmDetails[]	注册表所在的每个区域的详细信息
properties.registryPrivateEndpointConnections	RegistryPrivateEndpointConnection[]	专用终结点连接信息，用于专用链接门户中的挂起连接
sku	Sku	用于自动缩放的 ARM 协定所需的 SKU 详细信息。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

Sku

Object

表示 SKU 的资源模型定义

名称	类型	说明
capacity	integer (int32)	如果 SKU 支持横向扩展/缩减，则应包含容量整数。如果资源无法横向扩展/缩小，则可能会省略此范围。
family	string	如果服务具有不同代的硬件（对于同一 SKU，则可以在此处捕获）。
name	string	SKU 的名称。例 - P3。它通常是字母+数字代码
size	string	SKU 大小。当名称字段是层和其他一些值的组合时，这将是独立的代码。
tier	SkuTier	如果服务具有多个层，但在 PUT 上不需要，则需要资源提供程序实现此字段。

SkuTier

枚举

如果服务具有多个层，但在 PUT 上不需要，则需要资源提供程序实现此字段。

值	说明
Basic
Free
Premium
Standard

StorageAccountDetails

Object

要用于注册表的存储帐户的详细信息

名称	类型	说明
systemCreatedStorageAccount	SystemCreatedStorageAccount	要用于注册表的系统创建的存储帐户的详细信息

SystemCreatedAcrAccount

Object

名称	类型	说明
acrAccountName	string	ACR 帐户的名称
acrAccountSku	string	ACR 帐户的 SKU
armResourceId	ArmResourceId	创建 ACR 帐户后，将填充此帐户。

SystemCreatedStorageAccount

Object

名称	类型	说明
allowBlobPublicAccess	boolean	允许的公共 Blob 访问
armResourceId	ArmResourceId	创建存储帐户后，会填充此值。
storageAccountHnsEnabled	boolean	为存储帐户启用了 HNS
storageAccountName	string	存储帐户的名称
storageAccountType	string	允许的值：“Standard_LRS”、“Standard_GRS”、“Standard_RAGRS”、“Standard_ZRS”、“Standard_GZRS”、“Standard_RAGZRS”、“Premium_LRS”、“Premium_ZRS”

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

UserAssignedIdentity

Object

用户分配的标识属性

名称	类型	说明
clientId	string (uuid)	分配的标识的客户端 ID。
principalId	string (uuid)	已分配标识的主体 ID。

通过

Registries - Create Or Update

URI 参数

请求正文

响应

示例

CreateOrUpdate Registry with system created accounts.

示例请求

示例响应

定义

AcrDetails

ArmResourceId

createdByType

EndpointServiceConnectionStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedResourceGroupAssignedIdentities

ManagedResourceGroupSettings

ManagedServiceIdentity

ManagedServiceIdentityType

PrivateEndpointResource

RegistryPrivateEndpointConnection

RegistryPrivateLinkServiceConnectionState

RegistryRegionArmDetails

RegistryTrackedResource

Sku

SkuTier

StorageAccountDetails

SystemCreatedAcrAccount

SystemCreatedStorageAccount

systemData

UserAssignedIdentity