Compartir a través de

Espacios de nombres Microsoft.ServiceBus/colas

  • Artículo

Definición de recursos de Bicep

El tipo de recurso espacios de nombres o colas 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/queues, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.ServiceBus/namespaces/queues@2024-01-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    autoDeleteOnIdle: 'string'
    deadLetteringOnMessageExpiration: bool
    defaultMessageTimeToLive: 'string'
    duplicateDetectionHistoryTimeWindow: 'string'
    enableBatchedOperations: bool
    enableExpress: bool
    enablePartitioning: bool
    forwardDeadLetteredMessagesTo: 'string'
    forwardTo: 'string'
    lockDuration: 'string'
    maxDeliveryCount: int
    maxMessageSizeInKilobytes: int
    maxSizeInMegabytes: int
    requiresDuplicateDetection: bool
    requiresSession: bool
    status: 'string'
  }
}

Valores de propiedad

Microsoft.ServiceBus/namespaces/queues

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1 (obligatorio)
padre En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario.

Para obtener más información, consulte recurso secundario fuera del recurso primario.		 Nombre simbólico del recurso de tipo: espacios de nombres
Propiedades Propiedades de cola SBQueueProperties

SBQueueProperties

Nombre Descripción Valor
autoDeleteOnIdle Intervalo de inactividad de timeSpan iso 8061 después del cual se elimina automáticamente la cola. La duración mínima es de 5 minutos. cuerda
deadLetteringOnMessageExpiration Valor que indica si esta cola tiene compatibilidad con mensajes fallidos cuando expira un mensaje. Bool
defaultMessageTimeToLive El intervalo de tiempo predeterminado del mensaje ISO 8601 es activo. Esta es la duración después de la cual expira el mensaje, a partir de cuándo se envía el mensaje a Service Bus. Este es el valor predeterminado que se usa cuando TimeToLive no está establecido en un mensaje en sí. cuerda
duplicateDetectionHistoryTimeWindow Estructura timeSpan iso 8601 que define la duración del historial de detección de duplicados. El valor predeterminado es 10 minutos. cuerda
enableBatchedOperations Valor que indica si las operaciones por lotes del lado servidor están habilitadas. Bool
enableExpress Valor que indica si las entidades express están habilitadas. Una cola rápida contiene un mensaje en la memoria temporalmente antes de escribirlo en el almacenamiento persistente. Bool
enablePartitioning Valor que indica si la cola se va a particionar entre varios agentes de mensajes. Bool
forwardDeadLetteredMessagesTo Nombre de la cola o tema para reenviar el mensaje de mensajes fallidos cuerda
forwardTo Nombre de cola o tema para reenviar los mensajes cuerda
lockDuration Duración del intervalo de tiempo ISO 8601 de un bloqueo de inspección; es decir, la cantidad de tiempo que el mensaje está bloqueado para otros receptores. El valor máximo de LockDuration es de 5 minutos; el valor predeterminado es 1 minuto. cuerda
maxDeliveryCount Número máximo de entregas. Un mensaje se activa automáticamente después de este número de entregas. el valor predeterminado es 10. Int
maxMessageSizeInKilobytes Tamaño máximo (en KB) de la carga del mensaje que la cola puede aceptar. Esta propiedad solo se usa actualmente en Premium y el valor predeterminado es 1024. Int
maxSizeInMegabytes Tamaño máximo de la cola en megabytes, que es el tamaño de la memoria asignada para la cola. El valor predeterminado es 1024. Int
requireDuplicateDetection Valor que indica si esta cola requiere detección de duplicados. Bool
requireSession Valor que indica si la cola admite el concepto de sesiones. Bool
estado Enumera los valores posibles para el estado de una entidad de mensajería. 'Activo'
'Crear'
"Eliminar"
'Deshabilitado'
'ReceiveDisabled'
'Cambiar el nombre'
"Restaurar"
'SendDisabled'
'Desconocido'

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

Definición de recursos de plantilla de ARM

El tipo de recurso espacios de nombres o colas 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/queues, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.ServiceBus/namespaces/queues",
  "apiVersion": "2024-01-01",
  "name": "string",
  "properties": {
    "autoDeleteOnIdle": "string",
    "deadLetteringOnMessageExpiration": "bool",
    "defaultMessageTimeToLive": "string",
    "duplicateDetectionHistoryTimeWindow": "string",
    "enableBatchedOperations": "bool",
    "enableExpress": "bool",
    "enablePartitioning": "bool",
    "forwardDeadLetteredMessagesTo": "string",
    "forwardTo": "string",
    "lockDuration": "string",
    "maxDeliveryCount": "int",
    "maxMessageSizeInKilobytes": "int",
    "maxSizeInMegabytes": "int",
    "requiresDuplicateDetection": "bool",
    "requiresSession": "bool",
    "status": "string"
  }
}

Valores de propiedad

Microsoft.ServiceBus/namespaces/queues

Nombre Descripción Valor
apiVersion La versión de api '2024-01-01'
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1 (obligatorio)
Propiedades Propiedades de cola SBQueueProperties
tipo El tipo de recurso 'Microsoft.ServiceBus/namespaces/queues'

SBQueueProperties

Nombre Descripción Valor
autoDeleteOnIdle Intervalo de inactividad de timeSpan iso 8061 después del cual se elimina automáticamente la cola. La duración mínima es de 5 minutos. cuerda
deadLetteringOnMessageExpiration Valor que indica si esta cola tiene compatibilidad con mensajes fallidos cuando expira un mensaje. Bool
defaultMessageTimeToLive El intervalo de tiempo predeterminado del mensaje ISO 8601 es activo. Esta es la duración después de la cual expira el mensaje, a partir de cuándo se envía el mensaje a Service Bus. Este es el valor predeterminado que se usa cuando TimeToLive no está establecido en un mensaje en sí. cuerda
duplicateDetectionHistoryTimeWindow Estructura timeSpan iso 8601 que define la duración del historial de detección de duplicados. El valor predeterminado es 10 minutos. cuerda
enableBatchedOperations Valor que indica si las operaciones por lotes del lado servidor están habilitadas. Bool
enableExpress Valor que indica si las entidades express están habilitadas. Una cola rápida contiene un mensaje en la memoria temporalmente antes de escribirlo en el almacenamiento persistente. Bool
enablePartitioning Valor que indica si la cola se va a particionar entre varios agentes de mensajes. Bool
forwardDeadLetteredMessagesTo Nombre de la cola o tema para reenviar el mensaje de mensajes fallidos cuerda
forwardTo Nombre de cola o tema para reenviar los mensajes cuerda
lockDuration Duración del intervalo de tiempo ISO 8601 de un bloqueo de inspección; es decir, la cantidad de tiempo que el mensaje está bloqueado para otros receptores. El valor máximo de LockDuration es de 5 minutos; el valor predeterminado es 1 minuto. cuerda
maxDeliveryCount Número máximo de entregas. Un mensaje se activa automáticamente después de este número de entregas. el valor predeterminado es 10. Int
maxMessageSizeInKilobytes Tamaño máximo (en KB) de la carga del mensaje que la cola puede aceptar. Esta propiedad solo se usa actualmente en Premium y el valor predeterminado es 1024. Int
maxSizeInMegabytes Tamaño máximo de la cola en megabytes, que es el tamaño de la memoria asignada para la cola. El valor predeterminado es 1024. Int
requireDuplicateDetection Valor que indica si esta cola requiere detección de duplicados. Bool
requireSession Valor que indica si la cola admite el concepto de sesiones. Bool
estado Enumera los valores posibles para el estado de una entidad de mensajería. 'Activo'
'Crear'
"Eliminar"
'Deshabilitado'
'ReceiveDisabled'
'Cambiar el nombre'
"Restaurar"
'SendDisabled'
'Desconocido'

Plantillas de inicio rápido

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

Plantilla Descripción
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 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.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso espacios de nombres o colas 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/queues, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces/queues@2024-01-01"
  name = "string"
  body = jsonencode({
    properties = {
      autoDeleteOnIdle = "string"
      deadLetteringOnMessageExpiration = bool
      defaultMessageTimeToLive = "string"
      duplicateDetectionHistoryTimeWindow = "string"
      enableBatchedOperations = bool
      enableExpress = bool
      enablePartitioning = bool
      forwardDeadLetteredMessagesTo = "string"
      forwardTo = "string"
      lockDuration = "string"
      maxDeliveryCount = int
      maxMessageSizeInKilobytes = int
      maxSizeInMegabytes = int
      requiresDuplicateDetection = bool
      requiresSession = bool
      status = "string"
    }
  })
}

Valores de propiedad

Microsoft.ServiceBus/namespaces/queues

Nombre Descripción Valor
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1 (obligatorio)
parent_id Identificador del recurso que es el elemento primario de este recurso. Identificador del recurso de tipo: espacios de nombres
Propiedades Propiedades de cola SBQueueProperties
tipo El tipo de recurso "Microsoft.ServiceBus/namespaces/queues@2024-01-01"

SBQueueProperties

Nombre Descripción Valor
autoDeleteOnIdle Intervalo de inactividad de timeSpan iso 8061 después del cual se elimina automáticamente la cola. La duración mínima es de 5 minutos. cuerda
deadLetteringOnMessageExpiration Valor que indica si esta cola tiene compatibilidad con mensajes fallidos cuando expira un mensaje. Bool
defaultMessageTimeToLive El intervalo de tiempo predeterminado del mensaje ISO 8601 es activo. Esta es la duración después de la cual expira el mensaje, a partir de cuándo se envía el mensaje a Service Bus. Este es el valor predeterminado que se usa cuando TimeToLive no está establecido en un mensaje en sí. cuerda
duplicateDetectionHistoryTimeWindow Estructura timeSpan iso 8601 que define la duración del historial de detección de duplicados. El valor predeterminado es 10 minutos. cuerda
enableBatchedOperations Valor que indica si las operaciones por lotes del lado servidor están habilitadas. Bool
enableExpress Valor que indica si las entidades express están habilitadas. Una cola rápida contiene un mensaje en la memoria temporalmente antes de escribirlo en el almacenamiento persistente. Bool
enablePartitioning Valor que indica si la cola se va a particionar entre varios agentes de mensajes. Bool
forwardDeadLetteredMessagesTo Nombre de la cola o tema para reenviar el mensaje de mensajes fallidos cuerda
forwardTo Nombre de cola o tema para reenviar los mensajes cuerda
lockDuration Duración del intervalo de tiempo ISO 8601 de un bloqueo de inspección; es decir, la cantidad de tiempo que el mensaje está bloqueado para otros receptores. El valor máximo de LockDuration es de 5 minutos; el valor predeterminado es 1 minuto. cuerda
maxDeliveryCount Número máximo de entregas. Un mensaje se activa automáticamente después de este número de entregas. el valor predeterminado es 10. Int
maxMessageSizeInKilobytes Tamaño máximo (en KB) de la carga del mensaje que la cola puede aceptar. Esta propiedad solo se usa actualmente en Premium y el valor predeterminado es 1024. Int
maxSizeInMegabytes Tamaño máximo de la cola en megabytes, que es el tamaño de la memoria asignada para la cola. El valor predeterminado es 1024. Int
requireDuplicateDetection Valor que indica si esta cola requiere detección de duplicados. Bool
requireSession Valor que indica si la cola admite el concepto de sesiones. Bool
estado Enumera los valores posibles para el estado de una entidad de mensajería. 'Activo'
'Crear'
"Eliminar"
'Deshabilitado'
'ReceiveDisabled'
'Cambiar el nombre'
"Restaurar"
'SendDisabled'
'Desconocido'