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:
- 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.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
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:
- 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.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
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 |
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 |
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 |
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 |
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 |
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 |
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 |
Esta plantilla crea una Namespace y un tema de Service Bus. |
Crear una regla de filtro IP de espacio de nombres de Service Bus |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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. |
EPiserverCMS 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 |
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
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 |