Network Rule Sets - Create Or Update Network Rule Set

서비스:: Event Hubs

API 버전:: 2021-11-01

네임스페이스에 대한 NetworkRuleSet을 만들거나 업데이트합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
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	Azure 구독 내의 리소스 그룹의 이름입니다.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다.
api-version	query	True	string	클라이언트 API 버전입니다.

요청 본문

Name	형식	Description
properties.defaultAction	DefaultAction	네트워크 규칙 집합에 대한 기본 작업
properties.ipRules	NWRuleSetIpRules[]	IpRules 목록
properties.publicNetworkAccess	PublicNetworkAccessFlag	이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
properties.trustedServiceAccessEnabled	boolean	신뢰할 수 있는 서비스 액세스를 사용할지 여부를 나타내는 값입니다.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]	VirtualNetwork 규칙 나열

응답

Name	형식	Description
200 OK	NetworkRuleSet	네임스페이스 NetworkRuleSet이 성공적으로 반환되었습니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 ServiceBus 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

NameSpaceNetworkRuleSetCreate

샘플 요청

HTTP

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

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

샘플 응답

상태 코드:: 200

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

정의

Name	Description
createdByType	리소스를 만든 ID의 형식입니다.
DefaultAction	네트워크 규칙 집합에 대한 기본 작업
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답은 Event Hub 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.
NetworkRuleIPAction	IP 필터 작업
NetworkRuleSet	토픽 리소스에 대한 설명입니다.
NWRuleSetIpRules	네임스페이스 목록 작업의 응답입니다.
NWRuleSetVirtualNetworkRules	네임스페이스 목록 작업의 응답입니다.
PublicNetworkAccessFlag	이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
Subnet	서브넷에 제공된 속성
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
User
Application
ManagedIdentity
Key

DefaultAction

열거형

네트워크 규칙 집합에 대한 기본 작업

값	Description
Allow
Deny

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답은 Event Hub 서비스가 들어오는 요청을 처리할 수 없음을 나타냅니다. 그 이유는 오류 메시지에 제공됩니다.

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

NetworkRuleIPAction

열거형

IP 필터 작업

값	Description
Allow

NetworkRuleSet

Object

토픽 리소스에 대한 설명입니다.

Name	형식	Default value	Description
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	이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.
properties.trustedServiceAccessEnabled	boolean		신뢰할 수 있는 서비스 액세스를 사용할지 여부를 나타내는 값입니다.
properties.virtualNetworkRules	NWRuleSetVirtualNetworkRules[]		VirtualNetwork 규칙 나열
systemData	systemData		이 리소스와 관련된 시스템 메타 데이터입니다.
type	string		리소스의 형식입니다. 예: "Microsoft.EventHub/Namespaces" 또는 "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

Object

네임스페이스 목록 작업의 응답입니다.

Name	형식	Description
action	NetworkRuleIPAction	IP 필터 작업
ipMask	string	IP 마스크

NWRuleSetVirtualNetworkRules

Object

네임스페이스 목록 작업의 응답입니다.

Name	형식	Description
ignoreMissingVnetServiceEndpoint	boolean	누락된 Vnet 서비스 엔드포인트를 무시할지 여부를 나타내는 값
subnet	Subnet	서브넷 속성

PublicNetworkAccessFlag

열거형

이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다.

값	Description
Enabled
Disabled

Subnet

Object

서브넷에 제공된 속성

Name	형식	Description
id	string	Virtual Network 서브넷의 리소스 ID

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string (date-time)	리소스 만들기의 타임스탬프(UTC)입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string (date-time)	리소스를 마지막으로 수정한 ID의 형식입니다.
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID의 형식입니다.

다음을 통해 공유

Network Rule Sets - Create Or Update Network Rule Set

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

NameSpaceNetworkRuleSetCreate

샘플 요청

샘플 응답

정의

createdByType

DefaultAction

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

NetworkRuleIPAction

NetworkRuleSet

NWRuleSetIpRules

NWRuleSetVirtualNetworkRules

PublicNetworkAccessFlag

Subnet

systemData