Domains - Create Or Update

도메인을 만들거나 업데이트합니다.
지정된 매개 변수를 사용하여 새 도메인을 비동기적으로 만들거나 업데이트합니다.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}?api-version=2022-06-15

URI 매개 변수

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

string

도메인의 이름입니다.

resourceGroupName
path True

string

사용자의 구독 내에서 리소스 그룹의 이름입니다.

subscriptionId
path True

string

Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.

api-version
query True

string

클라이언트 요청과 함께 사용할 API의 버전입니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스의 위치입니다.

identity

IdentityInfo

Event Grid 도메인 리소스에 대한 ID 정보입니다.

properties.autoCreateTopicWithFirstSubscription

boolean

이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 만들기 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 만들기는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)가 될 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 null이거나 true로 설정된 경우 Event Grid는 도메인 토픽의 scope 첫 번째 이벤트 구독이 만들어질 때 도메인 토픽을 자동으로 만듭니다. 이 속성을 false로 설정하면 첫 번째 이벤트 구독을 만들려면 사용자가 도메인 토픽을 만들어야 합니다. 사용자가 도메인 토픽을 만드는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 사용자가 더 적은 작업을 수행하고 더 적은 리소스를 관리할 수 있는 유연성을 제공합니다. 또한 자동 관리형 만들기 모드에서는 필요한 경우 요청 시 도메인 토픽을 만들 수 있습니다.

properties.autoDeleteTopicWithLastSubscription

boolean

이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 삭제 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 삭제는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)가 될 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성을 true로 설정하면 Event Grid는 도메인 토픽의 scope 마지막 이벤트 구독이 삭제되면 도메인 토픽을 자동으로 삭제합니다. 이 속성을 false로 설정하면 더 이상 필요하지 않은 경우(예: 마지막 이벤트 구독이 삭제되고 리소스를 정리해야 하는 경우) 도메인 토픽을 수동으로 삭제해야 합니다. 사용자가 도메인 토픽을 삭제해야 하는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 더 적은 리소스를 관리할 수 있는 유연성을 제공합니다.

properties.dataResidencyBoundary

DataResidencyBoundary

리소스의 Data Residency 경계입니다.

properties.disableLocalAuth

boolean

이 부울은 로컬 인증을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 기본값은 false입니다. 속성이 true로 설정되면 사용자가 도메인에 게시할 수 있는 경우 AAD 토큰만 인증하는 데 사용됩니다.

properties.inboundIpRules

InboundIpRule[]

모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다.

properties.inputSchema

InputSchema

이는 Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid가 예상해야 하는 형식을 결정합니다.

properties.inputSchemaMapping InputSchemaMapping:

JsonInputSchemaMapping

매핑 이벤트 페이로드에 대한 정보를 지정한 InputSchemaMapping에 대한 정보입니다.

properties.publicNetworkAccess

PublicNetworkAccess

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다.

tags

object

리소스의 태그입니다.

응답

Name 형식 Description
201 Created

Domain

생성일

Other Status Codes

오류 응답: ***

  • 400 잘못된 요청.

  • 500 내부 서버 오류.

예제

Domains_CreateOrUpdate

Sample Request

PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/domains/exampledomain1?api-version=2022-06-15

{
  "location": "westus2",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "properties": {
    "publicNetworkAccess": "Enabled",
    "inboundIpRules": [
      {
        "ipMask": "12.18.30.15",
        "action": "Allow"
      },
      {
        "ipMask": "12.18.176.1",
        "action": "Allow"
      }
    ]
  }
}

Sample Response

{
  "properties": {
    "endpoint": "https://exampledomain1.westus2-1.eventgrid.azure.net/api/events",
    "provisioningState": "Succeeded",
    "publicNetworkAccess": "Enabled",
    "inboundIpRules": [
      {
        "ipMask": "12.18.30.15",
        "action": "Allow"
      },
      {
        "ipMask": "12.18.176.1",
        "action": "Allow"
      }
    ]
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/domains/exampledomain1",
  "location": "westus2",
  "name": "exampledomain1",
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "type": "Microsoft.EventGrid/domains"
}

정의

Name Description
ConnectionState

ConnectionState 정보입니다.

createdByType

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

DataResidencyBoundary

리소스의 Data Residency 경계입니다.

Domain

EventGrid 도메인.

DomainProvisioningState

Event Grid 도메인 리소스의 프로비전 상태입니다.

IdentityInfo

리소스에 대한 ID 정보입니다.

IdentityType

사용되는 관리 ID의 유형입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.

InboundIpRule
InputSchema

이는 Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid가 예상해야 하는 형식을 결정합니다.

IpActionType

IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다.

JsonField

Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'id', 'topic' 및 'eventtime' 속성에 대한 매핑에서 사용됩니다. 입력 이벤트 스키마의 필드를 나타냅니다.

JsonFieldWithDefault

Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'subject', 'eventtype' 및 'dataversion' 속성에 대한 매핑에서 사용됩니다. 이는 사용할 기본값과 함께 입력 이벤트 스키마의 필드를 나타내며 이러한 두 속성 중 하나 이상을 제공해야 합니다.

JsonInputSchemaMapping

이렇게 하면 사용자 지정 입력 스키마를 사용하여 Event Grid에 게시할 수 있습니다. 사용자 지정 입력 JSON 스키마의 속성을 Event Grid 이벤트 스키마에 매핑하는 데 사용할 수 있습니다.

PersistedConnectionStatus

연결의 상태입니다.

PrivateEndpoint

PrivateEndpoint 정보입니다.

PrivateEndpointConnection
PublicNetworkAccess

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다.

ResourceProvisioningState

프라이빗 엔드포인트 연결의 프로비전 상태입니다.

systemData

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

UserIdentityProperties

사용자 ID에 대한 정보입니다.

ConnectionState

ConnectionState 정보입니다.

Name 형식 Description
actionsRequired

string

필요한 작업(있는 경우).

description

string

연결 상태에 대한 설명입니다.

status

PersistedConnectionStatus

연결의 상태입니다.

createdByType

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

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataResidencyBoundary

리소스의 Data Residency 경계입니다.

Name 형식 Description
WithinGeopair

string

WithinRegion

string

Domain

EventGrid 도메인.

Name 형식 기본값 Description
id

string

리소스의 정규화된 식별자입니다.

identity

IdentityInfo

Event Grid 도메인 리소스에 대한 ID 정보입니다.

location

string

리소스의 위치입니다.

name

string

리소스의 이름입니다.

properties.autoCreateTopicWithFirstSubscription

boolean

True

이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 만들기 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 만들기는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)가 될 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 null이거나 true로 설정된 경우 Event Grid는 도메인 토픽의 scope 첫 번째 이벤트 구독이 만들어질 때 도메인 토픽을 자동으로 만듭니다. 이 속성을 false로 설정하면 첫 번째 이벤트 구독을 만들려면 사용자가 도메인 토픽을 만들어야 합니다. 사용자가 도메인 토픽을 만드는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 사용자가 더 적은 작업을 수행하고 더 적은 리소스를 관리할 수 있는 유연성을 제공합니다. 또한 자동 관리형 만들기 모드에서는 필요한 경우 요청 시 도메인 토픽을 만들 수 있습니다.

properties.autoDeleteTopicWithLastSubscription

boolean

True

이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 삭제 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 삭제는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)가 될 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성을 true로 설정하면 Event Grid는 도메인 토픽의 scope 마지막 이벤트 구독이 삭제되면 도메인 토픽을 자동으로 삭제합니다. 이 속성을 false로 설정하면 더 이상 필요하지 않은 경우(예: 마지막 이벤트 구독이 삭제되고 리소스를 정리해야 하는 경우) 도메인 토픽을 수동으로 삭제해야 합니다. 사용자가 도메인 토픽을 삭제해야 하는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 더 적은 리소스를 관리할 수 있는 유연성을 제공합니다.

properties.dataResidencyBoundary

DataResidencyBoundary

리소스의 Data Residency 경계입니다.

properties.disableLocalAuth

boolean

False

이 부울은 로컬 인증을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 기본값은 false입니다. 속성이 true로 설정되면 사용자가 도메인에 게시할 수 있는 경우 AAD 토큰만 인증하는 데 사용됩니다.

properties.endpoint

string

이벤트를 게시하는 데 사용되는 Event Grid 도메인 리소스에 대한 엔드포인트입니다.

properties.inboundIpRules

InboundIpRule[]

모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다.

properties.inputSchema

InputSchema

EventGridSchema

이는 Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid가 예상해야 하는 형식을 결정합니다.

properties.inputSchemaMapping InputSchemaMapping:

JsonInputSchemaMapping

매핑 이벤트 페이로드에 대한 정보를 지정한 InputSchemaMapping에 대한 정보입니다.

properties.metricResourceId

string

Event Grid 도메인 리소스에 대한 메트릭 리소스 ID입니다.

properties.privateEndpointConnections

PrivateEndpointConnection[]

프라이빗 엔드포인트 연결 목록입니다.

properties.provisioningState

DomainProvisioningState

Event Grid 도메인 리소스의 프로비전 상태입니다.

properties.publicNetworkAccess

PublicNetworkAccess

Enabled

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다.

systemData

systemData

Event Grid 도메인 리소스와 관련된 시스템 메타데이터입니다.

tags

object

리소스의 태그입니다.

type

string

리소스 유형입니다.

DomainProvisioningState

Event Grid 도메인 리소스의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

IdentityInfo

리소스에 대한 ID 정보입니다.

Name 형식 Description
principalId

string

리소스 ID의 보안 주체 ID입니다.

tenantId

string

리소스의 테넌트 ID입니다.

type

IdentityType

사용되는 관리 ID의 유형입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.

userAssignedIdentities

<string,  UserIdentityProperties>

리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. 이 속성은 현재 사용되지 않으며 향후 사용을 위해 예약되어 있습니다.

IdentityType

사용되는 관리 ID의 유형입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.

Name 형식 Description
None

string

SystemAssigned

string

SystemAssigned, UserAssigned

string

UserAssigned

string

InboundIpRule

Name 형식 Description
action

IpActionType

IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다.

ipMask

string

CIDR 표기법의 IP 주소(예: 10.0.0.0/8).

InputSchema

이는 Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid가 예상해야 하는 형식을 결정합니다.

Name 형식 Description
CloudEventSchemaV1_0

string

CustomEventSchema

string

EventGridSchema

string

IpActionType

IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다.

Name 형식 Description
Allow

string

JsonField

Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'id', 'topic' 및 'eventtime' 속성에 대한 매핑에서 사용됩니다. 입력 이벤트 스키마의 필드를 나타냅니다.

Name 형식 Description
sourceField

string

매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다.

JsonFieldWithDefault

Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'subject', 'eventtype' 및 'dataversion' 속성에 대한 매핑에서 사용됩니다. 이는 사용할 기본값과 함께 입력 이벤트 스키마의 필드를 나타내며 이러한 두 속성 중 하나 이상을 제공해야 합니다.

Name 형식 Description
defaultValue

string

SourceField가 제공되지 않거나 게시된 JSON 이벤트 페이로드에 지정된 이름의 속성이 없는 경우 매핑에 사용할 기본값입니다.

sourceField

string

매핑의 원본으로 사용할 입력 이벤트 스키마의 필드 이름입니다.

JsonInputSchemaMapping

이렇게 하면 사용자 지정 입력 스키마를 사용하여 Event Grid에 게시할 수 있습니다. 사용자 지정 입력 JSON 스키마의 속성을 Event Grid 이벤트 스키마에 매핑하는 데 사용할 수 있습니다.

Name 형식 Description
inputSchemaMappingType string:

Json

사용자 지정 매핑 유형

properties.dataVersion

JsonFieldWithDefault

Event Grid 이벤트의 DataVersion 속성에 대한 매핑 정보입니다.

properties.eventTime

JsonField

Event Grid 이벤트의 EventTime 속성에 대한 매핑 정보입니다.

properties.eventType

JsonFieldWithDefault

Event Grid 이벤트의 EventType 속성에 대한 매핑 정보입니다.

properties.id

JsonField

Event Grid 이벤트의 Id 속성에 대한 매핑 정보입니다.

properties.subject

JsonFieldWithDefault

Event Grid 이벤트의 Subject 속성에 대한 매핑 정보입니다.

properties.topic

JsonField

Event Grid 이벤트의 Topic 속성에 대한 매핑 정보입니다.

PersistedConnectionStatus

연결의 상태입니다.

Name 형식 Description
Approved

string

Disconnected

string

Pending

string

Rejected

string

PrivateEndpoint

PrivateEndpoint 정보입니다.

Name 형식 Description
id

string

프라이빗 엔드포인트에 대한 ARM 식별자입니다.

PrivateEndpointConnection

Name 형식 Description
id

string

리소스의 정규화된 식별자입니다.

name

string

리소스의 이름입니다.

properties.groupIds

string[]

프라이빗 링크 서비스 리소스의 GroupId입니다.

properties.privateEndpoint

PrivateEndpoint

이 연결에 대한 프라이빗 엔드포인트 리소스입니다.

properties.privateLinkServiceConnectionState

ConnectionState

연결 상태에 대한 세부 정보입니다.

properties.provisioningState

ResourceProvisioningState

프라이빗 엔드포인트 연결의 프로비전 상태입니다.

type

string

리소스 유형입니다.

PublicNetworkAccess

이렇게 하면 공용 네트워크를 통해 트래픽이 허용되는지 여부가 결정됩니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다.

Name 형식 Description
Disabled

string

Enabled

string

ResourceProvisioningState

프라이빗 엔드포인트 연결의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

systemData

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

Name 형식 Description
createdAt

string

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

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

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

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

UserIdentityProperties

사용자 ID에 대한 정보입니다.

Name 형식 Description
clientId

string

사용자 할당 ID의 클라이언트 ID입니다.

principalId

string

사용자 할당 ID의 보안 주체 ID입니다.