Compartir a través de


Microsoft.SignalRService signalR 2025-01-01-preview

Definición de recursos de Bicep

El tipo de recurso signalR se puede implementar con operaciones destinadas a:

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.SignalRService/signalR, agregue lo siguiente a la plantilla de Bicep.

resource symbolicname 'Microsoft.SignalRService/signalR@2025-01-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    applicationFirewall: {
      clientConnectionCountRules: [
        {
          type: 'string'
          // For remaining properties, see ClientConnectionCountRule objects
        }
      ]
      clientTrafficControlRules: [
        {
          type: 'string'
          // For remaining properties, see ClientTrafficControlRule objects
        }
      ]
      maxClientConnectionLifetimeInSeconds: int
    }
    cors: {
      allowedOrigins: [
        'string'
      ]
    }
    disableAadAuth: bool
    disableLocalAuth: bool
    features: [
      {
        flag: 'string'
        properties: {
          {customized property}: 'string'
        }
        value: 'string'
      }
    ]
    liveTraceConfiguration: {
      categories: [
        {
          enabled: 'string'
          name: 'string'
        }
      ]
      enabled: 'string'
    }
    networkACLs: {
      defaultAction: 'string'
      ipRules: [
        {
          action: 'string'
          value: 'string'
        }
      ]
      privateEndpoints: [
        {
          allow: [
            'string'
          ]
          deny: [
            'string'
          ]
          name: 'string'
        }
      ]
      publicNetwork: {
        allow: [
          'string'
        ]
        deny: [
          'string'
        ]
      }
    }
    publicNetworkAccess: 'string'
    regionEndpointEnabled: 'string'
    resourceLogConfiguration: {
      categories: [
        {
          enabled: 'string'
          name: 'string'
        }
      ]
    }
    resourceStopped: 'string'
    routeSettings: {
      connectionBalanceWeight: int
      latencyWeight: int
      serverBalanceWeight: int
    }
    serverless: {
      connectionTimeoutInSeconds: int
      keepAliveIntervalInSeconds: int
    }
    tls: {
      clientCertEnabled: bool
    }
    upstream: {
      templates: [
        {
          auth: {
            managedIdentity: {
              resource: 'string'
            }
            type: 'string'
          }
          categoryPattern: 'string'
          eventPattern: 'string'
          hubPattern: 'string'
          urlTemplate: 'string'
        }
      ]
    }
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Objetos ClientTrafficControlRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para TrafficThrottleByJwtCustomClaimRule, use:

{
  aggregationWindowInSeconds: int
  claimName: 'string'
  maxInboundMessageBytes: int
  type: 'TrafficThrottleByJwtCustomClaimRule'
}

Para TrafficThrottleByJwtSignatureRule, use:

{
  aggregationWindowInSeconds: int
  maxInboundMessageBytes: int
  type: 'TrafficThrottleByJwtSignatureRule'
}

Para TrafficThrottleByUserIdRule, use:

{
  aggregationWindowInSeconds: int
  maxInboundMessageBytes: int
  type: 'TrafficThrottleByUserIdRule'
}

Objetos ClientConnectionCountRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ThrottleByJwtCustomClaimRule, use:

{
  claimName: 'string'
  maxCount: int
  type: 'ThrottleByJwtCustomClaimRule'
}

Para ThrottleByJwtSignatureRule, use:

{
  maxCount: int
  type: 'ThrottleByJwtSignatureRule'
}

Para ThrottleByUserIdRule, use:

{
  maxCount: int
  type: 'ThrottleByUserIdRule'
}

Valores de propiedad

Microsoft.SignalRService/signalR

Nombre Descripción Importancia
identidad Una clase representa las identidades administradas usadas para la solicitud y la respuesta. ManagedIdentity
amable El tipo de servicio 'RawWebSockets'
'SeñalR'
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (obligatorio)
Propiedades Clase que describe las propiedades del recurso SignalRProperties
código SKU Información de facturación del recurso. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas

ApplicationFirewallSettings

Nombre Descripción Importancia
clientConnectionCountRules Reglas para controlar el recuento de conexiones de cliente ClientConnectionCountRule []
clientTrafficControlRules Reglas para controlar el tráfico del cliente ClientTrafficControlRule []
maxClientConnectionLifetimeInSeconds Config para controlar la vida útil de la conexión del cliente en segundos, se puede establecer en 0 para deshabilitar la configuración Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

ClientConnectionCountRule

Nombre Descripción Importancia
tipo Establezca en "ThrottleByJwtCustomClaimRule" para el tipo ThrottleByJwtCustomClaimRule. Establezca en "ThrottleByJwtSignatureRule" para el tipo ThrottleByJwtSignatureRule. Establezca en "ThrottleByUserIdRule" para el tipo ThrottleByUserIdRule. 'ThrottleByJwtCustomClaimRule'
'ThrottleByJwtSignatureRule'
'ThrottleByUserIdRule' (obligatorio)

ClientTrafficControlRule

Nombre Descripción Importancia
tipo Establezca en "TrafficThrottleByJwtCustomClaimRule" para el tipo TrafficThrottleByJwtCustomClaimRule. Establezca en "TrafficThrottleByJwtSignatureRule" para el tipo TrafficThrottleByJwtSignatureRule. Establezca en "TrafficThrottleByUserIdRule" para el tipo TrafficThrottleByUserIdRule. 'TrafficThrottleByJwtCustomClaimRule'
'TrafficThrottleByJwtSignatureRule'
'TrafficThrottleByUserIdRule' (obligatorio)

IPRule

Nombre Descripción Importancia
acción Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
valor Ip o CIDR o ServiceTag cuerda / cadena

LiveTraceCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de seguimiento activo está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría de seguimiento activo.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

LiveTraceConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. LiveTraceCategory []
Habilitado Indica si habilita o no el seguimiento activo.
Cuando se establece en true, el cliente de seguimiento activo puede conectarse al servicio.
De lo contrario, el cliente de seguimiento activo no puede conectarse al servicio, de modo que no pueda recibir ningún registro, independientemente de lo que configure en "categorías".
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena

Identidad administrada

Nombre Descripción Importancia
tipo Representa el tipo de identidad: systemAssigned, userAssigned, None 'Ninguno'
'SystemAssigned'
'Asignado por el usuario'
identidades asignadas por el usuario Obtener o establecer las identidades asignadas por el usuario ManagedIdentityUserAssignedIdentities

ManagedIdentitySettings

Nombre Descripción Importancia
recurso Recurso que indica el URI del identificador de aplicación del recurso de destino.
También aparece en la notificación aud (audiencia) del token emitido.
cuerda / cadena

ManagedIdentityUserAssignedIdentities

Nombre Descripción Importancia

RedACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'

PrivateEndpointACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
nombre Nombre de la conexión de punto de conexión privado string (obligatorio)

ResourceLogCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de registro de recursos está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría del registro de recursos.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

ResourceLogConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. resourceLogCategory[]

ResourceSku

Nombre Descripción Importancia
capacidad Opcional, entero. Recuento de unidades del recurso.
1 para Free_F1/Standard_S1/Premium_P1, 100 para Premium_P2 de forma predeterminada.

Si está presente, se permiten los siguientes valores:
Free_F1: 1;
Standard_S1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P2: 100.200.300.400.500.600.700.800.900.1000;
Int
nombre El nombre de la SKU. Obligatorio.

Valores permitidos: Standard_S1, Free_F1, Premium_P1, Premium_P2
string (obligatorio)
nivel Nivel opcional de esta SKU determinada. 'Estándar' o 'Gratis'.

Basic está en desuso, use Standard en su lugar.
"Básico"
"Gratis"
'Premium'
'Estándar'

RouteSettings (Configuración de ruta)

Nombre Descripción Importancia
connectionBalanceWeight Obtiene o establece el peso del equilibrio de conexión.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes conexiones de servidor.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para todos los casos.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
latencyWeight Obtiene o establece el peso del enrutamiento basado en latencia.
Un valor más alto aumenta la influencia del enrutamiento basado en latencia.
Un valor de 0 deshabilita por completo el enrutamiento basado en latencia, mientras que un valor de 255 lo habilita por completo.
El valor predeterminado es 0.
Se recomienda 255 para réplicas o servidores de aplicaciones en diferentes regiones para la recuperación ante desastres.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
serverBalanceWeight Obtiene o establece el peso del saldo del servidor.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes instancias de servidor de aplicaciones.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para varios servidores de aplicaciones del mismo tamaño.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255

ServerlessSettings

Nombre Descripción Importancia
connectionTimeoutInSeconds Obtiene o establece tiempo de espera de conexión de cliente. Opcional para establecer.
Valor en segundos.
El valor predeterminado es de 30 segundos.
El cliente debe establecer el tiempo de espera en un período más corto si se espera que los mensajes se envíen en intervalos más cortos,
y quiere que el cliente se desconecte más rápidamente después de enviar el último mensaje.
Puede establecer el tiempo de espera en un período más largo si se espera que los mensajes se envíen en intervalos más largos,
y quieren mantener activa la misma conexión de cliente durante esta sesión.
El servicio considera que el cliente está desconectado si no ha recibido un mensaje (incluido keep-alive) en este intervalo.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120
keepAliveIntervalInSeconds Obtiene o establece el intervalo de Keep-Alive. Opcional para establecer.
El valor es en segundos.
El valor predeterminado es de 15 segundos.
Los clientes deben establecer este valor en un período más corto si quieren que el servicio envíe mensajes de mantenimiento con más frecuencia,
garantizando comprobaciones oportunas del estado de conexión.
Por el contrario, los clientes pueden establecer este valor en un período más largo si quieren que el servicio envíe mensajes de mantenimiento activo con menos frecuencia,
Reducir el tráfico de red, pero tenga en cuenta que puede tardar más tiempo en detectar una desconexión.
Este intervalo garantiza que la conexión se mantenga enviando mensajes periódicos de mantenimiento al cliente.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120

ServerlessUpstreamSettings

Nombre Descripción Importancia
Plantillas Obtiene o establece la lista de plantillas de dirección URL ascendentes. El orden es importante y la primera plantilla coincidente tiene efectos. UpstreamTemplate []

SignalRCorsSettings

Nombre Descripción Importancia
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para realizar llamadas entre orígenes (por ejemplo: http://example.com:12345). Use "*" para permitir todo. Si se omite, permita todo de forma predeterminada. cadena[]

SignalRFeature

Nombre Descripción Importancia
bandera FeatureFlags es las características admitidas del servicio Azure SignalR.
- ServiceMode: marca para el servidor back-end para signalR service. Valores permitidos: "Valor predeterminado": tienen su propio servidor back-end; "Sin servidor": la aplicación no tiene un servidor back-end; "Clásico": para la compatibilidad con versiones anteriores. Admite tanto el modo predeterminado como el sin servidor, pero no se recomienda; "PredefinedOnly": para su uso futuro.
- EnableConnectivityLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableMessagingLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableLiveTrace: Live Trace le permite saber lo que sucede dentro del servicio Azure SignalR, le proporcionará seguimientos en vivo en tiempo real, será útil al desarrollar su propia aplicación web basada en Azure SignalR o solucionar algunos problemas. Tenga en cuenta que los seguimientos en directo se cuentan como mensajes salientes que se cobrarán. Valores permitidos: "true"/"false", para habilitar o deshabilitar la característica de seguimiento activo.
'EnableConnectivityLogs'
'EnableLiveTrace'
'HabilitarMensajeríaRegistros'
'ServiceMode' (obligatorio)
Propiedades Propiedades opcionales relacionadas con esta característica. SignalRFeatureProperties
valor Valor de la marca de característica. Consulte el documento de Azure SignalR Service /azure/azure-signalr/ para ver los valores permitidos. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 128 (obligatorio)

SignalRFeatureProperties

Nombre Descripción Importancia

SignalRNetworkACLs

Nombre Descripción Importancia
defaultAction Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Reglas ip para filtrar el tráfico público IPRule []
privateEndpoints ACL para solicitudes de puntos de conexión privados PrivateEndpointACL []
red pública ACL de red RedACL

SignalRProperties

Nombre Descripción Importancia
applicationFirewall Configuración del firewall de aplicaciones para el recurso applicationFirewallSettings
cors Configuración de uso compartido de recursos entre orígenes (CORS). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación de aad
Cuando se establece como true, la conexión con AuthType=aad no funcionará.
booleano
disableLocalAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación local con AccessKey
Cuando se establece como true, la conexión con AccessKey=xxx no funcionará.
booleano
Características Lista de featureFlags.

FeatureFlags que no se incluyen en los parámetros de la operación de actualización no se modificarán.
Y la respuesta solo incluirá featureFlags que se establecen explícitamente.
Cuando un featureFlag no se establece explícitamente, se usará su valor predeterminado global.
Pero tenga en cuenta que el valor predeterminado no significa "false". Varía en términos de características diferentes.
SignalRFeature[]
liveTraceConfiguration Configuración de seguimiento activo de un recurso Microsoft.SignalRService. LiveTraceConfiguration
ACLs de red ACL de red para el recurso SignalRNetworkACLs
publicNetworkAccess Habilite o deshabilite el acceso a la red pública. El valor predeterminado es "Habilitado".
Cuando está habilitado, las ACL de red se siguen aplicando.
Cuando está deshabilitado, el acceso a la red pública siempre está deshabilitado independientemente de lo que establezca en las ACL de red.
cuerda / cadena
regionEndpointEnabled Habilite o deshabilite el punto de conexión regional. El valor predeterminado es "Habilitado".
Cuando está deshabilitado, las nuevas conexiones no se enrutarán a este punto de conexión, pero las conexiones existentes no se verán afectadas.
Esta propiedad es específica de la réplica. No se permite deshabilitar el punto de conexión regional sin réplica.
cuerda / cadena
resourceLogConfiguration Configuración del registro de recursos de un recurso Microsoft.SignalRService. resourceLogConfiguration
resourceStopped Detenga o inicie el recurso. El valor predeterminado es "False".
Cuando se cumple, el plano de datos del recurso se apaga.
Cuando es false, se inicia el plano de datos del recurso.
cuerda / cadena
routeSettings Configuración de ruta para el recurso RouteSettings (Configuración de ruta)
sin servidor Configuración sin servidor. ServerlessSettings
TLS Configuración de TLS para el recurso SignalRTlsSettings
ascendente La configuración de upstream cuando el servicio está en modo sin servidor. ServerlessUpstreamSettings

SignalRTlsSettings

Nombre Descripción Importancia
clientCertEnabled Solicite el certificado de cliente durante el protocolo de enlace TLS si está habilitado. No se admite para el nivel gratis. Cualquier entrada se omitirá para el nivel gratis. booleano

ThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
claimName Nombre de la notificación en el token JWT. La conexión de cliente con el mismo valor de notificación se agregará. Si la notificación no se encuentra en el token, se permitirá la conexión. string (obligatorio)
maxCount Número máximo de conexiones permitido para el mismo valor de notificación Jwt. Los clientes con la misma notificación Jwt se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtCustomClaimRule' (obligatorio)

ThrottleByJwtSignatureRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para la misma firma JWT. Los clientes con la misma firma JWT se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtSignatureRule' (obligatorio)

ThrottleByUserIdRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para el mismo identificador de usuario. Los clientes con el mismo identificador de usuario se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByUserIdRule' (obligatorio)

TrackedResourceTags

Nombre Descripción Importancia

TrafficThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
claimName Nombre de la notificación en el token JWT. Se agregarán los bytes del mensaje con el mismo valor de notificación. Si no se encuentra la notificación en el token, se omitirá la regla. string (obligatorio)
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma notificación JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtCustomClaimRule' (obligatorio)

TrafficThrottleByJwtSignatureRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma firma JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtSignatureRule' (obligatorio)

TrafficThrottleByUserIdRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para el mismo identificador de usuario dentro de un período de tiempo. Los clientes con el mismo identificador de usuario se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByUserIdRule' (obligatorio)

UpstreamAuthSettings

Nombre Descripción Importancia
managedIdentity Configuración de identidad administrada para ascendente. managedIdentitySettings
tipo Enumeración de tipo de autenticación ascendente. 'Identidad administrada'
'Ninguno'

UpstreamTemplate

Nombre Descripción Importancia
autenticación Configuración de autenticación ascendente. Si no se establece, no se usa ninguna autenticación para los mensajes ascendentes. upstreamAuthSettings
categoryPattern Obtiene o establece el patrón coincidente para los nombres de categoría. Si no se establece, coincide con cualquier categoría.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de categoría.
2. Combine varias categorías con ",", por ejemplo "conexiones, mensajes", coincide con la categoría "connections" y "messages".
3. El nombre de categoría único, por ejemplo, "connections", coincide con la categoría "connections".
cuerda / cadena
eventPattern Obtiene o establece el patrón coincidente para los nombres de evento. Si no se establece, coincide con cualquier evento.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de evento.
2. Combine varios eventos con ",", por ejemplo "connect,disconnect", coincide con el evento "connect" y "disconnect".
3. El nombre de evento único, por ejemplo, "connect", coincide con "connect".
cuerda / cadena
hubPattern Obtiene o establece el patrón coincidente para los nombres del centro. Si no se establece, coincide con cualquier centro.
Hay 3 tipos de patrones admitidos:
1. "*", para que coincida con cualquier nombre del centro.
2. Combine varios concentradores con ",", por ejemplo "hub1,hub2", coincide con "hub1" y "hub2".
3. El nombre del concentrador único, por ejemplo, "hub1", coincide con "hub1".
cuerda / cadena
urlTemplate Obtiene o establece la plantilla dirección URL ascendente. Puede usar 3 parámetros predefinidos {hub}, {category} {event} dentro de la plantilla, el valor de la dirección URL ascendente se calcula dinámicamente cuando entra en la solicitud de cliente.
Por ejemplo, si la dirección URLTemplate es http://example.com/{hub}/api/{event}, con una solicitud de cliente del centro de conectividad chat se conecta, primero enviará POST a esta dirección URL: http://example.com/chat/api/connect.
string (obligatorio)

UserAssignedIdentityProperty

Nombre Descripción Importancia

Ejemplos de uso

Módulos comprobados de Azure

Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.

Módulo Descripción
Servicio SignalR SignalR Módulo de recursos de AVM para SignalR Service SignalR

Ejemplos de inicio rápido de Azure

Las siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.

Archivo de Bicep Descripción
Implementación de una de Azure SignalR Service Esta plantilla crea una instancia de Azure SignalR Service mediante una plantilla.

Definición de recursos de plantilla de ARM

El tipo de recurso signalR se puede implementar con operaciones destinadas a:

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

{
  "type": "Microsoft.SignalRService/signalR",
  "apiVersion": "2025-01-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "applicationFirewall": {
      "clientConnectionCountRules": [ {
        "type": "string"
        // For remaining properties, see ClientConnectionCountRule objects
      } ],
      "clientTrafficControlRules": [ {
        "type": "string"
        // For remaining properties, see ClientTrafficControlRule objects
      } ],
      "maxClientConnectionLifetimeInSeconds": "int"
    },
    "cors": {
      "allowedOrigins": [ "string" ]
    },
    "disableAadAuth": "bool",
    "disableLocalAuth": "bool",
    "features": [
      {
        "flag": "string",
        "properties": {
          "{customized property}": "string"
        },
        "value": "string"
      }
    ],
    "liveTraceConfiguration": {
      "categories": [
        {
          "enabled": "string",
          "name": "string"
        }
      ],
      "enabled": "string"
    },
    "networkACLs": {
      "defaultAction": "string",
      "ipRules": [
        {
          "action": "string",
          "value": "string"
        }
      ],
      "privateEndpoints": [
        {
          "allow": [ "string" ],
          "deny": [ "string" ],
          "name": "string"
        }
      ],
      "publicNetwork": {
        "allow": [ "string" ],
        "deny": [ "string" ]
      }
    },
    "publicNetworkAccess": "string",
    "regionEndpointEnabled": "string",
    "resourceLogConfiguration": {
      "categories": [
        {
          "enabled": "string",
          "name": "string"
        }
      ]
    },
    "resourceStopped": "string",
    "routeSettings": {
      "connectionBalanceWeight": "int",
      "latencyWeight": "int",
      "serverBalanceWeight": "int"
    },
    "serverless": {
      "connectionTimeoutInSeconds": "int",
      "keepAliveIntervalInSeconds": "int"
    },
    "tls": {
      "clientCertEnabled": "bool"
    },
    "upstream": {
      "templates": [
        {
          "auth": {
            "managedIdentity": {
              "resource": "string"
            },
            "type": "string"
          },
          "categoryPattern": "string",
          "eventPattern": "string",
          "hubPattern": "string",
          "urlTemplate": "string"
        }
      ]
    }
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Objetos ClientTrafficControlRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para TrafficThrottleByJwtCustomClaimRule, use:

{
  "aggregationWindowInSeconds": "int",
  "claimName": "string",
  "maxInboundMessageBytes": "int",
  "type": "TrafficThrottleByJwtCustomClaimRule"
}

Para TrafficThrottleByJwtSignatureRule, use:

{
  "aggregationWindowInSeconds": "int",
  "maxInboundMessageBytes": "int",
  "type": "TrafficThrottleByJwtSignatureRule"
}

Para TrafficThrottleByUserIdRule, use:

{
  "aggregationWindowInSeconds": "int",
  "maxInboundMessageBytes": "int",
  "type": "TrafficThrottleByUserIdRule"
}

Objetos ClientConnectionCountRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ThrottleByJwtCustomClaimRule, use:

{
  "claimName": "string",
  "maxCount": "int",
  "type": "ThrottleByJwtCustomClaimRule"
}

Para ThrottleByJwtSignatureRule, use:

{
  "maxCount": "int",
  "type": "ThrottleByJwtSignatureRule"
}

Para ThrottleByUserIdRule, use:

{
  "maxCount": "int",
  "type": "ThrottleByUserIdRule"
}

Valores de propiedad

Microsoft.SignalRService/signalR

Nombre Descripción Importancia
apiVersion La versión de api '2025-01-01-preestreno'
identidad Una clase representa las identidades administradas usadas para la solicitud y la respuesta. ManagedIdentity
amable El tipo de servicio 'RawWebSockets'
'SeñalR'
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (obligatorio)
Propiedades Clase que describe las propiedades del recurso SignalRProperties
código SKU Información de facturación del recurso. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta. Consulte etiquetas de en plantillas
tipo El tipo de recurso 'Microsoft.SignalRService/signalR'

ApplicationFirewallSettings

Nombre Descripción Importancia
clientConnectionCountRules Reglas para controlar el recuento de conexiones de cliente ClientConnectionCountRule []
clientTrafficControlRules Reglas para controlar el tráfico del cliente ClientTrafficControlRule []
maxClientConnectionLifetimeInSeconds Config para controlar la vida útil de la conexión del cliente en segundos, se puede establecer en 0 para deshabilitar la configuración Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

ClientConnectionCountRule

Nombre Descripción Importancia
tipo Establezca en "ThrottleByJwtCustomClaimRule" para el tipo ThrottleByJwtCustomClaimRule. Establezca en "ThrottleByJwtSignatureRule" para el tipo ThrottleByJwtSignatureRule. Establezca en "ThrottleByUserIdRule" para el tipo ThrottleByUserIdRule. 'ThrottleByJwtCustomClaimRule'
'ThrottleByJwtSignatureRule'
'ThrottleByUserIdRule' (obligatorio)

ClientTrafficControlRule

Nombre Descripción Importancia
tipo Establezca en "TrafficThrottleByJwtCustomClaimRule" para el tipo TrafficThrottleByJwtCustomClaimRule. Establezca en "TrafficThrottleByJwtSignatureRule" para el tipo TrafficThrottleByJwtSignatureRule. Establezca en "TrafficThrottleByUserIdRule" para el tipo TrafficThrottleByUserIdRule. 'TrafficThrottleByJwtCustomClaimRule'
'TrafficThrottleByJwtSignatureRule'
'TrafficThrottleByUserIdRule' (obligatorio)

IPRule

Nombre Descripción Importancia
acción Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
valor Ip o CIDR o ServiceTag cuerda / cadena

LiveTraceCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de seguimiento activo está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría de seguimiento activo.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

LiveTraceConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. LiveTraceCategory []
Habilitado Indica si habilita o no el seguimiento activo.
Cuando se establece en true, el cliente de seguimiento activo puede conectarse al servicio.
De lo contrario, el cliente de seguimiento activo no puede conectarse al servicio, de modo que no pueda recibir ningún registro, independientemente de lo que configure en "categorías".
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena

Identidad administrada

Nombre Descripción Importancia
tipo Representa el tipo de identidad: systemAssigned, userAssigned, None 'Ninguno'
'SystemAssigned'
'Asignado por el usuario'
identidades asignadas por el usuario Obtener o establecer las identidades asignadas por el usuario ManagedIdentityUserAssignedIdentities

ManagedIdentitySettings

Nombre Descripción Importancia
recurso Recurso que indica el URI del identificador de aplicación del recurso de destino.
También aparece en la notificación aud (audiencia) del token emitido.
cuerda / cadena

ManagedIdentityUserAssignedIdentities

Nombre Descripción Importancia

RedACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'

PrivateEndpointACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
nombre Nombre de la conexión de punto de conexión privado string (obligatorio)

ResourceLogCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de registro de recursos está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría del registro de recursos.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

ResourceLogConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. resourceLogCategory[]

ResourceSku

Nombre Descripción Importancia
capacidad Opcional, entero. Recuento de unidades del recurso.
1 para Free_F1/Standard_S1/Premium_P1, 100 para Premium_P2 de forma predeterminada.

Si está presente, se permiten los siguientes valores:
Free_F1: 1;
Standard_S1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P2: 100.200.300.400.500.600.700.800.900.1000;
Int
nombre El nombre de la SKU. Obligatorio.

Valores permitidos: Standard_S1, Free_F1, Premium_P1, Premium_P2
string (obligatorio)
nivel Nivel opcional de esta SKU determinada. 'Estándar' o 'Gratis'.

Basic está en desuso, use Standard en su lugar.
"Básico"
"Gratis"
'Premium'
'Estándar'

RouteSettings (Configuración de ruta)

Nombre Descripción Importancia
connectionBalanceWeight Obtiene o establece el peso del equilibrio de conexión.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes conexiones de servidor.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para todos los casos.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
latencyWeight Obtiene o establece el peso del enrutamiento basado en latencia.
Un valor más alto aumenta la influencia del enrutamiento basado en latencia.
Un valor de 0 deshabilita por completo el enrutamiento basado en latencia, mientras que un valor de 255 lo habilita por completo.
El valor predeterminado es 0.
Se recomienda 255 para réplicas o servidores de aplicaciones en diferentes regiones para la recuperación ante desastres.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
serverBalanceWeight Obtiene o establece el peso del saldo del servidor.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes instancias de servidor de aplicaciones.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para varios servidores de aplicaciones del mismo tamaño.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255

ServerlessSettings

Nombre Descripción Importancia
connectionTimeoutInSeconds Obtiene o establece tiempo de espera de conexión de cliente. Opcional para establecer.
Valor en segundos.
El valor predeterminado es de 30 segundos.
El cliente debe establecer el tiempo de espera en un período más corto si se espera que los mensajes se envíen en intervalos más cortos,
y quiere que el cliente se desconecte más rápidamente después de enviar el último mensaje.
Puede establecer el tiempo de espera en un período más largo si se espera que los mensajes se envíen en intervalos más largos,
y quieren mantener activa la misma conexión de cliente durante esta sesión.
El servicio considera que el cliente está desconectado si no ha recibido un mensaje (incluido keep-alive) en este intervalo.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120
keepAliveIntervalInSeconds Obtiene o establece el intervalo de Keep-Alive. Opcional para establecer.
El valor es en segundos.
El valor predeterminado es de 15 segundos.
Los clientes deben establecer este valor en un período más corto si quieren que el servicio envíe mensajes de mantenimiento con más frecuencia,
garantizando comprobaciones oportunas del estado de conexión.
Por el contrario, los clientes pueden establecer este valor en un período más largo si quieren que el servicio envíe mensajes de mantenimiento activo con menos frecuencia,
Reducir el tráfico de red, pero tenga en cuenta que puede tardar más tiempo en detectar una desconexión.
Este intervalo garantiza que la conexión se mantenga enviando mensajes periódicos de mantenimiento al cliente.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120

ServerlessUpstreamSettings

Nombre Descripción Importancia
Plantillas Obtiene o establece la lista de plantillas de dirección URL ascendentes. El orden es importante y la primera plantilla coincidente tiene efectos. UpstreamTemplate []

SignalRCorsSettings

Nombre Descripción Importancia
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para realizar llamadas entre orígenes (por ejemplo: http://example.com:12345). Use "*" para permitir todo. Si se omite, permita todo de forma predeterminada. cadena[]

SignalRFeature

Nombre Descripción Importancia
bandera FeatureFlags es las características admitidas del servicio Azure SignalR.
- ServiceMode: marca para el servidor back-end para signalR service. Valores permitidos: "Valor predeterminado": tienen su propio servidor back-end; "Sin servidor": la aplicación no tiene un servidor back-end; "Clásico": para la compatibilidad con versiones anteriores. Admite tanto el modo predeterminado como el sin servidor, pero no se recomienda; "PredefinedOnly": para su uso futuro.
- EnableConnectivityLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableMessagingLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableLiveTrace: Live Trace le permite saber lo que sucede dentro del servicio Azure SignalR, le proporcionará seguimientos en vivo en tiempo real, será útil al desarrollar su propia aplicación web basada en Azure SignalR o solucionar algunos problemas. Tenga en cuenta que los seguimientos en directo se cuentan como mensajes salientes que se cobrarán. Valores permitidos: "true"/"false", para habilitar o deshabilitar la característica de seguimiento activo.
'EnableConnectivityLogs'
'EnableLiveTrace'
'HabilitarMensajeríaRegistros'
'ServiceMode' (obligatorio)
Propiedades Propiedades opcionales relacionadas con esta característica. SignalRFeatureProperties
valor Valor de la marca de característica. Consulte el documento de Azure SignalR Service /azure/azure-signalr/ para ver los valores permitidos. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 128 (obligatorio)

SignalRFeatureProperties

Nombre Descripción Importancia

SignalRNetworkACLs

Nombre Descripción Importancia
defaultAction Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Reglas ip para filtrar el tráfico público IPRule []
privateEndpoints ACL para solicitudes de puntos de conexión privados PrivateEndpointACL []
red pública ACL de red RedACL

SignalRProperties

Nombre Descripción Importancia
applicationFirewall Configuración del firewall de aplicaciones para el recurso applicationFirewallSettings
cors Configuración de uso compartido de recursos entre orígenes (CORS). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación de aad
Cuando se establece como true, la conexión con AuthType=aad no funcionará.
booleano
disableLocalAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación local con AccessKey
Cuando se establece como true, la conexión con AccessKey=xxx no funcionará.
booleano
Características Lista de featureFlags.

FeatureFlags que no se incluyen en los parámetros de la operación de actualización no se modificarán.
Y la respuesta solo incluirá featureFlags que se establecen explícitamente.
Cuando un featureFlag no se establece explícitamente, se usará su valor predeterminado global.
Pero tenga en cuenta que el valor predeterminado no significa "false". Varía en términos de características diferentes.
SignalRFeature[]
liveTraceConfiguration Configuración de seguimiento activo de un recurso Microsoft.SignalRService. LiveTraceConfiguration
ACLs de red ACL de red para el recurso SignalRNetworkACLs
publicNetworkAccess Habilite o deshabilite el acceso a la red pública. El valor predeterminado es "Habilitado".
Cuando está habilitado, las ACL de red se siguen aplicando.
Cuando está deshabilitado, el acceso a la red pública siempre está deshabilitado independientemente de lo que establezca en las ACL de red.
cuerda / cadena
regionEndpointEnabled Habilite o deshabilite el punto de conexión regional. El valor predeterminado es "Habilitado".
Cuando está deshabilitado, las nuevas conexiones no se enrutarán a este punto de conexión, pero las conexiones existentes no se verán afectadas.
Esta propiedad es específica de la réplica. No se permite deshabilitar el punto de conexión regional sin réplica.
cuerda / cadena
resourceLogConfiguration Configuración del registro de recursos de un recurso Microsoft.SignalRService. resourceLogConfiguration
resourceStopped Detenga o inicie el recurso. El valor predeterminado es "False".
Cuando se cumple, el plano de datos del recurso se apaga.
Cuando es false, se inicia el plano de datos del recurso.
cuerda / cadena
routeSettings Configuración de ruta para el recurso RouteSettings (Configuración de ruta)
sin servidor Configuración sin servidor. ServerlessSettings
TLS Configuración de TLS para el recurso SignalRTlsSettings
ascendente La configuración de upstream cuando el servicio está en modo sin servidor. ServerlessUpstreamSettings

SignalRTlsSettings

Nombre Descripción Importancia
clientCertEnabled Solicite el certificado de cliente durante el protocolo de enlace TLS si está habilitado. No se admite para el nivel gratis. Cualquier entrada se omitirá para el nivel gratis. booleano

ThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
claimName Nombre de la notificación en el token JWT. La conexión de cliente con el mismo valor de notificación se agregará. Si la notificación no se encuentra en el token, se permitirá la conexión. string (obligatorio)
maxCount Número máximo de conexiones permitido para el mismo valor de notificación Jwt. Los clientes con la misma notificación Jwt se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtCustomClaimRule' (obligatorio)

ThrottleByJwtSignatureRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para la misma firma JWT. Los clientes con la misma firma JWT se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtSignatureRule' (obligatorio)

ThrottleByUserIdRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para el mismo identificador de usuario. Los clientes con el mismo identificador de usuario se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByUserIdRule' (obligatorio)

TrackedResourceTags

Nombre Descripción Importancia

TrafficThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
claimName Nombre de la notificación en el token JWT. Se agregarán los bytes del mensaje con el mismo valor de notificación. Si no se encuentra la notificación en el token, se omitirá la regla. string (obligatorio)
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma notificación JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtCustomClaimRule' (obligatorio)

TrafficThrottleByJwtSignatureRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma firma JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtSignatureRule' (obligatorio)

TrafficThrottleByUserIdRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para el mismo identificador de usuario dentro de un período de tiempo. Los clientes con el mismo identificador de usuario se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByUserIdRule' (obligatorio)

UpstreamAuthSettings

Nombre Descripción Importancia
managedIdentity Configuración de identidad administrada para ascendente. managedIdentitySettings
tipo Enumeración de tipo de autenticación ascendente. 'Identidad administrada'
'Ninguno'

UpstreamTemplate

Nombre Descripción Importancia
autenticación Configuración de autenticación ascendente. Si no se establece, no se usa ninguna autenticación para los mensajes ascendentes. upstreamAuthSettings
categoryPattern Obtiene o establece el patrón coincidente para los nombres de categoría. Si no se establece, coincide con cualquier categoría.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de categoría.
2. Combine varias categorías con ",", por ejemplo "conexiones, mensajes", coincide con la categoría "connections" y "messages".
3. El nombre de categoría único, por ejemplo, "connections", coincide con la categoría "connections".
cuerda / cadena
eventPattern Obtiene o establece el patrón coincidente para los nombres de evento. Si no se establece, coincide con cualquier evento.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de evento.
2. Combine varios eventos con ",", por ejemplo "connect,disconnect", coincide con el evento "connect" y "disconnect".
3. El nombre de evento único, por ejemplo, "connect", coincide con "connect".
cuerda / cadena
hubPattern Obtiene o establece el patrón coincidente para los nombres del centro. Si no se establece, coincide con cualquier centro.
Hay 3 tipos de patrones admitidos:
1. "*", para que coincida con cualquier nombre del centro.
2. Combine varios concentradores con ",", por ejemplo "hub1,hub2", coincide con "hub1" y "hub2".
3. El nombre del concentrador único, por ejemplo, "hub1", coincide con "hub1".
cuerda / cadena
urlTemplate Obtiene o establece la plantilla dirección URL ascendente. Puede usar 3 parámetros predefinidos {hub}, {category} {event} dentro de la plantilla, el valor de la dirección URL ascendente se calcula dinámicamente cuando entra en la solicitud de cliente.
Por ejemplo, si la dirección URLTemplate es http://example.com/{hub}/api/{event}, con una solicitud de cliente del centro de conectividad chat se conecta, primero enviará POST a esta dirección URL: http://example.com/chat/api/connect.
string (obligatorio)

UserAssignedIdentityProperty

Nombre Descripción Importancia

Ejemplos de uso

Plantillas de inicio rápido de Azure

Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.

Plantilla Descripción
Implementación de una de Azure SignalR Service

Implementación en Azure
Esta plantilla crea una instancia de Azure SignalR Service mediante una plantilla.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso signalR se puede implementar con operaciones destinadas a:

  • 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.SignalRService/signalR, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SignalRService/signalR@2025-01-01-preview"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    kind = "string"
    properties = {
      applicationFirewall = {
        clientConnectionCountRules = [
          {
            type = "string"
            // For remaining properties, see ClientConnectionCountRule objects
          }
        ]
        clientTrafficControlRules = [
          {
            type = "string"
            // For remaining properties, see ClientTrafficControlRule objects
          }
        ]
        maxClientConnectionLifetimeInSeconds = int
      }
      cors = {
        allowedOrigins = [
          "string"
        ]
      }
      disableAadAuth = bool
      disableLocalAuth = bool
      features = [
        {
          flag = "string"
          properties = {
            {customized property} = "string"
          }
          value = "string"
        }
      ]
      liveTraceConfiguration = {
        categories = [
          {
            enabled = "string"
            name = "string"
          }
        ]
        enabled = "string"
      }
      networkACLs = {
        defaultAction = "string"
        ipRules = [
          {
            action = "string"
            value = "string"
          }
        ]
        privateEndpoints = [
          {
            allow = [
              "string"
            ]
            deny = [
              "string"
            ]
            name = "string"
          }
        ]
        publicNetwork = {
          allow = [
            "string"
          ]
          deny = [
            "string"
          ]
        }
      }
      publicNetworkAccess = "string"
      regionEndpointEnabled = "string"
      resourceLogConfiguration = {
        categories = [
          {
            enabled = "string"
            name = "string"
          }
        ]
      }
      resourceStopped = "string"
      routeSettings = {
        connectionBalanceWeight = int
        latencyWeight = int
        serverBalanceWeight = int
      }
      serverless = {
        connectionTimeoutInSeconds = int
        keepAliveIntervalInSeconds = int
      }
      tls = {
        clientCertEnabled = bool
      }
      upstream = {
        templates = [
          {
            auth = {
              managedIdentity = {
                resource = "string"
              }
              type = "string"
            }
            categoryPattern = "string"
            eventPattern = "string"
            hubPattern = "string"
            urlTemplate = "string"
          }
        ]
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  }
}

Objetos ClientTrafficControlRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para TrafficThrottleByJwtCustomClaimRule, use:

{
  aggregationWindowInSeconds = int
  claimName = "string"
  maxInboundMessageBytes = int
  type = "TrafficThrottleByJwtCustomClaimRule"
}

Para TrafficThrottleByJwtSignatureRule, use:

{
  aggregationWindowInSeconds = int
  maxInboundMessageBytes = int
  type = "TrafficThrottleByJwtSignatureRule"
}

Para TrafficThrottleByUserIdRule, use:

{
  aggregationWindowInSeconds = int
  maxInboundMessageBytes = int
  type = "TrafficThrottleByUserIdRule"
}

Objetos ClientConnectionCountRule

Establezca el tipo propiedad para especificar el tipo de objeto.

Para ThrottleByJwtCustomClaimRule, use:

{
  claimName = "string"
  maxCount = int
  type = "ThrottleByJwtCustomClaimRule"
}

Para ThrottleByJwtSignatureRule, use:

{
  maxCount = int
  type = "ThrottleByJwtSignatureRule"
}

Para ThrottleByUserIdRule, use:

{
  maxCount = int
  type = "ThrottleByUserIdRule"
}

Valores de propiedad

Microsoft.SignalRService/signalR

Nombre Descripción Importancia
identidad Una clase representa las identidades administradas usadas para la solicitud y la respuesta. ManagedIdentity
amable El tipo de servicio 'RawWebSockets'
'SeñalR'
ubicación Ubicación geográfica donde reside el recurso string (obligatorio)
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 3
Longitud máxima = 63
Patrón = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (obligatorio)
Propiedades Clase que describe las propiedades del recurso SignalRProperties
código SKU Información de facturación del recurso. ResourceSku de
Etiquetas Etiquetas de recursos Diccionario de nombres y valores de etiqueta.
tipo El tipo de recurso "Microsoft.SignalRService/signalR@2025-01-01-preview"

ApplicationFirewallSettings

Nombre Descripción Importancia
clientConnectionCountRules Reglas para controlar el recuento de conexiones de cliente ClientConnectionCountRule []
clientTrafficControlRules Reglas para controlar el tráfico del cliente ClientTrafficControlRule []
maxClientConnectionLifetimeInSeconds Config para controlar la vida útil de la conexión del cliente en segundos, se puede establecer en 0 para deshabilitar la configuración Int

Restricciones:
Valor mínimo = 0
Valor máximo = 604800

ClientConnectionCountRule

Nombre Descripción Importancia
tipo Establezca en "ThrottleByJwtCustomClaimRule" para el tipo ThrottleByJwtCustomClaimRule. Establezca en "ThrottleByJwtSignatureRule" para el tipo ThrottleByJwtSignatureRule. Establezca en "ThrottleByUserIdRule" para el tipo ThrottleByUserIdRule. 'ThrottleByJwtCustomClaimRule'
'ThrottleByJwtSignatureRule'
'ThrottleByUserIdRule' (obligatorio)

ClientTrafficControlRule

Nombre Descripción Importancia
tipo Establezca en "TrafficThrottleByJwtCustomClaimRule" para el tipo TrafficThrottleByJwtCustomClaimRule. Establezca en "TrafficThrottleByJwtSignatureRule" para el tipo TrafficThrottleByJwtSignatureRule. Establezca en "TrafficThrottleByUserIdRule" para el tipo TrafficThrottleByUserIdRule. 'TrafficThrottleByJwtCustomClaimRule'
'TrafficThrottleByJwtSignatureRule'
'TrafficThrottleByUserIdRule' (obligatorio)

IPRule

Nombre Descripción Importancia
acción Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
valor Ip o CIDR o ServiceTag cuerda / cadena

LiveTraceCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de seguimiento activo está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría de seguimiento activo.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

LiveTraceConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. LiveTraceCategory []
Habilitado Indica si habilita o no el seguimiento activo.
Cuando se establece en true, el cliente de seguimiento activo puede conectarse al servicio.
De lo contrario, el cliente de seguimiento activo no puede conectarse al servicio, de modo que no pueda recibir ningún registro, independientemente de lo que configure en "categorías".
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena

Identidad administrada

Nombre Descripción Importancia
tipo Representa el tipo de identidad: systemAssigned, userAssigned, None 'Ninguno'
'SystemAssigned'
'Asignado por el usuario'
identidades asignadas por el usuario Obtener o establecer las identidades asignadas por el usuario ManagedIdentityUserAssignedIdentities

ManagedIdentitySettings

Nombre Descripción Importancia
recurso Recurso que indica el URI del identificador de aplicación del recurso de destino.
También aparece en la notificación aud (audiencia) del token emitido.
cuerda / cadena

ManagedIdentityUserAssignedIdentities

Nombre Descripción Importancia

RedACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'

PrivateEndpointACL

Nombre Descripción Importancia
conceder Tipos de solicitud permitidos. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
denegar Tipos de solicitud denegados. El valor puede ser uno o varios de: ClientConnection, ServerConnection, RESTAPI. Matriz de cadenas que contiene cualquiera de:
'Conexión de cliente'
'RESTAPI'
"ServerConnection"
'Rastro'
nombre Nombre de la conexión de punto de conexión privado string (obligatorio)

ResourceLogCategory

Nombre Descripción Importancia
Habilitado Indica si o la categoría de registro de recursos está habilitada.
Valores disponibles: true, false.
No distingue mayúsculas de minúsculas.
cuerda / cadena
nombre Obtiene o establece el nombre de la categoría del registro de recursos.
Valores disponibles: ConnectivityLogs, MessagingLogs.
No distingue mayúsculas de minúsculas.
cuerda / cadena

ResourceLogConfiguration

Nombre Descripción Importancia
categorías Obtiene o establece la lista de configuraciones de categoría. resourceLogCategory[]

ResourceSku

Nombre Descripción Importancia
capacidad Opcional, entero. Recuento de unidades del recurso.
1 para Free_F1/Standard_S1/Premium_P1, 100 para Premium_P2 de forma predeterminada.

Si está presente, se permiten los siguientes valores:
Free_F1: 1;
Standard_S1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P1: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
Premium_P2: 100.200.300.400.500.600.700.800.900.1000;
Int
nombre El nombre de la SKU. Obligatorio.

Valores permitidos: Standard_S1, Free_F1, Premium_P1, Premium_P2
string (obligatorio)
nivel Nivel opcional de esta SKU determinada. 'Estándar' o 'Gratis'.

Basic está en desuso, use Standard en su lugar.
"Básico"
"Gratis"
'Premium'
'Estándar'

RouteSettings (Configuración de ruta)

Nombre Descripción Importancia
connectionBalanceWeight Obtiene o establece el peso del equilibrio de conexión.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes conexiones de servidor.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para todos los casos.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
latencyWeight Obtiene o establece el peso del enrutamiento basado en latencia.
Un valor más alto aumenta la influencia del enrutamiento basado en latencia.
Un valor de 0 deshabilita por completo el enrutamiento basado en latencia, mientras que un valor de 255 lo habilita por completo.
El valor predeterminado es 0.
Se recomienda 255 para réplicas o servidores de aplicaciones en diferentes regiones para la recuperación ante desastres.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255
serverBalanceWeight Obtiene o establece el peso del saldo del servidor.
Un valor más alto significa un mayor equilibrio de conexiones de cliente entre diferentes instancias de servidor de aplicaciones.
Un valor de 0 distribuye las conexiones de forma aleatoria, mientras que un valor de 255 garantiza el equilibrio máximo.
El valor predeterminado es 255.
Recomendado 255 para varios servidores de aplicaciones del mismo tamaño.
Int

Restricciones:
Valor mínimo = 0
Valor máximo = 255

ServerlessSettings

Nombre Descripción Importancia
connectionTimeoutInSeconds Obtiene o establece tiempo de espera de conexión de cliente. Opcional para establecer.
Valor en segundos.
El valor predeterminado es de 30 segundos.
El cliente debe establecer el tiempo de espera en un período más corto si se espera que los mensajes se envíen en intervalos más cortos,
y quiere que el cliente se desconecte más rápidamente después de enviar el último mensaje.
Puede establecer el tiempo de espera en un período más largo si se espera que los mensajes se envíen en intervalos más largos,
y quieren mantener activa la misma conexión de cliente durante esta sesión.
El servicio considera que el cliente está desconectado si no ha recibido un mensaje (incluido keep-alive) en este intervalo.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120
keepAliveIntervalInSeconds Obtiene o establece el intervalo de Keep-Alive. Opcional para establecer.
El valor es en segundos.
El valor predeterminado es de 15 segundos.
Los clientes deben establecer este valor en un período más corto si quieren que el servicio envíe mensajes de mantenimiento con más frecuencia,
garantizando comprobaciones oportunas del estado de conexión.
Por el contrario, los clientes pueden establecer este valor en un período más largo si quieren que el servicio envíe mensajes de mantenimiento activo con menos frecuencia,
Reducir el tráfico de red, pero tenga en cuenta que puede tardar más tiempo en detectar una desconexión.
Este intervalo garantiza que la conexión se mantenga enviando mensajes periódicos de mantenimiento al cliente.
Int

Restricciones:
Valor mínimo = 1
Valor máximo = 120

ServerlessUpstreamSettings

Nombre Descripción Importancia
Plantillas Obtiene o establece la lista de plantillas de dirección URL ascendentes. El orden es importante y la primera plantilla coincidente tiene efectos. UpstreamTemplate []

SignalRCorsSettings

Nombre Descripción Importancia
allowedOrigins Obtiene o establece la lista de orígenes que se deben permitir para realizar llamadas entre orígenes (por ejemplo: http://example.com:12345). Use "*" para permitir todo. Si se omite, permita todo de forma predeterminada. cadena[]

SignalRFeature

Nombre Descripción Importancia
bandera FeatureFlags es las características admitidas del servicio Azure SignalR.
- ServiceMode: marca para el servidor back-end para signalR service. Valores permitidos: "Valor predeterminado": tienen su propio servidor back-end; "Sin servidor": la aplicación no tiene un servidor back-end; "Clásico": para la compatibilidad con versiones anteriores. Admite tanto el modo predeterminado como el sin servidor, pero no se recomienda; "PredefinedOnly": para su uso futuro.
- EnableConnectivityLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableMessagingLogs: "true"/"false", para habilitar o deshabilitar la categoría del registro de conectividad respectivamente.
- EnableLiveTrace: Live Trace le permite saber lo que sucede dentro del servicio Azure SignalR, le proporcionará seguimientos en vivo en tiempo real, será útil al desarrollar su propia aplicación web basada en Azure SignalR o solucionar algunos problemas. Tenga en cuenta que los seguimientos en directo se cuentan como mensajes salientes que se cobrarán. Valores permitidos: "true"/"false", para habilitar o deshabilitar la característica de seguimiento activo.
'EnableConnectivityLogs'
'EnableLiveTrace'
'HabilitarMensajeríaRegistros'
'ServiceMode' (obligatorio)
Propiedades Propiedades opcionales relacionadas con esta característica. SignalRFeatureProperties
valor Valor de la marca de característica. Consulte el documento de Azure SignalR Service /azure/azure-signalr/ para ver los valores permitidos. cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 128 (obligatorio)

SignalRFeatureProperties

Nombre Descripción Importancia

SignalRNetworkACLs

Nombre Descripción Importancia
defaultAction Acción de ACL de redes de Azure. 'Permitir'
'Denegar'
ipRules (Reglas de ip) Reglas ip para filtrar el tráfico público IPRule []
privateEndpoints ACL para solicitudes de puntos de conexión privados PrivateEndpointACL []
red pública ACL de red RedACL

SignalRProperties

Nombre Descripción Importancia
applicationFirewall Configuración del firewall de aplicaciones para el recurso applicationFirewallSettings
cors Configuración de uso compartido de recursos entre orígenes (CORS). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación de aad
Cuando se establece como true, la conexión con AuthType=aad no funcionará.
booleano
disableLocalAuth DisableLocalAuth
Habilitación o deshabilitación de la autenticación local con AccessKey
Cuando se establece como true, la conexión con AccessKey=xxx no funcionará.
booleano
Características Lista de featureFlags.

FeatureFlags que no se incluyen en los parámetros de la operación de actualización no se modificarán.
Y la respuesta solo incluirá featureFlags que se establecen explícitamente.
Cuando un featureFlag no se establece explícitamente, se usará su valor predeterminado global.
Pero tenga en cuenta que el valor predeterminado no significa "false". Varía en términos de características diferentes.
SignalRFeature[]
liveTraceConfiguration Configuración de seguimiento activo de un recurso Microsoft.SignalRService. LiveTraceConfiguration
ACLs de red ACL de red para el recurso SignalRNetworkACLs
publicNetworkAccess Habilite o deshabilite el acceso a la red pública. El valor predeterminado es "Habilitado".
Cuando está habilitado, las ACL de red se siguen aplicando.
Cuando está deshabilitado, el acceso a la red pública siempre está deshabilitado independientemente de lo que establezca en las ACL de red.
cuerda / cadena
regionEndpointEnabled Habilite o deshabilite el punto de conexión regional. El valor predeterminado es "Habilitado".
Cuando está deshabilitado, las nuevas conexiones no se enrutarán a este punto de conexión, pero las conexiones existentes no se verán afectadas.
Esta propiedad es específica de la réplica. No se permite deshabilitar el punto de conexión regional sin réplica.
cuerda / cadena
resourceLogConfiguration Configuración del registro de recursos de un recurso Microsoft.SignalRService. resourceLogConfiguration
resourceStopped Detenga o inicie el recurso. El valor predeterminado es "False".
Cuando se cumple, el plano de datos del recurso se apaga.
Cuando es false, se inicia el plano de datos del recurso.
cuerda / cadena
routeSettings Configuración de ruta para el recurso RouteSettings (Configuración de ruta)
sin servidor Configuración sin servidor. ServerlessSettings
TLS Configuración de TLS para el recurso SignalRTlsSettings
ascendente La configuración de upstream cuando el servicio está en modo sin servidor. ServerlessUpstreamSettings

SignalRTlsSettings

Nombre Descripción Importancia
clientCertEnabled Solicite el certificado de cliente durante el protocolo de enlace TLS si está habilitado. No se admite para el nivel gratis. Cualquier entrada se omitirá para el nivel gratis. booleano

ThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
claimName Nombre de la notificación en el token JWT. La conexión de cliente con el mismo valor de notificación se agregará. Si la notificación no se encuentra en el token, se permitirá la conexión. string (obligatorio)
maxCount Número máximo de conexiones permitido para el mismo valor de notificación Jwt. Los clientes con la misma notificación Jwt se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtCustomClaimRule' (obligatorio)

ThrottleByJwtSignatureRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para la misma firma JWT. Los clientes con la misma firma JWT se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByJwtSignatureRule' (obligatorio)

ThrottleByUserIdRule

Nombre Descripción Importancia
maxCount Número máximo de conexiones permitido para el mismo identificador de usuario. Los clientes con el mismo identificador de usuario se rechazarán si el recuento de conexiones supera este valor. El valor predeterminado es 20. Int

Restricciones:
Valor mínimo = 0
Valor máximo = 2147483647
tipo 'ThrottleByUserIdRule' (obligatorio)

TrackedResourceTags

Nombre Descripción Importancia

TrafficThrottleByJwtCustomClaimRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
claimName Nombre de la notificación en el token JWT. Se agregarán los bytes del mensaje con el mismo valor de notificación. Si no se encuentra la notificación en el token, se omitirá la regla. string (obligatorio)
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma notificación JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtCustomClaimRule' (obligatorio)

TrafficThrottleByJwtSignatureRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para la misma firma JWT dentro de un período de tiempo. Los clientes con la misma firma JWT se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByJwtSignatureRule' (obligatorio)

TrafficThrottleByUserIdRule

Nombre Descripción Importancia
aggregationWindowInSeconds Ventana de agregación para los bytes del mensaje. Los bytes del mensaje se agregarán en esta ventana y se restablecerán después de la ventana. El valor predeterminado es de 60 segundos. Int

Restricciones:
Valor mínimo = 10
Valor máximo = 3600
maxInboundMessageBytes Número máximo de bytes de mensajes entrantes acumulados permitidos para el mismo identificador de usuario dentro de un período de tiempo. Los clientes con el mismo identificador de usuario se desconectarán si los bytes del mensaje superan este valor. El valor predeterminado es de 1 GB. Int

Restricciones:
Valor mínimo = 0
tipo 'TrafficThrottleByUserIdRule' (obligatorio)

UpstreamAuthSettings

Nombre Descripción Importancia
managedIdentity Configuración de identidad administrada para ascendente. managedIdentitySettings
tipo Enumeración de tipo de autenticación ascendente. 'Identidad administrada'
'Ninguno'

UpstreamTemplate

Nombre Descripción Importancia
autenticación Configuración de autenticación ascendente. Si no se establece, no se usa ninguna autenticación para los mensajes ascendentes. upstreamAuthSettings
categoryPattern Obtiene o establece el patrón coincidente para los nombres de categoría. Si no se establece, coincide con cualquier categoría.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de categoría.
2. Combine varias categorías con ",", por ejemplo "conexiones, mensajes", coincide con la categoría "connections" y "messages".
3. El nombre de categoría único, por ejemplo, "connections", coincide con la categoría "connections".
cuerda / cadena
eventPattern Obtiene o establece el patrón coincidente para los nombres de evento. Si no se establece, coincide con cualquier evento.
Hay 3 tipos de patrones admitidos:
1. "*", coincide con cualquier nombre de evento.
2. Combine varios eventos con ",", por ejemplo "connect,disconnect", coincide con el evento "connect" y "disconnect".
3. El nombre de evento único, por ejemplo, "connect", coincide con "connect".
cuerda / cadena
hubPattern Obtiene o establece el patrón coincidente para los nombres del centro. Si no se establece, coincide con cualquier centro.
Hay 3 tipos de patrones admitidos:
1. "*", para que coincida con cualquier nombre del centro.
2. Combine varios concentradores con ",", por ejemplo "hub1,hub2", coincide con "hub1" y "hub2".
3. El nombre del concentrador único, por ejemplo, "hub1", coincide con "hub1".
cuerda / cadena
urlTemplate Obtiene o establece la plantilla dirección URL ascendente. Puede usar 3 parámetros predefinidos {hub}, {category} {event} dentro de la plantilla, el valor de la dirección URL ascendente se calcula dinámicamente cuando entra en la solicitud de cliente.
Por ejemplo, si la dirección URLTemplate es http://example.com/{hub}/api/{event}, con una solicitud de cliente del centro de conectividad chat se conecta, primero enviará POST a esta dirección URL: http://example.com/chat/api/connect.
string (obligatorio)

UserAssignedIdentityProperty

Nombre Descripción Importancia