Compartir a través de


Espacios de nombres Microsoft.ServiceBus

Definición de recursos de Bicep

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

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.ServiceBus/namespaces, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ServiceBus/namespaces@2024-01-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    alternateName: 'string'
    disableLocalAuth: bool
    encryption: {
      keySource: 'Microsoft.KeyVault'
      keyVaultProperties: [
        {
          identity: {
            userAssignedIdentity: 'string'
          }
          keyName: 'string'
          keyVaultUri: 'string'
          keyVersion: 'string'
        }
      ]
      requireInfrastructureEncryption: bool
    }
    minimumTlsVersion: 'string'
    premiumMessagingPartitions: int
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    publicNetworkAccess: 'string'
    zoneRedundant: bool
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propiedad

ConnectionState

Nombre Descripción Valor
descripción Descripción del estado de conexión. cuerda
estado Estado de la conexión. 'Aprobado'
'Desconectado'
'Pendiente'
'Rechazado'

Encriptación

Nombre Descripción Valor
keySource Enumera el valor posible de keySource para el cifrado. "Microsoft.KeyVault"
keyVaultProperties Propiedades de KeyVault keyVaultProperties[]
requireInfrastructureEncryption Habilitación del cifrado de infraestructura (cifrado doble) Bool

Identidad

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Propiedades de identidades asignadas por el usuario IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre Descripción Valor

KeyVaultProperties

Nombre Descripción Valor
identidad UserAssignedIdentityProperties
keyName Nombre de la clave de KeyVault cuerda
keyVaultUri Uri de KeyVault cuerda
keyVersion Versión de KeyVault cuerda

Microsoft.ServiceBus/namespaces

Nombre Descripción Valor
identidad Propiedades de la descripción de la identidad BYOK Identity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del espacio de nombres. SBNamespaceProperties
Sku Propiedades de la SKU sbSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

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
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"

SBNamespaceProperties

Nombre Descripción Valor
alternateName Nombre alternativo para el espacio de nombres cuerda
disableLocalAuth Esta propiedad deshabilita la autenticación de SAS para el espacio de nombres de Service Bus. Bool
encriptación Propiedades de la descripción del cifrado BYOK Cifrado
minimumTlsVersion Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". '1.0'
'1.1'
'1.2'
premiumMessagingPartitions Número de particiones de un espacio de nombres de Service Bus. Esta propiedad solo es aplicable a los espacios de nombres de SKU Premium. El valor predeterminado es 1 y los valores posibles son 1, 2 y 4 Int
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. 'Deshabilitado'
'Habilitado'
"SecuredByPerimeter"
zoneRedundant Al habilitar esta propiedad se crea una Namespace premium de Service Bus en regiones admitidas zonas de disponibilidad. Bool

SBSku

Nombre Descripción Valor
capacidad Unidades de mensajería para el espacio de nombres Premium de Service Bus. Las capacidades válidas son {1, 2, 4, 8, 16} múltiplas de las propiedades.premiumMessagingPartitions. Por ejemplo, si properties.premiumMessagingPartitions es 1, los valores de capacidad posibles son 1, 2, 4, 8 y 16. Si properties.premiumMessagingPartitions es 4, los valores de capacidad posibles son 4, 8, 16, 32 y 64. Int
nombre Nombre de esta SKU. "Básico"
'Premium'
'Estándar' (obligatorio)
nivel Nivel de facturación de esta SKU determinada. "Básico"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

UserAssignedIdentityProperties

Nombre Descripción Valor
userAssignedIdentity Id. de ARM de la identidad de usuario seleccionada para el cifrado cuerda

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
Creación de un espacio de nombres de Service Bus y una cola Esta plantilla le permite implementar un espacio de nombres Estándar de Service Bus y una cola.
Creación de una regla de red virtual de espacio de nombres de Service Bus Esta plantilla le permite implementar un espacio de nombres Premium de Service Bus con una regla de red virtual.
crear temas personalizados de Azure Event Grid y de suscripción de cola Crea un tema personalizado de Azure Event Grid y una suscripción de cola de Service Bus. Plantilla originalmente creadas por Markus Meyer.
Crea una aplicación de microservicios Dapr mediante Container Apps Cree una aplicación de microservicios de Dapr mediante Container Apps.
Crea una aplicación dapr pub-sub servicebus mediante Container Apps Cree una aplicación pub-sub servicebus de Dapr mediante Container Apps.

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:

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.ServiceBus/namespaces, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.ServiceBus/namespaces",
  "apiVersion": "2024-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "alternateName": "string",
    "disableLocalAuth": "bool",
    "encryption": {
      "keySource": "Microsoft.KeyVault",
      "keyVaultProperties": [
        {
          "identity": {
            "userAssignedIdentity": "string"
          },
          "keyName": "string",
          "keyVaultUri": "string",
          "keyVersion": "string"
        }
      ],
      "requireInfrastructureEncryption": "bool"
    },
    "minimumTlsVersion": "string",
    "premiumMessagingPartitions": "int",
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "publicNetworkAccess": "string",
    "zoneRedundant": "bool"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propiedad

ConnectionState

Nombre Descripción Valor
descripción Descripción del estado de conexión. cuerda
estado Estado de la conexión. 'Aprobado'
'Desconectado'
'Pendiente'
'Rechazado'

Encriptación

Nombre Descripción Valor
keySource Enumera el valor posible de keySource para el cifrado. "Microsoft.KeyVault"
keyVaultProperties Propiedades de KeyVault keyVaultProperties[]
requireInfrastructureEncryption Habilitación del cifrado de infraestructura (cifrado doble) Bool

Identidad

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Propiedades de identidades asignadas por el usuario IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre Descripción Valor

KeyVaultProperties

Nombre Descripción Valor
identidad UserAssignedIdentityProperties
keyName Nombre de la clave de KeyVault cuerda
keyVaultUri Uri de KeyVault cuerda
keyVersion Versión de KeyVault cuerda

Microsoft.ServiceBus/namespaces

Nombre Descripción Valor
apiVersion La versión de api '2024-01-01'
identidad Propiedades de la descripción de la identidad BYOK Identity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del espacio de nombres. SBNamespaceProperties
Sku Propiedades de la SKU sbSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso 'Microsoft.ServiceBus/namespaces'

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
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"

SBNamespaceProperties

Nombre Descripción Valor
alternateName Nombre alternativo para el espacio de nombres cuerda
disableLocalAuth Esta propiedad deshabilita la autenticación de SAS para el espacio de nombres de Service Bus. Bool
encriptación Propiedades de la descripción del cifrado BYOK Cifrado
minimumTlsVersion Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". '1.0'
'1.1'
'1.2'
premiumMessagingPartitions Número de particiones de un espacio de nombres de Service Bus. Esta propiedad solo es aplicable a los espacios de nombres de SKU Premium. El valor predeterminado es 1 y los valores posibles son 1, 2 y 4 Int
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. 'Deshabilitado'
'Habilitado'
"SecuredByPerimeter"
zoneRedundant Al habilitar esta propiedad se crea una Namespace premium de Service Bus en regiones admitidas zonas de disponibilidad. Bool

SBSku

Nombre Descripción Valor
capacidad Unidades de mensajería para el espacio de nombres Premium de Service Bus. Las capacidades válidas son {1, 2, 4, 8, 16} múltiplas de las propiedades.premiumMessagingPartitions. Por ejemplo, si properties.premiumMessagingPartitions es 1, los valores de capacidad posibles son 1, 2, 4, 8 y 16. Si properties.premiumMessagingPartitions es 4, los valores de capacidad posibles son 4, 8, 16, 32 y 64. Int
nombre Nombre de esta SKU. "Básico"
'Premium'
'Estándar' (obligatorio)
nivel Nivel de facturación de esta SKU determinada. "Básico"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

UserAssignedIdentityProperties

Nombre Descripción Valor
userAssignedIdentity Id. de ARM de la identidad de usuario seleccionada para el cifrado cuerda

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Conectarse a un espacio de nombres de Service Bus a través de un punto de conexión privado

Implementación en Azure
En este ejemplo se muestra cómo usar la configuración de una red virtual y una zona DNS privada para acceder a un espacio de nombres de Service Bus a través de un punto de conexión privado.
correlacionar mensajes a través de Logic Apps mediante service Bus

Implementación en Azure
que muestra cómo podemos correlacionar los mensajes a través de Logic Apps mediante Azure Service Bus
Crear un de recuperación geográfica de Service Bus

Implementación en Azure
Esta plantilla le permite configurar el alias de recuperación ante desastres geográfica de Service Bus en espacios de nombres de SKU premium.
Creación de un espacio de nombres de Service Bus

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres de Service Bus con una SKU básica o estándar.
Creación de un espacio de nombres de Service Bus y una cola

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Estándar de Service Bus y una cola.
Crear un espacio de nombres de Service Bus y una regla de autorización de cola

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Estándar de Service Bus y reglas de autorización para el espacio de nombres y una cola.
Crear un espacio de nombres de Service Bus y un de temas

Implementación en Azure
Esta plantilla crea una Namespace y un tema de Service Bus.
Crear una regla de filtro IP de espacio de nombres de Service Bus

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Premium de Service Bus con la regla de filtro IP.
Creación de una regla de red virtual de espacio de nombres de Service Bus

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Premium de Service Bus con una regla de red virtual.
Crear un espacio de nombres, tema y suscripción de Service Bus

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Estándar de Service Bus, un tema y una suscripción.
Crear un espacio de nombres, tema, suscripción y regla de Service Bus

Implementación en Azure
Esta plantilla le permite implementar un espacio de nombres Estándar de Service Bus, un tema, una suscripción y una regla.
Crear un espacio de nombres Premium de Service Bus y authorizationRule

Implementación en Azure
Esta plantilla crea una Namespace Premium de Service Bus y un espacio de nombres AuthorizationRule
crear un tema de Service Bus con de filtro SQL y suscripción

Implementación en Azure
Esta plantilla crea un Namespace de Service Bus y un tema con una suscripción mediante una expresión de filtro SQL para recibir solo los mensajes que coinciden con la expresión de filtro SQL definida.
crear temas personalizados de Azure Event Grid y de suscripción de cola

Implementación en Azure
Crea un tema personalizado de Azure Event Grid y una suscripción de cola de Service Bus. Plantilla originalmente creadas por Markus Meyer.
crear una suscripción a temas personalizados de Azure Event Grid

Implementación en Azure
Crea un tema personalizado de Azure Event Grid y una suscripción a temas de Service Bus. Plantilla originalmente creadas por Markus Meyer.
Crea una aplicación de microservicios Dapr mediante Container Apps

Implementación en Azure
Cree una aplicación de microservicios de Dapr mediante Container Apps.
Crea una aplicación dapr pub-sub servicebus mediante Container Apps

Implementación en Azure
Cree una aplicación pub-sub servicebus de Dapr mediante Container Apps.
EPiserverCMS en Azure

Implementación en Azure
Esta plantilla le permite crear recursos necesarios para la implementación de EpiServerCMS en Azure.
Patrones de integración de : enrutador de mensajes- Service Bus

Implementación en Azure
Solución que muestra cómo se puede configurar el patrón de enrutador de mensajes mediante un tema de Service Bus

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.ServiceBus/namespaces, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces@2024-01-01"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  location = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      alternateName = "string"
      disableLocalAuth = bool
      encryption = {
        keySource = "Microsoft.KeyVault"
        keyVaultProperties = [
          {
            identity = {
              userAssignedIdentity = "string"
            }
            keyName = "string"
            keyVaultUri = "string"
            keyVersion = "string"
          }
        ]
        requireInfrastructureEncryption = bool
      }
      minimumTlsVersion = "string"
      premiumMessagingPartitions = int
      privateEndpointConnections = [
        {
          properties = {
            privateEndpoint = {
              id = "string"
            }
            privateLinkServiceConnectionState = {
              description = "string"
              status = "string"
            }
            provisioningState = "string"
          }
        }
      ]
      publicNetworkAccess = "string"
      zoneRedundant = bool
    }
  })
}

Valores de propiedad

ConnectionState

Nombre Descripción Valor
descripción Descripción del estado de conexión. cuerda
estado Estado de la conexión. 'Aprobado'
'Desconectado'
'Pendiente'
'Rechazado'

Encriptación

Nombre Descripción Valor
keySource Enumera el valor posible de keySource para el cifrado. "Microsoft.KeyVault"
keyVaultProperties Propiedades de KeyVault keyVaultProperties[]
requireInfrastructureEncryption Habilitación del cifrado de infraestructura (cifrado doble) Bool

Identidad

Nombre Descripción Valor
tipo Tipo de identidad de servicio administrada. 'Ninguno'
'SystemAssigned'
'SystemAssigned, UserAssigned'
'UserAssigned'
userAssignedIdentities Propiedades de identidades asignadas por el usuario IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

Nombre Descripción Valor

KeyVaultProperties

Nombre Descripción Valor
identidad UserAssignedIdentityProperties
keyName Nombre de la clave de KeyVault cuerda
keyVaultUri Uri de KeyVault cuerda
keyVersion Versión de KeyVault cuerda

Microsoft.ServiceBus/namespaces

Nombre Descripción Valor
identidad Propiedades de la descripción de la identidad BYOK Identity
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso string (obligatorio)
Propiedades Propiedades del espacio de nombres. SBNamespaceProperties
Sku Propiedades de la SKU sbSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.ServiceBus/namespaces@2024-01-01"

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
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"

SBNamespaceProperties

Nombre Descripción Valor
alternateName Nombre alternativo para el espacio de nombres cuerda
disableLocalAuth Esta propiedad deshabilita la autenticación de SAS para el espacio de nombres de Service Bus. Bool
encriptación Propiedades de la descripción del cifrado BYOK Cifrado
minimumTlsVersion Versión mínima de TLS para que el clúster admita, por ejemplo, "1.2". '1.0'
'1.1'
'1.2'
premiumMessagingPartitions Número de particiones de un espacio de nombres de Service Bus. Esta propiedad solo es aplicable a los espacios de nombres de SKU Premium. El valor predeterminado es 1 y los valores posibles son 1, 2 y 4 Int
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. 'Deshabilitado'
'Habilitado'
"SecuredByPerimeter"
zoneRedundant Al habilitar esta propiedad se crea una Namespace premium de Service Bus en regiones admitidas zonas de disponibilidad. Bool

SBSku

Nombre Descripción Valor
capacidad Unidades de mensajería para el espacio de nombres Premium de Service Bus. Las capacidades válidas son {1, 2, 4, 8, 16} múltiplas de las propiedades.premiumMessagingPartitions. Por ejemplo, si properties.premiumMessagingPartitions es 1, los valores de capacidad posibles son 1, 2, 4, 8 y 16. Si properties.premiumMessagingPartitions es 4, los valores de capacidad posibles son 4, 8, 16, 32 y 64. Int
nombre Nombre de esta SKU. "Básico"
'Premium'
'Estándar' (obligatorio)
nivel Nivel de facturación de esta SKU determinada. "Básico"
'Premium'
'Estándar'

TrackedResourceTags

Nombre Descripción Valor

UserAssignedIdentity

Nombre Descripción Valor

UserAssignedIdentityProperties

Nombre Descripción Valor
userAssignedIdentity Id. de ARM de la identidad de usuario seleccionada para el cifrado cuerda