Inference Pools - Update

服務:: Machine Learning

API 版本:: 2025-10-01-preview

更新 InferencePool （非同步）。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/inferencePools/{inferencePoolName}?api-version=2025-10-01-preview

URI 參數

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

要求本文

名稱	類型	Description
identity	PartialManagedServiceIdentity	受控服務識別（系統指派和/或使用者指派的身分識別）
sku	PartialSku	自動調整之 ARM 合約所需的 SKU 詳細數據。
tags	object	資源標籤。

回應

名稱	類型	Description
200 OK	InferencePoolTrackedResource	成功
202 Accepted		已接受標題 x-ms-async-operation-timeout: string Location: string Retry-After: integer
Other Status Codes	ErrorResponse	錯誤

名稱

類型

Description

200 OK

InferencePoolTrackedResource

成功

202 Accepted

已接受

標題

x-ms-async-operation-timeout: string
Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

錯誤

範例

Update Workspace Inference Pool.

範例要求

HTTP

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/inferencePools/string?api-version=2025-10-01-preview

{
  "tags": {},
  "sku": {
    "name": "string",
    "tier": "Standard",
    "size": "string",
    "family": "string",
    "capacity": 1
  },
  "identity": {
    "type": "UserAssigned",
    "userAssignedIdentities": {
      "string": {}
    }
  }
}

範例回覆

狀態碼:: 200

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "properties": [
      {
        "key": "string",
        "value": "string"
      }
    ],
    "provisioningState": "Canceled",
    "scaleUnitConfiguration": {
      "registries": [
        "string",
        "registryName1"
      ],
      "disablePublicEgress": false
    }
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:22",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:22",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  },
  "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": "Standard",
    "size": "string",
    "family": "string",
    "capacity": 1
  }
}

狀態碼:: 202

location: https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/testrg123/providers/Microsoft.MachineLearningServices/locations/centraluseuap/mfeOperationResults/prefix:F0C6B8EC-0D53-432C-913B-1CD9E8CDE3A0

定義

名稱	Description
createdByType	建立資源的身分識別類型。
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
InferencePool	推論集區組態
InferencePoolTrackedResource
ManagedServiceIdentity	受控服務識別（系統指派和/或使用者指派的身分識別）
ManagedServiceIdentityType	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。
PartialManagedServiceIdentity	受控服務識別（系統指派和/或使用者指派的身分識別）
PartialMinimalTrackedResourceWithSkuAndIdentity	嚴格用於更新請求。
PartialSku	通用 SKU 定義。
PoolProvisioningState	集區相關資源佈建的狀態。
ScaleUnitConfiguration	ScaleUnit 集區的設定。
Sku	代表 SKU 的資源模型定義
SkuTier	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。
StringStringKeyValuePair
systemData	與建立和上次修改資源相關的元數據。
UserAssignedIdentity	使用者指派的身分識別屬性

createdByType

列舉型別

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

值	Description
User
Application
ManagedIdentity
Key

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 物件。

InferencePool

Object

推論集區組態

名稱	類型	Description
description	string	資源的描述。
properties	StringStringKeyValuePair[]	屬性字典。可以新增屬性，但無法移除或改變。
provisioningState	PoolProvisioningState	集區的佈建狀態。
scaleUnitConfiguration	ScaleUnitConfiguration	取得或設定推斷集區的 ScaleUnitConfiguration。如果 PoolType=ScaleUnit，則使用。

InferencePoolTrackedResource

Object

名稱	類型	Description
id	string	資源的完整資源標識碼。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity	ManagedServiceIdentity	受控服務識別（系統指派和/或使用者指派的身分識別）
kind	string	入口網站/工具等用來轉譯相同類型資源的不同UX體驗的元數據。
location	string	資源所在的地理位置
name	string	資源的名稱
properties	InferencePool	[必要]實體的其他屬性。
sku	Sku	自動調整之 ARM 合約所需的 SKU 詳細數據。
systemData	systemData	包含 createdBy 和 modifiedBy 資訊的 Azure Resource Manager 元數據。
tags	object	資源標籤。
type	string	資源的類型。例如「Microsoft.Compute/virtualMachines」或「Microsoft.Storage/storageAccounts」

ManagedServiceIdentity

Object

受控服務識別（系統指派和/或使用者指派的身分識別）

名稱	類型	Description
principalId	string (uuid)	系統指派身分識別的服務主體標識碼。此屬性只會針對系統指派的身分識別提供。
tenantId	string (uuid)	系統指派身分識別的租用戶標識碼。此屬性只會針對系統指派的身分識別提供。
type	ManagedServiceIdentityType	受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned 身分識別與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。

ManagedServiceIdentityType

列舉型別

受控服務識別的類型（允許 SystemAssigned 和 UserAssigned 類型）。

值	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

PartialManagedServiceIdentity

Object

受控服務識別（系統指派和/或使用者指派的身分識別）

名稱	類型	Description
type	ManagedServiceIdentityType	受控服務識別（系統指派和/或使用者指派的身分識別）
userAssignedIdentities		與資源相關聯的使用者指派身分識別集。 userAssignedIdentities 字典索引鍵的格式為 ARM 資源標識符：'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}。字典值可以是要求中的空白物件（{}）。

PartialMinimalTrackedResourceWithSkuAndIdentity

Object

嚴格用於更新請求。

名稱	類型	Description
identity	PartialManagedServiceIdentity	受控服務識別（系統指派和/或使用者指派的身分識別）
sku	PartialSku	自動調整之 ARM 合約所需的 SKU 詳細數據。
tags	object	資源標籤。

PartialSku

Object

通用 SKU 定義。

名稱	類型	Description
capacity	integer (int32)	如果 SKU 支援相應放大/縮小，則應該包含容量整數。如果資源無法相應放大/縮小，可能會省略此專案。
family	string	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。
name	string	SKU 的名稱。例如 - P3。它通常是字母+數字代碼。
size	string	SKU 大小。當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。
tier	SkuTier	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。

PoolProvisioningState

列舉型別

集區相關資源佈建的狀態。

值	Description
Creating
Deleting
Succeeded
Failed
Updating
Canceled

ScaleUnitConfiguration

Object

ScaleUnit 集區的設定。

名稱	類型	預設值	Description
disablePublicEgress	boolean	False	取得或設定值，指出是否停用 PublicEgress。
registries	string[]		取得或設定將用來確認身分識別、記憶體、ACR 的登錄來源清單。

Sku

Object

代表 SKU 的資源模型定義

名稱	類型	Description
capacity	integer (int32)	如果 SKU 支援相應放大/縮小，則應該包含容量整數。如果資源無法相應放大/縮小，可能會省略此專案。
family	string	如果服務有不同世代的硬體，針對相同的 SKU，則可以在這裡擷取。
name	string	SKU 的名稱。例如 - P3。通常是字母+數位碼
size	string	SKU 大小。當名稱欄位是階層和其他一些值的組合時，這會是獨立程序代碼。
tier	SkuTier	如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。

SkuTier

列舉型別

如果服務有一個以上的層級，但 PUT 上不需要此欄位，則資源提供者必須實作此字段。

值	Description
Free
Basic
Standard
Premium

StringStringKeyValuePair

Object

名稱	類型	Description
key	string
value	string

systemData

Object

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

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

UserAssignedIdentity

Object

使用者指派的身分識別屬性

名稱	類型	Description
clientId	string (uuid)	指派之身分識別的用戶端標識碼。
principalId	string (uuid)	指派之身分識別的主體標識碼。

共用方式為

Inference Pools - Update

URI 參數

要求本文

回應

範例

Update Workspace Inference Pool.

範例要求

範例回覆

定義

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InferencePool

InferencePoolTrackedResource

ManagedServiceIdentity

ManagedServiceIdentityType

PartialManagedServiceIdentity

PartialMinimalTrackedResourceWithSkuAndIdentity

PartialSku

PoolProvisioningState

ScaleUnitConfiguration

Sku

SkuTier

StringStringKeyValuePair

systemData

UserAssignedIdentity