Namespaces - Network Rule Set - Create Or Update Network Rule Set

Referensi

Service:: Service Bus

API Version:: 2021-06-01-preview

Membuat atau memperbarui NetworkRuleSet untuk Namespace.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ServiceBus/namespaces/{namespaceName}/networkRuleSets/default?api-version=2021-06-01-preview

Parameter URI

Name	In	Required	Type	Description
namespaceName	path	True	string	Nama namespace
resourceGroupName	path	True	string	Nama grup Sumber Daya dalam langganan Azure.
subscriptionId	path	True	string	Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
api-version	query	True	string	Versi API klien.

Isi Permintaan

Name	Type	Description
properties.defaultAction	DefaultAction	Tindakan Default untuk Seperangkat Aturan Jaringan
properties.ipRules	NWRuleSetIpRules[]	Daftar IpRules
properties.publicNetworkAccess	PublicNetworkAccessFlag	Ini menentukan apakah lalu lintas diizinkan melalui jaringan publik. Secara default diaktifkan.
properties.trustedServiceAccessEnabled	boolean	Nilai yang menunjukkan apakah Akses Layanan Tepercaya Diaktifkan atau tidak.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]	Mencantumkan Aturan VirtualNetwork

Respons

Name	Type	Description
200 OK	NetworkRuleSet	Namespace NetworkRuleSet berhasil dikembalikan.
Other Status Codes	ErrorResponse	Respons kesalahan ServiceBus yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Azure Active Directory Flow OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	meniru akun pengguna Anda

Contoh

NameSpaceNetworkRuleSetCreate

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2021-06-01-preview

{
  "properties": {
    "defaultAction": "Deny",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        },
        "ignoreMissingVnetServiceEndpoint": false
      }
    ],
    "ipRules": [
      {
        "ipMask": "1.1.1.1",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.2",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.3",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.4",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.5",
        "action": "Allow"
      }
    ]
  }
}

Sample Response

Status code:: 200

{
  "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/Default-ServiceBus-AustraliaEast/providers/Microsoft.ServiceBus/namespaces/sdk-Namespace-9659/networkruleset/default",
  "name": "default",
  "type": "Microsoft.ServiceBus/Namespaces/NetworkRuleSet",
  "properties": {
    "defaultAction": "Deny",
    "publicNetworkAccess": "Enabled",
    "virtualNetworkRules": [
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        },
        "ignoreMissingVnetServiceEndpoint": true
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        },
        "ignoreMissingVnetServiceEndpoint": false
      },
      {
        "subnet": {
          "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourcegroups/alitest/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        },
        "ignoreMissingVnetServiceEndpoint": false
      }
    ],
    "ipRules": [
      {
        "ipMask": "1.1.1.1",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.2",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.3",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.4",
        "action": "Allow"
      },
      {
        "ipMask": "1.1.1.5",
        "action": "Allow"
      }
    ]
  }
}

Definisi

createdByType	Jenis identitas yang membuat sumber daya.
DefaultAction	Tindakan Default untuk Seperangkat Aturan Jaringan
Error	Objek kesalahan.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorResponse	Respons kesalahan manajemen sumber daya.
NetworkRuleIPAction	Tindakan Filter IP
NetworkRuleSet	Deskripsi sumber daya NetworkRuleSet.
NWRuleSetIpRules	Deskripsi NetWorkRuleSet - Sumber daya IpRules.
NWRuleSetVirtualNetworkRules	Deskripsi VirtualNetworkRules - Sumber daya NetworkRules.
PublicNetworkAccessFlag	Ini menentukan apakah lalu lintas diizinkan melalui jaringan publik. Secara default diaktifkan.
Subnet	Properti yang disediakan untuk Subnet
systemData	Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

createdByType

Jenis identitas yang membuat sumber daya.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DefaultAction

Tindakan Default untuk Seperangkat Aturan Jaringan

Name	Type	Description
Allow	string
Deny	string

Error

Objek kesalahan.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorResponse[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Name	Type	Description
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorResponse

Respons kesalahan manajemen sumber daya.

Name	Type	Description
error	Error	Objek kesalahan.

NetworkRuleIPAction

Tindakan Filter IP

Name	Type	Description
Allow	string

NetworkRuleSet

Deskripsi sumber daya NetworkRuleSet.

Name	Type	Default Value	Description
id	string		ID sumber daya
name	string		Nama sumber daya
properties.defaultAction	DefaultAction		Tindakan Default untuk Seperangkat Aturan Jaringan
properties.ipRules	NWRuleSetIpRules[]		Daftar IpRules
properties.publicNetworkAccess	PublicNetworkAccessFlag	Enabled	Ini menentukan apakah lalu lintas diizinkan melalui jaringan publik. Secara default diaktifkan.
properties.trustedServiceAccessEnabled	boolean		Nilai yang menunjukkan apakah Akses Layanan Tepercaya Diaktifkan atau tidak.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]		Mencantumkan Aturan VirtualNetwork
systemData	systemData		Data meta sistem yang berkaitan dengan sumber daya ini.
type	string		Jenis Sumber Daya

NWRuleSetIpRules

Deskripsi NetWorkRuleSet - Sumber daya IpRules.

Name	Type	Default Value	Description
action	NetworkRuleIPAction	Allow	Tindakan Filter IP
ipMask	string		Masker IP

NWRuleSetVirtualNetworkRules

Deskripsi VirtualNetworkRules - Sumber daya NetworkRules.

Name	Type	Description
ignoreMissingVnetServiceEndpoint	boolean	Nilai yang menunjukkan apakah akan mengabaikan Titik Akhir Layanan VNet yang hilang
subnet	Subnet	Properti subnet

PublicNetworkAccessFlag

Ini menentukan apakah lalu lintas diizinkan melalui jaringan publik. Secara default diaktifkan.

Name	Type	Description
Disabled	string
Enabled	string

Subnet

Properti yang disediakan untuk Subnet

Name	Type	Description
id	string	ID sumber daya subnet Virtual Network

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Name	Type	Description
createdAt	string	Tanda waktu pembuatan sumber daya (UTC).
createdBy	string	Identitas yang membuat sumber daya.
createdByType	createdByType	Jenis identitas yang membuat sumber daya.
lastModifiedAt	string	Jenis identitas yang terakhir mengubah sumber daya.
lastModifiedBy	string	Identitas yang terakhir memodifikasi sumber daya.
lastModifiedByType	createdByType	Jenis identitas yang terakhir mengubah sumber daya.