你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Domains - Create Or Update
创建或更新域。
使用指定参数异步创建或更新新域。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/domains/{domainName}?api-version=2022-06-15
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
domain
|
path | True |
string |
域的名称。 |
resource
|
path | True |
string |
用户订阅中的资源组的名称。 |
subscription
|
path | True |
string |
唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
要与客户端请求一起使用的 API 的版本。 |
请求正文
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
location | True |
string |
资源的位置。 |
identity |
事件网格域资源的标识信息。 |
||
properties.autoCreateTopicWithFirstSubscription |
boolean |
此布尔值用于指定与此事件网格域资源关联的“所有”事件网格域主题的创建机制。 在此上下文中,当为 true) 时,可以自动管理 (域主题的创建;如果为 false) ,则可以创建自管理 (。 此属性的默认值为 true。 当此属性为 null 或设置为 true 时,事件网格负责在域主题范围内创建第一个事件订阅时自动创建域主题。 如果此属性设置为 false,则创建第一个事件订阅需要用户创建域主题。 如果用户希望完全控制域主题的创建时间,则可以使用自我管理模式,而自动管理模式则允许用户灵活地执行更少的操作和管理更少的资源。 另请注意,在自动管理的创建模式下,允许用户根据需要按需创建域主题。 |
|
properties.autoDeleteTopicWithLastSubscription |
boolean |
此布尔值用于指定与此事件网格域资源关联的“所有”事件网格域主题的删除机制。 在此上下文中,当为 true) 时,可以自动管理 (域主题的删除;如果为 false) ,则可以自行管理 (。 此属性的默认值为 true。 当此属性设置为 true 时,事件网格负责在删除域主题范围内的最后一个事件订阅时自动删除域主题。 如果此属性设置为 false,则用户需要在不再需要域主题时手动删除该主题, (例如,删除最后一个事件订阅并且需要清理资源) 。 如果用户希望完全控制何时需要删除域主题,则可以使用自我管理模式,而自动管理模式则提供由用户执行更少操作和管理资源的灵活性。 |
|
properties.dataResidencyBoundary |
Data Residency资源的边界。 |
||
properties.disableLocalAuth |
boolean |
此布尔值用于启用或禁用本地身份验证。默认值为 false。 当 属性设置为 true 时,如果用户被允许发布到域,则仅使用 AAD 令牌进行身份验证。 |
|
properties.inboundIpRules |
这可用于限制来自特定 IP 而不是所有 IP 的流量。 注意:仅当启用了 PublicNetworkAccess 时,才会考虑这些项。 |
||
properties.inputSchema |
这决定了事件网格应预期发布到事件网格域资源的传入事件的格式。 |
||
properties.inputSchemaMapping | InputSchemaMapping: |
有关 InputSchemaMapping 的信息,它指定了有关映射事件有效负载的信息。 |
|
properties.publicNetworkAccess |
这确定是否允许通过公用网络流量。 默认情况下,它处于启用状态。 可以通过配置进一步限制为特定 IP |
||
tags |
object |
资源的标记。 |
响应
名称 | 类型 | 说明 |
---|---|---|
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=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"
}
]
}
}
示例响应
{
"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"
}
定义
名称 | 说明 |
---|---|
Connection |
ConnectionState 信息。 |
created |
创建资源的标识类型。 |
Data |
资源Data Residency边界。 |
Domain |
EventGrid 域。 |
Domain |
事件网格域资源的预配状态。 |
Identity |
资源的标识信息。 |
Identity |
使用的托管标识的类型。 类型“SystemAssigned, UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。 |
Inbound |
|
Input |
这决定了事件网格对发布到事件网格域资源的传入事件应采用的格式。 |
Ip |
要根据 IpMask 的匹配项或不匹配执行的操作。 |
Json |
这用于表示事件网格事件架构中单个目标字段的输入架构映射的源。 这当前用于“id”、“topic”和“eventtime”属性的映射中。 这表示输入事件架构中的字段。 |
Json |
这用于表示事件网格事件架构中单个目标字段的输入架构映射的源。 这当前在“subject”、“eventtype”和“dataversion”属性的映射中使用。 这表示输入事件架构中的字段以及要使用的默认值,并且至少应提供这两个属性中的一个。 |
Json |
这允许使用自定义输入架构发布到事件网格。 这可用于将属性从自定义输入 JSON 架构映射到事件网格事件架构。 |
Persisted |
连接状态。 |
Private |
PrivateEndpoint 信息。 |
Private |
|
Public |
这确定是否允许通过公用网络进行流量。 默认情况下,它处于启用状态。 可以通过配置来进一步限制为特定 IP |
Resource |
专用终结点连接的预配状态。 |
system |
与资源的创建和上次修改相关的元数据。 |
User |
有关用户标识的信息。 |
ConnectionState
ConnectionState 信息。
名称 | 类型 | 说明 |
---|---|---|
actionsRequired |
string |
如果有任何) , (所需的操作。 |
description |
string |
连接状态的说明。 |
status |
连接状态。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
DataResidencyBoundary
资源Data Residency边界。
名称 | 类型 | 说明 |
---|---|---|
WithinGeopair |
string |
|
WithinRegion |
string |
Domain
EventGrid 域。
名称 | 类型 | 默认值 | 说明 |
---|---|---|---|
id |
string |
资源的完全限定标识符。 |
|
identity |
事件网格域资源的标识信息。 |
||
location |
string |
资源的位置。 |
|
name |
string |
资源的名称。 |
|
properties.autoCreateTopicWithFirstSubscription |
boolean |
True |
此布尔值用于指定与此事件网格域资源关联的“所有”事件网格域主题的创建机制。 在此上下文中,当为 true) 时,可以自动管理域主题的创建 (;如果为 false) ,则可以创建自托管 (。 此属性的默认值为 true。 当此属性为 null 或设置为 true 时,事件网格负责在域主题范围内创建第一个事件订阅时自动创建域主题。 如果此属性设置为 false,则创建第一个事件订阅需要用户创建域主题。 如果用户希望完全控制域主题的创建时间,则可以使用自我管理模式,而自动管理模式则提供灵活性,可以让用户执行更少的操作和管理更少的资源。 另请注意,在自动管理的创建模式下,允许用户根据需要按需创建域主题。 |
properties.autoDeleteTopicWithLastSubscription |
boolean |
True |
此布尔值用于指定与此事件网格域资源关联的“所有”事件网格域主题的删除机制。 在此上下文中,当为 true) 时,可以自动管理 (域主题的删除;如果为 false) ,则可以进行自我管理 (。 此属性的默认值为 true。 当此属性设置为 true 时,事件网格负责在删除域主题范围内的最后一个事件订阅时自动删除域主题。 如果此属性设置为 false,则用户需要在不再需要域主题时手动删除该主题 (例如,删除最后一个事件订阅并且需要清理资源) 。 如果用户希望完全控制何时需要删除域主题,则可以使用自我管理模式,而自动管理模式则提供灵活性,可以让用户执行更少的操作和管理更少的资源。 |
properties.dataResidencyBoundary |
资源Data Residency边界。 |
||
properties.disableLocalAuth |
boolean |
False |
此布尔值用于启用或禁用本地身份验证。默认值为 false。 当 属性设置为 true 时,如果用户被允许发布到域,则仅使用 AAD 令牌进行身份验证。 |
properties.endpoint |
string |
用于发布事件的事件网格域资源的终结点。 |
|
properties.inboundIpRules |
这可用于限制来自特定 IP 而不是所有 IP 的流量。 注意:仅当启用了 PublicNetworkAccess 时,才会考虑这些内容。 |
||
properties.inputSchema | EventGridSchema |
这决定了事件网格对发布到事件网格域资源的传入事件应采用的格式。 |
|
properties.inputSchemaMapping | InputSchemaMapping: |
有关 InputSchemaMapping 的信息,它指定了有关映射事件有效负载的信息。 |
|
properties.metricResourceId |
string |
事件网格域资源的指标资源 ID。 |
|
properties.privateEndpointConnections |
专用终结点连接列表。 |
||
properties.provisioningState |
事件网格域资源的预配状态。 |
||
properties.publicNetworkAccess | Enabled |
这确定是否允许通过公用网络进行流量。 默认情况下,它处于启用状态。 可以通过配置来进一步限制为特定 IP |
|
systemData |
与事件网格域资源相关的系统元数据。 |
||
tags |
object |
资源的标记。 |
|
type |
string |
资源的类型。 |
DomainProvisioningState
事件网格域资源的预配状态。
名称 | 类型 | 说明 |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
IdentityInfo
资源的标识信息。
名称 | 类型 | 说明 |
---|---|---|
principalId |
string |
资源标识的主体 ID。 |
tenantId |
string |
资源的租户 ID。 |
type |
使用的托管标识的类型。 类型“SystemAssigned, UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。 |
|
userAssignedIdentities |
<string,
User |
与资源关联的用户标识列表。 用户标识字典键引用将是 ARM 资源 ID,格式为:“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 此属性当前未使用,保留以供将来使用。 |
IdentityType
使用的托管标识的类型。 类型“SystemAssigned, UserAssigned”包括隐式创建的标识和一组用户分配的标识。 类型“None”将删除任何标识。
名称 | 类型 | 说明 |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
InboundIpRule
名称 | 类型 | 说明 |
---|---|---|
action |
要根据 IpMask 的匹配项或不匹配执行的操作。 |
|
ipMask |
string |
采用 CIDR 表示法的 IP 地址,例如 10.0.0.0/8。 |
InputSchema
这决定了事件网格对发布到事件网格域资源的传入事件应采用的格式。
名称 | 类型 | 说明 |
---|---|---|
CloudEventSchemaV1_0 |
string |
|
CustomEventSchema |
string |
|
EventGridSchema |
string |
IpActionType
要根据 IpMask 的匹配项或不匹配执行的操作。
名称 | 类型 | 说明 |
---|---|---|
Allow |
string |
JsonField
这用于表示事件网格事件架构中单个目标字段的输入架构映射的源。 这当前用于“id”、“topic”和“eventtime”属性的映射中。 这表示输入事件架构中的字段。
名称 | 类型 | 说明 |
---|---|---|
sourceField |
string |
要用作映射源的输入事件架构中的字段的名称。 |
JsonFieldWithDefault
这用于表示事件网格事件架构中单个目标字段的输入架构映射的源。 这当前在“subject”、“eventtype”和“dataversion”属性的映射中使用。 这表示输入事件架构中的字段以及要使用的默认值,并且至少应提供这两个属性中的一个。
名称 | 类型 | 说明 |
---|---|---|
defaultValue |
string |
如果未提供 SourceField,或者发布的 JSON 事件有效负载中没有具有指定名称的属性,则用于映射的默认值。 |
sourceField |
string |
要用作映射源的输入事件架构中的字段的名称。 |
JsonInputSchemaMapping
这允许使用自定义输入架构发布到事件网格。 这可用于将属性从自定义输入 JSON 架构映射到事件网格事件架构。
名称 | 类型 | 说明 |
---|---|---|
inputSchemaMappingType |
string:
Json |
自定义映射的类型 |
properties.dataVersion |
事件网格事件的 DataVersion 属性的映射信息。 |
|
properties.eventTime |
事件网格事件的 EventTime 属性的映射信息。 |
|
properties.eventType |
事件网格事件的 EventType 属性的映射信息。 |
|
properties.id |
事件网格事件的 Id 属性的映射信息。 |
|
properties.subject |
事件网格事件的 Subject 属性的映射信息。 |
|
properties.topic |
事件网格事件的 Topic 属性的映射信息。 |
PersistedConnectionStatus
连接状态。
名称 | 类型 | 说明 |
---|---|---|
Approved |
string |
|
Disconnected |
string |
|
Pending |
string |
|
Rejected |
string |
PrivateEndpoint
PrivateEndpoint 信息。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
专用终结点的 ARM 标识符。 |
PrivateEndpointConnection
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定标识符。 |
name |
string |
资源的名称。 |
properties.groupIds |
string[] |
专用链接服务资源的 GroupIds。 |
properties.privateEndpoint |
此连接的专用终结点资源。 |
|
properties.privateLinkServiceConnectionState |
有关连接状态的详细信息。 |
|
properties.provisioningState |
专用终结点连接的预配状态。 |
|
type |
string |
资源的类型。 |
PublicNetworkAccess
这确定是否允许通过公用网络进行流量。 默认情况下,它处于启用状态。 可以通过配置来进一步限制为特定 IP
名称 | 类型 | 说明 |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ResourceProvisioningState
专用终结点连接的预配状态。
名称 | 类型 | 说明 |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |
UserIdentityProperties
有关用户标识的信息。
名称 | 类型 | 说明 |
---|---|---|
clientId |
string |
用户分配标识的客户端 ID。 |
principalId |
string |
用户分配标识的主体 ID。 |