Outbound Rules - Post

服务:

Machine Learning

API 版本:

2026-03-15-preview

用于更新与机器学习工作区关联的托管网络的出站规则的 POST API。

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/managedNetworks/{managedNetworkName}/batchOutboundRules?api-version=2026-03-15-preview

URI 参数

名称	在	必需	类型	说明
managedNetworkName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	与工作区关联的 managedNetwork 的名称。 仅支持“默认”。
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	ManagedNetworkSettings	机器学习工作区的托管网络设置。

响应

名称	类型	说明
200 OK	OutboundRuleListResult	Azure作已成功完成。
202 Accepted		已接受资源作。 标头 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	意外的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Post OutboundRules

示例请求

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/managedNetworks/default/batchOutboundRules?api-version=2026-03-15-preview

{
  "properties": {
    "enableNetworkMonitor": true,
    "firewallSku": "Standard",
    "isolationMode": "AllowOnlyApprovedOutbound",
    "outboundRules": {
      "rule_name_1": {
        "type": "FQDN",
        "category": "UserDefined",
        "destination": "destination_endpoint"
      }
    }
  }
}

示例响应

状态代码:

200

{
  "value": [
    {
      "name": "rule_name_1",
      "type": "workspace/outboundRules",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/managedNetworks/default/outboundRules/rule_name_1",
      "properties": {
        "type": "FQDN",
        "category": "Required",
        "destination": "destination_of_the_fqdn_rule",
        "errorInformation": null,
        "status": "Active"
      }
    }
  ]
}

状态代码:

202

Location: example_location

定义

名称	说明
createdByType	创建资源的标识的类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
FirewallSku	用于 FQDN 规则的防火墙 SKU
FqdnOutboundRule	机器学习工作区托管网络的 FQDN 出站规则。
IsolationMode	机器学习工作区的托管网络的隔离模式。
ManagedNetworkKind	托管网络的 Kind。 用户可以从 V1 切换到 V2 以进行精细访问控制，但启用 V2 后无法切换回 V1。
ManagedNetworkProvisionStatus	机器学习工作区托管网络的预配状态。
ManagedNetworkSettings	机器学习工作区的托管网络设置。
ManagedNetworkSettingsBasicResource
ManagedNetworkStatus	机器学习工作区的托管网络的状态。
OutboundRuleBasicResource	具体代理资源类型可以通过使用特定属性类型将此类型别名创建。
OutboundRuleListResult	OutboundRuleBasicResource 项目的分页集合
PrivateEndpointDestination	机器学习工作区托管网络的专用终结点出站规则的专用终结点目标。
PrivateEndpointOutboundRule	机器学习工作区托管网络的专用终结点出站规则。
RuleAction	网络规则的操作枚举。
RuleCategory	机器学习工作区的托管网络出站规则类别。
RuleStatus	机器学习工作区的托管网络出站规则的类型。
RuleType	机器学习工作区的托管网络出站规则的类型。
ServiceTagDestination	机器学习工作区托管网络的服务标记出站规则的服务标记目标。
ServiceTagOutboundRule	机器学习工作区托管网络的服务标记出站规则。
systemData	与创建和上次修改资源相关的元数据。

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

对象

资源管理错误附加信息。

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

ErrorDetail

对象

错误详细信息。

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

ErrorResponse

对象

错误响应

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

FirewallSku

枚举

用于 FQDN 规则的防火墙 SKU

值	说明
Standard
Basic

FqdnOutboundRule

对象

机器学习工作区托管网络的 FQDN 出站规则。

名称	类型	说明
category	RuleCategory	机器学习工作区的托管网络出站规则类别。
destination	string
errorInformation	string	如果 RuleStatus 失败，则有关机器学习工作区的出站规则的错误信息。
parentRuleNames	string[]
status	RuleStatus	机器学习工作区的托管网络出站规则的类型。
type	string: FQDN	机器学习工作区的托管网络出站规则的类型。

IsolationMode

枚举

机器学习工作区的托管网络的隔离模式。

值	说明
Disabled
AllowInternetOutbound
AllowOnlyApprovedOutbound

ManagedNetworkKind

枚举

托管网络的 Kind。 用户可以从 V1 切换到 V2 以进行精细访问控制，但启用 V2 后无法切换回 V1。

值	说明
V1
V2

ManagedNetworkProvisionStatus

对象

机器学习工作区托管网络的预配状态。

名称	类型	说明
sparkReady	boolean
status	ManagedNetworkStatus	机器学习工作区的托管网络的状态。

ManagedNetworkSettings

对象

机器学习工作区的托管网络设置。

名称	类型	默认值	说明
enableNetworkMonitor	boolean	False	一个标志，用于指示是否需要为托管网络启用监控。
firewallPublicIpAddress	string		分配给 Azure 防火墙的公共 IP 地址。
firewallSku	FirewallSku		用于 FQDN 规则的防火墙 SKU
isolationMode	IsolationMode		机器学习工作区的托管网络的隔离模式。
managedNetworkKind	ManagedNetworkKind		托管网络的 Kind。 用户可以从 V1 切换到 V2 以进行精细访问控制，但启用 V2 后无法切换回 V1。
networkId	string
outboundRules	object		OutboundRule 字典<>
status	ManagedNetworkProvisionStatus		机器学习工作区托管网络的预配状态。

ManagedNetworkSettingsBasicResource

对象

名称	类型	说明
id	string	资源的完全限定的资源 ID。 示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	资源的名称
properties	ManagedNetworkSettings	机器学习工作区的托管网络设置。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

ManagedNetworkStatus

枚举

机器学习工作区的托管网络的状态。

值	说明
Inactive
Active

OutboundRuleBasicResource

对象

具体代理资源类型可以通过使用特定属性类型将此类型别名创建。

名称	类型	说明
id	string	资源的完全限定的资源 ID。 示例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	资源的名称
properties	OutboundRule: FqdnOutboundRule PrivateEndpointOutboundRule ServiceTagOutboundRule	机器学习工作区的托管网络的出站规则。
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
type	string	资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

OutboundRuleListResult

对象

OutboundRuleBasicResource 项目的分页集合

名称	类型	说明
nextLink	string (uri)	指向下一页项的链接
value	OutboundRuleBasicResource[]	本页的OutboundRuleBasicResource项目

PrivateEndpointDestination

对象

机器学习工作区托管网络的专用终结点出站规则的专用终结点目标。

名称	类型	说明
serviceResourceId	string (arm-id)	将 ID 引用到 Azure 资源管理器资源的类型定义。
sparkEnabled	boolean
sparkStatus	RuleStatus	机器学习工作区的托管网络出站规则的类型。
subresourceTarget	string

PrivateEndpointOutboundRule

对象

机器学习工作区托管网络的专用终结点出站规则。

名称	类型	说明
category	RuleCategory	机器学习工作区的托管网络出站规则类别。
destination	PrivateEndpointDestination	机器学习工作区托管网络的专用终结点出站规则的专用终结点目标。
errorInformation	string	如果 RuleStatus 失败，则有关机器学习工作区的出站规则的错误信息。
fqdns	string[]
parentRuleNames	string[]
status	RuleStatus	机器学习工作区的托管网络出站规则的类型。
type	string: PrivateEndpoint	机器学习工作区的托管网络出站规则的类型。

RuleAction

枚举

网络规则的操作枚举。

值	说明
Allow
Deny

RuleCategory

枚举

机器学习工作区的托管网络出站规则类别。

值	说明
Required
Recommended
UserDefined
Dependency

RuleStatus

枚举

机器学习工作区的托管网络出站规则的类型。

值	说明
Inactive
Active
Provisioning
Deleting
Failed

RuleType

枚举

机器学习工作区的托管网络出站规则的类型。

值	说明
FQDN
PrivateEndpoint
ServiceTag

ServiceTagDestination

对象

机器学习工作区托管网络的服务标记出站规则的服务标记目标。

名称	类型	说明
action	RuleAction	网络规则的操作枚举。
addressPrefixes	string[]	可选，如果提供，将忽略 ServiceTag 属性。
portRanges	string
protocol	string
serviceTag	string

ServiceTagOutboundRule

对象

机器学习工作区托管网络的服务标记出站规则。

名称	类型	说明
category	RuleCategory	机器学习工作区的托管网络出站规则类别。
destination	ServiceTagDestination	机器学习工作区托管网络的服务标记出站规则的服务标记目标。
errorInformation	string	如果 RuleStatus 失败，则有关机器学习工作区的出站规则的错误信息。
parentRuleNames	string[]
status	RuleStatus	机器学习工作区的托管网络出站规则的类型。
type	string: ServiceTag	机器学习工作区的托管网络出站规则的类型。

systemData

对象

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

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