다음을 통해 공유

Microsoft.SignalRService signalR 2022-08-01-preview

  • 아티클

Bicep 리소스 정의

signalR 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.SignalRService/signalR 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.SignalRService/signalR@2022-08-01-preview' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    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'
      privateEndpoints: [
        {
          allow: [
            'string'
          ]
          deny: [
            'string'
          ]
          name: 'string'
        }
      ]
      publicNetwork: {
        allow: [
          'string'
        ]
        deny: [
          'string'
        ]
      }
    }
    publicNetworkAccess: 'string'
    resourceLogConfiguration: {
      categories: [
        {
          enabled: 'string'
          name: 'string'
        }
      ]
    }
    serverless: {
      connectionTimeoutInSeconds: 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'
  }
}

속성 값

LiveTraceCategory

이름 묘사 값
사용 라이브 추적 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 라이브 추적 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

LiveTraceConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. LiveTraceCategory[]
사용 라이브 추적을 사용하도록 설정할지 여부를 나타냅니다.
true로 설정되면 라이브 추적 클라이언트가 서비스에 연결할 수 있습니다.
그렇지 않으면 라이브 추적 클라이언트가 서비스에 연결할 수 없으므로 "범주"에서 구성한 내용에 관계없이 로그를 받을 수 없습니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열

ManagedIdentity

이름 묘사 값
형 id 형식을 나타냅니다. systemAssigned, userAssigned, None 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities 사용자 할당 ID 가져오기 또는 설정 managedIdentityUserAssignedIdentities

ManagedIdentitySettings

이름 묘사 값
자원 대상 리소스의 앱 ID URI를 나타내는 리소스입니다.
또한 발급된 토큰의 aud(대상 그룹) 클레임에도 표시됩니다.		 문자열

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
신원 클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다. managedIdentity
종류 서비스의 종류는 SignalR 또는 RawWebSockets일 수 있습니다. 'RawWebSockets'
'SignalR'
위치 리소스의 GEO 위치입니다. 예: 미국 서부 미국 동부 미국 중북부 미국 중남부. 문자열
이름 리소스 이름 string(필수)
속성 리소스의 속성을 설명하는 클래스 SignalRProperties
sku 리소스의 청구 정보입니다. resourceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NetworkACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'

PrivateEndpointACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
이름 프라이빗 엔드포인트 연결의 이름 string(필수)

ResourceLogCategory

이름 묘사 값
사용 리소스 로그 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 리소스 로그 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

ResourceLogConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. resourceLogCategory[]

ResourceSku

이름 묘사 값
용량 선택적 정수입니다. 리소스의 단위 수입니다. 기본적으로 1.

있는 경우 다음 값이 허용됩니다.
무료: 1;
표준: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
프리미엄: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;		 int
이름 SKU의 이름입니다. 필수.

허용되는 값: Standard_S1, Free_F1, Premium_P1		 string(필수)
계층 이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.

더 이상 사용되지 않는 Basic 대신 Standard 사용합니다.		 '기본'
'무료'
'프리미엄'
'Standard'

ServerlessSettings

이름 묘사 값
connectionTimeoutInSeconds 클라이언트 연결 시간 제한을 가져오거나 설정합니다. 설정하려면 선택 사항입니다.
값(초)입니다.
기본값은 30초입니다.
메시지가 더 짧은 간격으로 전송되어야 하는 경우 고객은 시간 제한을 더 짧은 기간으로 설정해야 합니다.
마지막 메시지를 보낸 후 클라이언트의 연결을 더 빠르게 끊을 수 있도록 합니다.
메시지가 더 긴 간격으로 전송되어야 하는 경우 시간 제한을 더 긴 기간으로 설정할 수 있습니다.
이 세션 중에 동일한 클라이언트 연결을 활성 상태로 유지하려고 합니다.
이 서비스는 이 간격에 메시지(연결 유지 포함)를 받지 못한 경우 클라이언트의 연결이 끊어진 것으로 간주합니다.		 int

제약 조건:
최소값 = 1
최대값 = 120

ServerlessUpstreamSettings

이름 묘사 값
템플릿 업스트림 URL 템플릿 목록을 가져오거나 설정합니다. 순서가 중요하며 첫 번째 일치하는 템플릿이 적용됩니다. upstreamTemplate[]

SignalRCorsSettings

이름 묘사 값
allowedOrigins 원본 간 호출을 수행할 수 있어야 하는 원본 목록을 가져오거나 설정합니다(예: http://example.com:12345). "*"를 사용하여 모두 허용합니다. 생략하면 기본적으로 모두 허용합니다. string[]

SignalRFeature

이름 묘사 값
기 FeatureFlags는 Azure SignalR 서비스의 지원되는 기능입니다.
- ServiceMode: SignalR 서비스의 백 엔드 서버에 대한 플래그입니다. 허용되는 값: "기본값": 고유한 백 엔드 서버가 있습니다. "서버리스": 애플리케이션에 백 엔드 서버가 없습니다. "클래식": 이전 버전과의 호환성을 위한 것입니다. 기본 모드와 서버리스 모드를 모두 지원하지만 권장되지는 않습니다. "PredefinedOnly": 나중에 사용할 수 있습니다.
- EnableConnectivityLogs: 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정하려면 "true"/"false"입니다.
- EnableMessagingLogs: "true"/"false"입니다. 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정합니다.
- EnableLiveTrace: 라이브 추적을 사용하면 Azure SignalR 서비스 내에서 무슨 일이 일어나고 있는지 알 수 있습니다. 실시간 추적을 제공하며, 사용자 고유의 Azure SignalR 기반 웹 애플리케이션을 개발하거나 일부 문제를 자체 해결할 때 유용합니다. 라이브 추적은 요금이 청구되는 아웃바운드 메시지로 계산됩니다. 허용되는 값: "true"/"false", 라이브 추적 기능을 사용하거나 사용하지 않도록 설정합니다.		 'EnableConnectivityLogs'
'EnableLiveTrace'
'EnableMessagingLogs'
'ServiceMode'(필수)
속성 이 기능과 관련된 선택적 속성입니다. SignalRFeatureProperties
값 기능 플래그의 값입니다. 허용되는 값은 Azure SignalR Service 문서 /azure/azure-signalr/를 참조하세요. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1(필수)

SignalRFeatureProperties

이름 묘사 값

SignalRNetworkACLs

이름 묘사 값
defaultAction Azure 네트워킹 ACL 작업. '허용'
'거부'
privateEndpoints 프라이빗 엔드포인트의 요청에 대한 ACL PrivateEndpointACL[]
publicNetwork 네트워크 ACL NetworkACL

SignalRProperties

이름 묘사 값
cors CORS(원본 간 리소스 공유) 설정입니다. SignalRCorsSettings
disableAadAuth DisableLocalAuth
aad 인증 사용 또는 사용 안 함
true로 설정하면 AuthType=aad와의 연결이 작동하지 않습니다.		 bool
disableLocalAuth DisableLocalAuth
AccessKey를 사용하여 로컬 인증 사용 또는 사용 안 함
true로 설정하면 AccessKey=xxx와의 연결이 작동하지 않습니다.		 bool
기능 featureFlags 목록입니다.

업데이트 작업의 매개 변수에 포함되지 않은 FeatureFlag는 수정되지 않습니다.
또한 응답에는 명시적으로 설정된 featureFlags만 포함됩니다.
featureFlag가 명시적으로 설정되지 않은 경우 전역적으로 기본값이 사용됩니다.
그러나 기본값이 "false"를 의미하지는 않습니다. 다양한 FeatureFlag의 측면에서 다릅니다.		 SignalRFeature[]
liveTraceConfiguration Microsoft.SignalRService 리소스의 라이브 추적 구성입니다. LiveTraceConfiguration
networkACLs 리소스에 대한 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
resourceLogConfiguration Microsoft.SignalRService 리소스의 리소스 로그 구성입니다. ResourceLogConfiguration
서버리스 서버리스 설정. ServerlessSettings
tls 리소스에 대한 TLS 설정 SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림에 대한 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

이름 묘사 값
clientCertEnabled TLS 핸드셰이크 중 클라이언트 인증서 요청(사용하도록 설정된 경우) bool

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 업스트림에 대한 관리 ID 설정입니다. managedIdentitySettings
형 업스트림 인증 형식 열거형입니다. 'ManagedIdentity'
'None'

UpstreamTemplate

이름 묘사 값
인증 업스트림 인증 설정입니다. 설정하지 않으면 업스트림 메시지에 인증이 사용되지 않습니다. upstreamAuthSettings
categoryPattern 범주 이름의 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 범주와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*", 모든 범주 이름과 일치합니다.
2. 여러 범주를 ""와 결합합니다(예: "connections,messages"). "connections" 및 "messages" 범주와 일치합니다.
3. 단일 범주 이름(예: "connections")은 "connections" 범주와 일치합니다.		 문자열
eventPattern 이벤트 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 이벤트와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 이벤트 이름과 일치합니다.
2. 여러 이벤트를 ","(예: "connect,disconnect")와 결합합니다. "connect" 및 "disconnect" 이벤트와 일치합니다.
3. 단일 이벤트 이름(예: "connect")은 "connect"에 일치합니다.		 문자열
hubPattern 허브 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 허브와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 허브 이름과 일치합니다.
2. 여러 허브를 ""(예: "hub1,hub2")와 결합하면 "hub1" 및 "hub2"와 일치합니다.
3. 단일 허브 이름(예: "hub1")은 "hub1"에 일치합니다.		 문자열
urlTemplate 업스트림 URL 템플릿을 가져오거나 설정합니다. 템플릿 내에서 3개의 미리 정의된 매개 변수 {hub}, {category} {event}를 사용할 수 있습니다. 클라이언트 요청이 들어올 때 업스트림 URL의 값이 동적으로 계산됩니다.
예를 들어 urlTemplate이 http://example.com/{hub}/api/{event}허브에서 클라이언트 요청을 chat 연결하면 먼저 이 URL인 http://example.com/chat/api/connect게시합니다.		 string(필수)

UserAssignedIdentityProperty

이름 묘사 값

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일 묘사
Azure SignalR Service 배포 이 템플릿은 템플릿을 사용하여 Azure SignalR Service를 만듭니다.

ARM 템플릿 리소스 정의

signalR 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.SignalRService/signalR 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.SignalRService/signalR",
  "apiVersion": "2022-08-01-preview",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "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",
      "privateEndpoints": [
        {
          "allow": [ "string" ],
          "deny": [ "string" ],
          "name": "string"
        }
      ],
      "publicNetwork": {
        "allow": [ "string" ],
        "deny": [ "string" ]
      }
    },
    "publicNetworkAccess": "string",
    "resourceLogConfiguration": {
      "categories": [
        {
          "enabled": "string",
          "name": "string"
        }
      ]
    },
    "serverless": {
      "connectionTimeoutInSeconds": "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"
  }
}

속성 값

LiveTraceCategory

이름 묘사 값
사용 라이브 추적 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 라이브 추적 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

LiveTraceConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. LiveTraceCategory[]
사용 라이브 추적을 사용하도록 설정할지 여부를 나타냅니다.
true로 설정되면 라이브 추적 클라이언트가 서비스에 연결할 수 있습니다.
그렇지 않으면 라이브 추적 클라이언트가 서비스에 연결할 수 없으므로 "범주"에서 구성한 내용에 관계없이 로그를 받을 수 없습니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열

ManagedIdentity

이름 묘사 값
형 id 형식을 나타냅니다. systemAssigned, userAssigned, None 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities 사용자 할당 ID 가져오기 또는 설정 managedIdentityUserAssignedIdentities

ManagedIdentitySettings

이름 묘사 값
자원 대상 리소스의 앱 ID URI를 나타내는 리소스입니다.
또한 발급된 토큰의 aud(대상 그룹) 클레임에도 표시됩니다.		 문자열

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
apiVersion api 버전 '2022-08-01-preview'
신원 클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다. managedIdentity
종류 서비스의 종류는 SignalR 또는 RawWebSockets일 수 있습니다. 'RawWebSockets'
'SignalR'
위치 리소스의 GEO 위치입니다. 예: 미국 서부 미국 동부 미국 중북부 미국 중남부. 문자열
이름 리소스 이름 string(필수)
속성 리소스의 속성을 설명하는 클래스 SignalRProperties
sku 리소스의 청구 정보입니다. resourceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형 리소스 종류 'Microsoft.SignalRService/signalR'

NetworkACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'

PrivateEndpointACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
이름 프라이빗 엔드포인트 연결의 이름 string(필수)

ResourceLogCategory

이름 묘사 값
사용 리소스 로그 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 리소스 로그 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

ResourceLogConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. resourceLogCategory[]

ResourceSku

이름 묘사 값
용량 선택적 정수입니다. 리소스의 단위 수입니다. 기본적으로 1.

있는 경우 다음 값이 허용됩니다.
무료: 1;
표준: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
프리미엄: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;		 int
이름 SKU의 이름입니다. 필수.

허용되는 값: Standard_S1, Free_F1, Premium_P1		 string(필수)
계층 이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.

더 이상 사용되지 않는 Basic 대신 Standard 사용합니다.		 '기본'
'무료'
'프리미엄'
'Standard'

ServerlessSettings

이름 묘사 값
connectionTimeoutInSeconds 클라이언트 연결 시간 제한을 가져오거나 설정합니다. 설정하려면 선택 사항입니다.
값(초)입니다.
기본값은 30초입니다.
메시지가 더 짧은 간격으로 전송되어야 하는 경우 고객은 시간 제한을 더 짧은 기간으로 설정해야 합니다.
마지막 메시지를 보낸 후 클라이언트의 연결을 더 빠르게 끊을 수 있도록 합니다.
메시지가 더 긴 간격으로 전송되어야 하는 경우 시간 제한을 더 긴 기간으로 설정할 수 있습니다.
이 세션 중에 동일한 클라이언트 연결을 활성 상태로 유지하려고 합니다.
이 서비스는 이 간격에 메시지(연결 유지 포함)를 받지 못한 경우 클라이언트의 연결이 끊어진 것으로 간주합니다.		 int

제약 조건:
최소값 = 1
최대값 = 120

ServerlessUpstreamSettings

이름 묘사 값
템플릿 업스트림 URL 템플릿 목록을 가져오거나 설정합니다. 순서가 중요하며 첫 번째 일치하는 템플릿이 적용됩니다. upstreamTemplate[]

SignalRCorsSettings

이름 묘사 값
allowedOrigins 원본 간 호출을 수행할 수 있어야 하는 원본 목록을 가져오거나 설정합니다(예: http://example.com:12345). "*"를 사용하여 모두 허용합니다. 생략하면 기본적으로 모두 허용합니다. string[]

SignalRFeature

이름 묘사 값
기 FeatureFlags는 Azure SignalR 서비스의 지원되는 기능입니다.
- ServiceMode: SignalR 서비스의 백 엔드 서버에 대한 플래그입니다. 허용되는 값: "기본값": 고유한 백 엔드 서버가 있습니다. "서버리스": 애플리케이션에 백 엔드 서버가 없습니다. "클래식": 이전 버전과의 호환성을 위한 것입니다. 기본 모드와 서버리스 모드를 모두 지원하지만 권장되지는 않습니다. "PredefinedOnly": 나중에 사용할 수 있습니다.
- EnableConnectivityLogs: 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정하려면 "true"/"false"입니다.
- EnableMessagingLogs: "true"/"false"입니다. 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정합니다.
- EnableLiveTrace: 라이브 추적을 사용하면 Azure SignalR 서비스 내에서 무슨 일이 일어나고 있는지 알 수 있습니다. 실시간 추적을 제공하며, 사용자 고유의 Azure SignalR 기반 웹 애플리케이션을 개발하거나 일부 문제를 자체 해결할 때 유용합니다. 라이브 추적은 요금이 청구되는 아웃바운드 메시지로 계산됩니다. 허용되는 값: "true"/"false", 라이브 추적 기능을 사용하거나 사용하지 않도록 설정합니다.		 'EnableConnectivityLogs'
'EnableLiveTrace'
'EnableMessagingLogs'
'ServiceMode'(필수)
속성 이 기능과 관련된 선택적 속성입니다. SignalRFeatureProperties
값 기능 플래그의 값입니다. 허용되는 값은 Azure SignalR Service 문서 /azure/azure-signalr/를 참조하세요. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1(필수)

SignalRFeatureProperties

이름 묘사 값

SignalRNetworkACLs

이름 묘사 값
defaultAction Azure 네트워킹 ACL 작업. '허용'
'거부'
privateEndpoints 프라이빗 엔드포인트의 요청에 대한 ACL PrivateEndpointACL[]
publicNetwork 네트워크 ACL NetworkACL

SignalRProperties

이름 묘사 값
cors CORS(원본 간 리소스 공유) 설정입니다. SignalRCorsSettings
disableAadAuth DisableLocalAuth
aad 인증 사용 또는 사용 안 함
true로 설정하면 AuthType=aad와의 연결이 작동하지 않습니다.		 bool
disableLocalAuth DisableLocalAuth
AccessKey를 사용하여 로컬 인증 사용 또는 사용 안 함
true로 설정하면 AccessKey=xxx와의 연결이 작동하지 않습니다.		 bool
기능 featureFlags 목록입니다.

업데이트 작업의 매개 변수에 포함되지 않은 FeatureFlag는 수정되지 않습니다.
또한 응답에는 명시적으로 설정된 featureFlags만 포함됩니다.
featureFlag가 명시적으로 설정되지 않은 경우 전역적으로 기본값이 사용됩니다.
그러나 기본값이 "false"를 의미하지는 않습니다. 다양한 FeatureFlag의 측면에서 다릅니다.		 SignalRFeature[]
liveTraceConfiguration Microsoft.SignalRService 리소스의 라이브 추적 구성입니다. LiveTraceConfiguration
networkACLs 리소스에 대한 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
resourceLogConfiguration Microsoft.SignalRService 리소스의 리소스 로그 구성입니다. ResourceLogConfiguration
서버리스 서버리스 설정. ServerlessSettings
tls 리소스에 대한 TLS 설정 SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림에 대한 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

이름 묘사 값
clientCertEnabled TLS 핸드셰이크 중 클라이언트 인증서 요청(사용하도록 설정된 경우) bool

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 업스트림에 대한 관리 ID 설정입니다. managedIdentitySettings
형 업스트림 인증 형식 열거형입니다. 'ManagedIdentity'
'None'

UpstreamTemplate

이름 묘사 값
인증 업스트림 인증 설정입니다. 설정하지 않으면 업스트림 메시지에 인증이 사용되지 않습니다. upstreamAuthSettings
categoryPattern 범주 이름의 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 범주와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*", 모든 범주 이름과 일치합니다.
2. 여러 범주를 ""와 결합합니다(예: "connections,messages"). "connections" 및 "messages" 범주와 일치합니다.
3. 단일 범주 이름(예: "connections")은 "connections" 범주와 일치합니다.		 문자열
eventPattern 이벤트 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 이벤트와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 이벤트 이름과 일치합니다.
2. 여러 이벤트를 ","(예: "connect,disconnect")와 결합합니다. "connect" 및 "disconnect" 이벤트와 일치합니다.
3. 단일 이벤트 이름(예: "connect")은 "connect"에 일치합니다.		 문자열
hubPattern 허브 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 허브와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 허브 이름과 일치합니다.
2. 여러 허브를 ""(예: "hub1,hub2")와 결합하면 "hub1" 및 "hub2"와 일치합니다.
3. 단일 허브 이름(예: "hub1")은 "hub1"에 일치합니다.		 문자열
urlTemplate 업스트림 URL 템플릿을 가져오거나 설정합니다. 템플릿 내에서 3개의 미리 정의된 매개 변수 {hub}, {category} {event}를 사용할 수 있습니다. 클라이언트 요청이 들어올 때 업스트림 URL의 값이 동적으로 계산됩니다.
예를 들어 urlTemplate이 http://example.com/{hub}/api/{event}허브에서 클라이언트 요청을 chat 연결하면 먼저 이 URL인 http://example.com/chat/api/connect게시합니다.		 string(필수)

UserAssignedIdentityProperty

이름 묘사 값

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛 묘사
Azure SignalR Service 배포

Azure 배포 		이 템플릿은 템플릿을 사용하여 Azure SignalR Service를 만듭니다.

Terraform(AzAPI 공급자) 리소스 정의

signalR 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.

  • 리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.SignalRService/signalR 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SignalRService/signalR@2022-08-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 = {
      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"
        privateEndpoints = [
          {
            allow = [
              "string"
            ]
            deny = [
              "string"
            ]
            name = "string"
          }
        ]
        publicNetwork = {
          allow = [
            "string"
          ]
          deny = [
            "string"
          ]
        }
      }
      publicNetworkAccess = "string"
      resourceLogConfiguration = {
        categories = [
          {
            enabled = "string"
            name = "string"
          }
        ]
      }
      serverless = {
        connectionTimeoutInSeconds = int
      }
      tls = {
        clientCertEnabled = bool
      }
      upstream = {
        templates = [
          {
            auth = {
              managedIdentity = {
                resource = "string"
              }
              type = "string"
            }
            categoryPattern = "string"
            eventPattern = "string"
            hubPattern = "string"
            urlTemplate = "string"
          }
        ]
      }
    }
  })
}

속성 값

LiveTraceCategory

이름 묘사 값
사용 라이브 추적 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 라이브 추적 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

LiveTraceConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. LiveTraceCategory[]
사용 라이브 추적을 사용하도록 설정할지 여부를 나타냅니다.
true로 설정되면 라이브 추적 클라이언트가 서비스에 연결할 수 있습니다.
그렇지 않으면 라이브 추적 클라이언트가 서비스에 연결할 수 없으므로 "범주"에서 구성한 내용에 관계없이 로그를 받을 수 없습니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열

ManagedIdentity

이름 묘사 값
형 id 형식을 나타냅니다. systemAssigned, userAssigned, None 'None'
'SystemAssigned'
'UserAssigned'
userAssignedIdentities 사용자 할당 ID 가져오기 또는 설정 managedIdentityUserAssignedIdentities

ManagedIdentitySettings

이름 묘사 값
자원 대상 리소스의 앱 ID URI를 나타내는 리소스입니다.
또한 발급된 토큰의 aud(대상 그룹) 클레임에도 표시됩니다.		 문자열

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
신원 클래스는 요청 및 응답에 사용되는 관리 ID를 나타냅니다. managedIdentity
종류 서비스의 종류는 SignalR 또는 RawWebSockets일 수 있습니다. 'RawWebSockets'
'SignalR'
위치 리소스의 GEO 위치입니다. 예: 미국 서부 미국 동부 미국 중북부 미국 중남부. 문자열
이름 리소스 이름 string(필수)
속성 리소스의 속성을 설명하는 클래스 SignalRProperties
sku 리소스의 청구 정보입니다. resourceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.SignalRService/signalR@2022-08-01-preview"

NetworkACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'

PrivateEndpointACL

이름 묘사 값
허용하다 허용된 요청 유형입니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
거절하다 요청 유형이 거부되었습니다. 값은 ClientConnection, ServerConnection, RESTAPI 중 하나 이상일 수 있습니다. 다음 중 어느 것을 포함하는 문자열 배열:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
이름 프라이빗 엔드포인트 연결의 이름 string(필수)

ResourceLogCategory

이름 묘사 값
사용 리소스 로그 범주를 사용할지 여부를 나타냅니다.
사용 가능한 값: true, false.
대/소문자를 구분하지 않습니다.		 문자열
이름 리소스 로그 범주의 이름을 가져오거나 설정합니다.
사용 가능한 값: ConnectivityLogs, MessagingLogs.
대/소문자를 구분하지 않습니다.		 문자열

ResourceLogConfiguration

이름 묘사 값
카테고리 범주 구성 목록을 가져오거나 설정합니다. resourceLogCategory[]

ResourceSku

이름 묘사 값
용량 선택적 정수입니다. 리소스의 단위 수입니다. 기본적으로 1.

있는 경우 다음 값이 허용됩니다.
무료: 1;
표준: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;
프리미엄: 1,2,3,4,5,6,7,8,9,10,20,30,40,50,60,70,80,90,100;		 int
이름 SKU의 이름입니다. 필수.

허용되는 값: Standard_S1, Free_F1, Premium_P1		 string(필수)
계층 이 특정 SKU의 선택적 계층입니다. '표준' 또는 '무료'.

더 이상 사용되지 않는 Basic 대신 Standard 사용합니다.		 '기본'
'무료'
'프리미엄'
'Standard'

ServerlessSettings

이름 묘사 값
connectionTimeoutInSeconds 클라이언트 연결 시간 제한을 가져오거나 설정합니다. 설정하려면 선택 사항입니다.
값(초)입니다.
기본값은 30초입니다.
메시지가 더 짧은 간격으로 전송되어야 하는 경우 고객은 시간 제한을 더 짧은 기간으로 설정해야 합니다.
마지막 메시지를 보낸 후 클라이언트의 연결을 더 빠르게 끊을 수 있도록 합니다.
메시지가 더 긴 간격으로 전송되어야 하는 경우 시간 제한을 더 긴 기간으로 설정할 수 있습니다.
이 세션 중에 동일한 클라이언트 연결을 활성 상태로 유지하려고 합니다.
이 서비스는 이 간격에 메시지(연결 유지 포함)를 받지 못한 경우 클라이언트의 연결이 끊어진 것으로 간주합니다.		 int

제약 조건:
최소값 = 1
최대값 = 120

ServerlessUpstreamSettings

이름 묘사 값
템플릿 업스트림 URL 템플릿 목록을 가져오거나 설정합니다. 순서가 중요하며 첫 번째 일치하는 템플릿이 적용됩니다. upstreamTemplate[]

SignalRCorsSettings

이름 묘사 값
allowedOrigins 원본 간 호출을 수행할 수 있어야 하는 원본 목록을 가져오거나 설정합니다(예: http://example.com:12345). "*"를 사용하여 모두 허용합니다. 생략하면 기본적으로 모두 허용합니다. string[]

SignalRFeature

이름 묘사 값
기 FeatureFlags는 Azure SignalR 서비스의 지원되는 기능입니다.
- ServiceMode: SignalR 서비스의 백 엔드 서버에 대한 플래그입니다. 허용되는 값: "기본값": 고유한 백 엔드 서버가 있습니다. "서버리스": 애플리케이션에 백 엔드 서버가 없습니다. "클래식": 이전 버전과의 호환성을 위한 것입니다. 기본 모드와 서버리스 모드를 모두 지원하지만 권장되지는 않습니다. "PredefinedOnly": 나중에 사용할 수 있습니다.
- EnableConnectivityLogs: 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정하려면 "true"/"false"입니다.
- EnableMessagingLogs: "true"/"false"입니다. 연결 로그 범주를 각각 사용하거나 사용하지 않도록 설정합니다.
- EnableLiveTrace: 라이브 추적을 사용하면 Azure SignalR 서비스 내에서 무슨 일이 일어나고 있는지 알 수 있습니다. 실시간 추적을 제공하며, 사용자 고유의 Azure SignalR 기반 웹 애플리케이션을 개발하거나 일부 문제를 자체 해결할 때 유용합니다. 라이브 추적은 요금이 청구되는 아웃바운드 메시지로 계산됩니다. 허용되는 값: "true"/"false", 라이브 추적 기능을 사용하거나 사용하지 않도록 설정합니다.		 'EnableConnectivityLogs'
'EnableLiveTrace'
'EnableMessagingLogs'
'ServiceMode'(필수)
속성 이 기능과 관련된 선택적 속성입니다. SignalRFeatureProperties
값 기능 플래그의 값입니다. 허용되는 값은 Azure SignalR Service 문서 /azure/azure-signalr/를 참조하세요. 문자열

제약 조건:
최소 길이 = 1
최대 길이 = 1(필수)

SignalRFeatureProperties

이름 묘사 값

SignalRNetworkACLs

이름 묘사 값
defaultAction Azure 네트워킹 ACL 작업. '허용'
'거부'
privateEndpoints 프라이빗 엔드포인트의 요청에 대한 ACL PrivateEndpointACL[]
publicNetwork 네트워크 ACL NetworkACL

SignalRProperties

이름 묘사 값
cors CORS(원본 간 리소스 공유) 설정입니다. SignalRCorsSettings
disableAadAuth DisableLocalAuth
aad 인증 사용 또는 사용 안 함
true로 설정하면 AuthType=aad와의 연결이 작동하지 않습니다.		 bool
disableLocalAuth DisableLocalAuth
AccessKey를 사용하여 로컬 인증 사용 또는 사용 안 함
true로 설정하면 AccessKey=xxx와의 연결이 작동하지 않습니다.		 bool
기능 featureFlags 목록입니다.

업데이트 작업의 매개 변수에 포함되지 않은 FeatureFlag는 수정되지 않습니다.
또한 응답에는 명시적으로 설정된 featureFlags만 포함됩니다.
featureFlag가 명시적으로 설정되지 않은 경우 전역적으로 기본값이 사용됩니다.
그러나 기본값이 "false"를 의미하지는 않습니다. 다양한 FeatureFlag의 측면에서 다릅니다.		 SignalRFeature[]
liveTraceConfiguration Microsoft.SignalRService 리소스의 라이브 추적 구성입니다. LiveTraceConfiguration
networkACLs 리소스에 대한 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
resourceLogConfiguration Microsoft.SignalRService 리소스의 리소스 로그 구성입니다. ResourceLogConfiguration
서버리스 서버리스 설정. ServerlessSettings
tls 리소스에 대한 TLS 설정 SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림에 대한 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

이름 묘사 값
clientCertEnabled TLS 핸드셰이크 중 클라이언트 인증서 요청(사용하도록 설정된 경우) bool

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 업스트림에 대한 관리 ID 설정입니다. managedIdentitySettings
형 업스트림 인증 형식 열거형입니다. 'ManagedIdentity'
'None'

UpstreamTemplate

이름 묘사 값
인증 업스트림 인증 설정입니다. 설정하지 않으면 업스트림 메시지에 인증이 사용되지 않습니다. upstreamAuthSettings
categoryPattern 범주 이름의 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 범주와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*", 모든 범주 이름과 일치합니다.
2. 여러 범주를 ""와 결합합니다(예: "connections,messages"). "connections" 및 "messages" 범주와 일치합니다.
3. 단일 범주 이름(예: "connections")은 "connections" 범주와 일치합니다.		 문자열
eventPattern 이벤트 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 모든 이벤트와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 이벤트 이름과 일치합니다.
2. 여러 이벤트를 ","(예: "connect,disconnect")와 결합합니다. "connect" 및 "disconnect" 이벤트와 일치합니다.
3. 단일 이벤트 이름(예: "connect")은 "connect"에 일치합니다.		 문자열
hubPattern 허브 이름에 대한 일치 패턴을 가져오거나 설정합니다. 설정하지 않으면 허브와 일치합니다.
지원되는 패턴에는 다음과 같은 3가지 종류가 있습니다.
1. "*"이면 허브 이름과 일치합니다.
2. 여러 허브를 ""(예: "hub1,hub2")와 결합하면 "hub1" 및 "hub2"와 일치합니다.
3. 단일 허브 이름(예: "hub1")은 "hub1"에 일치합니다.		 문자열
urlTemplate 업스트림 URL 템플릿을 가져오거나 설정합니다. 템플릿 내에서 3개의 미리 정의된 매개 변수 {hub}, {category} {event}를 사용할 수 있습니다. 클라이언트 요청이 들어올 때 업스트림 URL의 값이 동적으로 계산됩니다.
예를 들어 urlTemplate이 http://example.com/{hub}/api/{event}허브에서 클라이언트 요청을 chat 연결하면 먼저 이 URL인 http://example.com/chat/api/connect게시합니다.		 string(필수)

UserAssignedIdentityProperty

이름 묘사 값