Dela via


Microsoft.SignalRService signalR

Bicep-resursdefinition

SignalR-resurstypen kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.SignalRService/signalR-resurs lägger du till följande Bicep i mallen.

resource symbolicname 'Microsoft.SignalRService/signalR@2024-10-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
        }
      ]
    }
    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'
    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'
  }
}

ClientTrafficControlRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För TrafficThrottleByJwtCustomClaimRuleanvänder du:

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

För TrafficThrottleByJwtSignatureRuleanvänder du:

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

För TrafficThrottleByUserIdRuleanvänder du:

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

ClientConnectionCountRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För ThrottleByJwtCustomClaimRuleanvänder du:

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

För ThrottleByJwtSignatureRuleanvänder du:

{
  maxCount: int
  type: 'ThrottleByJwtSignatureRule'
}

För ThrottleByUserIdRuleanvänder du:

{
  maxCount: int
  type: 'ThrottleByUserIdRule'
}

Egenskapsvärden

ApplicationFirewallSettings

Namn Beskrivning Värde
clientConnectionCountRules Regler för att kontrollera antalet klientanslutningar ClientConnectionCountRule[]
clientTrafficControlRules Regler för att styra klienttrafiken ClientTrafficControlRule[]

ClientConnectionCountRule

Namn Beskrivning Värde
typ Ange till "ThrottleByJwtCustomClaimRule" för typen ThrottleByJwtCustomClaimRule. Ange till "ThrottleByJwtSignatureRule" för typen ThrottleByJwtSignatureRule. Ange till "ThrottleByUserIdRule" för typ ThrottleByUserIdRule. "ThrottleByJwtCustomClaimRule"
"ThrottleByJwtSignatureRule"
"ThrottleByUserIdRule" (krävs)

ClientTrafficControlRule

Namn Beskrivning Värde
typ Ange till "TrafficThrottleByJwtCustomClaimRule" för typen TrafficThrottleByJwtCustomClaimRule. Ange till TrafficThrottleByJwtSignatureRule för typen TrafficThrottleByJwtSignatureRule. Ange till TrafficThrottleByUserIdRule för typ TrafficThrottleByUserIdRule. "TrafficThrottleByJwtCustomClaimRule"
"TrafficThrottleByJwtSignatureRule"
"TrafficThrottleByUserIdRule" (krävs)

IPRule

Namn Beskrivning Värde
handling Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
värde En IP-adress eller CIDR eller ServiceTag sträng

LiveTraceCategory

Namn Beskrivning Värde
Aktiverat Anger om eller livespårningskategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger namnet på livespårningskategorin.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

LiveTraceConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. LiveTraceCategory[]
Aktiverat Anger om aktivering av livespårning ska aktiveras eller inte.
När den är inställd på true kan livespårningsklienten ansluta till tjänsten.
Annars kan livespårningsklienten inte ansluta till tjänsten, så att du inte kan ta emot någon logg, oavsett vad du konfigurerar i "kategorier".
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng

Hanterad identitet

Namn Beskrivning Värde
typ Representerar identitetstypen: systemAssigned, userAssigned, None "Ingen"
"SystemAssigned"
"UserAssigned"
userAssignedIdentities Hämta eller ange användartilldelade identiteter ManagedIdentityUserAssignedIdentiteter

ManagedIdentitySettings

Namn Beskrivning Värde
resurs Resursen som anger app-ID-URI:n för målresursen.
Det visas också i aud-anspråket (målgruppen) för den utfärdade token.
sträng

ManagedIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.SignalRService/signalR

Namn Beskrivning Värde
identitet En klass representerar hanterade identiteter som används för begäran och svar ManagedIdentity
sort Typen av tjänst "RawWebSockets"
"SignalR"
plats Den geo-plats där resursen finns sträng (krävs)
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Max längd = 63
Mönster = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (krävs)
Egenskaper En klass som beskriver resursens egenskaper SignalRProperties
Sku Faktureringsinformation för resursen. ResourceSku
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar

NetworkACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"

PrivateEndpointACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
Namn Namnet på den privata slutpunktsanslutningen sträng (krävs)

ResourceLogCategory

Namn Beskrivning Värde
Aktiverat Anger om eller resursloggkategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger resursloggkategorins namn.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

ResourceLogConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. ResourceLogCategory[]

ResourceSku

Namn Beskrivning Värde
kapacitet Valfritt heltal. Antalet enheter för resursen.
1 för Free_F1/Standard_S1/Premium_P1, 100 för Premium_P2 som standard.

Om det finns tillåts följande värden:
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
Namn Namnet på SKU:n. Krävs.

Tillåtna värden: Standard_S1, Free_F1, Premium_P1, Premium_P2
sträng (krävs)
Nivå Valfri nivå för den här specifika SKU:n. "Standard" eller "Kostnadsfri".

Basic är inaktuell använder du Standard i stället.
"Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ServerlessSettings

Namn Beskrivning Värde
connectionTimeoutInSeconds Hämtar eller anger tidsgränsen för klientanslutning. Valfritt att ställa in.
Värde i sekunder.
Standardvärdet är 30 sekunder.
Kunden bör ange tidsgränsen till en kortare period om meddelanden förväntas skickas med kortare intervall.
och vill att klienten ska kopplas från snabbare när det senaste meddelandet har skickats.
Du kan ange tidsgränsen till en längre period om meddelanden förväntas skickas med längre intervall.
och de vill hålla samma klientanslutning vid liv under den här sessionen.
Tjänsten anser att klienten är frånkopplad om den inte har tagit emot ett meddelande (inklusive keep-alive) i det här intervallet.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120
keepAliveIntervalInSeconds Hämtar eller anger Keep-Alive intervall. Valfritt att ange.
Värdet är i sekunder.
Standardvärdet är 15 sekunder.
Kunder bör ange det här värdet till en kortare period om de vill att tjänsten ska skicka keep-alive-meddelanden oftare,
se till att anslutningsstatusen kontrolleras i tid.
Kunderna kan däremot ange det här värdet till en längre period om de vill att tjänsten ska skicka keep-alive-meddelanden mindre ofta.
minska nätverkstrafiken, men observera att det kan ta längre tid att identifiera en frånkoppling.
Det här intervallet säkerställer att anslutningen underhålls genom att periodiska keep-alive-meddelanden skickas till klienten.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120

ServerlessUpstreamSettings

Namn Beskrivning Värde
Mallar Hämtar eller anger listan över överordnade URL-mallar. Ordningen är viktig och den första matchande mallen får effekter. UpstreamTemplate[]

SignalRCorsSettings

Namn Beskrivning Värde
allowedOrigins Hämtar eller anger den lista över ursprung som ska tillåtas att göra korsande anrop (till exempel: http://example.com:12345). Använd "*" för att tillåta alla. Om det utelämnas tillåter du alla som standard. string[]

SignalRFeature

Namn Beskrivning Värde
flagga FeatureFlags är de funktioner som stöds i Azure SignalR-tjänsten.
– ServiceMode: Flagga för serverdelsserver för SignalR-tjänsten. Värden tillåtna: "Standard": har en egen serverdelsserver; "Serverlös": programmet har ingen serverdelsserver. "Klassisk": för bakåtkompatibilitet. Stöd för både standardläge och serverlöst läge men rekommenderas inte. "PredefinedOnly": för framtida användning.
– EnableConnectivityLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableMessagingLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableLiveTrace: Med Live Trace kan du veta vad som händer i Azure SignalR-tjänsten, det ger dig livespårningar i realtid. Det är användbart när du utvecklar ett eget Azure SignalR-baserat webbprogram eller själv felsöker några problem. Observera att livespårningar räknas som utgående meddelanden som debiteras. Värden tillåts: "true"/"false", för att aktivera/inaktivera funktionen för livespårning.
"EnableConnectivityLogs"
"EnableLiveTrace"
"EnableMessagingLogs"
"ServiceMode" (krävs)
Egenskaper Valfria egenskaper som är relaterade till den här funktionen. SignalRFeatureProperties
värde Värdet för funktionsflaggan. Se Azure SignalR Service-dokumentet /azure/azure-signalr/ för tillåtna värden. sträng

Begränsningar:
Min längd = 1
Maximal längd = 128 (krävs)

SignalRFeatureProperties

Namn Beskrivning Värde

SignalRNetworkACLs

Namn Beskrivning Värde
defaultAction Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
ipRules IP-regler för filtrering av offentlig trafik IPRule[]
privateEndpoints ACL:er för begäranden från privata slutpunkter PrivateEndpointACL[]
publicNetwork Nätverks-ACL NetworkACL

SignalRProperties

Namn Beskrivning Värde
applicationFirewall Programbrandväggsinställningar för resursen ApplicationFirewallSettings
cors CORS-inställningar (Cross-Origin Resource Sharing). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Aktivera eller inaktivera aad-autentisering
När värdet är true fungerar inte anslutningen med AuthType=aad.
Bool
disableLocalAuth DisableLocalAuth
Aktivera eller inaktivera lokal autentisering med AccessKey
När värdet är true fungerar inte anslutningen med AccessKey=xxx.
Bool
Funktioner Lista över featureFlags.

FeatureFlags som inte ingår i parametrarna för uppdateringsåtgärden ändras inte.
Och svaret innehåller endast featureFlags som uttryckligen anges.
När en featureFlag inte uttryckligen anges används dess globala standardvärde
Men kom ihåg att standardvärdet inte betyder "false". Det varierar beroende på olika FeatureFlags.
SignalRFeature[]
liveTraceConfiguration Livespårningskonfiguration av en Microsoft.SignalRService-resurs. LiveTraceConfiguration
networkACLs Nätverks-ACL:er för resursen SignalRNetworkACLs
publicNetworkAccess Aktivera eller inaktivera åtkomst till offentligt nätverk. Standardvärdet är "Aktiverad".
När den är aktiverad gäller fortfarande nätverks-ACL:er.
När den är inaktiverad inaktiveras alltid åtkomsten till det offentliga nätverket oavsett vad du anger i nätverks-ACL:er.
sträng
regionEndpointEnabled Aktivera eller inaktivera den regionala slutpunkten. Standardvärdet är "Aktiverad".
När den är inaktiverad dirigeras inte nya anslutningar till den här slutpunkten, men befintliga anslutningar påverkas inte.
Den här egenskapen är replikspecifik. Inaktivera den regionala slutpunkten utan replik tillåts inte.
sträng
resourceLogConfiguration Konfiguration av resurslogg för en Microsoft.SignalRService-resurs. ResourceLogConfiguration
resourceStopad Stoppa eller starta resursen. Standardvärdet är "False".
När det är sant stängs resursens dataplan av.
När det är falskt startas resursens dataplan.
sträng
serverlös Serverlösa inställningar. ServerlessSettings
tls TLS-inställningar för resursen SignalRTlsSettings
uppströms Inställningarna för Upstream när tjänsten är i serverlöst läge. ServerlessUpstreamSettings

SignalRTlsSettings

Namn Beskrivning Värde
clientCertEnabled Begär klientcertifikat under TLS-handskakning om det är aktiverat. Stöds inte för den kostnadsfria nivån. Alla indata ignoreras för den kostnadsfria nivån. Bool

ThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
claimName Namnet på anspråket i JWT-token. Klientanslutningen med samma anspråksvärde aggregeras. Om anspråket inte hittas i token tillåts anslutningen. sträng (krävs)
maxCount Maximalt antal anslutningar som tillåts för samma Jwt-anspråksvärde. Klienter med samma Jwt-anspråk avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtCustomClaimRule" (krävs)

ThrottleByJwtSignatureRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma JWT-signatur. Klienter med samma JWT-signatur avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtSignatureRule" (krävs)

ThrottleByUserIdRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma användar-ID. Klienter med samma användar-ID avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByUserIdRule" (krävs)

TrackedResourceTags

Namn Beskrivning Värde

TrafficThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
claimName Namnet på anspråket i JWT-token. Meddelandets byte med samma anspråksvärde aggregeras. Om anspråket inte hittas i token hoppas regeln över. sträng (krävs)
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-anspråk kopplas från om meddelandebytena överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtCustomClaimRule" (krävs)

TrafficThrottleByJwtSignatureRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-signatur kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtSignatureRule" (krävs)

TrafficThrottleByUserIdRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma användar-ID inom en tidsperiod. Klienter med samma användar-ID kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByUserIdRule" (krävs)

UpstreamAuthSettings

Namn Beskrivning Värde
managedIdentity Hanterade identitetsinställningar för uppströms. ManagedIdentitySettings
typ Uppströms autentiseringstyp uppräkning. "ManagedIdentity"
"Ingen"

UpstreamTemplate

Namn Beskrivning Värde
Auth Inställningar för överordnad autentisering. Om den inte har angetts används ingen autentisering för överordnade meddelanden. UpstreamAuthSettings
categoryPattern Hämtar eller anger matchningsmönstret för kategorinamn. Om den inte har angetts matchar den alla kategorier.
Det finns tre typer av mönster som stöds:
1. "*", den matchar valfritt kategorinamn.
2. Kombinera flera kategorier med ",", till exempel "anslutningar,meddelanden", matchar kategorin "anslutningar" och "meddelanden".
3. Namnet på en kategori, till exempel "anslutningar", matchar kategorin "anslutningar".
sträng
eventPattern Hämtar eller anger matchningsmönstret för händelsenamn. Om den inte har angetts matchar den alla händelser.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla händelsenamn.
2. Kombinera flera händelser med ",", till exempel "anslut,koppla från", matchar händelsen "anslut" och "koppla från".
3. Det enskilda händelsenamnet, till exempel "anslut", matchar "anslut".
sträng
hubPattern Hämtar eller anger matchningsmönstret för hubbnamn. Om den inte har angetts matchar den alla hubbar.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla hubbnamn.
2. Kombinera flera hubbar med "", till exempel "hub1,hub2", matchar det "hub1" och "hub2".
3. Namnet på den enskilda hubben, till exempel "hub1", matchar "hub1".
sträng
urlTemplate Hämtar eller ställer in mallen Överordnad URL. Du kan använda tre fördefinierade parametrar {hub}, {category} {event} i mallen. Värdet för den överordnade URL:en beräknas dynamiskt när klientbegäran kommer in.
Om urlTemplate till exempel är http://example.com/{hub}/api/{event}, med en klientbegäran från hubben chat ansluter, skickas den först till den här URL:en: http://example.com/chat/api/connect.
sträng (krävs)

UserAssignedIdentityProperty

Namn Beskrivning Värde

Snabbstartsexempel

Följande snabbstartsexempel distribuerar den här resurstypen.

Bicep-fil Beskrivning
Distribuera en Azure SignalR-tjänst Den här mallen skapar en Azure SignalR Service med hjälp av en mall.

Resursdefinition för ARM-mall

SignalR-resurstypen kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.SignalRService/signalR-resurs lägger du till följande JSON i mallen.

{
  "type": "Microsoft.SignalRService/signalR",
  "apiVersion": "2024-10-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
      } ]
    },
    "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",
    "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"
  }
}

ClientTrafficControlRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För TrafficThrottleByJwtCustomClaimRuleanvänder du:

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

För TrafficThrottleByJwtSignatureRuleanvänder du:

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

För TrafficThrottleByUserIdRuleanvänder du:

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

ClientConnectionCountRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För ThrottleByJwtCustomClaimRuleanvänder du:

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

För ThrottleByJwtSignatureRuleanvänder du:

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

För ThrottleByUserIdRuleanvänder du:

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

Egenskapsvärden

ApplicationFirewallSettings

Namn Beskrivning Värde
clientConnectionCountRules Regler för att kontrollera antalet klientanslutningar ClientConnectionCountRule[]
clientTrafficControlRules Regler för att styra klienttrafiken ClientTrafficControlRule[]

ClientConnectionCountRule

Namn Beskrivning Värde
typ Ange till "ThrottleByJwtCustomClaimRule" för typen ThrottleByJwtCustomClaimRule. Ange till "ThrottleByJwtSignatureRule" för typen ThrottleByJwtSignatureRule. Ange till "ThrottleByUserIdRule" för typ ThrottleByUserIdRule. "ThrottleByJwtCustomClaimRule"
"ThrottleByJwtSignatureRule"
"ThrottleByUserIdRule" (krävs)

ClientTrafficControlRule

Namn Beskrivning Värde
typ Ange till "TrafficThrottleByJwtCustomClaimRule" för typen TrafficThrottleByJwtCustomClaimRule. Ange till TrafficThrottleByJwtSignatureRule för typen TrafficThrottleByJwtSignatureRule. Ange till TrafficThrottleByUserIdRule för typ TrafficThrottleByUserIdRule. "TrafficThrottleByJwtCustomClaimRule"
"TrafficThrottleByJwtSignatureRule"
"TrafficThrottleByUserIdRule" (krävs)

IPRule

Namn Beskrivning Värde
handling Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
värde En IP-adress eller CIDR eller ServiceTag sträng

LiveTraceCategory

Namn Beskrivning Värde
Aktiverat Anger om eller livespårningskategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger namnet på livespårningskategorin.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

LiveTraceConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. LiveTraceCategory[]
Aktiverat Anger om aktivering av livespårning ska aktiveras eller inte.
När den är inställd på true kan livespårningsklienten ansluta till tjänsten.
Annars kan livespårningsklienten inte ansluta till tjänsten, så att du inte kan ta emot någon logg, oavsett vad du konfigurerar i "kategorier".
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng

Hanterad identitet

Namn Beskrivning Värde
typ Representerar identitetstypen: systemAssigned, userAssigned, None "Ingen"
"SystemAssigned"
"UserAssigned"
userAssignedIdentities Hämta eller ange användartilldelade identiteter ManagedIdentityUserAssignedIdentiteter

ManagedIdentitySettings

Namn Beskrivning Värde
resurs Resursen som anger app-ID-URI:n för målresursen.
Det visas också i aud-anspråket (målgruppen) för den utfärdade token.
sträng

ManagedIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.SignalRService/signalR

Namn Beskrivning Värde
apiVersion API-versionen "2024-10-01-preview"
identitet En klass representerar hanterade identiteter som används för begäran och svar ManagedIdentity
sort Typen av tjänst "RawWebSockets"
"SignalR"
plats Den geo-plats där resursen finns sträng (krävs)
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Max längd = 63
Mönster = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (krävs)
Egenskaper En klass som beskriver resursens egenskaper SignalRProperties
Sku Faktureringsinformation för resursen. ResourceSku
Taggar Resurstaggar Ordlista med taggnamn och värden. Se taggar i mallar
typ Resurstypen "Microsoft.SignalRService/signalR"

NetworkACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"

PrivateEndpointACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
Namn Namnet på den privata slutpunktsanslutningen sträng (krävs)

ResourceLogCategory

Namn Beskrivning Värde
Aktiverat Anger om eller resursloggkategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger resursloggkategorins namn.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

ResourceLogConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. ResourceLogCategory[]

ResourceSku

Namn Beskrivning Värde
kapacitet Valfritt heltal. Antalet enheter för resursen.
1 för Free_F1/Standard_S1/Premium_P1, 100 för Premium_P2 som standard.

Om det finns tillåts följande värden:
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
Namn Namnet på SKU:n. Krävs.

Tillåtna värden: Standard_S1, Free_F1, Premium_P1, Premium_P2
sträng (krävs)
Nivå Valfri nivå för den här specifika SKU:n. "Standard" eller "Kostnadsfri".

Basic är inaktuell använder du Standard i stället.
"Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ServerlessSettings

Namn Beskrivning Värde
connectionTimeoutInSeconds Hämtar eller anger tidsgränsen för klientanslutning. Valfritt att ställa in.
Värde i sekunder.
Standardvärdet är 30 sekunder.
Kunden bör ange tidsgränsen till en kortare period om meddelanden förväntas skickas med kortare intervall.
och vill att klienten ska kopplas från snabbare när det senaste meddelandet har skickats.
Du kan ange tidsgränsen till en längre period om meddelanden förväntas skickas med längre intervall.
och de vill hålla samma klientanslutning vid liv under den här sessionen.
Tjänsten anser att klienten är frånkopplad om den inte har tagit emot ett meddelande (inklusive keep-alive) i det här intervallet.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120
keepAliveIntervalInSeconds Hämtar eller anger Keep-Alive intervall. Valfritt att ange.
Värdet är i sekunder.
Standardvärdet är 15 sekunder.
Kunder bör ange det här värdet till en kortare period om de vill att tjänsten ska skicka keep-alive-meddelanden oftare,
se till att anslutningsstatusen kontrolleras i tid.
Kunderna kan däremot ange det här värdet till en längre period om de vill att tjänsten ska skicka keep-alive-meddelanden mindre ofta.
minska nätverkstrafiken, men observera att det kan ta längre tid att identifiera en frånkoppling.
Det här intervallet säkerställer att anslutningen underhålls genom att periodiska keep-alive-meddelanden skickas till klienten.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120

ServerlessUpstreamSettings

Namn Beskrivning Värde
Mallar Hämtar eller anger listan över överordnade URL-mallar. Ordningen är viktig och den första matchande mallen får effekter. UpstreamTemplate[]

SignalRCorsSettings

Namn Beskrivning Värde
allowedOrigins Hämtar eller anger den lista över ursprung som ska tillåtas att göra korsande anrop (till exempel: http://example.com:12345). Använd "*" för att tillåta alla. Om det utelämnas tillåter du alla som standard. string[]

SignalRFeature

Namn Beskrivning Värde
flagga FeatureFlags är de funktioner som stöds i Azure SignalR-tjänsten.
– ServiceMode: Flagga för serverdelsserver för SignalR-tjänsten. Värden tillåtna: "Standard": har en egen serverdelsserver; "Serverlös": programmet har ingen serverdelsserver. "Klassisk": för bakåtkompatibilitet. Stöd för både standardläge och serverlöst läge men rekommenderas inte. "PredefinedOnly": för framtida användning.
– EnableConnectivityLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableMessagingLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableLiveTrace: Med Live Trace kan du veta vad som händer i Azure SignalR-tjänsten, det ger dig livespårningar i realtid. Det är användbart när du utvecklar ett eget Azure SignalR-baserat webbprogram eller själv felsöker några problem. Observera att livespårningar räknas som utgående meddelanden som debiteras. Värden tillåts: "true"/"false", för att aktivera/inaktivera funktionen för livespårning.
"EnableConnectivityLogs"
"EnableLiveTrace"
"EnableMessagingLogs"
"ServiceMode" (krävs)
Egenskaper Valfria egenskaper som är relaterade till den här funktionen. SignalRFeatureProperties
värde Värdet för funktionsflaggan. Se Azure SignalR Service-dokumentet /azure/azure-signalr/ för tillåtna värden. sträng

Begränsningar:
Min längd = 1
Maximal längd = 128 (krävs)

SignalRFeatureProperties

Namn Beskrivning Värde

SignalRNetworkACLs

Namn Beskrivning Värde
defaultAction Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
ipRules IP-regler för filtrering av offentlig trafik IPRule[]
privateEndpoints ACL:er för begäranden från privata slutpunkter PrivateEndpointACL[]
publicNetwork Nätverks-ACL NetworkACL

SignalRProperties

Namn Beskrivning Värde
applicationFirewall Programbrandväggsinställningar för resursen ApplicationFirewallSettings
cors CORS-inställningar (Cross-Origin Resource Sharing). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Aktivera eller inaktivera aad-autentisering
När värdet är true fungerar inte anslutningen med AuthType=aad.
Bool
disableLocalAuth DisableLocalAuth
Aktivera eller inaktivera lokal autentisering med AccessKey
När värdet är true fungerar inte anslutningen med AccessKey=xxx.
Bool
Funktioner Lista över featureFlags.

FeatureFlags som inte ingår i parametrarna för uppdateringsåtgärden ändras inte.
Och svaret innehåller endast featureFlags som uttryckligen anges.
När en featureFlag inte uttryckligen anges används dess globala standardvärde
Men kom ihåg att standardvärdet inte betyder "false". Det varierar beroende på olika FeatureFlags.
SignalRFeature[]
liveTraceConfiguration Livespårningskonfiguration av en Microsoft.SignalRService-resurs. LiveTraceConfiguration
networkACLs Nätverks-ACL:er för resursen SignalRNetworkACLs
publicNetworkAccess Aktivera eller inaktivera åtkomst till offentligt nätverk. Standardvärdet är "Aktiverad".
När den är aktiverad gäller fortfarande nätverks-ACL:er.
När den är inaktiverad inaktiveras alltid åtkomsten till det offentliga nätverket oavsett vad du anger i nätverks-ACL:er.
sträng
regionEndpointEnabled Aktivera eller inaktivera den regionala slutpunkten. Standardvärdet är "Aktiverad".
När den är inaktiverad dirigeras inte nya anslutningar till den här slutpunkten, men befintliga anslutningar påverkas inte.
Den här egenskapen är replikspecifik. Inaktivera den regionala slutpunkten utan replik tillåts inte.
sträng
resourceLogConfiguration Konfiguration av resurslogg för en Microsoft.SignalRService-resurs. ResourceLogConfiguration
resourceStopad Stoppa eller starta resursen. Standardvärdet är "False".
När det är sant stängs resursens dataplan av.
När det är falskt startas resursens dataplan.
sträng
serverlös Serverlösa inställningar. ServerlessSettings
tls TLS-inställningar för resursen SignalRTlsSettings
uppströms Inställningarna för Upstream när tjänsten är i serverlöst läge. ServerlessUpstreamSettings

SignalRTlsSettings

Namn Beskrivning Värde
clientCertEnabled Begär klientcertifikat under TLS-handskakning om det är aktiverat. Stöds inte för den kostnadsfria nivån. Alla indata ignoreras för den kostnadsfria nivån. Bool

ThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
claimName Namnet på anspråket i JWT-token. Klientanslutningen med samma anspråksvärde aggregeras. Om anspråket inte hittas i token tillåts anslutningen. sträng (krävs)
maxCount Maximalt antal anslutningar som tillåts för samma Jwt-anspråksvärde. Klienter med samma Jwt-anspråk avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtCustomClaimRule" (krävs)

ThrottleByJwtSignatureRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma JWT-signatur. Klienter med samma JWT-signatur avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtSignatureRule" (krävs)

ThrottleByUserIdRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma användar-ID. Klienter med samma användar-ID avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByUserIdRule" (krävs)

TrackedResourceTags

Namn Beskrivning Värde

TrafficThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
claimName Namnet på anspråket i JWT-token. Meddelandets byte med samma anspråksvärde aggregeras. Om anspråket inte hittas i token hoppas regeln över. sträng (krävs)
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-anspråk kopplas från om meddelandebytena överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtCustomClaimRule" (krävs)

TrafficThrottleByJwtSignatureRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-signatur kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtSignatureRule" (krävs)

TrafficThrottleByUserIdRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma användar-ID inom en tidsperiod. Klienter med samma användar-ID kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByUserIdRule" (krävs)

UpstreamAuthSettings

Namn Beskrivning Värde
managedIdentity Hanterade identitetsinställningar för uppströms. ManagedIdentitySettings
typ Uppströms autentiseringstyp uppräkning. "ManagedIdentity"
"Ingen"

UpstreamTemplate

Namn Beskrivning Värde
Auth Inställningar för överordnad autentisering. Om den inte har angetts används ingen autentisering för överordnade meddelanden. UpstreamAuthSettings
categoryPattern Hämtar eller anger matchningsmönstret för kategorinamn. Om den inte har angetts matchar den alla kategorier.
Det finns tre typer av mönster som stöds:
1. "*", den matchar valfritt kategorinamn.
2. Kombinera flera kategorier med ",", till exempel "anslutningar,meddelanden", matchar kategorin "anslutningar" och "meddelanden".
3. Namnet på en kategori, till exempel "anslutningar", matchar kategorin "anslutningar".
sträng
eventPattern Hämtar eller anger matchningsmönstret för händelsenamn. Om den inte har angetts matchar den alla händelser.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla händelsenamn.
2. Kombinera flera händelser med ",", till exempel "anslut,koppla från", matchar händelsen "anslut" och "koppla från".
3. Det enskilda händelsenamnet, till exempel "anslut", matchar "anslut".
sträng
hubPattern Hämtar eller anger matchningsmönstret för hubbnamn. Om den inte har angetts matchar den alla hubbar.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla hubbnamn.
2. Kombinera flera hubbar med "", till exempel "hub1,hub2", matchar det "hub1" och "hub2".
3. Namnet på den enskilda hubben, till exempel "hub1", matchar "hub1".
sträng
urlTemplate Hämtar eller ställer in mallen Överordnad URL. Du kan använda tre fördefinierade parametrar {hub}, {category} {event} i mallen. Värdet för den överordnade URL:en beräknas dynamiskt när klientbegäran kommer in.
Om urlTemplate till exempel är http://example.com/{hub}/api/{event}, med en klientbegäran från hubben chat ansluter, skickas den först till den här URL:en: http://example.com/chat/api/connect.
sträng (krävs)

UserAssignedIdentityProperty

Namn Beskrivning Värde

Snabbstartsmallar

Följande snabbstartsmallar distribuerar den här resurstypen.

Mall Beskrivning
Distribuera en Azure SignalR-tjänst

Distribuera till Azure
Den här mallen skapar en Azure SignalR Service med hjälp av en mall.

Resursdefinition för Terraform (AzAPI-provider)

SignalR-resurstypen kan distribueras med åtgärder som mål:

  • Resursgrupper

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.SignalRService/signalR-resurs lägger du till följande Terraform i mallen.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SignalRService/signalR@2024-10-01-preview"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    capacity = int
    name = "string"
    tier = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      applicationFirewall = {
        clientConnectionCountRules = [
          {
            type = "string"
            // For remaining properties, see ClientConnectionCountRule objects
          }
        ]
        clientTrafficControlRules = [
          {
            type = "string"
            // For remaining properties, see ClientTrafficControlRule objects
          }
        ]
      }
      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"
      serverless = {
        connectionTimeoutInSeconds = int
        keepAliveIntervalInSeconds = int
      }
      tls = {
        clientCertEnabled = bool
      }
      upstream = {
        templates = [
          {
            auth = {
              managedIdentity = {
                resource = "string"
              }
              type = "string"
            }
            categoryPattern = "string"
            eventPattern = "string"
            hubPattern = "string"
            urlTemplate = "string"
          }
        ]
      }
    }
  })
}

ClientTrafficControlRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För TrafficThrottleByJwtCustomClaimRuleanvänder du:

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

För TrafficThrottleByJwtSignatureRuleanvänder du:

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

För TrafficThrottleByUserIdRuleanvänder du:

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

ClientConnectionCountRule-objekt

Ange egenskapen typ för att ange typ av objekt.

För ThrottleByJwtCustomClaimRuleanvänder du:

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

För ThrottleByJwtSignatureRuleanvänder du:

{
  maxCount = int
  type = "ThrottleByJwtSignatureRule"
}

För ThrottleByUserIdRuleanvänder du:

{
  maxCount = int
  type = "ThrottleByUserIdRule"
}

Egenskapsvärden

ApplicationFirewallSettings

Namn Beskrivning Värde
clientConnectionCountRules Regler för att kontrollera antalet klientanslutningar ClientConnectionCountRule[]
clientTrafficControlRules Regler för att styra klienttrafiken ClientTrafficControlRule[]

ClientConnectionCountRule

Namn Beskrivning Värde
typ Ange till "ThrottleByJwtCustomClaimRule" för typen ThrottleByJwtCustomClaimRule. Ange till "ThrottleByJwtSignatureRule" för typen ThrottleByJwtSignatureRule. Ange till "ThrottleByUserIdRule" för typ ThrottleByUserIdRule. "ThrottleByJwtCustomClaimRule"
"ThrottleByJwtSignatureRule"
"ThrottleByUserIdRule" (krävs)

ClientTrafficControlRule

Namn Beskrivning Värde
typ Ange till "TrafficThrottleByJwtCustomClaimRule" för typen TrafficThrottleByJwtCustomClaimRule. Ange till TrafficThrottleByJwtSignatureRule för typen TrafficThrottleByJwtSignatureRule. Ange till TrafficThrottleByUserIdRule för typ TrafficThrottleByUserIdRule. "TrafficThrottleByJwtCustomClaimRule"
"TrafficThrottleByJwtSignatureRule"
"TrafficThrottleByUserIdRule" (krävs)

IPRule

Namn Beskrivning Värde
handling Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
värde En IP-adress eller CIDR eller ServiceTag sträng

LiveTraceCategory

Namn Beskrivning Värde
Aktiverat Anger om eller livespårningskategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger namnet på livespårningskategorin.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

LiveTraceConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. LiveTraceCategory[]
Aktiverat Anger om aktivering av livespårning ska aktiveras eller inte.
När den är inställd på true kan livespårningsklienten ansluta till tjänsten.
Annars kan livespårningsklienten inte ansluta till tjänsten, så att du inte kan ta emot någon logg, oavsett vad du konfigurerar i "kategorier".
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng

Hanterad identitet

Namn Beskrivning Värde
typ Representerar identitetstypen: systemAssigned, userAssigned, None "Ingen"
"SystemAssigned"
"UserAssigned"
userAssignedIdentities Hämta eller ange användartilldelade identiteter ManagedIdentityUserAssignedIdentiteter

ManagedIdentitySettings

Namn Beskrivning Värde
resurs Resursen som anger app-ID-URI:n för målresursen.
Det visas också i aud-anspråket (målgruppen) för den utfärdade token.
sträng

ManagedIdentityUserAssignedIdentiteter

Namn Beskrivning Värde

Microsoft.SignalRService/signalR

Namn Beskrivning Värde
identitet En klass representerar hanterade identiteter som används för begäran och svar ManagedIdentity
sort Typen av tjänst "RawWebSockets"
"SignalR"
plats Den geo-plats där resursen finns sträng (krävs)
Namn Resursnamnet sträng

Begränsningar:
Min längd = 3
Max längd = 63
Mönster = ^[a-zA-Z][a-zA-Z0-9-]{1,61}[a-zA-Z0-9]$ (krävs)
Egenskaper En klass som beskriver resursens egenskaper SignalRProperties
Sku Faktureringsinformation för resursen. ResourceSku
Taggar Resurstaggar Ordlista med taggnamn och värden.
typ Resurstypen "Microsoft.SignalRService/signalR@2024-10-01-preview"

NetworkACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"

PrivateEndpointACL

Namn Beskrivning Värde
tillåta Tillåtna typer av begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
neka Typer av nekade begäranden. Värdet kan vara ett eller flera av: ClientConnection, ServerConnection, RESTAPI. Strängmatris som innehåller något av:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Spårning"
Namn Namnet på den privata slutpunktsanslutningen sträng (krävs)

ResourceLogCategory

Namn Beskrivning Värde
Aktiverat Anger om eller resursloggkategorin är aktiverad.
Tillgängliga värden: sant, falskt.
Skiftlägesokänsligt.
sträng
Namn Hämtar eller anger resursloggkategorins namn.
Tillgängliga värden: ConnectivityLogs, MessagingLogs.
Skiftlägesokänsligt.
sträng

ResourceLogConfiguration

Namn Beskrivning Värde
Kategorier Hämtar eller anger listan över kategorikonfigurationer. ResourceLogCategory[]

ResourceSku

Namn Beskrivning Värde
kapacitet Valfritt heltal. Antalet enheter för resursen.
1 för Free_F1/Standard_S1/Premium_P1, 100 för Premium_P2 som standard.

Om det finns tillåts följande värden:
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
Namn Namnet på SKU:n. Krävs.

Tillåtna värden: Standard_S1, Free_F1, Premium_P1, Premium_P2
sträng (krävs)
Nivå Valfri nivå för den här specifika SKU:n. "Standard" eller "Kostnadsfri".

Basic är inaktuell använder du Standard i stället.
"Grundläggande"
"Kostnadsfri"
"Premium"
"Standard"

ServerlessSettings

Namn Beskrivning Värde
connectionTimeoutInSeconds Hämtar eller anger tidsgränsen för klientanslutning. Valfritt att ställa in.
Värde i sekunder.
Standardvärdet är 30 sekunder.
Kunden bör ange tidsgränsen till en kortare period om meddelanden förväntas skickas med kortare intervall.
och vill att klienten ska kopplas från snabbare när det senaste meddelandet har skickats.
Du kan ange tidsgränsen till en längre period om meddelanden förväntas skickas med längre intervall.
och de vill hålla samma klientanslutning vid liv under den här sessionen.
Tjänsten anser att klienten är frånkopplad om den inte har tagit emot ett meddelande (inklusive keep-alive) i det här intervallet.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120
keepAliveIntervalInSeconds Hämtar eller anger Keep-Alive intervall. Valfritt att ange.
Värdet är i sekunder.
Standardvärdet är 15 sekunder.
Kunder bör ange det här värdet till en kortare period om de vill att tjänsten ska skicka keep-alive-meddelanden oftare,
se till att anslutningsstatusen kontrolleras i tid.
Kunderna kan däremot ange det här värdet till en längre period om de vill att tjänsten ska skicka keep-alive-meddelanden mindre ofta.
minska nätverkstrafiken, men observera att det kan ta längre tid att identifiera en frånkoppling.
Det här intervallet säkerställer att anslutningen underhålls genom att periodiska keep-alive-meddelanden skickas till klienten.
Int

Begränsningar:
Minsta värde = 1
Maxvärde = 120

ServerlessUpstreamSettings

Namn Beskrivning Värde
Mallar Hämtar eller anger listan över överordnade URL-mallar. Ordningen är viktig och den första matchande mallen får effekter. UpstreamTemplate[]

SignalRCorsSettings

Namn Beskrivning Värde
allowedOrigins Hämtar eller anger den lista över ursprung som ska tillåtas att göra korsande anrop (till exempel: http://example.com:12345). Använd "*" för att tillåta alla. Om det utelämnas tillåter du alla som standard. string[]

SignalRFeature

Namn Beskrivning Värde
flagga FeatureFlags är de funktioner som stöds i Azure SignalR-tjänsten.
– ServiceMode: Flagga för serverdelsserver för SignalR-tjänsten. Värden tillåtna: "Standard": har en egen serverdelsserver; "Serverlös": programmet har ingen serverdelsserver. "Klassisk": för bakåtkompatibilitet. Stöd för både standardläge och serverlöst läge men rekommenderas inte. "PredefinedOnly": för framtida användning.
– EnableConnectivityLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableMessagingLogs: "true"/"false", för att aktivera/inaktivera anslutningsloggkategorin.
– EnableLiveTrace: Med Live Trace kan du veta vad som händer i Azure SignalR-tjänsten, det ger dig livespårningar i realtid. Det är användbart när du utvecklar ett eget Azure SignalR-baserat webbprogram eller själv felsöker några problem. Observera att livespårningar räknas som utgående meddelanden som debiteras. Värden tillåts: "true"/"false", för att aktivera/inaktivera funktionen för livespårning.
"EnableConnectivityLogs"
"EnableLiveTrace"
"EnableMessagingLogs"
"ServiceMode" (krävs)
Egenskaper Valfria egenskaper som är relaterade till den här funktionen. SignalRFeatureProperties
värde Värdet för funktionsflaggan. Se Azure SignalR Service-dokumentet /azure/azure-signalr/ för tillåtna värden. sträng

Begränsningar:
Min längd = 1
Maximal längd = 128 (krävs)

SignalRFeatureProperties

Namn Beskrivning Värde

SignalRNetworkACLs

Namn Beskrivning Värde
defaultAction Azure Networking ACL-åtgärd. "Tillåt"
"Neka"
ipRules IP-regler för filtrering av offentlig trafik IPRule[]
privateEndpoints ACL:er för begäranden från privata slutpunkter PrivateEndpointACL[]
publicNetwork Nätverks-ACL NetworkACL

SignalRProperties

Namn Beskrivning Värde
applicationFirewall Programbrandväggsinställningar för resursen ApplicationFirewallSettings
cors CORS-inställningar (Cross-Origin Resource Sharing). SignalRCorsSettings
disableAadAuth DisableLocalAuth
Aktivera eller inaktivera aad-autentisering
När värdet är true fungerar inte anslutningen med AuthType=aad.
Bool
disableLocalAuth DisableLocalAuth
Aktivera eller inaktivera lokal autentisering med AccessKey
När värdet är true fungerar inte anslutningen med AccessKey=xxx.
Bool
Funktioner Lista över featureFlags.

FeatureFlags som inte ingår i parametrarna för uppdateringsåtgärden ändras inte.
Och svaret innehåller endast featureFlags som uttryckligen anges.
När en featureFlag inte uttryckligen anges används dess globala standardvärde
Men kom ihåg att standardvärdet inte betyder "false". Det varierar beroende på olika FeatureFlags.
SignalRFeature[]
liveTraceConfiguration Livespårningskonfiguration av en Microsoft.SignalRService-resurs. LiveTraceConfiguration
networkACLs Nätverks-ACL:er för resursen SignalRNetworkACLs
publicNetworkAccess Aktivera eller inaktivera åtkomst till offentligt nätverk. Standardvärdet är "Aktiverad".
När den är aktiverad gäller fortfarande nätverks-ACL:er.
När den är inaktiverad inaktiveras alltid åtkomsten till det offentliga nätverket oavsett vad du anger i nätverks-ACL:er.
sträng
regionEndpointEnabled Aktivera eller inaktivera den regionala slutpunkten. Standardvärdet är "Aktiverad".
När den är inaktiverad dirigeras inte nya anslutningar till den här slutpunkten, men befintliga anslutningar påverkas inte.
Den här egenskapen är replikspecifik. Inaktivera den regionala slutpunkten utan replik tillåts inte.
sträng
resourceLogConfiguration Konfiguration av resurslogg för en Microsoft.SignalRService-resurs. ResourceLogConfiguration
resourceStopad Stoppa eller starta resursen. Standardvärdet är "False".
När det är sant stängs resursens dataplan av.
När det är falskt startas resursens dataplan.
sträng
serverlös Serverlösa inställningar. ServerlessSettings
tls TLS-inställningar för resursen SignalRTlsSettings
uppströms Inställningarna för Upstream när tjänsten är i serverlöst läge. ServerlessUpstreamSettings

SignalRTlsSettings

Namn Beskrivning Värde
clientCertEnabled Begär klientcertifikat under TLS-handskakning om det är aktiverat. Stöds inte för den kostnadsfria nivån. Alla indata ignoreras för den kostnadsfria nivån. Bool

ThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
claimName Namnet på anspråket i JWT-token. Klientanslutningen med samma anspråksvärde aggregeras. Om anspråket inte hittas i token tillåts anslutningen. sträng (krävs)
maxCount Maximalt antal anslutningar som tillåts för samma Jwt-anspråksvärde. Klienter med samma Jwt-anspråk avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtCustomClaimRule" (krävs)

ThrottleByJwtSignatureRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma JWT-signatur. Klienter med samma JWT-signatur avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByJwtSignatureRule" (krävs)

ThrottleByUserIdRule

Namn Beskrivning Värde
maxCount Maximalt antal anslutningar som tillåts för samma användar-ID. Klienter med samma användar-ID avvisas om antalet anslutningar överskrider det här värdet. Standardvärdet är 20. Int

Begränsningar:
Minsta värde = 0
Maxvärde = 2147483647
typ "ThrottleByUserIdRule" (krävs)

TrackedResourceTags

Namn Beskrivning Värde

TrafficThrottleByJwtCustomClaimRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
claimName Namnet på anspråket i JWT-token. Meddelandets byte med samma anspråksvärde aggregeras. Om anspråket inte hittas i token hoppas regeln över. sträng (krävs)
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-anspråk kopplas från om meddelandebytena överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtCustomClaimRule" (krävs)

TrafficThrottleByJwtSignatureRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma JWT-signatur inom ett tidsfönster. Klienter med samma JWT-signatur kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByJwtSignatureRule" (krävs)

TrafficThrottleByUserIdRule

Namn Beskrivning Värde
aggregeringWindowInSeconds Aggregeringsfönstret för meddelandebytena. Meddelandebytena aggregeras i det här fönstret och återställs efter fönstret. Standardvärdet är 60 sekunder. Int

Begränsningar:
Minsta värde = 10
Maxvärde = 3600
maxInboundMessageBytes Maximalt antal ackumulerade inkommande meddelandebyte som tillåts för samma användar-ID inom en tidsperiod. Klienter med samma användar-ID kopplas från om meddelandets byte överskrider det här värdet. Standardvärdet är 1 GB. Int

Begränsningar:
Minsta värde = 0
typ "TrafficThrottleByUserIdRule" (krävs)

UpstreamAuthSettings

Namn Beskrivning Värde
managedIdentity Hanterade identitetsinställningar för uppströms. ManagedIdentitySettings
typ Uppströms autentiseringstyp uppräkning. "ManagedIdentity"
"Ingen"

UpstreamTemplate

Namn Beskrivning Värde
Auth Inställningar för överordnad autentisering. Om den inte har angetts används ingen autentisering för överordnade meddelanden. UpstreamAuthSettings
categoryPattern Hämtar eller anger matchningsmönstret för kategorinamn. Om den inte har angetts matchar den alla kategorier.
Det finns tre typer av mönster som stöds:
1. "*", den matchar valfritt kategorinamn.
2. Kombinera flera kategorier med ",", till exempel "anslutningar,meddelanden", matchar kategorin "anslutningar" och "meddelanden".
3. Namnet på en kategori, till exempel "anslutningar", matchar kategorin "anslutningar".
sträng
eventPattern Hämtar eller anger matchningsmönstret för händelsenamn. Om den inte har angetts matchar den alla händelser.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla händelsenamn.
2. Kombinera flera händelser med ",", till exempel "anslut,koppla från", matchar händelsen "anslut" och "koppla från".
3. Det enskilda händelsenamnet, till exempel "anslut", matchar "anslut".
sträng
hubPattern Hämtar eller anger matchningsmönstret för hubbnamn. Om den inte har angetts matchar den alla hubbar.
Det finns tre typer av mönster som stöds:
1. "*", den matchar alla hubbnamn.
2. Kombinera flera hubbar med "", till exempel "hub1,hub2", matchar det "hub1" och "hub2".
3. Namnet på den enskilda hubben, till exempel "hub1", matchar "hub1".
sträng
urlTemplate Hämtar eller ställer in mallen Överordnad URL. Du kan använda tre fördefinierade parametrar {hub}, {category} {event} i mallen. Värdet för den överordnade URL:en beräknas dynamiskt när klientbegäran kommer in.
Om urlTemplate till exempel är http://example.com/{hub}/api/{event}, med en klientbegäran från hubben chat ansluter, skickas den först till den här URL:en: http://example.com/chat/api/connect.
sträng (krävs)

UserAssignedIdentityProperty

Namn Beskrivning Värde