Domeny Microsoft.EventGrid 2023-12-15-preview
Definicja zasobu Bicep
Typ zasobu domen można wdrożyć za pomocą operacji, które są przeznaczone:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventGrid/domains, dodaj następujący kod Bicep do szablonu.
resource symbolicname 'Microsoft.EventGrid/domains@2023-12-15-preview' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
name: 'string'
}
identity: {
principalId: 'string'
tenantId: 'string'
type: 'string'
userAssignedIdentities: {
{customized property}: {
clientId: 'string'
principalId: 'string'
}
}
}
properties: {
autoCreateTopicWithFirstSubscription: bool
autoDeleteTopicWithLastSubscription: bool
dataResidencyBoundary: 'string'
disableLocalAuth: bool
eventTypeInfo: {
inlineEventTypes: {
{customized property}: {
dataSchemaUrl: 'string'
description: 'string'
displayName: 'string'
documentationUrl: 'string'
}
}
kind: 'Inline'
}
inboundIpRules: [
{
action: 'Allow'
ipMask: 'string'
}
]
inputSchema: 'string'
inputSchemaMapping: {
inputSchemaMappingType: 'string'
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed: 'string'
publicNetworkAccess: 'string'
}
}
Obiekty InputSchemaMapping
Ustaw właściwość inputSchemaMappingType , aby określić typ obiektu.
W przypadku formatu Json użyj:
inputSchemaMappingType: 'Json'
properties: {
dataVersion: {
defaultValue: 'string'
sourceField: 'string'
}
eventTime: {
sourceField: 'string'
}
eventType: {
defaultValue: 'string'
sourceField: 'string'
}
id: {
sourceField: 'string'
}
subject: {
defaultValue: 'string'
sourceField: 'string'
}
topic: {
sourceField: 'string'
}
}
Wartości właściwości
Domen
Nazwa | Opis | Wartość |
---|---|---|
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–50 Prawidłowe znaki: Alfanumeryczne i łączniki. |
location | Lokalizacja zasobu. | ciąg (wymagany) |
tags | Tagi zasobu. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
sku | Warstwa cenowa jednostki SKU dla zasobu domeny usługi Event Grid. | ZasóbSku |
identity | Informacje o tożsamości zasobu domeny usługi Event Grid. | IdentityInfo |
properties | Właściwości zasobu domeny usługi Event Grid. | Właściwości domeny |
IdentityInfo
Nazwa | Opis | Wartość |
---|---|---|
principalId | Identyfikator podmiotu zabezpieczeń tożsamości zasobu. | ciąg |
tenantId | Identyfikator dzierżawy zasobu. | ciąg |
typ | Używany typ tożsamości zarządzanej. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie dowolnej tożsamości. | "Brak" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities | Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą zawierać identyfikatory zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Ta właściwość nie jest obecnie używana i zarezerwowana do użycia w przyszłości. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | UserIdentityProperties |
UserIdentityProperties
Nazwa | Opis | Wartość |
---|---|---|
clientId | Identyfikator klienta tożsamości przypisanej przez użytkownika. | ciąg |
principalId | Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. | ciąg |
Właściwości domeny
Nazwa | Opis | Wartość |
---|---|---|
autoCreateTopicWithFirstSubscription | Ta wartość logiczna służy do określania mechanizmu tworzenia dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście tworzenie tematu domeny może być zarządzane automatycznie (gdy prawda) lub self-managed (gdy fałsz). Wartość domyślna tej właściwości to true. Gdy ta właściwość ma wartość null lub ma wartość true, usługa Event Grid jest odpowiedzialna za automatyczne tworzenie tematu domeny, gdy pierwsza subskrypcja zdarzeń to utworzony w zakresie tematu domeny. Jeśli ta właściwość ma wartość false, utworzenie pierwszej subskrypcji zdarzeń będzie wymagać utworzenia tematu domeny przez użytkownika. Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełną kontrolę nad utworzeniem tematu domeny, a tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszych operacji i zarządzania mniejszą liczbą zasobów przez użytkownika. Należy również pamiętać, że w trybie automatycznego tworzenia użytkownik może utworzyć w razie potrzeby temat domeny na żądanie. |
bool |
autoDeleteTopicWithLastSubscription | Ta wartość logiczna służy do określania mechanizmu usuwania dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście usunięcie tematu domeny może być zarządzane automatycznie (jeśli prawda) lub samozarządzane (gdy fałsz). Wartość domyślna tej właściwości to true. Gdy ta właściwość ma wartość true, usługa Event Grid jest odpowiedzialna za automatyczne usuwanie tematu domeny, gdy ostatnia subskrypcja zdarzeń w zakresie temat domeny jest usuwany. Jeśli ta właściwość ma wartość false, użytkownik musi ręcznie usunąć temat domeny, gdy nie jest już potrzebny (np. po usunięciu ostatniej subskrypcji zdarzeń, a zasób musi zostać wyczyszczony). Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełne możliwości kontrola nad tym, kiedy należy usunąć temat domeny, podczas gdy tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszych operacji i zarządzania mniejszą liczbą operacji zasoby przez użytkownika. |
bool |
dataResidencyBoundary | Data Residency granicę zasobu. | "WithinGeopair" "W obrębie regionu" |
disableLocalAuth | Ten wartość logiczna służy do włączania lub wyłączania lokalnego uwierzytelniania. Wartość domyślna to false. Gdy właściwość ma wartość true, do uwierzytelniania będzie używany tylko token usługi AAD, jeśli użytkownik może publikować w domenie. | bool |
eventTypeInfo | Informacje o typie zdarzenia dla domeny. Te informacje są udostępniane przez wydawcę i mogą być używane przez subskrybent, aby wyświetlić różne typy zdarzeń, które są publikowane. |
EventTypeInfo |
inboundIpRules | Może to służyć do ograniczania ruchu z określonych adresów IP zamiast wszystkich adresów IP. Uwaga: są one traktowane tylko wtedy, gdy funkcja PublicNetworkAccess jest włączona. | InboundIpRule[] |
inputSchema | Określa format, którego usługa Event Grid powinna oczekiwać dla zdarzeń przychodzących opublikowanych w zasobie domeny usługi Event Grid. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
inputSchemaMapping | Informacje o inputSchemaMapping, które określiły informacje o mapowaniu ładunku zdarzenia. | InputSchemaMapping |
minimumTlsVersionAllowed | Minimalna wersja protokołu TLS wydawcy może publikować w tej domenie | '1.0' '1.1' '1.2' |
publicNetworkAccess | Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując element {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" /} |
"Wyłączone" "Włączone" "SecuredByPerimeter" |
EventTypeInfo
Nazwa | Opis | Wartość |
---|---|---|
inlineEventTypes | Kolekcja wbudowanych typów zdarzeń dla zasobu. Wbudowane klucze typu zdarzenia są ciągiem typu, który reprezentuje nazwę zdarzenia. Przykładem prawidłowej wbudowanej nazwy zdarzenia jest "Contoso.OrderCreated". Wbudowane wartości typu zdarzenia są typu InlineEventProperties i będą zawierać dodatkowe informacje dla każdego wbudowanego typu zdarzenia. |
EventTypeInfoInlineEventTypes |
Rodzaju | Używany typ zdarzenia. | "Wbudowany" |
EventTypeInfoInlineEventTypes
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | Właściwości inlineEventProperties |
Właściwości inlineEventProperties
Nazwa | Opis | Wartość |
---|---|---|
dataSchemaUrl | DataSchemaUrl dla zdarzenia wbudowanego. | ciąg |
description (opis) | Opis zdarzenia wbudowanego. | ciąg |
displayName | DisplayName dla zdarzenia wbudowanego. | ciąg |
documentationUrl | DokumentacjaUrl dla zdarzenia wbudowanego. | ciąg |
InboundIpRule
Nazwa | Opis | Wartość |
---|---|---|
action | Akcja do wykonania na podstawie dopasowania lub braku dopasowania maski IpMask. | "Zezwalaj" |
ipMask | Adres IP w notacji CIDR, np. 10.0.0.0/8. | ciąg |
InputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Ustawianie typu obiektu | Json (wymagane) |
JsonInputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Typ mapowania niestandardowego | "Json" (wymagane) |
properties | Właściwości JSON mapowania schematu wejściowego | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
Nazwa | Opis | Wartość |
---|---|---|
dataVersion | Informacje o mapowaniu właściwości DataVersion zdarzenia usługi Event Grid. | JsonFieldWithDefault |
eventTime | Informacje o mapowaniu właściwości EventTime zdarzenia usługi Event Grid. | Pole Json |
eventType | Informacje o mapowaniu właściwości EventType zdarzenia usługi Event Grid. | JsonFieldWithDefault |
identyfikator | Informacje o mapowaniu właściwości Id zdarzenia usługi Event Grid. | Pole Json |
Temat | Informacje o mapowaniu właściwości Subject zdarzenia usługi Event Grid. | JsonFieldWithDefault |
temat | Informacje o mapowaniu właściwości Topic zdarzenia usługi Event Grid. | Pole Json |
JsonFieldWithDefault
Nazwa | Opis | Wartość |
---|---|---|
Defaultvalue | Wartość domyślna, która ma być używana do mapowania, gdy pole źródłowe nie jest podane lub jeśli nie ma właściwości o określonej nazwie w opublikowanym ładunku zdarzenia JSON. | ciąg |
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
Pole Json
Nazwa | Opis | Wartość |
---|---|---|
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
ZasóbSku
Nazwa | Opis | Wartość |
---|---|---|
name | Nazwa jednostki SKU zasobu. Możliwe wartości to: Podstawowa lub Premium. | "Podstawowa" "Premium" |
Definicja zasobu szablonu usługi ARM
Typ zasobu domen można wdrożyć za pomocą operacji, które są przeznaczone:
- Grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventGrid/domains, dodaj następujący kod JSON do szablonu.
{
"type": "Microsoft.EventGrid/domains",
"apiVersion": "2023-12-15-preview",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"name": "string"
},
"identity": {
"principalId": "string",
"tenantId": "string",
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
"clientId": "string",
"principalId": "string"
}
}
},
"properties": {
"autoCreateTopicWithFirstSubscription": "bool",
"autoDeleteTopicWithLastSubscription": "bool",
"dataResidencyBoundary": "string",
"disableLocalAuth": "bool",
"eventTypeInfo": {
"inlineEventTypes": {
"{customized property}": {
"dataSchemaUrl": "string",
"description": "string",
"displayName": "string",
"documentationUrl": "string"
}
},
"kind": "Inline"
},
"inboundIpRules": [
{
"action": "Allow",
"ipMask": "string"
}
],
"inputSchema": "string",
"inputSchemaMapping": {
"inputSchemaMappingType": "string"
// For remaining properties, see InputSchemaMapping objects
},
"minimumTlsVersionAllowed": "string",
"publicNetworkAccess": "string"
}
}
Obiekty InputSchemaMapping
Ustaw właściwość inputSchemaMappingType , aby określić typ obiektu.
W przypadku formatu Json użyj:
"inputSchemaMappingType": "Json",
"properties": {
"dataVersion": {
"defaultValue": "string",
"sourceField": "string"
},
"eventTime": {
"sourceField": "string"
},
"eventType": {
"defaultValue": "string",
"sourceField": "string"
},
"id": {
"sourceField": "string"
},
"subject": {
"defaultValue": "string",
"sourceField": "string"
},
"topic": {
"sourceField": "string"
}
}
Wartości właściwości
Domen
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.EventGrid/domains" |
apiVersion | Wersja interfejsu API zasobów | "2023-12-15-preview" |
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–50 Prawidłowe znaki: Alfanumeryczne i łączniki. |
location | Lokalizacja zasobu. | ciąg (wymagany) |
tags | Tagi zasobu. | Słownik nazw tagów i wartości. Zobacz Tagi w szablonach |
sku | Warstwa cenowa jednostki SKU dla zasobu domeny usługi Event Grid. | ZasóbSku |
identity | Informacje o tożsamości zasobu domeny usługi Event Grid. | IdentityInfo |
properties | Właściwości zasobu domeny usługi Event Grid. | Właściwości domeny |
IdentityInfo
Nazwa | Opis | Wartość |
---|---|---|
principalId | Identyfikator podmiotu zabezpieczeń tożsamości zasobu. | ciąg |
tenantId | Identyfikator dzierżawy zasobu. | ciąg |
typ | Używany typ tożsamości zarządzanej. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie dowolnej tożsamości. | "Brak" "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
userAssignedIdentities | Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą zawierać identyfikatory zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Ta właściwość nie jest obecnie używana i zarezerwowana do użycia w przyszłości. |
IdentityInfoUserAssignedIdentities |
IdentityInfoUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | UserIdentityProperties |
UserIdentityProperties
Nazwa | Opis | Wartość |
---|---|---|
clientId | Identyfikator klienta tożsamości przypisanej przez użytkownika. | ciąg |
principalId | Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. | ciąg |
Właściwości domeny
Nazwa | Opis | Wartość |
---|---|---|
autoCreateTopicWithFirstSubscription | Ta wartość logiczna służy do określania mechanizmu tworzenia dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście tworzenie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnej (w przypadku wartości false). Wartość domyślna tej właściwości to true. Jeśli ta właściwość ma wartość null lub jest ustawiona na wartość true, usługa Event Grid jest odpowiedzialna za automatyczne tworzenie tematu domeny, gdy pierwsza subskrypcja zdarzeń to utworzony w zakresie tematu domeny. Jeśli ta właściwość ma wartość false, utworzenie pierwszej subskrypcji zdarzeń będzie wymagać utworzenia tematu domeny przez użytkownika. Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełną kontrolę nad utworzeniem tematu domeny, podczas gdy tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasobów przez użytkownika. Należy również pamiętać, że w trybie automatycznego tworzenia użytkownik może utworzyć temat domeny na żądanie w razie potrzeby. |
bool |
autoDeleteTopicWithLastSubscription | Ta wartość logiczna służy do określania mechanizmu usuwania dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście usunięcie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnej (w przypadku wartości false). Wartość domyślna tej właściwości to true. Gdy ta właściwość ma wartość true, usługa Event Grid jest odpowiedzialna za automatyczne usuwanie tematu domeny, gdy ostatnia subskrypcja zdarzeń w zakresie tematu domeny jest usuwany. Jeśli ta właściwość ma wartość false, użytkownik musi ręcznie usunąć temat domeny, gdy nie jest już potrzebny (np. po usunięciu ostatniej subskrypcji zdarzeń i konieczności wyczyszczenia zasobu). Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełny tryb kontrola nad tym, kiedy należy usunąć temat domeny, podczas gdy tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasoby przez użytkownika. |
bool |
dataResidencyBoundary | Data Residency granicę zasobu. | "WithinGeopair" "WithinRegion" |
disableLocalAuth | Ta wartość logiczna służy do włączania lub wyłączania uwierzytelniania lokalnego. Wartość domyślna to false. Jeśli właściwość jest ustawiona na wartość true, tylko token usługi AAD będzie używany do uwierzytelniania, jeśli użytkownik może publikować w domenie. | bool |
eventTypeInfo | Informacje o typie zdarzenia dla domeny. Te informacje są dostarczane przez wydawcę i mogą być używane przez subskrybent do wyświetlania różnych typów zdarzeń, które są publikowane. |
EventTypeInfo |
inboundIpRules | Może to służyć do ograniczania ruchu z określonych adresów IP zamiast wszystkich adresów IP. Uwaga: są one brane pod uwagę tylko wtedy, gdy funkcja PublicNetworkAccess jest włączona. | InboundIpRule[] |
inputSchema | Określa to format, którego usługa Event Grid powinna oczekiwać dla zdarzeń przychodzących publikowanych w zasobie domeny usługi Event Grid. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
inputSchemaMapping | Informacje o inputSchemaMapping, które określiły informacje o ładunku zdarzenia mapowania. | InputSchemaMapping |
minimumTlsVersionAllowed | Minimalna wersja protokołu TLS wydawcy dozwolona do opublikowania w tej domenie | '1.0' '1.1' '1.2' |
publicNetworkAccess | Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując element {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" /} |
"Wyłączone" "Włączone" "SecuredByPerimeter" |
EventTypeInfo
Nazwa | Opis | Wartość |
---|---|---|
inlineEventTypes | Kolekcja wbudowanych typów zdarzeń dla zasobu. Wbudowane klucze typu zdarzenia są typu ciąg, który reprezentuje nazwę zdarzenia. Przykładem prawidłowej wbudowanej nazwy zdarzenia jest "Contoso.OrderCreated". Wbudowane wartości typu zdarzenia są typu InlineEventProperties i będą zawierać dodatkowe informacje dla każdego wbudowanego typu zdarzenia. |
EventTypeInfoInlineEventTypes |
Rodzaju | Rodzaj używanego typu zdarzenia. | "Wbudowany" |
EventTypeInfoInlineEventTypes
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | InlineEventProperties |
InlineEventProperties
Nazwa | Opis | Wartość |
---|---|---|
dataSchemaUrl | DataSchemaUrl dla zdarzenia wbudowanego. | ciąg |
description (opis) | Opis zdarzenia wbudowanego. | ciąg |
displayName | DisplayName dla zdarzenia wbudowanego. | ciąg |
documentationUrl | DokumentacjaUrl dla zdarzenia wbudowanego. | ciąg |
Ruch przychodzący irule
Nazwa | Opis | Wartość |
---|---|---|
action | Akcja do wykonania na podstawie dopasowania lub braku dopasowania maski IpMask. | "Zezwalaj" |
ipMask | Adres IP w notacji CIDR, np. 10.0.0.0/8. | ciąg |
InputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Ustawianie typu obiektu | Json (wymagane) |
JsonInputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Typ mapowania niestandardowego | "Json" (wymagane) |
properties | Właściwości JSON mapowania schematu wejściowego | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
Nazwa | Opis | Wartość |
---|---|---|
dataVersion | Informacje o mapowaniu właściwości DataVersion zdarzenia usługi Event Grid. | JsonFieldWithDefault |
eventTime | Informacje o mapowaniu właściwości EventTime zdarzenia usługi Event Grid. | Pole Json |
eventType | Informacje o mapowaniu właściwości EventType zdarzenia usługi Event Grid. | JsonFieldWithDefault |
identyfikator | Informacje o mapowaniu właściwości Id zdarzenia usługi Event Grid. | Pole Json |
Temat | Informacje o mapowaniu właściwości Subject zdarzenia usługi Event Grid. | JsonFieldWithDefault |
temat | Informacje o mapowaniu właściwości Topic zdarzenia usługi Event Grid. | Pole Json |
JsonFieldWithDefault
Nazwa | Opis | Wartość |
---|---|---|
Defaultvalue | Wartość domyślna, która ma być używana do mapowania, gdy pole źródłowe nie jest podane lub jeśli nie ma właściwości o określonej nazwie w opublikowanym ładunku zdarzenia JSON. | ciąg |
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
Pole Json
Nazwa | Opis | Wartość |
---|---|---|
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
ZasóbSku
Nazwa | Opis | Wartość |
---|---|---|
name | Nazwa jednostki SKU zasobu. Możliwe wartości to: Podstawowa lub Premium. | "Podstawowa" "Premium" |
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu domen można wdrożyć za pomocą operacji, które są przeznaczone:
- Grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennik zmian.
Format zasobu
Aby utworzyć zasób Microsoft.EventGrid/domains, dodaj następujący element Terraform do szablonu.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventGrid/domains@2023-12-15-preview"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
body = jsonencode({
properties = {
autoCreateTopicWithFirstSubscription = bool
autoDeleteTopicWithLastSubscription = bool
dataResidencyBoundary = "string"
disableLocalAuth = bool
eventTypeInfo = {
inlineEventTypes = {
{customized property} = {
dataSchemaUrl = "string"
description = "string"
displayName = "string"
documentationUrl = "string"
}
}
kind = "Inline"
}
inboundIpRules = [
{
action = "Allow"
ipMask = "string"
}
]
inputSchema = "string"
inputSchemaMapping = {
inputSchemaMappingType = "string"
// For remaining properties, see InputSchemaMapping objects
}
minimumTlsVersionAllowed = "string"
publicNetworkAccess = "string"
}
sku = {
name = "string"
}
})
}
Obiekty InputSchemaMapping
Ustaw właściwość inputSchemaMappingType , aby określić typ obiektu.
W przypadku formatu Json użyj:
inputSchemaMappingType = "Json"
properties = {
dataVersion = {
defaultValue = "string"
sourceField = "string"
}
eventTime = {
sourceField = "string"
}
eventType = {
defaultValue = "string"
sourceField = "string"
}
id = {
sourceField = "string"
}
subject = {
defaultValue = "string"
sourceField = "string"
}
topic = {
sourceField = "string"
}
}
Wartości właściwości
Domen
Nazwa | Opis | Wartość |
---|---|---|
typ | Typ zasobu | "Microsoft.EventGrid/domains@2023-12-15-preview" |
name | Nazwa zasobu | ciąg (wymagany) Limit znaków: 3–50 Prawidłowe znaki: Alfanumeryczne i łączniki. |
location | Lokalizacja zasobu. | ciąg (wymagany) |
parent_id | Aby przeprowadzić wdrożenie w grupie zasobów, użyj identyfikatora tej grupy zasobów. | ciąg (wymagany) |
tags | Tagi zasobu. | Słownik nazw tagów i wartości. |
sku | Warstwa cenowa jednostki SKU dla zasobu domeny usługi Event Grid. | ZasóbSku |
identity | Informacje o tożsamości zasobu domeny usługi Event Grid. | IdentityInfo |
properties | Właściwości zasobu domeny usługi Event Grid. | Właściwości domeny |
IdentityInfo
Nazwa | Opis | Wartość |
---|---|---|
typ | Używany typ tożsamości zarządzanej. Typ "SystemAssigned, UserAssigned" zawiera zarówno niejawnie utworzoną tożsamość, jak i zestaw tożsamości przypisanych przez użytkownika. Typ "Brak" spowoduje usunięcie dowolnej tożsamości. | "SystemAssigned" "SystemAssigned, UserAssigned" "UserAssigned" |
identity_ids | Lista tożsamości użytkowników skojarzonych z zasobem. Odwołania do klucza słownika tożsamości użytkownika będą zawierać identyfikatory zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}". Ta właściwość nie jest obecnie używana i zarezerwowana do użycia w przyszłości. |
Tablica identyfikatorów tożsamości użytkowników. |
IdentityInfoUserAssignedIdentities
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | UserIdentityProperties |
UserIdentityProperties
Nazwa | Opis | Wartość |
---|---|---|
clientId | Identyfikator klienta tożsamości przypisanej przez użytkownika. | ciąg |
principalId | Identyfikator podmiotu zabezpieczeń tożsamości przypisanej przez użytkownika. | ciąg |
Właściwości domeny
Nazwa | Opis | Wartość |
---|---|---|
autoCreateTopicWithFirstSubscription | Ta wartość logiczna służy do określania mechanizmu tworzenia dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście tworzenie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnej (w przypadku wartości false). Wartość domyślna tej właściwości to true. Jeśli ta właściwość ma wartość null lub jest ustawiona na wartość true, usługa Event Grid jest odpowiedzialna za automatyczne tworzenie tematu domeny, gdy pierwsza subskrypcja zdarzeń to utworzony w zakresie tematu domeny. Jeśli ta właściwość ma wartość false, utworzenie pierwszej subskrypcji zdarzeń będzie wymagać utworzenia tematu domeny przez użytkownika. Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełną kontrolę nad utworzeniem tematu domeny, podczas gdy tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasobów przez użytkownika. Należy również pamiętać, że w trybie automatycznego tworzenia użytkownik może utworzyć temat domeny na żądanie w razie potrzeby. |
bool |
autoDeleteTopicWithLastSubscription | Ta wartość logiczna służy do określania mechanizmu usuwania dla "wszystkich" tematów domeny usługi Event Grid skojarzonych z tym zasobem domeny usługi Event Grid. W tym kontekście usunięcie tematu domeny może być zarządzane automatycznie (w przypadku wartości true) lub samodzielnej (w przypadku wartości false). Wartość domyślna tej właściwości to true. Gdy ta właściwość ma wartość true, usługa Event Grid jest odpowiedzialna za automatyczne usuwanie tematu domeny, gdy ostatnia subskrypcja zdarzeń w zakresie tematu domeny jest usuwany. Jeśli ta właściwość ma wartość false, użytkownik musi ręcznie usunąć temat domeny, gdy nie jest już potrzebny (np. po usunięciu ostatniej subskrypcji zdarzeń i konieczności wyczyszczenia zasobu). Tryb samodzielnego zarządzania może być używany, jeśli użytkownik chce mieć pełny tryb kontrola nad tym, kiedy należy usunąć temat domeny, podczas gdy tryb automatycznego zarządzania zapewnia elastyczność wykonywania mniejszej liczby operacji i zarządzania mniejszą liczbą zasoby przez użytkownika. |
bool |
dataResidencyBoundary | Data Residency granicę zasobu. | "WithinGeopair" "WithinRegion" |
disableLocalAuth | Ta wartość logiczna służy do włączania lub wyłączania uwierzytelniania lokalnego. Wartość domyślna to false. Jeśli właściwość jest ustawiona na wartość true, tylko token usługi AAD będzie używany do uwierzytelniania, jeśli użytkownik może publikować w domenie. | bool |
eventTypeInfo | Informacje o typie zdarzenia dla domeny. Te informacje są dostarczane przez wydawcę i mogą być używane przez subskrybent do wyświetlania różnych typów zdarzeń, które są publikowane. |
EventTypeInfo |
inboundIpRules | Może to służyć do ograniczania ruchu z określonych adresów IP zamiast wszystkich adresów IP. Uwaga: są one brane pod uwagę tylko wtedy, gdy funkcja PublicNetworkAccess jest włączona. | InboundIpRule[] |
inputSchema | Określa to format, którego usługa Event Grid powinna oczekiwać dla zdarzeń przychodzących publikowanych w zasobie domeny usługi Event Grid. | "CloudEventSchemaV1_0" "CustomEventSchema" "EventGridSchema" |
inputSchemaMapping | Informacje o inputSchemaMapping, które określiły informacje o ładunku zdarzenia mapowania. | InputSchemaMapping |
minimumTlsVersionAllowed | Minimalna wersja protokołu TLS wydawcy dozwolona do opublikowania w tej domenie | „1.0” "1.1" "1.2" |
publicNetworkAccess | Określa, czy ruch jest dozwolony za pośrednictwem sieci publicznej. Domyślnie jest ona włączona. Możesz dodatkowo ograniczyć do określonych adresów IP, konfigurując element {seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.DomainProperties.InboundIpRules" /} |
"Wyłączone" "Włączone" "SecuredByPerimeter" |
EventTypeInfo
Nazwa | Opis | Wartość |
---|---|---|
inlineEventTypes | Kolekcja wbudowanych typów zdarzeń dla zasobu. Wbudowane klucze typu zdarzenia są typu ciąg, który reprezentuje nazwę zdarzenia. Przykładem prawidłowej wbudowanej nazwy zdarzenia jest "Contoso.OrderCreated". Wbudowane wartości typu zdarzenia są typu InlineEventProperties i będą zawierać dodatkowe informacje dla każdego wbudowanego typu zdarzenia. |
EventTypeInfoInlineEventTypes |
Rodzaju | Rodzaj używanego typu zdarzenia. | "Wbudowane" |
EventTypeInfoInlineEventTypes
Nazwa | Opis | Wartość |
---|---|---|
{niestandardowa właściwość} | InlineEventProperties |
InlineEventProperties
Nazwa | Opis | Wartość |
---|---|---|
dataSchemaUrl | DataSchemaUrl dla zdarzenia wbudowanego. | ciąg |
description (opis) | Opis zdarzenia wbudowanego. | ciąg |
displayName | DisplayName dla zdarzenia wbudowanego. | ciąg |
documentationUrl | DokumentacjaUrl dla zdarzenia wbudowanego. | ciąg |
Ruch przychodzący irule
Nazwa | Opis | Wartość |
---|---|---|
action | Akcja do wykonania na podstawie dopasowania lub braku dopasowania maski IpMask. | "Zezwalaj" |
ipMask | Adres IP w notacji CIDR, np. 10.0.0.0/8. | ciąg |
InputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Ustawianie typu obiektu | Json (wymagane) |
JsonInputSchemaMapping
Nazwa | Opis | Wartość |
---|---|---|
inputSchemaMappingType | Typ mapowania niestandardowego | "Json" (wymagane) |
properties | Właściwości JSON mapowania schematu wejściowego | JsonInputSchemaMappingProperties |
JsonInputSchemaMappingProperties
Nazwa | Opis | Wartość |
---|---|---|
dataVersion | Informacje o mapowaniu właściwości DataVersion zdarzenia usługi Event Grid. | JsonFieldWithDefault |
eventTime | Informacje o mapowaniu właściwości EventTime zdarzenia usługi Event Grid. | Pole Json |
eventType | Informacje o mapowaniu właściwości EventType zdarzenia usługi Event Grid. | JsonFieldWithDefault |
identyfikator | Informacje o mapowaniu właściwości Id zdarzenia usługi Event Grid. | Pole Json |
Temat | Informacje o mapowaniu właściwości Subject zdarzenia usługi Event Grid. | JsonFieldWithDefault |
temat | Informacje o mapowaniu właściwości Topic zdarzenia usługi Event Grid. | Pole Json |
JsonFieldWithDefault
Nazwa | Opis | Wartość |
---|---|---|
Defaultvalue | Wartość domyślna, która ma być używana do mapowania, gdy pole źródłowe nie jest podane lub jeśli nie ma właściwości o określonej nazwie w opublikowanym ładunku zdarzenia JSON. | ciąg |
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
Pole Json
Nazwa | Opis | Wartość |
---|---|---|
sourceField | Nazwa pola w schemacie zdarzeń wejściowych, które mają być używane jako źródło mapowania. | ciąg |
ZasóbSku
Nazwa | Opis | Wartość |
---|---|---|
name | Nazwa jednostki SKU zasobu. Możliwe wartości to: Podstawowa lub Premium. | "Podstawowa" "Premium" |
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla