Outbound Rules - Post

Layanan:: Machine Learning

Versi API:: 2026-03-15-preview

API POST untuk memperbarui aturan keluar jaringan terkelola yang terkait dengan ruang kerja pembelajaran mesin.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
managedNetworkName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nama managedNetwork yang terkait dengan ruang kerja. Hanya 'default' yang didukung.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
workspaceName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]{2,32}$	Nama Ruang Kerja Azure Machine Learning
api-version	query	True	string minLength: 1	Versi API yang akan digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
properties	ManagedNetworkSettings	Pengaturan Jaringan Terkelola untuk ruang kerja pembelajaran mesin.

Respons

Nama	Jenis	Deskripsi
200 OK	OutboundRuleListResult	Operasi Azure berhasil diselesaikan.
202 Accepted		Operasi sumber daya diterima. Header Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Respons kesalahan tak terduga.

Nama

Jenis

Deskripsi

200 OK

OutboundRuleListResult

Operasi Azure berhasil diselesaikan.

202 Accepted

Operasi sumber daya diterima.

Header

Location: string
Retry-After: integer

Other Status Codes

ErrorResponse

Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

Post OutboundRules

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"
      }
    }
  }
}

package armmachinelearning_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/machinelearning/armmachinelearning/v5"
)

// Generated from example definition: 2026-03-15-preview/ManagedNetwork/postOutboundRulesV2.json
func ExampleOutboundRulesClient_BeginPost() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmachinelearning.NewClientFactory("00000000-1111-2222-3333-444444444444", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewOutboundRulesClient().BeginPost(ctx, "test-rg", "aml-workspace-name", "default", armmachinelearning.ManagedNetworkSettingsBasicResource{
		Properties: &armmachinelearning.ManagedNetworkSettings{
			EnableNetworkMonitor: to.Ptr(true),
			FirewallSKU:          to.Ptr(armmachinelearning.FirewallSKUStandard),
			IsolationMode:        to.Ptr(armmachinelearning.IsolationModeAllowOnlyApprovedOutbound),
			OutboundRules: map[string]armmachinelearning.OutboundRuleClassification{
				"rule_name_1": &armmachinelearning.FqdnOutboundRule{
					Type:        to.Ptr(armmachinelearning.RuleTypeFQDN),
					Category:    to.Ptr(armmachinelearning.RuleCategoryUserDefined),
					Destination: to.Ptr("destination_endpoint"),
				},
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to poll the result: %v", err)
	}
	for res.More() {
		page, err := res.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armmachinelearning.OutboundRulesClientPostResponse{
		// 	OutboundRuleListResult: armmachinelearning.OutboundRuleListResult{
		// 		Value: []*armmachinelearning.OutboundRuleBasicResource{
		// 			{
		// 				Name: to.Ptr("rule_name_1"),
		// 				Type: to.Ptr("workspace/outboundRules"),
		// 				ID: to.Ptr("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/aml-workspace-name/managedNetworks/default/outboundRules/rule_name_1"),
		// 				Properties: &armmachinelearning.FqdnOutboundRule{
		// 					Type: to.Ptr(armmachinelearning.RuleTypeFQDN),
		// 					Category: to.Ptr(armmachinelearning.RuleCategoryRequired),
		// 					Destination: to.Ptr("destination_of_the_fqdn_rule"),
		// 					Status: to.Ptr(armmachinelearning.RuleStatusActive),
		// 				},
		// 			},
		// 		},
		// 	},
		// }
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Respon sampel

Kode status:: 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"
      }
    }
  ]
}

Kode status:: 202

Location: example_location

Definisi

Nama	Deskripsi
createdByType	Jenis identitas yang membuat sumber daya.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
FirewallSku	Firewall Sku digunakan untuk Aturan FQDN
FqdnOutboundRule	Aturan Keluar FQDN untuk jaringan terkelola ruang kerja pembelajaran mesin.
IsolationMode	Mode isolasi untuk jaringan terkelola ruang kerja pembelajaran mesin.
ManagedNetworkKind	Jenis jaringan yang dikelola. Pengguna dapat beralih dari V1 ke V2 untuk kontrol akses terperinci, tetapi tidak dapat beralih kembali ke V1 setelah V2 diaktifkan.
ManagedNetworkProvisionStatus	Status Provisi untuk jaringan terkelola ruang kerja pembelajaran mesin.
ManagedNetworkSettings	Pengaturan Jaringan Terkelola untuk ruang kerja pembelajaran mesin.
ManagedNetworkSettingsBasicResource
ManagedNetworkStatus	Status untuk jaringan terkelola ruang kerja pembelajaran mesin.
OutboundRuleBasicResource	Jenis sumber daya proksi konkret dapat dibuat dengan alias jenis ini menggunakan jenis properti tertentu.
OutboundRuleListResult	Kumpulan halaman item OutboundRuleBasicResource
PrivateEndpointDestination	Tujuan Titik Akhir Privat untuk Aturan Keluar Titik Akhir Privat untuk jaringan terkelola ruang kerja pembelajaran mesin.
PrivateEndpointOutboundRule	Aturan Keluar Titik Akhir Privat untuk jaringan terkelola ruang kerja pembelajaran mesin.
RuleAction	Enum tindakan untuk aturan jaringan.
RuleCategory	Kategori Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
RuleStatus	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
RuleType	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
ServiceTagDestination	Tujuan Tag Layanan untuk Aturan Keluar Tag Layanan untuk jaringan terkelola ruang kerja pembelajaran mesin.
ServiceTagOutboundRule	Aturan Keluar Tag Layanan untuk jaringan terkelola ruang kerja pembelajaran mesin.
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Enumerasi

Jenis identitas yang membuat sumber daya.

Nilai	Deskripsi
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Rincian kesalahan.
message	string	Pesan kesalahan.
target	string	Sasaran kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

FirewallSku

Enumerasi

Firewall Sku digunakan untuk Aturan FQDN

Nilai	Deskripsi
Standard
Basic

FqdnOutboundRule

Objek

Aturan Keluar FQDN untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
category	RuleCategory	Kategori Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
destination	string
errorInformation	string	Informasi kesalahan tentang aturan keluar dari ruang kerja pembelajaran mesin jika RuleStatus gagal.
parentRuleNames	string[]
status	RuleStatus	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
type	string: FQDN	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

IsolationMode

Enumerasi

Mode isolasi untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nilai	Deskripsi
Disabled
AllowInternetOutbound
AllowOnlyApprovedOutbound

ManagedNetworkKind

Enumerasi

Jenis jaringan yang dikelola. Pengguna dapat beralih dari V1 ke V2 untuk kontrol akses terperinci, tetapi tidak dapat beralih kembali ke V1 setelah V2 diaktifkan.

Nilai	Deskripsi
V1
V2

ManagedNetworkProvisionStatus

Objek

Status Provisi untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
sparkReady	boolean
status	ManagedNetworkStatus	Status untuk jaringan terkelola ruang kerja pembelajaran mesin.

ManagedNetworkSettings

Objek

Pengaturan Jaringan Terkelola untuk ruang kerja pembelajaran mesin.

Nama	Jenis	Nilai default	Deskripsi
enableNetworkMonitor	boolean	False	Bendera untuk menunjukkan apakah pemantauan perlu diaktifkan untuk jaringan terkelola.
firewallPublicIpAddress	string		Alamat IP publik yang ditetapkan ke Azure Firewall.
firewallSku	FirewallSku		Firewall Sku digunakan untuk Aturan FQDN
isolationMode	IsolationMode		Mode isolasi untuk jaringan terkelola ruang kerja pembelajaran mesin.
managedNetworkKind	ManagedNetworkKind		Jenis jaringan yang dikelola. Pengguna dapat beralih dari V1 ke V2 untuk kontrol akses terperinci, tetapi tidak dapat beralih kembali ke V1 setelah V2 diaktifkan.
networkId	string
outboundRules	object		Kamus <OutboundRule>
status	ManagedNetworkProvisionStatus		Status Provisi untuk jaringan terkelola ruang kerja pembelajaran mesin.

ManagedNetworkSettingsBasicResource

Objek

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties	ManagedNetworkSettings	Pengaturan Jaringan Terkelola untuk ruang kerja pembelajaran mesin.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

ManagedNetworkStatus

Enumerasi

Status untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nilai	Deskripsi
Inactive
Active

OutboundRuleBasicResource

Objek

Jenis sumber daya proksi konkret dapat dibuat dengan alias jenis ini menggunakan jenis properti tertentu.

Nama	Jenis	Deskripsi
id	string	ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Misalnya - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nama sumber daya
properties	OutboundRule: FqdnOutboundRule PrivateEndpointOutboundRule ServiceTagOutboundRule	Aturan Keluar untuk jaringan terkelola ruang kerja pembelajaran mesin.
systemData	systemData	Metadata Azure Resource Manager yang berisi informasi createBy dan modifiedBy.
type	string	Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

OutboundRuleListResult

Objek

Kumpulan halaman item OutboundRuleBasicResource

Nama	Jenis	Deskripsi
nextLink	string (uri)	Tautan ke halaman item berikutnya
value	OutboundRuleBasicResource[]	Item OutboundRuleBasicResource di halaman ini

PrivateEndpointDestination

Objek

Tujuan Titik Akhir Privat untuk Aturan Keluar Titik Akhir Privat untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
serviceResourceId	string (arm-id)	Definisi jenis yang merujuk id ke sumber daya Azure Resource Manager.
sparkEnabled	boolean
sparkStatus	RuleStatus	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
subresourceTarget	string

PrivateEndpointOutboundRule

Objek

Aturan Keluar Titik Akhir Privat untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
category	RuleCategory	Kategori Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
destination	PrivateEndpointDestination	Tujuan Titik Akhir Privat untuk Aturan Keluar Titik Akhir Privat untuk jaringan terkelola ruang kerja pembelajaran mesin.
errorInformation	string	Informasi kesalahan tentang aturan keluar dari ruang kerja pembelajaran mesin jika RuleStatus gagal.
fqdns	string[]
parentRuleNames	string[]
status	RuleStatus	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
type	string: PrivateEndpoint	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

RuleAction

Enumerasi

Enum tindakan untuk aturan jaringan.

Nilai	Deskripsi
Allow
Deny

RuleCategory

Enumerasi

Kategori Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

Nilai	Deskripsi
Required
Recommended
UserDefined
Dependency

RuleStatus

Enumerasi

Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

Nilai	Deskripsi
Inactive
Active
Provisioning
Deleting
Failed

RuleType

Enumerasi

Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

Nilai	Deskripsi
FQDN
PrivateEndpoint
ServiceTag

ServiceTagDestination

Objek

Tujuan Tag Layanan untuk Aturan Keluar Tag Layanan untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
action	RuleAction	Enum tindakan untuk aturan jaringan.
addressPrefixes	string[]	Opsional, jika disediakan, properti ServiceTag akan diabaikan.
portRanges	string
protocol	string
serviceTag	string

ServiceTagOutboundRule

Objek

Aturan Keluar Tag Layanan untuk jaringan terkelola ruang kerja pembelajaran mesin.

Nama	Jenis	Deskripsi
category	RuleCategory	Kategori Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
destination	ServiceTagDestination	Tujuan Tag Layanan untuk Aturan Keluar Tag Layanan untuk jaringan terkelola ruang kerja pembelajaran mesin.
errorInformation	string	Informasi kesalahan tentang aturan keluar dari ruang kerja pembelajaran mesin jika RuleStatus gagal.
parentRuleNames	string[]
status	RuleStatus	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.
type	string: ServiceTag	Jenis Aturan Keluar jaringan terkelola dari ruang kerja pembelajaran mesin.

systemData

Objek

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama	Jenis	Deskripsi
createdAt	string (date-time)	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string (date-time)	Tanda waktu modifikasi terakhir sumber daya (UTC)
lastModifiedBy	string	Identitas yang terakhir mengubah sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir memodifikasi sumber daya.