Domains - Create Or Update
도메인을 만들거나 업데이트합니다.
지정된 매개 변수를 사용하여 새 도메인을 비동기적으로 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}?api-version=2025-02-15
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
___domain
|
path | True |
string |
도메인의 이름입니다. |
resource
|
path | True |
string |
사용자의 구독 내에 있는 리소스 그룹의 이름입니다. |
subscription
|
path | True |
string |
Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명입니다. 구독 ID는 모든 서비스 호출에 대한 URI의 일부를 형성합니다. |
api-version
|
query | True |
string |
클라이언트 요청과 함께 사용할 API의 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
___location | True |
string |
리소스의 위치입니다. |
identity |
Event Grid 도메인 리소스에 대한 ID 정보입니다. |
||
properties.autoCreateTopicWithFirstSubscription |
boolean |
이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 만들기 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 만들기는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)일 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 null이거나 true로 설정되면 Event Grid는 도메인 토픽의 범위에서 첫 번째 이벤트 구독을 만들 때 도메인 토픽을 자동으로 만듭니다. 이 속성이 false로 설정된 경우 첫 번째 이벤트 구독을 만들려면 사용자가 도메인 토픽을 만들어야 합니다. 사용자가 도메인 토픽을 만드는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 적은 리소스를 관리할 수 있는 유연성을 제공합니다. 또한 자동 관리형 만들기 모드에서는 필요한 경우 사용자가 요청 시 도메인 토픽을 만들 수 있습니다. |
|
properties.autoDeleteTopicWithLastSubscription |
boolean |
이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 삭제 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 삭제는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)일 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 true로 설정되면 Event Grid는 도메인 토픽의 범위에서 마지막 이벤트 구독이 삭제될 때 도메인 토픽을 자동으로 삭제합니다. 이 속성이 false로 설정된 경우 사용자는 더 이상 필요하지 않을 때 도메인 토픽을 수동으로 삭제해야 합니다(예: 마지막 이벤트 구독이 삭제되고 리소스를 정리해야 하는 경우). 사용자가 도메인 토픽을 삭제해야 하는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 적은 리소스를 관리할 수 있는 유연성을 제공합니다. |
|
properties.dataResidencyBoundary |
리소스의 데이터 상주 경계입니다. |
||
properties.disableLocalAuth |
boolean |
이 부울은 로컬 인증을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 기본값은 false입니다. 속성이 true로 설정되면 사용자가 도메인에 게시할 수 있는 경우 AAD 토큰만 인증하는 데 사용됩니다. |
|
properties.eventTypeInfo |
도메인에 대한 이벤트 유형 정보입니다. 이 정보는 게시자가 제공하며 구독자가 게시되는 다양한 유형의 이벤트를 보는 데 사용할 수 있습니다. |
||
properties.inboundIpRules |
모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. |
||
properties.inputSchema |
Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid에서 예상해야 하는 형식이 결정됩니다. |
||
properties.inputSchemaMapping | InputSchemaMapping: |
매핑 이벤트 페이로드에 대한 정보를 지정한 InputSchemaMapping에 대한 정보입니다. |
|
properties.minimumTlsVersionAllowed |
이 도메인에 게시할 수 있는 게시자의 최소 TLS 버전 |
||
properties.publicNetworkAccess |
이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다. |
||
tags |
object |
리소스의 태그입니다. |
응답
Name | 형식 | Description |
---|---|---|
201 Created |
만든 |
|
Other Status Codes |
오류 응답: ***
|
예제
Domains_CreateOrUpdate
샘플 요청
PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/domains/exampledomain1?api-version=2025-02-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"
}
]
}
}
샘플 응답
{
"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 |
---|---|
Connection |
ConnectionState 정보입니다. |
created |
리소스를 만든 ID의 형식입니다. |
Data |
리소스의 데이터 상주 경계입니다. |
Domain |
EventGrid 도메인. |
Domain |
Event Grid 도메인 리소스의 프로비전 상태입니다. |
Event |
사용되는 이벤트 형식의 종류입니다. |
Event |
채널에 대한 이벤트 유형 정보입니다. |
Identity |
리소스에 대한 ID 정보입니다. |
Identity |
사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다. |
Inbound |
|
Inline |
모든 인라인 이벤트에 대한 추가 정보입니다. |
Input |
Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid에서 예상해야 하는 형식이 결정됩니다. |
Ip |
IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. |
Json |
Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'id', 'topic' 및 'eventtime' 속성에 대한 매핑에 사용됩니다. 입력 이벤트 스키마의 필드를 나타냅니다. |
Json |
Event Grid 이벤트 스키마에서 단일 대상 필드에 대한 입력 스키마 매핑의 원본을 표현하는 데 사용됩니다. 이는 현재 'subject', 'eventtype' 및 'dataversion' 속성에 대한 매핑에 사용됩니다. 이는 사용할 기본값과 함께 입력 이벤트 스키마의 필드를 나타내며, 이러한 두 속성 중 하나 이상을 제공해야 합니다. |
Json |
이렇게 하면 사용자 지정 입력 스키마를 사용하여 Event Grid에 게시할 수 있습니다. 사용자 지정 입력 JSON 스키마의 속성을 Event Grid 이벤트 스키마에 매핑하는 데 사용할 수 있습니다. |
Persisted |
연결의 상태입니다. |
Private |
PrivateEndpoint 정보입니다. |
Private |
|
Public |
이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다. |
Resource |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
Tls |
이 도메인에 게시할 수 있는 게시자의 최소 TLS 버전 |
User |
사용자 ID에 대한 정보입니다. |
ConnectionState
ConnectionState 정보입니다.
Name | 형식 | Description |
---|---|---|
actionsRequired |
string |
필요한 작업(있는 경우)입니다. |
description |
string |
연결 상태에 대한 설명입니다. |
status |
연결의 상태입니다. |
createdByType
리소스를 만든 ID의 형식입니다.
값 | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
DataResidencyBoundary
리소스의 데이터 상주 경계입니다.
값 | Description |
---|---|
WithinGeopair | |
WithinRegion |
Domain
EventGrid 도메인.
Name | 형식 | Default value | Description |
---|---|---|---|
id |
string |
리소스의 정규화된 식별자입니다. |
|
identity |
Event Grid 도메인 리소스에 대한 ID 정보입니다. |
||
___location |
string |
리소스의 위치입니다. |
|
name |
string |
리소스의 이름입니다. |
|
properties.autoCreateTopicWithFirstSubscription |
boolean |
True |
이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 만들기 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 만들기는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)일 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 null이거나 true로 설정되면 Event Grid는 도메인 토픽의 범위에서 첫 번째 이벤트 구독을 만들 때 도메인 토픽을 자동으로 만듭니다. 이 속성이 false로 설정된 경우 첫 번째 이벤트 구독을 만들려면 사용자가 도메인 토픽을 만들어야 합니다. 사용자가 도메인 토픽을 만드는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 적은 리소스를 관리할 수 있는 유연성을 제공합니다. 또한 자동 관리형 만들기 모드에서는 필요한 경우 사용자가 요청 시 도메인 토픽을 만들 수 있습니다. |
properties.autoDeleteTopicWithLastSubscription |
boolean |
True |
이 부울은 이 Event Grid 도메인 리소스와 연결된 Event Grid 도메인 토픽 'all'에 대한 삭제 메커니즘을 지정하는 데 사용됩니다. 이 컨텍스트에서 도메인 토픽 삭제는 자동 관리(true인 경우) 또는 자체 관리(false인 경우)일 수 있습니다. 이 속성의 기본값은 true입니다. 이 속성이 true로 설정되면 Event Grid는 도메인 토픽의 범위에서 마지막 이벤트 구독이 삭제될 때 도메인 토픽을 자동으로 삭제합니다. 이 속성이 false로 설정된 경우 사용자는 더 이상 필요하지 않을 때 도메인 토픽을 수동으로 삭제해야 합니다(예: 마지막 이벤트 구독이 삭제되고 리소스를 정리해야 하는 경우). 사용자가 도메인 토픽을 삭제해야 하는 시기를 완전히 제어하려는 경우 자체 관리 모드를 사용할 수 있으며, 자동 관리 모드는 작업을 줄이고 사용자가 적은 리소스를 관리할 수 있는 유연성을 제공합니다. |
properties.dataResidencyBoundary |
리소스의 데이터 상주 경계입니다. |
||
properties.disableLocalAuth |
boolean |
False |
이 부울은 로컬 인증을 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 기본값은 false입니다. 속성이 true로 설정되면 사용자가 도메인에 게시할 수 있는 경우 AAD 토큰만 인증하는 데 사용됩니다. |
properties.endpoint |
string |
이벤트를 게시하는 데 사용되는 Event Grid 도메인 리소스의 엔드포인트입니다. |
|
properties.eventTypeInfo |
도메인에 대한 이벤트 유형 정보입니다. 이 정보는 게시자가 제공하며 구독자가 게시되는 다양한 유형의 이벤트를 보는 데 사용할 수 있습니다. |
||
properties.inboundIpRules |
모든 IP 대신 특정 IP의 트래픽을 제한하는 데 사용할 수 있습니다. 참고: PublicNetworkAccess를 사용하는 경우에만 고려됩니다. |
||
properties.inputSchema | EventGridSchema |
Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid에서 예상해야 하는 형식이 결정됩니다. |
|
properties.inputSchemaMapping | InputSchemaMapping: |
매핑 이벤트 페이로드에 대한 정보를 지정한 InputSchemaMapping에 대한 정보입니다. |
|
properties.metricResourceId |
string |
Event Grid 도메인 리소스에 대한 메트릭 리소스 ID입니다. |
|
properties.minimumTlsVersionAllowed |
이 도메인에 게시할 수 있는 게시자의 최소 TLS 버전 |
||
properties.privateEndpointConnections |
프라이빗 엔드포인트 연결 목록입니다. |
||
properties.provisioningState |
Event Grid 도메인 리소스의 프로비전 상태입니다. |
||
properties.publicNetworkAccess | Enabled |
이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다. |
|
systemData |
Event Grid 리소스와 관련된 시스템 메타데이터입니다. |
||
tags |
object |
리소스의 태그입니다. |
|
type |
string |
리소스의 유형입니다. |
DomainProvisioningState
Event Grid 도메인 리소스의 프로비전 상태입니다.
값 | Description |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Succeeded | |
Updating |
EventDefinitionKind
사용되는 이벤트 형식의 종류입니다.
값 | Description |
---|---|
Inline |
EventTypeInfo
채널에 대한 이벤트 유형 정보입니다.
Name | 형식 | Description |
---|---|---|
inlineEventTypes |
<string,
Inline |
리소스에 대한 인라인 이벤트 형식의 컬렉션입니다. 인라인 이벤트 형식 키는 이벤트의 이름을 나타내는 문자열 형식입니다. 유효한 인라인 이벤트 이름의 예는 "Contoso.OrderCreated"입니다. 인라인 이벤트 형식 값은 InlineEventProperties 형식이며 모든 인라인 이벤트 형식에 대한 추가 정보를 포함합니다. |
kind |
사용되는 이벤트 형식의 종류입니다. |
IdentityInfo
리소스에 대한 ID 정보입니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
리소스 ID의 보안 주체 ID입니다. |
tenantId |
string |
리소스의 테넌트 ID입니다. |
type |
사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다. |
|
userAssignedIdentities |
<string,
User |
리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다. 이 속성은 현재 사용되지 않으며 향후 사용을 위해 예약되어 있습니다. |
IdentityType
사용되는 관리 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 모든 ID를 제거합니다.
값 | Description |
---|---|
None | |
SystemAssigned | |
SystemAssigned, UserAssigned | |
UserAssigned |
InboundIpRule
Name | 형식 | Description |
---|---|---|
action |
IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다. |
|
ipMask |
string |
CIDR 표기법의 IP 주소(예: 10.0.0.0/8). |
InlineEventProperties
모든 인라인 이벤트에 대한 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
dataSchemaUrl |
string |
인라인 이벤트에 대한 dataSchemaUrl입니다. |
description |
string |
인라인 이벤트에 대한 설명입니다. |
displayName |
string |
인라인 이벤트의 displayName입니다. |
documentationUrl |
string |
인라인 이벤트에 대한 documentationUrl입니다. |
InputSchema
Event Grid 도메인 리소스에 게시된 들어오는 이벤트에 대해 Event Grid에서 예상해야 하는 형식이 결정됩니다.
값 | Description |
---|---|
CloudEventSchemaV1_0 | |
CustomEventSchema | |
EventGridSchema |
IpActionType
IpMask의 일치 또는 일치 여부에 따라 수행할 작업입니다.
값 | Description |
---|---|
Allow |
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 |
Event Grid 이벤트의 DataVersion 속성에 대한 매핑 정보입니다. |
|
properties.eventTime |
Event Grid 이벤트의 EventTime 속성에 대한 매핑 정보입니다. |
|
properties.eventType |
Event Grid 이벤트의 EventType 속성에 대한 매핑 정보입니다. |
|
properties.id |
Event Grid 이벤트의 Id 속성에 대한 매핑 정보입니다. |
|
properties.subject |
Event Grid 이벤트의 Subject 속성에 대한 매핑 정보입니다. |
|
properties.topic |
Event Grid 이벤트의 Topic 속성에 대한 매핑 정보입니다. |
PersistedConnectionStatus
연결의 상태입니다.
값 | Description |
---|---|
Approved | |
Disconnected | |
Pending | |
Rejected |
PrivateEndpoint
PrivateEndpoint 정보입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트의 ARM 식별자입니다. |
PrivateEndpointConnection
Name | 형식 | Description |
---|---|---|
id |
string |
리소스의 정규화된 식별자입니다. |
name |
string |
리소스의 이름입니다. |
properties.groupIds |
string[] |
프라이빗 링크 서비스 리소스의 GroupId입니다. |
properties.privateEndpoint |
이 연결에 대한 프라이빗 엔드포인트 리소스입니다. |
|
properties.privateLinkServiceConnectionState |
연결 상태에 대한 세부 정보입니다. |
|
properties.provisioningState |
프라이빗 엔드포인트 연결의 프로비전 상태입니다. |
|
type |
string |
리소스의 유형입니다. |
PublicNetworkAccess
이는 공용 네트워크를 통해 트래픽이 허용되는지 여부를 결정합니다. 기본적으로 사용하도록 설정됩니다. 구성하여 특정 IP로 더 제한할 수 있습니다.
값 | Description |
---|---|
Disabled | |
Enabled |
ResourceProvisioningState
프라이빗 엔드포인트 연결의 프로비전 상태입니다.
값 | Description |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Succeeded | |
Updating |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |
TlsVersion
이 도메인에 게시할 수 있는 게시자의 최소 TLS 버전
값 | Description |
---|---|
1.0 | |
1.1 | |
1.2 |
UserIdentityProperties
사용자 ID에 대한 정보입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
사용자 할당 ID의 클라이언트 ID입니다. |
principalId |
string |
사용자 할당 ID의 보안 주체 ID입니다. |