Condividi tramite


Spazi dei nomi Microsoft.EventGrid 2024-12-15-preview

Definizione di risorsa Bicep

Il tipo di risorsa spazi dei nomi può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.EventGrid/namespaces, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.EventGrid/namespaces@2024-12-15-preview' = {
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    inboundIpRules: [
      {
        action: 'string'
        ipMask: 'string'
      }
    ]
    isZoneRedundant: bool
    minimumTlsVersionAllowed: 'string'
    privateEndpointConnections: [
      {
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    publicNetworkAccess: 'string'
    topicsConfiguration: {
      customDomains: [
        {
          certificateUrl: 'string'
          expectedTxtRecordName: 'string'
          expectedTxtRecordValue: 'string'
          fullyQualifiedDomainName: 'string'
          identity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          validationState: 'string'
        }
      ]
    }
    topicSpacesConfiguration: {
      clientAuthentication: {
        alternativeAuthenticationNameSources: [
          'string'
        ]
        customJwtAuthentication: {
          encodedIssuerCertificates: [
            {
              encodedCertificate: 'string'
              kid: 'string'
            }
          ]
          issuerCertificates: [
            {
              certificateUrl: 'string'
              identity: {
                type: 'string'
                userAssignedIdentity: 'string'
              }
            }
          ]
          tokenIssuer: 'string'
        }
      }
      customDomains: [
        {
          certificateUrl: 'string'
          expectedTxtRecordName: 'string'
          expectedTxtRecordValue: 'string'
          fullyQualifiedDomainName: 'string'
          identity: {
            type: 'string'
            userAssignedIdentity: 'string'
          }
          validationState: 'string'
        }
      ]
      maximumClientSessionsPerAuthenticationName: int
      maximumSessionExpiryInHours: int
      routeTopicResourceId: 'string'
      routingEnrichments: {
        dynamic: [
          {
            key: 'string'
            value: 'string'
          }
        ]
        static: [
          {
            key: 'string'
            valueType: 'string'
            // For remaining properties, see StaticRoutingEnrichment objects
          }
        ]
      }
      routingIdentityInfo: {
        type: 'string'
        userAssignedIdentity: 'string'
      }
      state: 'string'
    }
  }
  sku: {
    capacity: int
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Oggetti StaticRoutingEnrichment

Impostare la proprietà valueType per specificare il tipo di oggetto.

Per String, usare:

{
  value: 'string'
  valueType: 'String'
}

Valori delle proprietà

ClientAuthenticationSettings

Nome Descrizione Valore
alternativeAuthenticationNameSources Origini dei nomi di autenticazione alternative correlate alle impostazioni di autenticazione client per la risorsa dello spazio dei nomi. Matrice di stringhe contenente uno dei seguenti elementi:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication Impostazioni di autenticazione JWT personalizzate per la risorsa dello spazio dei nomi. CustomJwtAuthenticationSettings

ConnectionState

Nome Descrizione Valore
actionsRequired Azioni necessarie (se presenti). corda
descrizione Descrizione dello stato della connessione. corda
stato Stato della connessione. 'Approvato'
'Disconnesso'
'In sospeso'
'Rejected'

CustomDomainConfiguration

Nome Descrizione Valore
certificateUrl URL del certificato usato per la pubblicazione nel dominio personalizzato. Attualmente sono supportati solo i certificati archiviati in Azure Key Vault. Mentre l'URL del certificato può essere uno dei due
URL con versione del formato seguente https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}o URL non modificato del formato seguente (ad esempio,
https://contosovault.vault.azure.net/certificates/contosocert, è supportato solo l'URL del certificato non modificato (ad esempio, https://contosovault.vault.azure.net/certificates/contosocert)
corda
expectedTxtRecordName Nome del record TXT DNS previsto. Griglia di eventi verificherà la presenza di un record TXT con questo nome nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio.
I valori in questo record TXT devono contenere il valore del record TXT previsto.
corda
expectedTxtRecordValue Valore previsto del record TXT DNS. Griglia di eventi verificherà la presenza di un record TXT con questo valore nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio. corda
fullyQualifiedDomainName Nome di dominio completo (FQDN) per il dominio personalizzato. stringa (obbligatorio)
identità Informazioni sull'identità per l'accesso al certificato per il dominio personalizzato. Queste informazioni sull'identità devono corrispondere a un'identità impostata nello spazio dei nomi. CustomDomainIdentity
validationState Stato di convalida per il dominio personalizzato. Si tratta di una proprietà di sola lettura e inizialmente impostata su "In sospeso" e verrà aggiornata a "Approvato" da Griglia di eventi solo dopo che la proprietà del nome di dominio è stata convalidata correttamente. 'Approvato'
'ErrorRetrievingDnsRecord'
'In sospeso'

CustomDomainIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationSettings

Nome Descrizione Valore
encodedIssuerCertificates Informazioni sui certificati pubblici codificati usati per l'autenticazione personalizzata. EncodedIssuerCertificateInfo[]
issuerCertificates Informazioni sui certificati usati per la convalida del token. Attualmente sono supportati al massimo 2 certificati. IssuerCertificateInfo[]
tokenIssuer Autorità di certificazione del token JWT prevista. corda

DynamicRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing dinamico. corda
valore Valore di arricchimento del routing dinamico. corda

EncodedIssuerCertificateInfo

Nome Descrizione Valore
encodedCertificate Certificato in formato pem. stringa (obbligatorio)
capretto Identificatore del certificato. stringa (obbligatorio)

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. 'Consenti'
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8. corda

IssuerCertificateInfo

Nome Descrizione Valore
certificateUrl URL del certificato keyvault in formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion. stringa (obbligatorio)
identità Identità che verrà usata per accedere al certificato. customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nome Descrizione Valore
identità Informazioni sull'identità per la risorsa Spazio dei nomi. IdentityInfo
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-zA-Z0-9-]*$ (obbligatorio)
proprietà Proprietà della risorsa Spazio dei nomi. NamespaceProperties
Sku Rappresenta i piani tariffari sku disponibili. NamespaceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli

NamespaceProperties

Nome Descrizione Valore
inboundIpRules Può essere usato per limitare il traffico da indirizzi IP specifici anziché da tutti gli INDIRIZZI IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule []
isZoneRedundant Si tratta di una proprietà facoltativa che consente all'utente di specificare se la risorsa dello spazio dei nomi supporta o meno la funzionalità di ridondanza della zona. In caso affermativo
la proprietà non viene specificata in modo esplicito dall'utente, il valore predefinito dipende dalle condizioni seguenti:
un. Per le aree abilitate per le zone di disponibilità: il valore predefinito della proprietà sarà true.
b. Per le aree abilitate per le zone non di disponibilità: il valore predefinito della proprietà è false.
Una volta specificata, questa proprietà non può essere aggiornata.
Bool
minimumTlsVersionAllowed Versione minima tls del server di pubblicazione consentita per la pubblicazione in questo spazio dei nomi. È supportato solo TLS versione 1.2. '1.0'
'1.1'
'1.2'
privateEndpointConnections Elenco delle connessioni endpoint private. PrivateEndpointConnection[]
publicNetworkAccess Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli indirizzi IP specifici configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />
'Disabilitato'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration Informazioni sulla configurazione degli argomenti per la risorsa dello spazio dei nomi TopicsConfiguration
topicSpacesConfiguration Informazioni sulla configurazione degli spazi degli argomenti per la risorsa dello spazio dei nomi TopicSpacesConfiguration

NamespaceSku

Nome Descrizione Valore
capacità Specifica il numero di unità elaborate che definisce la capacità per lo spazio dei nomi. Il valore predefinito della proprietà è
1 che indica 1 unità elaborate = 1 MB/s in ingresso e 2 MB/s in uscita per spazio dei nomi. La capacità minima è 1 e
capacità massima consentita è 20.
Int
nome Nome dello SKU. 'Standard'

PrivateEndpoint

Nome Descrizione Valore
Id Identificatore arm per endpoint privato. corda

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds GroupIds dalla risorsa del servizio di collegamento privato. string[]
privateEndpoint Risorsa endpoint privato per questa connessione. PrivateEndpoint
privateLinkServiceConnectionState Dettagli sullo stato della connessione. ConnectionState
provisioningState Stato di provisioning della connessione endpoint privato. 'Annullato'
'Creazione'
'Eliminazione'
'Failed'
'Succeeded'
'Aggiornamento'

RoutingEnrichments

Nome Descrizione Valore
dinamico DynamicRoutingEnrichment []
statico staticRoutingEnrichment[]

RoutingIdentityInfo

Nome Descrizione Valore
digitare Tipo di identità di routing per la configurazione degli spazi degli argomenti. 'Nessuno'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity corda

StaticRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing statico. corda
valueType Impostare su "String" per il tipo StaticStringRoutingEnrichment. 'String' (obbligatorio)

StaticStringRoutingEnrichment

Nome Descrizione Valore
valore Valore di arricchimento del routing del tipo stringa. corda
valueType Tipo di valore di arricchimento del routing statico. Ad esempio, questo valore della proprietà può essere 'String'. 'String' (obbligatorio)

TopicsConfiguration

Nome Descrizione Valore
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]

TopicSpacesConfiguration

Nome Descrizione Valore
clientAuthentication Impostazioni di autenticazione client per la configurazione degli spazi degli argomenti. clientAuthenticationSettings
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]
maximumClientSessionsPerAuthenticationName Numero massimo di sessioni per nome di autenticazione. Il valore predefinito della proprietà è 1.
Il valore minimo consentito è 1 e il valore massimo consentito è 100.
Int
maximumSessionExpiryInHours Scadenza massima della sessione in ore. Il valore predefinito della proprietà è 1 ora.
Il valore minimo consentito è 1 ora e il valore massimo consentito è 8 ore.
Int
routeTopicResourceId ID risorsa di Azure completo per l'argomento di Griglia di eventi a cui verranno indirizzati gli eventi da TopicSpaces in uno spazio dei nomi.
Questa proprietà deve essere nel formato seguente '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'.
Questo argomento deve trovarsi nella stessa area in cui si trova lo spazio dei nomi.
corda
routingEnrichments Arricchimenti di routing per la configurazione degli spazi degli argomenti RoutingEnrichments
routingIdentityInfo Informazioni sull'identità di routing per la configurazione degli spazi degli argomenti. RoutingIdentityInfo
stato Indicare se la configurazione di Spazi di argomento è abilitata per lo spazio dei nomi. Il valore predefinito è Disabled. 'Disabilitato'
'Enabled'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa spazi dei nomi può essere distribuito con operazioni destinate a:

  • gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.EventGrid/namespaces, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.EventGrid/namespaces",
  "apiVersion": "2024-12-15-preview",
  "name": "string",
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "location": "string",
  "properties": {
    "inboundIpRules": [
      {
        "action": "string",
        "ipMask": "string"
      }
    ],
    "isZoneRedundant": "bool",
    "minimumTlsVersionAllowed": "string",
    "privateEndpointConnections": [
      {
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "publicNetworkAccess": "string",
    "topicsConfiguration": {
      "customDomains": [
        {
          "certificateUrl": "string",
          "expectedTxtRecordName": "string",
          "expectedTxtRecordValue": "string",
          "fullyQualifiedDomainName": "string",
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "validationState": "string"
        }
      ]
    },
    "topicSpacesConfiguration": {
      "clientAuthentication": {
        "alternativeAuthenticationNameSources": [ "string" ],
        "customJwtAuthentication": {
          "encodedIssuerCertificates": [
            {
              "encodedCertificate": "string",
              "kid": "string"
            }
          ],
          "issuerCertificates": [
            {
              "certificateUrl": "string",
              "identity": {
                "type": "string",
                "userAssignedIdentity": "string"
              }
            }
          ],
          "tokenIssuer": "string"
        }
      },
      "customDomains": [
        {
          "certificateUrl": "string",
          "expectedTxtRecordName": "string",
          "expectedTxtRecordValue": "string",
          "fullyQualifiedDomainName": "string",
          "identity": {
            "type": "string",
            "userAssignedIdentity": "string"
          },
          "validationState": "string"
        }
      ],
      "maximumClientSessionsPerAuthenticationName": "int",
      "maximumSessionExpiryInHours": "int",
      "routeTopicResourceId": "string",
      "routingEnrichments": {
        "dynamic": [
          {
            "key": "string",
            "value": "string"
          }
        ],
        "static": [ {
          "key": "string",
          "valueType": "string"
          // For remaining properties, see StaticRoutingEnrichment objects
        } ]
      },
      "routingIdentityInfo": {
        "type": "string",
        "userAssignedIdentity": "string"
      },
      "state": "string"
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Oggetti StaticRoutingEnrichment

Impostare la proprietà valueType per specificare il tipo di oggetto.

Per String, usare:

{
  "value": "string",
  "valueType": "String"
}

Valori delle proprietà

ClientAuthenticationSettings

Nome Descrizione Valore
alternativeAuthenticationNameSources Origini dei nomi di autenticazione alternative correlate alle impostazioni di autenticazione client per la risorsa dello spazio dei nomi. Matrice di stringhe contenente uno dei seguenti elementi:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication Impostazioni di autenticazione JWT personalizzate per la risorsa dello spazio dei nomi. CustomJwtAuthenticationSettings

ConnectionState

Nome Descrizione Valore
actionsRequired Azioni necessarie (se presenti). corda
descrizione Descrizione dello stato della connessione. corda
stato Stato della connessione. 'Approvato'
'Disconnesso'
'In sospeso'
'Rejected'

CustomDomainConfiguration

Nome Descrizione Valore
certificateUrl URL del certificato usato per la pubblicazione nel dominio personalizzato. Attualmente sono supportati solo i certificati archiviati in Azure Key Vault. Mentre l'URL del certificato può essere uno dei due
URL con versione del formato seguente https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}o URL non modificato del formato seguente (ad esempio,
https://contosovault.vault.azure.net/certificates/contosocert, è supportato solo l'URL del certificato non modificato (ad esempio, https://contosovault.vault.azure.net/certificates/contosocert)
corda
expectedTxtRecordName Nome del record TXT DNS previsto. Griglia di eventi verificherà la presenza di un record TXT con questo nome nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio.
I valori in questo record TXT devono contenere il valore del record TXT previsto.
corda
expectedTxtRecordValue Valore previsto del record TXT DNS. Griglia di eventi verificherà la presenza di un record TXT con questo valore nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio. corda
fullyQualifiedDomainName Nome di dominio completo (FQDN) per il dominio personalizzato. stringa (obbligatorio)
identità Informazioni sull'identità per l'accesso al certificato per il dominio personalizzato. Queste informazioni sull'identità devono corrispondere a un'identità impostata nello spazio dei nomi. CustomDomainIdentity
validationState Stato di convalida per il dominio personalizzato. Si tratta di una proprietà di sola lettura e inizialmente impostata su "In sospeso" e verrà aggiornata a "Approvato" da Griglia di eventi solo dopo che la proprietà del nome di dominio è stata convalidata correttamente. 'Approvato'
'ErrorRetrievingDnsRecord'
'In sospeso'

CustomDomainIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationSettings

Nome Descrizione Valore
encodedIssuerCertificates Informazioni sui certificati pubblici codificati usati per l'autenticazione personalizzata. EncodedIssuerCertificateInfo[]
issuerCertificates Informazioni sui certificati usati per la convalida del token. Attualmente sono supportati al massimo 2 certificati. IssuerCertificateInfo[]
tokenIssuer Autorità di certificazione del token JWT prevista. corda

DynamicRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing dinamico. corda
valore Valore di arricchimento del routing dinamico. corda

EncodedIssuerCertificateInfo

Nome Descrizione Valore
encodedCertificate Certificato in formato pem. stringa (obbligatorio)
capretto Identificatore del certificato. stringa (obbligatorio)

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. 'Consenti'
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8. corda

IssuerCertificateInfo

Nome Descrizione Valore
certificateUrl URL del certificato keyvault in formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion. stringa (obbligatorio)
identità Identità che verrà usata per accedere al certificato. customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nome Descrizione Valore
apiVersion Versione dell'API '2024-12-15-preview'
identità Informazioni sull'identità per la risorsa Spazio dei nomi. IdentityInfo
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-zA-Z0-9-]*$ (obbligatorio)
proprietà Proprietà della risorsa Spazio dei nomi. NamespaceProperties
Sku Rappresenta i piani tariffari sku disponibili. NamespaceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare Tipo di risorsa 'Microsoft.EventGrid/namespaces'

NamespaceProperties

Nome Descrizione Valore
inboundIpRules Può essere usato per limitare il traffico da indirizzi IP specifici anziché da tutti gli INDIRIZZI IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule []
isZoneRedundant Si tratta di una proprietà facoltativa che consente all'utente di specificare se la risorsa dello spazio dei nomi supporta o meno la funzionalità di ridondanza della zona. In caso affermativo
la proprietà non viene specificata in modo esplicito dall'utente, il valore predefinito dipende dalle condizioni seguenti:
un. Per le aree abilitate per le zone di disponibilità: il valore predefinito della proprietà sarà true.
b. Per le aree abilitate per le zone non di disponibilità: il valore predefinito della proprietà è false.
Una volta specificata, questa proprietà non può essere aggiornata.
Bool
minimumTlsVersionAllowed Versione minima tls del server di pubblicazione consentita per la pubblicazione in questo spazio dei nomi. È supportato solo TLS versione 1.2. '1.0'
'1.1'
'1.2'
privateEndpointConnections Elenco delle connessioni endpoint private. PrivateEndpointConnection[]
publicNetworkAccess Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli indirizzi IP specifici configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />
'Disabilitato'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration Informazioni sulla configurazione degli argomenti per la risorsa dello spazio dei nomi TopicsConfiguration
topicSpacesConfiguration Informazioni sulla configurazione degli spazi degli argomenti per la risorsa dello spazio dei nomi TopicSpacesConfiguration

NamespaceSku

Nome Descrizione Valore
capacità Specifica il numero di unità elaborate che definisce la capacità per lo spazio dei nomi. Il valore predefinito della proprietà è
1 che indica 1 unità elaborate = 1 MB/s in ingresso e 2 MB/s in uscita per spazio dei nomi. La capacità minima è 1 e
capacità massima consentita è 20.
Int
nome Nome dello SKU. 'Standard'

PrivateEndpoint

Nome Descrizione Valore
Id Identificatore arm per endpoint privato. corda

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds GroupIds dalla risorsa del servizio di collegamento privato. string[]
privateEndpoint Risorsa endpoint privato per questa connessione. PrivateEndpoint
privateLinkServiceConnectionState Dettagli sullo stato della connessione. ConnectionState
provisioningState Stato di provisioning della connessione endpoint privato. 'Annullato'
'Creazione'
'Eliminazione'
'Failed'
'Succeeded'
'Aggiornamento'

RoutingEnrichments

Nome Descrizione Valore
dinamico DynamicRoutingEnrichment []
statico staticRoutingEnrichment[]

RoutingIdentityInfo

Nome Descrizione Valore
digitare Tipo di identità di routing per la configurazione degli spazi degli argomenti. 'Nessuno'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity corda

StaticRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing statico. corda
valueType Impostare su "String" per il tipo StaticStringRoutingEnrichment. 'String' (obbligatorio)

StaticStringRoutingEnrichment

Nome Descrizione Valore
valore Valore di arricchimento del routing del tipo stringa. corda
valueType Tipo di valore di arricchimento del routing statico. Ad esempio, questo valore della proprietà può essere 'String'. 'String' (obbligatorio)

TopicsConfiguration

Nome Descrizione Valore
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]

TopicSpacesConfiguration

Nome Descrizione Valore
clientAuthentication Impostazioni di autenticazione client per la configurazione degli spazi degli argomenti. clientAuthenticationSettings
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]
maximumClientSessionsPerAuthenticationName Numero massimo di sessioni per nome di autenticazione. Il valore predefinito della proprietà è 1.
Il valore minimo consentito è 1 e il valore massimo consentito è 100.
Int
maximumSessionExpiryInHours Scadenza massima della sessione in ore. Il valore predefinito della proprietà è 1 ora.
Il valore minimo consentito è 1 ora e il valore massimo consentito è 8 ore.
Int
routeTopicResourceId ID risorsa di Azure completo per l'argomento di Griglia di eventi a cui verranno indirizzati gli eventi da TopicSpaces in uno spazio dei nomi.
Questa proprietà deve essere nel formato seguente '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'.
Questo argomento deve trovarsi nella stessa area in cui si trova lo spazio dei nomi.
corda
routingEnrichments Arricchimenti di routing per la configurazione degli spazi degli argomenti RoutingEnrichments
routingIdentityInfo Informazioni sull'identità di routing per la configurazione degli spazi degli argomenti. RoutingIdentityInfo
stato Indicare se la configurazione di Spazi di argomento è abilitata per lo spazio dei nomi. Il valore predefinito è Disabled. 'Disabilitato'
'Enabled'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa spazi dei nomi può essere distribuito con operazioni destinate a:

  • gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.EventGrid/namespaces, aggiungere il codice Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/namespaces@2024-12-15-preview"
  name = "string"
  identity = {
    principalId = "string"
    tenantId = "string"
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      inboundIpRules = [
        {
          action = "string"
          ipMask = "string"
        }
      ]
      isZoneRedundant = bool
      minimumTlsVersionAllowed = "string"
      privateEndpointConnections = [
        {
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
              id = "string"
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
            provisioningState = "string"
          }
        }
      ]
      publicNetworkAccess = "string"
      topicsConfiguration = {
        customDomains = [
          {
            certificateUrl = "string"
            expectedTxtRecordName = "string"
            expectedTxtRecordValue = "string"
            fullyQualifiedDomainName = "string"
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            validationState = "string"
          }
        ]
      }
      topicSpacesConfiguration = {
        clientAuthentication = {
          alternativeAuthenticationNameSources = [
            "string"
          ]
          customJwtAuthentication = {
            encodedIssuerCertificates = [
              {
                encodedCertificate = "string"
                kid = "string"
              }
            ]
            issuerCertificates = [
              {
                certificateUrl = "string"
                identity = {
                  type = "string"
                  userAssignedIdentity = "string"
                }
              }
            ]
            tokenIssuer = "string"
          }
        }
        customDomains = [
          {
            certificateUrl = "string"
            expectedTxtRecordName = "string"
            expectedTxtRecordValue = "string"
            fullyQualifiedDomainName = "string"
            identity = {
              type = "string"
              userAssignedIdentity = "string"
            }
            validationState = "string"
          }
        ]
        maximumClientSessionsPerAuthenticationName = int
        maximumSessionExpiryInHours = int
        routeTopicResourceId = "string"
        routingEnrichments = {
          dynamic = [
            {
              key = "string"
              value = "string"
            }
          ]
          static = [
            {
              key = "string"
              valueType = "string"
              // For remaining properties, see StaticRoutingEnrichment objects
            }
          ]
        }
        routingIdentityInfo = {
          type = "string"
          userAssignedIdentity = "string"
        }
        state = "string"
      }
    }
  })
}

Oggetti StaticRoutingEnrichment

Impostare la proprietà valueType per specificare il tipo di oggetto.

Per String, usare:

{
  value = "string"
  valueType = "String"
}

Valori delle proprietà

ClientAuthenticationSettings

Nome Descrizione Valore
alternativeAuthenticationNameSources Origini dei nomi di autenticazione alternative correlate alle impostazioni di autenticazione client per la risorsa dello spazio dei nomi. Matrice di stringhe contenente uno dei seguenti elementi:
'ClientCertificateDns'
'ClientCertificateEmail'
'ClientCertificateIp'
'ClientCertificateSubject'
'ClientCertificateUri'
customJwtAuthentication Impostazioni di autenticazione JWT personalizzate per la risorsa dello spazio dei nomi. CustomJwtAuthenticationSettings

ConnectionState

Nome Descrizione Valore
actionsRequired Azioni necessarie (se presenti). corda
descrizione Descrizione dello stato della connessione. corda
stato Stato della connessione. 'Approvato'
'Disconnesso'
'In sospeso'
'Rejected'

CustomDomainConfiguration

Nome Descrizione Valore
certificateUrl URL del certificato usato per la pubblicazione nel dominio personalizzato. Attualmente sono supportati solo i certificati archiviati in Azure Key Vault. Mentre l'URL del certificato può essere uno dei due
URL con versione del formato seguente https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}o URL non modificato del formato seguente (ad esempio,
https://contosovault.vault.azure.net/certificates/contosocert, è supportato solo l'URL del certificato non modificato (ad esempio, https://contosovault.vault.azure.net/certificates/contosocert)
corda
expectedTxtRecordName Nome del record TXT DNS previsto. Griglia di eventi verificherà la presenza di un record TXT con questo nome nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio.
I valori in questo record TXT devono contenere il valore del record TXT previsto.
corda
expectedTxtRecordValue Valore previsto del record TXT DNS. Griglia di eventi verificherà la presenza di un record TXT con questo valore nel set di record DNS del nome di dominio personalizzato per dimostrare la proprietà del dominio. corda
fullyQualifiedDomainName Nome di dominio completo (FQDN) per il dominio personalizzato. stringa (obbligatorio)
identità Informazioni sull'identità per l'accesso al certificato per il dominio personalizzato. Queste informazioni sull'identità devono corrispondere a un'identità impostata nello spazio dei nomi. CustomDomainIdentity
validationState Stato di convalida per il dominio personalizzato. Si tratta di una proprietà di sola lettura e inizialmente impostata su "In sospeso" e verrà aggiornata a "Approvato" da Griglia di eventi solo dopo che la proprietà del nome di dominio è stata convalidata correttamente. 'Approvato'
'ErrorRetrievingDnsRecord'
'In sospeso'

CustomDomainIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned'
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationManagedIdentity

Nome Descrizione Valore
digitare Tipo di identità gestita usata. Può essere 'SystemAssigned' o 'UserAssigned'. 'SystemAssigned'
'UserAssigned' (obbligatorio)
userAssignedIdentity Identità utente associata alla risorsa. corda

CustomJwtAuthenticationSettings

Nome Descrizione Valore
encodedIssuerCertificates Informazioni sui certificati pubblici codificati usati per l'autenticazione personalizzata. EncodedIssuerCertificateInfo[]
issuerCertificates Informazioni sui certificati usati per la convalida del token. Attualmente sono supportati al massimo 2 certificati. IssuerCertificateInfo[]
tokenIssuer Autorità di certificazione del token JWT prevista. corda

DynamicRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing dinamico. corda
valore Valore di arricchimento del routing dinamico. corda

EncodedIssuerCertificateInfo

Nome Descrizione Valore
encodedCertificate Certificato in formato pem. stringa (obbligatorio)
capretto Identificatore del certificato. stringa (obbligatorio)

IdentityInfo

Nome Descrizione Valore
principalId ID principale dell'identità della risorsa. corda
tenantId ID tenant della risorsa. corda
digitare Tipo di identità gestita usata. Il tipo 'SystemAssigned, UserAssigned' include sia un'identità creata in modo implicito che un set di identità assegnate dall'utente. Il tipo 'Nessuno' rimuoverà qualsiasi identità. 'Nessuno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Elenco di identità utente associate alla risorsa. I riferimenti alla chiave del dizionario delle identità utente saranno gli ID risorsa ARM nel formato:
'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Questa proprietà non è attualmente utilizzata e riservata per l'utilizzo futuro.
IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nome Descrizione Valore

InboundIpRule

Nome Descrizione Valore
azione Azione da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. 'Consenti'
ipMask Indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8. corda

IssuerCertificateInfo

Nome Descrizione Valore
certificateUrl URL del certificato keyvault in formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion. stringa (obbligatorio)
identità Identità che verrà usata per accedere al certificato. customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nome Descrizione Valore
identità Informazioni sull'identità per la risorsa Spazio dei nomi. IdentityInfo
ubicazione Posizione della risorsa. stringa (obbligatorio)
nome Nome della risorsa corda

Vincoli:
Lunghezza minima = 3
Lunghezza massima = 3
Pattern = ^[a-zA-Z0-9-]*$ (obbligatorio)
proprietà Proprietà della risorsa Spazio dei nomi. NamespaceProperties
Sku Rappresenta i piani tariffari sku disponibili. NamespaceSku
Tag Tag delle risorse Dizionario di nomi e valori di tag.
digitare Tipo di risorsa "Microsoft.EventGrid/namespaces@2024-12-15-preview"

NamespaceProperties

Nome Descrizione Valore
inboundIpRules Può essere usato per limitare il traffico da indirizzi IP specifici anziché da tutti gli INDIRIZZI IP. Nota: questi vengono considerati solo se PublicNetworkAccess è abilitato. InboundIpRule []
isZoneRedundant Si tratta di una proprietà facoltativa che consente all'utente di specificare se la risorsa dello spazio dei nomi supporta o meno la funzionalità di ridondanza della zona. In caso affermativo
la proprietà non viene specificata in modo esplicito dall'utente, il valore predefinito dipende dalle condizioni seguenti:
un. Per le aree abilitate per le zone di disponibilità: il valore predefinito della proprietà sarà true.
b. Per le aree abilitate per le zone non di disponibilità: il valore predefinito della proprietà è false.
Una volta specificata, questa proprietà non può essere aggiornata.
Bool
minimumTlsVersionAllowed Versione minima tls del server di pubblicazione consentita per la pubblicazione in questo spazio dei nomi. È supportato solo TLS versione 1.2. '1.0'
'1.1'
'1.2'
privateEndpointConnections Elenco delle connessioni endpoint private. PrivateEndpointConnection[]
publicNetworkAccess Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata.
È possibile limitare ulteriormente gli indirizzi IP specifici configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />
'Disabilitato'
'Enabled'
'SecuredByPerimeter'
topicsConfiguration Informazioni sulla configurazione degli argomenti per la risorsa dello spazio dei nomi TopicsConfiguration
topicSpacesConfiguration Informazioni sulla configurazione degli spazi degli argomenti per la risorsa dello spazio dei nomi TopicSpacesConfiguration

NamespaceSku

Nome Descrizione Valore
capacità Specifica il numero di unità elaborate che definisce la capacità per lo spazio dei nomi. Il valore predefinito della proprietà è
1 che indica 1 unità elaborate = 1 MB/s in ingresso e 2 MB/s in uscita per spazio dei nomi. La capacità minima è 1 e
capacità massima consentita è 20.
Int
nome Nome dello SKU. 'Standard'

PrivateEndpoint

Nome Descrizione Valore
Id Identificatore arm per endpoint privato. corda

PrivateEndpointConnection

Nome Descrizione Valore
proprietà Proprietà di PrivateEndpointConnection. PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nome Descrizione Valore
groupIds GroupIds dalla risorsa del servizio di collegamento privato. string[]
privateEndpoint Risorsa endpoint privato per questa connessione. PrivateEndpoint
privateLinkServiceConnectionState Dettagli sullo stato della connessione. ConnectionState
provisioningState Stato di provisioning della connessione endpoint privato. 'Annullato'
'Creazione'
'Eliminazione'
'Failed'
'Succeeded'
'Aggiornamento'

RoutingEnrichments

Nome Descrizione Valore
dinamico DynamicRoutingEnrichment []
statico staticRoutingEnrichment[]

RoutingIdentityInfo

Nome Descrizione Valore
digitare Tipo di identità di routing per la configurazione degli spazi degli argomenti. 'Nessuno'
'SystemAssigned'
'UserAssigned'
userAssignedIdentity corda

StaticRoutingEnrichment

Nome Descrizione Valore
chiave Chiave di arricchimento del routing statico. corda
valueType Impostare su "String" per il tipo StaticStringRoutingEnrichment. 'String' (obbligatorio)

StaticStringRoutingEnrichment

Nome Descrizione Valore
valore Valore di arricchimento del routing del tipo stringa. corda
valueType Tipo di valore di arricchimento del routing statico. Ad esempio, questo valore della proprietà può essere 'String'. 'String' (obbligatorio)

TopicsConfiguration

Nome Descrizione Valore
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]

TopicSpacesConfiguration

Nome Descrizione Valore
clientAuthentication Impostazioni di autenticazione client per la configurazione degli spazi degli argomenti. clientAuthenticationSettings
customDomains Elenco delle configurazioni di dominio personalizzate per lo spazio dei nomi. CustomDomainConfiguration[]
maximumClientSessionsPerAuthenticationName Numero massimo di sessioni per nome di autenticazione. Il valore predefinito della proprietà è 1.
Il valore minimo consentito è 1 e il valore massimo consentito è 100.
Int
maximumSessionExpiryInHours Scadenza massima della sessione in ore. Il valore predefinito della proprietà è 1 ora.
Il valore minimo consentito è 1 ora e il valore massimo consentito è 8 ore.
Int
routeTopicResourceId ID risorsa di Azure completo per l'argomento di Griglia di eventi a cui verranno indirizzati gli eventi da TopicSpaces in uno spazio dei nomi.
Questa proprietà deve essere nel formato seguente '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'.
Questo argomento deve trovarsi nella stessa area in cui si trova lo spazio dei nomi.
corda
routingEnrichments Arricchimenti di routing per la configurazione degli spazi degli argomenti RoutingEnrichments
routingIdentityInfo Informazioni sull'identità di routing per la configurazione degli spazi degli argomenti. RoutingIdentityInfo
stato Indicare se la configurazione di Spazi di argomento è abilitata per lo spazio dei nomi. Il valore predefinito è Disabled. 'Disabilitato'
'Enabled'

TrackedResourceTags

Nome Descrizione Valore

UserIdentityProperties

Nome Descrizione Valore
clientId ID client dell'identità assegnata dall'utente. corda
principalId ID principale dell'identità assegnata dall'utente. corda