다음을 통해 공유

Microsoft.SignalRService signalR 2021-09-01-preview

  • 아티클

Bicep 리소스 정의

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

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

리소스 형식

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

resource symbolicname 'Microsoft.SignalRService/signalR@2021-09-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'
      }
    ]
    networkACLs: {
      defaultAction: 'string'
      privateEndpoints: [
        {
          allow: [
            'string'
          ]
          deny: [
            'string'
          ]
          name: 'string'
        }
      ]
      publicNetwork: {
        allow: [
          'string'
        ]
        deny: [
          'string'
        ]
      }
    }
    publicNetworkAccess: 'string'
    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'
  }
}

속성 값

ManagedIdentity

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

ManagedIdentitySettings

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

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
신원 관리 ID 응답 managedIdentity
종류 서비스의 종류 - 예: "Microsoft.SignalRService/SignalR"에 대한 "SignalR" '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(필수)

ResourceSku

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

있는 경우 다음 값이 허용됩니다.
무료: 1
표준: 1,2,5,10,20,50,100		 int
이름 SKU의 이름입니다. 필수.

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

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

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 다른 규칙과 일치하지 않는 경우의 기본 작업 '허용'
'거부'
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[]
networkACLs 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
tls TLS 설정. SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

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

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 관리 ID 설정을 가져오거나 설정합니다. 인증 형식이 ManagedIdentity로 설정된 경우 필요합니다. managedIdentitySettings
형 인증 유형을 가져오거나 설정합니다. 현재 None 또는 ManagedIdentity가 지원되지 않습니다. '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": "2021-09-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"
      }
    ],
    "networkACLs": {
      "defaultAction": "string",
      "privateEndpoints": [
        {
          "allow": [ "string" ],
          "deny": [ "string" ],
          "name": "string"
        }
      ],
      "publicNetwork": {
        "allow": [ "string" ],
        "deny": [ "string" ]
      }
    },
    "publicNetworkAccess": "string",
    "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"
  }
}

속성 값

ManagedIdentity

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

ManagedIdentitySettings

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

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
apiVersion api 버전 '2021-09-01-preview'
신원 관리 ID 응답 managedIdentity
종류 서비스의 종류 - 예: "Microsoft.SignalRService/SignalR"에 대한 "SignalR" '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(필수)

ResourceSku

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

있는 경우 다음 값이 허용됩니다.
무료: 1
표준: 1,2,5,10,20,50,100		 int
이름 SKU의 이름입니다. 필수.

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

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

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 다른 규칙과 일치하지 않는 경우의 기본 작업 '허용'
'거부'
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[]
networkACLs 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
tls TLS 설정. SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

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

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 관리 ID 설정을 가져오거나 설정합니다. 인증 형식이 ManagedIdentity로 설정된 경우 필요합니다. managedIdentitySettings
형 인증 유형을 가져오거나 설정합니다. 현재 None 또는 ManagedIdentity가 지원되지 않습니다. '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@2021-09-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"
        }
      ]
      networkACLs = {
        defaultAction = "string"
        privateEndpoints = [
          {
            allow = [
              "string"
            ]
            deny = [
              "string"
            ]
            name = "string"
          }
        ]
        publicNetwork = {
          allow = [
            "string"
          ]
          deny = [
            "string"
          ]
        }
      }
      publicNetworkAccess = "string"
      tls = {
        clientCertEnabled = bool
      }
      upstream = {
        templates = [
          {
            auth = {
              managedIdentity = {
                resource = "string"
              }
              type = "string"
            }
            categoryPattern = "string"
            eventPattern = "string"
            hubPattern = "string"
            urlTemplate = "string"
          }
        ]
      }
    }
  })
}

속성 값

ManagedIdentity

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

ManagedIdentitySettings

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

ManagedIdentityUserAssignedIdentities

이름 묘사 값

Microsoft.SignalRService/signalR

이름 묘사 값
신원 관리 ID 응답 managedIdentity
종류 서비스의 종류 - 예: "Microsoft.SignalRService/SignalR"에 대한 "SignalR" 'RawWebSockets'
'SignalR'
위치 리소스의 GEO 위치입니다. 예: 미국 서부 미국 동부 미국 중북부 미국 중남부. 문자열
이름 리소스 이름 string(필수)
속성 리소스를 프로비전하거나 구성하는 데 사용되는 설정 SignalRProperties
sku 리소스의 청구 정보입니다. (예: 무료, 표준) resourceSku
태그 리소스 태그 태그 이름 및 값의 사전입니다.
형 리소스 종류 "Microsoft.SignalRService/signalR@2021-09-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(필수)

ResourceSku

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

있는 경우 다음 값이 허용됩니다.
무료: 1
표준: 1,2,5,10,20,50,100		 int
이름 SKU의 이름입니다. 필수.

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

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

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 다른 규칙과 일치하지 않는 경우의 기본 작업 '허용'
'거부'
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[]
networkACLs 네트워크 ACL SignalRNetworkACLs
publicNetworkAccess 공용 네트워크 액세스를 사용하거나 사용하지 않도록 설정합니다. 기본값은 "Enabled"입니다.
사용하도록 설정되면 네트워크 ACL이 계속 적용됩니다.
사용 안 함인 경우 네트워크 ACL에서 설정한 내용에 관계없이 공용 네트워크 액세스는 항상 사용하지 않도록 설정됩니다.		 문자열
tls TLS 설정. SignalRTlsSettings
업스트림 서비스가 서버리스 모드인 경우 업스트림 설정입니다. ServerlessUpstreamSettings

SignalRTlsSettings

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

TrackedResourceTags

이름 묘사 값

UpstreamAuthSettings

이름 묘사 값
managedIdentity 관리 ID 설정을 가져오거나 설정합니다. 인증 형식이 ManagedIdentity로 설정된 경우 필요합니다. managedIdentitySettings
형 인증 유형을 가져오거나 설정합니다. 현재 None 또는 ManagedIdentity가 지원되지 않습니다. '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

이름 묘사 값