Namespaces - Create Or Update Network Rule Set

サービス:
Event Hubs
API バージョン:
2026-01-01

名前空間の NetworkRuleSet を作成または更新します。

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

URI パラメーター

名前 / 必須 型 説明
namespaceName
 path True

string

minLength: 6
maxLength: 50
pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$

名前空間名
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前の大文字と小文字は区別されません。
subscriptionId
 path True

string

minLength: 1

ターゲット サブスクリプションの ID。
api-version
 query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

名前 型 説明
properties.defaultAction

DefaultAction

ネットワーク ルール セットの既定のアクション
properties.ipRules

NWRuleSetIpRules[]

IpRules の一覧
properties.publicNetworkAccess

PublicNetworkAccessFlag

これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。 値が SecuredByPerimeter の場合、受信と送信の通信は、ネットワーク セキュリティ境界とプロファイルのアクセス規則によって制御されます。
properties.trustedServiceAccessEnabled

boolean

信頼されたサービス アクセスが有効かどうかを示す値。
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork ルールの一覧表示

応答

名前 型 説明
200 OK

NetworkRuleSet

リソース 'NetworkRuleSet' の更新操作に成功しました
Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

NameSpaceNetworkRuleSetCreate

要求のサンプル

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

{
  "properties": {
    "defaultAction": "Deny",
    "ipRules": [
      {
        "action": "Allow",
        "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"
      }
    ],
    "virtualNetworkRules": [
      {
        "ignoreMissingVnetServiceEndpoint": true,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        }
      },
      {
        "ignoreMissingVnetServiceEndpoint": false,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        }
      },
      {
        "ignoreMissingVnetServiceEndpoint": false,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        }
      }
    ]
  }
}

応答のサンプル

状態コード:
200 
{
  "name": "default",
  "type": "Microsoft.EventHub/Namespaces/NetworkRuleSet",
  "id": "/subscriptions/854d368f-1828-428f-8f3c-f2affa9b2f7d/resourceGroups/resourcegroupid/providers/Microsoft.EventHub/namespaces/sdk-Namespace-9659/networkruleset/default",
  "properties": {
    "defaultAction": "Deny",
    "ipRules": [
      {
        "action": "Allow",
        "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"
      }
    ],
    "virtualNetworkRules": [
      {
        "ignoreMissingVnetServiceEndpoint": true,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet2"
        }
      },
      {
        "ignoreMissingVnetServiceEndpoint": false,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet3"
        }
      },
      {
        "ignoreMissingVnetServiceEndpoint": false,
        "subnet": {
          "id": "/subscriptions/subscriptionid/resourcegroups/resourcegroupid/providers/Microsoft.Network/virtualNetworks/myvn/subnets/subnet6"
        }
      }
    ]
  }
}

定義

名前 説明
createdByType

リソースを作成した ID の種類。
DefaultAction

ネットワーク ルール セットの既定のアクション
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答は、Event Hub サービスが受信要求を処理できないことを示します。 エラー メッセージに理由が示されます。
NetworkRuleIPAction

IP フィルター アクション
NetworkRuleSet

トピック リソースの説明。
NWRuleSetIpRules

List 名前空間操作からの応答。
NWRuleSetVirtualNetworkRules

List 名前空間操作からの応答。
PublicNetworkAccessFlag

これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。 値が SecuredByPerimeter の場合、受信と送信の通信は、ネットワーク セキュリティ境界とプロファイルのアクセス規則によって制御されます。
Subnet

サブネットに提供されるプロパティ
systemData

リソースの作成と最後の変更に関連するメタデータ。

createdByType

列挙

リソースを作成した ID の種類。

値 説明
User
Application
ManagedIdentity
Key

DefaultAction

列挙

ネットワーク ルール セットの既定のアクション

値 説明
Allow
Deny

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答は、Event Hub サービスが受信要求を処理できないことを示します。 エラー メッセージに理由が示されます。

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

NetworkRuleIPAction

列挙

IP フィルター アクション

値 説明
Allow

NetworkRuleSet

Object

トピック リソースの説明。

名前 型 規定値 説明
id

string

リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

リソースが存在する地理的な場所
name

string

リソースの名前
properties.defaultAction

DefaultAction

ネットワーク ルール セットの既定のアクション
properties.ipRules

NWRuleSetIpRules[]

IpRules の一覧
properties.publicNetworkAccess

PublicNetworkAccessFlag

Enabled

これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。 値が SecuredByPerimeter の場合、受信と送信の通信は、ネットワーク セキュリティ境界とプロファイルのアクセス規則によって制御されます。
properties.trustedServiceAccessEnabled

boolean

信頼されたサービス アクセスが有効かどうかを示す値。
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork ルールの一覧表示
systemData

systemData

createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。
type

string

リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

NWRuleSetIpRules

Object

List 名前空間操作からの応答。

名前 型 説明
action

NetworkRuleIPAction

IP フィルター アクション
ipMask

string

IP マスク

NWRuleSetVirtualNetworkRules

Object

List 名前空間操作からの応答。

名前 型 説明
ignoreMissingVnetServiceEndpoint

boolean

不足している Vnet サービス エンドポイントを無視するかどうかを示す値
subnet

Subnet

サブネットのプロパティ

PublicNetworkAccessFlag

列挙

これにより、パブリック ネットワーク経由でトラフィックが許可されるかどうかが決まります。 既定では有効になっています。 値が SecuredByPerimeter の場合、受信と送信の通信は、ネットワーク セキュリティ境界とプロファイルのアクセス規則によって制御されます。

値 説明
Enabled
Disabled
SecuredByPerimeter

Subnet

Object

サブネットに提供されるプロパティ

名前 型 説明
id

string

Virtual Network サブネットのリソース ID

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。
createdBy

string

リソースを作成した ID。
createdByType

createdByType

リソースを作成した ID の種類。
lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy

string

リソースを最後に変更した ID。
lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。