Espacios de nombres Microsoft.EventGrid 2024-06-01-preview

Artículo
12/19/2024

Definición de recursos de Bicep

El tipo de recurso de espacios de nombres se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.EventGrid/namespaces, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.EventGrid/namespaces@2024-06-01-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: {
          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'
  }
}

Objetos StaticRoutingEnrichment

Establezca la propiedad valueType para especificar el tipo de objeto.

Para string, use:

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

Valores de propiedad

ClientAuthenticationSettings

Nombre	Descripción	Valor
alternativeAuthenticationNameSources	Orígenes de nombres de autenticación alternativos relacionados con la configuración de autenticación de cliente para el recurso de espacio de nombres.	Matriz de cadenas que contiene cualquiera de: 'ClientCertificateDns' 'ClientCertificateEmail' 'ClientCertificateIp' 'ClientCertificateSubject' 'ClientCertificateUri'
customJwtAuthentication	Configuración de autenticación JWT personalizada para el recurso de espacio de nombres.	CustomJwtAuthenticationSettings

ConnectionState

Nombre	Descripción	Valor
actionsRequired	Acciones necesarias (si las hay).	cuerda
descripción	Descripción del estado de conexión.	cuerda
estado	Estado de la conexión.	'Aprobado' 'Desconectado' 'Pendiente' 'Rechazado'

CustomDomainConfiguration

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado que se usa para publicar en el dominio personalizado. Actualmente solo se admiten certificados almacenados en Azure Key Vault. Aunque la dirección URL del certificado puede ser cualquiera de las dos dirección URL con versiones del siguiente formato https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}, o dirección URL sin versión del siguiente formato (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert, solo se admite la dirección URL de certificado sin versión (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert)	cuerda
expectedTxtRecordName	Se esperaba el nombre del registro TXT de DNS. Event Grid comprobará si hay un registro TXT con este nombre en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio. Los valores de este registro TXT deben contener el valor de registro TXT esperado.	cuerda
expectedTxtRecordValue	Valor de registro TXT de DNS esperado. Event Grid comprobará si hay un registro TXT con este valor en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio.	cuerda
fullyQualifiedDomainName	Nombre de dominio completo (FQDN) para el dominio personalizado.	string (obligatorio)
identidad	Información de identidad para acceder al certificado del dominio personalizado. Esta información de identidad debe coincidir con una identidad que se ha establecido en el espacio de nombres.	CustomDomainIdentity
validationState	Estado de validación para el dominio personalizado. Se trata de una propiedad de solo lectura y se establece inicialmente en "Pendiente" y se actualizará a "Aprobado" por Event Grid solo después de que la propiedad del nombre de dominio se haya validado correctamente.	'Aprobado' 'ErrorRetrievingDnsRecord' 'Pendiente'

CustomDomainIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationManagedIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationSettings

Nombre	Descripción	Valor
issuerCertificates	Información sobre el certificado que se usa para la validación de tokens. Actualmente se admiten 2 certificados como máximo.	IssuerCertificateInfo[]
tokenIssuer	Emisor de tokens JWT esperado.	cuerda

DynamicRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento dinámico.	cuerda
valor	Valor de enriquecimiento de enrutamiento dinámico.	cuerda

IdentityInfo

Nombre	Descripción	Valor
principalId	Identificador de entidad de seguridad de la identidad del recurso.	cuerda
tenantId	Identificador de inquilino del recurso.	cuerda
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Esta propiedad no se usa actualmente y está reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre	Descripción	Valor

InboundIpRule

Nombre	Descripción	Valor
acción	Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask.	'Permitir'
ipMask	Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8.	cuerda

IssuerCertificateInfo

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado de Keyvault en formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion.	string (obligatorio)
identidad	Identidad que se usará para acceder al certificado.	customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nombre	Descripción	Valor
identidad	Información de identidad del recurso Espacio de nombres.	IdentityInfo
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 3 Patrón = `^[a-zA-Z0-9-]*$` (obligatorio)
Propiedades	Propiedades del recurso Espacio de nombres.	espacio de nombresPropiedades
Sku	Representa los planes de tarifa de SKU disponibles.	NamespaceSku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

NamespaceProperties

Nombre	Descripción	Valor
inboundIpRules	Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado.	inboundIpRule []
isZoneRedundant	Se trata de una propiedad opcional y permite al usuario especificar si el recurso de espacio de nombres admite o no la funcionalidad de redundancia de zona. Si es así El usuario no especifica explícitamente la propiedad , su valor predeterminado depende de las condiciones siguientes: un. En el caso de las regiones habilitadas para Availability Zones: el valor de propiedad predeterminado sería true. b. En el caso de las regiones habilitadas para zonas que no son de disponibilidad: el valor de propiedad predeterminado sería false. Una vez especificada, esta propiedad no se puede actualizar.	Bool
minimumTlsVersionAllowed	Versión mínima de TLS del publicador que permite publicar en este espacio de nombres. Solo se admite TLS versión 1.2.	'1.0' '1.1' '1.2'
privateEndpointConnections	Lista de conexiones de punto de conexión privado.	privateEndpointConnection[]
publicNetworkAccess	Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />	'Deshabilitado' 'Habilitado' "SecuredByPerimeter"
topicsConfiguration	Temas información de configuración del recurso de espacio de nombres	TopicsConfiguration
topicSpacesConfiguration	Información de configuración de espacios de temas para el recurso de espacio de nombres	TopicSpacesConfiguration

NamespaceSku

Nombre	Descripción	Valor
capacidad	Especifica el número de unidades de rendimiento que define la capacidad del espacio de nombres. El valor predeterminado de la propiedad es 1 que significa 1 unidad de rendimiento = 1 MB/s entrada y 2 MB/s salida por espacio de nombres. La capacidad mínima es 1 y La capacidad máxima permitida es de 20.	Int
nombre	Nombre de la SKU.	'Estándar'

PrivateEndpoint

Nombre	Descripción	Valor
identificación	Identificador de ARM para punto de conexión privado.	cuerda

PrivateEndpointConnection

Nombre	Descripción	Valor
Propiedades	Propiedades de PrivateEndpointConnection.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nombre	Descripción	Valor
groupIds	GroupIds del recurso del servicio private link.	string[]
privateEndpoint	El recurso Punto de conexión privado para esta conexión.	PrivateEndpoint
privateLinkServiceConnectionState	Detalles sobre el estado de la conexión.	ConnectionState
provisioningState	Estado de aprovisionamiento de la conexión de punto de conexión privado.	'Cancelado' 'Crear' "Eliminar" 'Error' "Correcto" "Actualización"

RoutingEnrichments

Nombre	Descripción	Valor
dinámico		dynamicRoutingEnrichment[]
estático		staticRoutingEnrichment []

RoutingIdentityInfo

Nombre	Descripción	Valor
tipo	Tipo de identidad de enrutamiento para la configuración de espacios de temas.	'Ninguno' 'SystemAssigned' 'UserAssigned'
userAssignedIdentity		cuerda

StaticRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento estático.	cuerda
valueType	Establezca en "String" para el tipo StaticStringRoutingEnrichment.	'String' (obligatorio)

StaticStringRoutingEnrichment

Nombre	Descripción	Valor
valor	Valor de enriquecimiento de enrutamiento de tipo de cadena.	cuerda
valueType	Tipo de valor de enriquecimiento de enrutamiento estático. Por ejemplo, este valor de propiedad puede ser "String".	'String' (obligatorio)

TopicsConfiguration

Nombre	Descripción	Valor
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]

TopicSpacesConfiguration

Nombre	Descripción	Valor
clientAuthentication	Configuración de autenticación de cliente para la configuración de espacios de temas.	clientAuthenticationSettings
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName	Número máximo de sesiones por nombre de autenticación. El valor predeterminado de la propiedad es 1. El valor mínimo permitido es 1 y el valor máximo permitido es 100.	Int
maximumSessionExpiryInHours	Expiración máxima de la sesión en horas. El valor predeterminado de la propiedad es 1 hora. El valor mínimo permitido es de 1 hora y el valor máximo permitido es de 8 horas.	Int
routeTopicResourceId	Identificador de recurso de Azure completo para el tema de Event Grid al que se enrutarán los eventos desde TopicSpaces en un espacio de nombres. Esta propiedad debe tener el siguiente formato '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'. Este tema debe residir en la misma región donde se encuentra el espacio de nombres.	cuerda
routingEnrichments	Enrutamiento de enriquecimientos para la configuración de espacios de temas	routingEnrichments
routingIdentityInfo	Información de identidad de enrutamiento para la configuración de espacios de temas.	routingIdentityInfo
estado	Indique si la configuración de espacios de temas está habilitada para el espacio de nombres. El valor predeterminado es Deshabilitado.	'Deshabilitado' 'Habilitado'

TrackedResourceTags

Nombre	Descripción	Valor

UserIdentityProperties

Nombre	Descripción	Valor
clientId	Identificador de cliente de la identidad asignada por el usuario.	cuerda
principalId	Identificador principal de la identidad asignada por el usuario.	cuerda

Definición de recursos de plantilla de ARM

El tipo de recurso de espacios de nombres se puede implementar con operaciones que tienen como destino:

grupos de recursos: consulte comandos de implementación de grupos de recursos

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.EventGrid/namespaces, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.EventGrid/namespaces",
  "apiVersion": "2024-06-01-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": {
          "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"
  }
}

Objetos StaticRoutingEnrichment

Establezca la propiedad valueType para especificar el tipo de objeto.

Para string, use:

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

Valores de propiedad

ClientAuthenticationSettings

Nombre	Descripción	Valor
alternativeAuthenticationNameSources	Orígenes de nombres de autenticación alternativos relacionados con la configuración de autenticación de cliente para el recurso de espacio de nombres.	Matriz de cadenas que contiene cualquiera de: 'ClientCertificateDns' 'ClientCertificateEmail' 'ClientCertificateIp' 'ClientCertificateSubject' 'ClientCertificateUri'
customJwtAuthentication	Configuración de autenticación JWT personalizada para el recurso de espacio de nombres.	CustomJwtAuthenticationSettings

ConnectionState

Nombre	Descripción	Valor
actionsRequired	Acciones necesarias (si las hay).	cuerda
descripción	Descripción del estado de conexión.	cuerda
estado	Estado de la conexión.	'Aprobado' 'Desconectado' 'Pendiente' 'Rechazado'

CustomDomainConfiguration

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado que se usa para publicar en el dominio personalizado. Actualmente solo se admiten certificados almacenados en Azure Key Vault. Aunque la dirección URL del certificado puede ser cualquiera de las dos dirección URL con versiones del siguiente formato https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}, o dirección URL sin versión del siguiente formato (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert, solo se admite la dirección URL de certificado sin versión (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert)	cuerda
expectedTxtRecordName	Se esperaba el nombre del registro TXT de DNS. Event Grid comprobará si hay un registro TXT con este nombre en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio. Los valores de este registro TXT deben contener el valor de registro TXT esperado.	cuerda
expectedTxtRecordValue	Valor de registro TXT de DNS esperado. Event Grid comprobará si hay un registro TXT con este valor en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio.	cuerda
fullyQualifiedDomainName	Nombre de dominio completo (FQDN) para el dominio personalizado.	string (obligatorio)
identidad	Información de identidad para acceder al certificado del dominio personalizado. Esta información de identidad debe coincidir con una identidad que se ha establecido en el espacio de nombres.	CustomDomainIdentity
validationState	Estado de validación para el dominio personalizado. Se trata de una propiedad de solo lectura y se establece inicialmente en "Pendiente" y se actualizará a "Aprobado" por Event Grid solo después de que la propiedad del nombre de dominio se haya validado correctamente.	'Aprobado' 'ErrorRetrievingDnsRecord' 'Pendiente'

CustomDomainIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationManagedIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationSettings

Nombre	Descripción	Valor
issuerCertificates	Información sobre el certificado que se usa para la validación de tokens. Actualmente se admiten 2 certificados como máximo.	IssuerCertificateInfo[]
tokenIssuer	Emisor de tokens JWT esperado.	cuerda

DynamicRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento dinámico.	cuerda
valor	Valor de enriquecimiento de enrutamiento dinámico.	cuerda

IdentityInfo

Nombre	Descripción	Valor
principalId	Identificador de entidad de seguridad de la identidad del recurso.	cuerda
tenantId	Identificador de inquilino del recurso.	cuerda
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Esta propiedad no se usa actualmente y está reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre	Descripción	Valor

InboundIpRule

Nombre	Descripción	Valor
acción	Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask.	'Permitir'
ipMask	Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8.	cuerda

IssuerCertificateInfo

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado de Keyvault en formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion.	string (obligatorio)
identidad	Identidad que se usará para acceder al certificado.	customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nombre	Descripción	Valor
apiVersion	La versión de api	'2024-06-01-preview'
identidad	Información de identidad del recurso Espacio de nombres.	IdentityInfo
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 3 Patrón = `^[a-zA-Z0-9-]*$` (obligatorio)
Propiedades	Propiedades del recurso Espacio de nombres.	espacio de nombresPropiedades
Sku	Representa los planes de tarifa de SKU disponibles.	NamespaceSku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo	El tipo de recurso	'Microsoft.EventGrid/namespaces'

NamespaceProperties

Nombre	Descripción	Valor
inboundIpRules	Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado.	inboundIpRule []
isZoneRedundant	Se trata de una propiedad opcional y permite al usuario especificar si el recurso de espacio de nombres admite o no la funcionalidad de redundancia de zona. Si es así El usuario no especifica explícitamente la propiedad , su valor predeterminado depende de las condiciones siguientes: un. En el caso de las regiones habilitadas para Availability Zones: el valor de propiedad predeterminado sería true. b. En el caso de las regiones habilitadas para zonas que no son de disponibilidad: el valor de propiedad predeterminado sería false. Una vez especificada, esta propiedad no se puede actualizar.	Bool
minimumTlsVersionAllowed	Versión mínima de TLS del publicador que permite publicar en este espacio de nombres. Solo se admite TLS versión 1.2.	'1.0' '1.1' '1.2'
privateEndpointConnections	Lista de conexiones de punto de conexión privado.	privateEndpointConnection[]
publicNetworkAccess	Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />	'Deshabilitado' 'Habilitado' "SecuredByPerimeter"
topicsConfiguration	Temas información de configuración del recurso de espacio de nombres	TopicsConfiguration
topicSpacesConfiguration	Información de configuración de espacios de temas para el recurso de espacio de nombres	TopicSpacesConfiguration

NamespaceSku

Nombre	Descripción	Valor
capacidad	Especifica el número de unidades de rendimiento que define la capacidad del espacio de nombres. El valor predeterminado de la propiedad es 1 que significa 1 unidad de rendimiento = 1 MB/s entrada y 2 MB/s salida por espacio de nombres. La capacidad mínima es 1 y La capacidad máxima permitida es de 20.	Int
nombre	Nombre de la SKU.	'Estándar'

PrivateEndpoint

Nombre	Descripción	Valor
identificación	Identificador de ARM para punto de conexión privado.	cuerda

PrivateEndpointConnection

Nombre	Descripción	Valor
Propiedades	Propiedades de PrivateEndpointConnection.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nombre	Descripción	Valor
groupIds	GroupIds del recurso del servicio private link.	string[]
privateEndpoint	El recurso Punto de conexión privado para esta conexión.	PrivateEndpoint
privateLinkServiceConnectionState	Detalles sobre el estado de la conexión.	ConnectionState
provisioningState	Estado de aprovisionamiento de la conexión de punto de conexión privado.	'Cancelado' 'Crear' "Eliminar" 'Error' "Correcto" "Actualización"

RoutingEnrichments

Nombre	Descripción	Valor
dinámico		dynamicRoutingEnrichment[]
estático		staticRoutingEnrichment []

RoutingIdentityInfo

Nombre	Descripción	Valor
tipo	Tipo de identidad de enrutamiento para la configuración de espacios de temas.	'Ninguno' 'SystemAssigned' 'UserAssigned'
userAssignedIdentity		cuerda

StaticRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento estático.	cuerda
valueType	Establezca en "String" para el tipo StaticStringRoutingEnrichment.	'String' (obligatorio)

StaticStringRoutingEnrichment

Nombre	Descripción	Valor
valor	Valor de enriquecimiento de enrutamiento de tipo de cadena.	cuerda
valueType	Tipo de valor de enriquecimiento de enrutamiento estático. Por ejemplo, este valor de propiedad puede ser "String".	'String' (obligatorio)

TopicsConfiguration

Nombre	Descripción	Valor
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]

TopicSpacesConfiguration

Nombre	Descripción	Valor
clientAuthentication	Configuración de autenticación de cliente para la configuración de espacios de temas.	clientAuthenticationSettings
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName	Número máximo de sesiones por nombre de autenticación. El valor predeterminado de la propiedad es 1. El valor mínimo permitido es 1 y el valor máximo permitido es 100.	Int
maximumSessionExpiryInHours	Expiración máxima de la sesión en horas. El valor predeterminado de la propiedad es 1 hora. El valor mínimo permitido es de 1 hora y el valor máximo permitido es de 8 horas.	Int
routeTopicResourceId	Identificador de recurso de Azure completo para el tema de Event Grid al que se enrutarán los eventos desde TopicSpaces en un espacio de nombres. Esta propiedad debe tener el siguiente formato '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'. Este tema debe residir en la misma región donde se encuentra el espacio de nombres.	cuerda
routingEnrichments	Enrutamiento de enriquecimientos para la configuración de espacios de temas	routingEnrichments
routingIdentityInfo	Información de identidad de enrutamiento para la configuración de espacios de temas.	routingIdentityInfo
estado	Indique si la configuración de espacios de temas está habilitada para el espacio de nombres. El valor predeterminado es Deshabilitado.	'Deshabilitado' 'Habilitado'

TrackedResourceTags

Nombre	Descripción	Valor

UserIdentityProperties

Nombre	Descripción	Valor
clientId	Identificador de cliente de la identidad asignada por el usuario.	cuerda
principalId	Identificador principal de la identidad asignada por el usuario.	cuerda

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso de espacios de nombres se puede implementar con operaciones que tienen como destino:

grupos de recursos de

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.EventGrid/namespaces, agregue el siguiente Terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.EventGrid/namespaces@2024-06-01-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 = {
            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"
      }
    }
  })
}

Objetos StaticRoutingEnrichment

Establezca la propiedad valueType para especificar el tipo de objeto.

Para string, use:

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

Valores de propiedad

ClientAuthenticationSettings

Nombre	Descripción	Valor
alternativeAuthenticationNameSources	Orígenes de nombres de autenticación alternativos relacionados con la configuración de autenticación de cliente para el recurso de espacio de nombres.	Matriz de cadenas que contiene cualquiera de: 'ClientCertificateDns' 'ClientCertificateEmail' 'ClientCertificateIp' 'ClientCertificateSubject' 'ClientCertificateUri'
customJwtAuthentication	Configuración de autenticación JWT personalizada para el recurso de espacio de nombres.	CustomJwtAuthenticationSettings

ConnectionState

Nombre	Descripción	Valor
actionsRequired	Acciones necesarias (si las hay).	cuerda
descripción	Descripción del estado de conexión.	cuerda
estado	Estado de la conexión.	'Aprobado' 'Desconectado' 'Pendiente' 'Rechazado'

CustomDomainConfiguration

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado que se usa para publicar en el dominio personalizado. Actualmente solo se admiten certificados almacenados en Azure Key Vault. Aunque la dirección URL del certificado puede ser cualquiera de las dos dirección URL con versiones del siguiente formato https://{key-vault-name}.vault.azure.net/certificates/{certificate-name}/{version-id}, o dirección URL sin versión del siguiente formato (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert, solo se admite la dirección URL de certificado sin versión (por ejemplo, https://contosovault.vault.azure.net/certificates/contosocert)	cuerda
expectedTxtRecordName	Se esperaba el nombre del registro TXT de DNS. Event Grid comprobará si hay un registro TXT con este nombre en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio. Los valores de este registro TXT deben contener el valor de registro TXT esperado.	cuerda
expectedTxtRecordValue	Valor de registro TXT de DNS esperado. Event Grid comprobará si hay un registro TXT con este valor en el conjunto de registros DNS del nombre de dominio personalizado para demostrar la propiedad sobre el dominio.	cuerda
fullyQualifiedDomainName	Nombre de dominio completo (FQDN) para el dominio personalizado.	string (obligatorio)
identidad	Información de identidad para acceder al certificado del dominio personalizado. Esta información de identidad debe coincidir con una identidad que se ha establecido en el espacio de nombres.	CustomDomainIdentity
validationState	Estado de validación para el dominio personalizado. Se trata de una propiedad de solo lectura y se establece inicialmente en "Pendiente" y se actualizará a "Aprobado" por Event Grid solo después de que la propiedad del nombre de dominio se haya validado correctamente.	'Aprobado' 'ErrorRetrievingDnsRecord' 'Pendiente'

CustomDomainIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned'
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationManagedIdentity

Nombre	Descripción	Valor
tipo	Tipo de identidad administrada usada. Puede ser "SystemAssigned" o "UserAssigned".	'SystemAssigned' 'UserAssigned' (obligatorio)
userAssignedIdentity	Identidad de usuario asociada al recurso.	cuerda

CustomJwtAuthenticationSettings

Nombre	Descripción	Valor
issuerCertificates	Información sobre el certificado que se usa para la validación de tokens. Actualmente se admiten 2 certificados como máximo.	IssuerCertificateInfo[]
tokenIssuer	Emisor de tokens JWT esperado.	cuerda

DynamicRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento dinámico.	cuerda
valor	Valor de enriquecimiento de enrutamiento dinámico.	cuerda

IdentityInfo

Nombre	Descripción	Valor
principalId	Identificador de entidad de seguridad de la identidad del recurso.	cuerda
tenantId	Identificador de inquilino del recurso.	cuerda
tipo	Tipo de identidad administrada usada. El tipo "SystemAssigned, UserAssigned" incluye una identidad creada implícitamente y un conjunto de identidades asignadas por el usuario. El tipo "None" quitará cualquier identidad.	'Ninguno' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Lista de identidades de usuario asociadas al recurso. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recursos de ARM con el formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. Esta propiedad no se usa actualmente y está reservada para uso futuro.	IdentityInfoUserAssignedIdentities

IdentityInfoUserAssignedIdentities

Nombre	Descripción	Valor

InboundIpRule

Nombre	Descripción	Valor
acción	Acción que se va a realizar en función de la coincidencia o ninguna coincidencia de IpMask.	'Permitir'
ipMask	Dirección IP en notación CIDR, por ejemplo, 10.0.0.0/8.	cuerda

IssuerCertificateInfo

Nombre	Descripción	Valor
certificateUrl	Dirección URL del certificado de Keyvault en formato https://keyvaultname.vault.azure.net/certificates/certificateName/certificateVersion.	string (obligatorio)
identidad	Identidad que se usará para acceder al certificado.	customJwtAuthenticationManagedIdentity

Microsoft.EventGrid/namespaces

Nombre	Descripción	Valor
identidad	Información de identidad del recurso Espacio de nombres.	IdentityInfo
ubicación	Ubicación del recurso.	string (obligatorio)
nombre	El nombre del recurso	cuerda Restricciones: Longitud mínima = 3 Longitud máxima = 3 Patrón = `^[a-zA-Z0-9-]*$` (obligatorio)
Propiedades	Propiedades del recurso Espacio de nombres.	espacio de nombresPropiedades
Sku	Representa los planes de tarifa de SKU disponibles.	NamespaceSku
Etiquetas	Etiquetas de recursos	Diccionario de nombres y valores de etiqueta.
tipo	El tipo de recurso	"Microsoft.EventGrid/namespaces@2024-06-01-preview"

NamespaceProperties

Nombre	Descripción	Valor
inboundIpRules	Esto se puede usar para restringir el tráfico de direcciones IP específicas en lugar de todas las direcciones IP. Nota: Estos se consideran solo si PublicNetworkAccess está habilitado.	inboundIpRule []
isZoneRedundant	Se trata de una propiedad opcional y permite al usuario especificar si el recurso de espacio de nombres admite o no la funcionalidad de redundancia de zona. Si es así El usuario no especifica explícitamente la propiedad , su valor predeterminado depende de las condiciones siguientes: un. En el caso de las regiones habilitadas para Availability Zones: el valor de propiedad predeterminado sería true. b. En el caso de las regiones habilitadas para zonas que no son de disponibilidad: el valor de propiedad predeterminado sería false. Una vez especificada, esta propiedad no se puede actualizar.	Bool
minimumTlsVersionAllowed	Versión mínima de TLS del publicador que permite publicar en este espacio de nombres. Solo se admite TLS versión 1.2.	'1.0' '1.1' '1.2'
privateEndpointConnections	Lista de conexiones de punto de conexión privado.	privateEndpointConnection[]
publicNetworkAccess	Esto determina si se permite el tráfico a través de la red pública. De forma predeterminada, está habilitado. Puede restringir aún más a direcciones IP específicas configurando <seealso cref="P:Microsoft.Azure.Events.ResourceProvider.Common.Contracts.PubSub.NamespaceProperties.InboundIpRules" />	'Deshabilitado' 'Habilitado' "SecuredByPerimeter"
topicsConfiguration	Temas información de configuración del recurso de espacio de nombres	TopicsConfiguration
topicSpacesConfiguration	Información de configuración de espacios de temas para el recurso de espacio de nombres	TopicSpacesConfiguration

NamespaceSku

Nombre	Descripción	Valor
capacidad	Especifica el número de unidades de rendimiento que define la capacidad del espacio de nombres. El valor predeterminado de la propiedad es 1 que significa 1 unidad de rendimiento = 1 MB/s entrada y 2 MB/s salida por espacio de nombres. La capacidad mínima es 1 y La capacidad máxima permitida es de 20.	Int
nombre	Nombre de la SKU.	'Estándar'

PrivateEndpoint

Nombre	Descripción	Valor
identificación	Identificador de ARM para punto de conexión privado.	cuerda

PrivateEndpointConnection

Nombre	Descripción	Valor
Propiedades	Propiedades de PrivateEndpointConnection.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Nombre	Descripción	Valor
groupIds	GroupIds del recurso del servicio private link.	string[]
privateEndpoint	El recurso Punto de conexión privado para esta conexión.	PrivateEndpoint
privateLinkServiceConnectionState	Detalles sobre el estado de la conexión.	ConnectionState
provisioningState	Estado de aprovisionamiento de la conexión de punto de conexión privado.	'Cancelado' 'Crear' "Eliminar" 'Error' "Correcto" "Actualización"

RoutingEnrichments

Nombre	Descripción	Valor
dinámico		dynamicRoutingEnrichment[]
estático		staticRoutingEnrichment []

RoutingIdentityInfo

Nombre	Descripción	Valor
tipo	Tipo de identidad de enrutamiento para la configuración de espacios de temas.	'Ninguno' 'SystemAssigned' 'UserAssigned'
userAssignedIdentity		cuerda

StaticRoutingEnrichment

Nombre	Descripción	Valor
llave	Clave de enriquecimiento de enrutamiento estático.	cuerda
valueType	Establezca en "String" para el tipo StaticStringRoutingEnrichment.	'String' (obligatorio)

StaticStringRoutingEnrichment

Nombre	Descripción	Valor
valor	Valor de enriquecimiento de enrutamiento de tipo de cadena.	cuerda
valueType	Tipo de valor de enriquecimiento de enrutamiento estático. Por ejemplo, este valor de propiedad puede ser "String".	'String' (obligatorio)

TopicsConfiguration

Nombre	Descripción	Valor
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]

TopicSpacesConfiguration

Nombre	Descripción	Valor
clientAuthentication	Configuración de autenticación de cliente para la configuración de espacios de temas.	clientAuthenticationSettings
customDomains	Lista de configuraciones de dominio personalizadas para el espacio de nombres.	customDomainConfiguration[]
maximumClientSessionsPerAuthenticationName	Número máximo de sesiones por nombre de autenticación. El valor predeterminado de la propiedad es 1. El valor mínimo permitido es 1 y el valor máximo permitido es 100.	Int
maximumSessionExpiryInHours	Expiración máxima de la sesión en horas. El valor predeterminado de la propiedad es 1 hora. El valor mínimo permitido es de 1 hora y el valor máximo permitido es de 8 horas.	Int
routeTopicResourceId	Identificador de recurso de Azure completo para el tema de Event Grid al que se enrutarán los eventos desde TopicSpaces en un espacio de nombres. Esta propiedad debe tener el siguiente formato '/subscriptions/{subId}/resourcegroups/{resourceGroupName}/providers/microsoft. EventGrid/topics/{topicName}'. Este tema debe residir en la misma región donde se encuentra el espacio de nombres.	cuerda
routingEnrichments	Enrutamiento de enriquecimientos para la configuración de espacios de temas	routingEnrichments
routingIdentityInfo	Información de identidad de enrutamiento para la configuración de espacios de temas.	routingIdentityInfo
estado	Indique si la configuración de espacios de temas está habilitada para el espacio de nombres. El valor predeterminado es Deshabilitado.	'Deshabilitado' 'Habilitado'

TrackedResourceTags

Nombre	Descripción	Valor

UserIdentityProperties

Nombre	Descripción	Valor
clientId	Identificador de cliente de la identidad asignada por el usuario.	cuerda
principalId	Identificador principal de la identidad asignada por el usuario.	cuerda

Compartir a través de

Espacios de nombres Microsoft.EventGrid 2024-06-01-preview

Definición de recursos de Bicep

Formato de recurso

Objetos StaticRoutingEnrichment

Valores de propiedad

ClientAuthenticationSettings

ConnectionState

CustomDomainConfiguration

CustomDomainIdentity

CustomJwtAuthenticationManagedIdentity

CustomJwtAuthenticationSettings

DynamicRoutingEnrichment

IdentityInfo

IdentityInfoUserAssignedIdentities

InboundIpRule

IssuerCertificateInfo

Microsoft.EventGrid/namespaces

NamespaceProperties

NamespaceSku

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

RoutingEnrichments

RoutingIdentityInfo

StaticRoutingEnrichment

StaticStringRoutingEnrichment

TopicsConfiguration

TopicSpacesConfiguration

TrackedResourceTags

UserIdentityProperties

Definición de recursos de plantilla de ARM

Formato de recurso

Objetos StaticRoutingEnrichment

Valores de propiedad

ClientAuthenticationSettings

ConnectionState

CustomDomainConfiguration

CustomDomainIdentity

CustomJwtAuthenticationManagedIdentity

CustomJwtAuthenticationSettings

DynamicRoutingEnrichment

IdentityInfo

IdentityInfoUserAssignedIdentities

InboundIpRule

IssuerCertificateInfo

Microsoft.EventGrid/namespaces

NamespaceProperties

NamespaceSku

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

RoutingEnrichments

RoutingIdentityInfo

StaticRoutingEnrichment

StaticStringRoutingEnrichment

TopicsConfiguration

TopicSpacesConfiguration

TrackedResourceTags

UserIdentityProperties

Definición de recursos de Terraform (proveedor AzAPI)

Formato de recurso

Objetos StaticRoutingEnrichment

Valores de propiedad

ClientAuthenticationSettings

ConnectionState

CustomDomainConfiguration

CustomDomainIdentity

CustomJwtAuthenticationManagedIdentity

CustomJwtAuthenticationSettings

DynamicRoutingEnrichment

IdentityInfo

IdentityInfoUserAssignedIdentities

InboundIpRule

IssuerCertificateInfo

Microsoft.EventGrid/namespaces

NamespaceProperties

NamespaceSku

PrivateEndpoint

PrivateEndpointConnection