Namespaces - Create Or Update Network Rule Set

  • 참조
Service:
Event Hubs
API Version:
2024-01-01

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

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
namespaceName
 path True

string

네임스페이스 이름

Regex pattern: ^[a-zA-Z][a-zA-Z0-9-]{6,50}[a-zA-Z0-9]$
resourceGroupName
 path True

string

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

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 값이 SecuredByPerimeter이면 인바운드 및 아웃바운드 통신은 네트워크 보안 경계 및 프로필의 액세스 규칙에 의해 제어됩니다.
properties.trustedServiceAccessEnabled

boolean

신뢰할 수 있는 서비스 액세스가 사용인지 여부를 나타내는 값입니다.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork 규칙 나열

응답

Name 형식 Description
200 OK

NetworkRuleSet

네임스페이스 NetworkRuleSet이 성공적으로 반환되었습니다.
Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 ServiceBus 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation 사용자 계정 가장

예제

NameSpaceNetworkRuleSetCreate

Sample Request

PUT https://management.azure.com/subscriptions/Subscription/resourceGroups/ResourceGroup/providers/Microsoft.EventHub/namespaces/sdk-Namespace-6019/networkRuleSets/default?api-version=2024-01-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"
      }
    ]
  }
}

Sample Response

Status code:
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",
    "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

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 값이 SecuredByPerimeter이면 인바운드 및 아웃바운드 통신은 네트워크 보안 경계 및 프로필의 액세스 규칙에 의해 제어됩니다.
Subnet

서브넷에 제공된 속성
systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DefaultAction

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

Name 형식 Description
Allow

string

Deny

string

ErrorAdditionalInfo

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

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

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

Name 형식 Description
error

ErrorDetail

Error 개체.

NetworkRuleIPAction

IP 필터 작업

Name 형식 Description
Allow

string

NetworkRuleSet

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

Name 형식 기본값 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

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 값이 SecuredByPerimeter이면 인바운드 및 아웃바운드 통신은 네트워크 보안 경계 및 프로필의 액세스 규칙에 의해 제어됩니다.
properties.trustedServiceAccessEnabled

boolean

신뢰할 수 있는 서비스 액세스가 사용인지 여부를 나타내는 값입니다.
properties.virtualNetworkRules

NWRuleSetVirtualNetworkRules[]

VirtualNetwork 규칙 나열
systemData

systemData

이 리소스와 관련된 시스템 메타 데이터입니다.
type

string

리소스 형식입니다. 예: "Microsoft.EventHub/Namespaces" 또는 "Microsoft.EventHub/Namespaces/EventHubs"

NWRuleSetIpRules

네임스페이스 나열 작업의 응답입니다.

Name 형식 Description
action

NetworkRuleIPAction

IP 필터 작업
ipMask

string

IP 마스크

NWRuleSetVirtualNetworkRules

네임스페이스 나열 작업의 응답입니다.

Name 형식 Description
ignoreMissingVnetServiceEndpoint

boolean

누락된 Vnet 서비스 엔드포인트를 무시할지 여부를 나타내는 값
subnet

Subnet

서브넷 속성

PublicNetworkAccessFlag

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 값이 SecuredByPerimeter이면 인바운드 및 아웃바운드 통신은 네트워크 보안 경계 및 프로필의 액세스 규칙에 의해 제어됩니다.

Name 형식 Description
Disabled

string

Enabled

string

SecuredByPerimeter

string

Subnet

서브넷에 제공된 속성

Name 형식 Description
id

string

Virtual Network 서브넷의 리소스 ID

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

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

string

리소스를 마지막으로 수정한 ID 유형입니다.
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.