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

Capability Hosts - Create Or Update

服务:: Machine Learning

API 版本:: 2025-09-01

创建或更新 capabilityHost。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/capabilityHosts/{name}?api-version=2025-09-01

URI 参数

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

请求正文

名称	必需	类型	说明
properties	True	CapabilityHost	[必需]实体的其他属性。

响应

名称	类型	说明
200 OK	CapabilityHostResource	创建或更新请求成功。
201 Created	CapabilityHostResource	已创建标头 x-ms-async-operation-timeout: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	错误

名称

类型

说明

200 OK

CapabilityHostResource

创建或更新请求成功。

201 Created

CapabilityHostResource

已创建

标头

x-ms-async-operation-timeout: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

错误

示例

CreateOrUpdate CapabilityHost.

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/capabilityHosts/capabilityHostName?api-version=2025-09-01

{
  "properties": {
    "customerSubnet": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroups/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubnet"
  }
}

示例响应

状态代码:: 200

{
  "id": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/capabilityHosts/capabilityHostName",
  "name": "capabilityHostName",
  "type": "Microsoft.MachineLearningServices/workspaces/capabilityHosts",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "customerSubnet": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroups/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubne",
    "provisioningState": "Succeeded"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:22",
    "createdBy": "string",
    "createdByType": "ManagedIdentity",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:22",
    "lastModifiedBy": "string",
    "lastModifiedByType": "ManagedIdentity"
  }
}

状态代码:: 201

Location: example_location

{
  "id": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/capabilityHosts/capabilityHostName",
  "name": "capabilityHostName",
  "type": "Microsoft.MachineLearningServices/workspaces/capabilityHosts",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "customerSubnet": "subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myResourceGroups/providers/Microsoft.Network/virtualNetworks/myVnet/subnets/mySubne",
    "provisioningState": "Succeeded"
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999+00:22",
    "createdBy": "string",
    "createdByType": "ManagedIdentity",
    "lastModifiedAt": "2020-01-01T12:34:56.999+00:22",
    "lastModifiedBy": "string",
    "lastModifiedByType": "ManagedIdentity"
  }
}

定义

名称	说明
CapabilityHost
CapabilityHostKind
CapabilityHostProvisioningState	功能主机的预配状态。
CapabilityHostResource	Azure 资源管理器资源信封。
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
systemData	与创建和上次修改资源相关的元数据。

CapabilityHost

Object

名称	类型	默认值	说明
aiServicesConnections	string[]		AI 服务连接列表。
capabilityHostKind	CapabilityHostKind	Agents	此功能主机的类型。
customerSubnet	string		用于帮助设置此功能主机的客户子网信息。
description	string		资产说明文本。
properties	object		资产属性字典。
provisioningState	CapabilityHostProvisioningState		CapabilityHost 的预配状态。
storageConnections	string[]		存储连接列表。
tags	object		标记字典。可以添加、删除和更新标记。
threadStorageConnections	string[]		线程存储连接列表。
vectorStoreConnections	string[]		VectorStore 连接列表。

CapabilityHostKind

枚举

值	说明
Agents

CapabilityHostProvisioningState

枚举

功能主机的预配状态。

值	说明
Succeeded
Failed
Canceled
Creating
Updating
Deleting

CapabilityHostResource

Object

Azure 资源管理器资源信封。

名称	类型	说明
id	string	资源的完全限定资源 ID。例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	资源的名称
properties	CapabilityHost	[必需]实体的其他属性。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Object

资源管理错误附加信息。

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

ErrorDetail

Object

错误详细信息。

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

ErrorResponse

Object

错误响应

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

systemData

Object

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

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

通过

Capability Hosts - Create Or Update

URI 参数

请求正文

响应

示例

CreateOrUpdate CapabilityHost.

示例请求

示例响应

定义

CapabilityHost

CapabilityHostKind

CapabilityHostProvisioningState

CapabilityHostResource

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

systemData