次の方法で共有


Microsoft.SignalRService signalR 2020-05-01

Bicep リソース定義

signalR リソースの種類は、次をターゲットとする操作と共にデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.SignalRService/signalR リソースを作成するには、次の Bicep をテンプレートに追加します。

resource symbolicname 'Microsoft.SignalRService/signalR@2020-05-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  kind: 'string'
  properties: {
    cors: {
      allowedOrigins: [
        'string'
      ]
    }
    features: [
      {
        flag: 'string'
        properties: {
          {customized property}: 'string'
        }
        value: 'string'
      }
    ]
    networkACLs: {
      defaultAction: 'string'
      privateEndpoints: [
        {
          allow: [
            'string'
          ]
          deny: [
            'string'
          ]
          name: 'string'
        }
      ]
      publicNetwork: {
        allow: [
          'string'
        ]
        deny: [
          'string'
        ]
      }
    }
    upstream: {
      templates: [
        {
          categoryPattern: 'string'
          eventPattern: 'string'
          hubPattern: 'string'
          urlTemplate: 'string'
        }
      ]
    }
  }
}

プロパティ値

signalR

名前 説明
name リソース名 string (必須)

文字制限: 3 から 63

有効な文字:
英数字とハイフン。

文字で開始します。 文字または数字で終了します。

リソース名は、Azure 全体で一意である必要があります。
location SignalR サービスの GEO の場所。 例: 米国西部、米国東部、米国中北部、米国中南部。 string
tags リソースを記述するキー値ペアの一覧であるサービスのタグ。 タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください
sku リソースの課金情報。(無料、標準など) ResourceSku
kind サービスの種類 ("SignalR"、"Microsoft.SignalRService/SignalR" の "RawWebSockets" など) 'RawWebSockets'
'SignalR'
properties リソースのプロビジョニングまたは構成に使用される設定 SignalRProperties

SignalRProperties

名前 説明
cors クロスオリジン リソース共有 (CORS) 設定。 SignalRCorsSettings
features SignalR featureFlags の一覧。 例: ServiceMode。

更新操作のパラメーターに含まれていない FeatureFlags は変更されません。
応答には、明示的に設定された featureFlags のみが含まれます。
featureFlag が明示的に設定されていない場合、SignalR サービスではグローバルな既定値が使用されます。
ただし、既定値は "false" を意味するわけではない点に注意してください。 これは、異なる FeatureFlags の観点から異なります。
SignalRFeature[]
networkACLs ネットワーク ACL SignalRNetworkACLs
アップストリーム Azure SignalR がサーバーレス モードの場合のアップストリーム設定。 ServerlessUpstreamSettings

SignalRCorsSettings

名前 説明
allowedOrigins クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345)。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべて許可します。 string[]

SignalRFeature

名前 説明
flag FeatureFlags は、Azure SignalR サービスでサポートされている機能です。
- ServiceMode: SignalR サービスのバックエンド サーバーにフラグを設定します。 使用できる値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来使用します。
- EnableConnectivityLogs: "true"/"false"、接続ログ カテゴリをそれぞれ有効または無効にします。
'EnableConnectivityLogs'
'EnableMessagingLogs'
'ServiceMode' (必須)
properties この機能に関連する省略可能なプロパティ。 SignalRFeatureProperties
value 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ string (必須)

制約:
最小長 = 1
最大長 = 128

SignalRFeatureProperties

名前 説明
{カスタマイズされたプロパティ} string

SignalRNetworkACL

名前 説明
defaultAction 他のルールが一致しない場合の既定のアクション 'Allow'
'Deny'
privateEndpoints プライベート エンドポイントからの要求の ACL PrivateEndpointACL[]
publicNetwork パブリック ネットワークからの要求の ACL NetworkACL

PrivateEndpointACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
name プライベート エンドポイント接続の名前 string (必須)

NetworkACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'

ServerlessUpstreamSettings

名前 説明
テンプレート アップストリーム URL テンプレートの一覧を取得または設定します。 順序が重要であり、最初に一致するテンプレートが効果を受け取ります。 UpstreamTemplate[]

UpstreamTemplate

名前 説明
categoryPattern カテゴリ名の一致パターンを取得または設定します。 設定されていない場合は、任意のカテゴリと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のカテゴリ名に一致します
2. 複数のカテゴリを "," ("connections,messages"など) と組み合わせると、カテゴリ "connections" と "messages" と一致します
3. 1 つのカテゴリ名 ("connections"など) は、カテゴリ "connections" と一致します
string
eventPattern イベント名の一致パターンを取得または設定します。 設定されていない場合は、任意のイベントと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のイベント名に一致します
2. 複数のイベントを "," と組み合わせます(例: "connect,disconnect", it matches event "connect" and "disconnect"
3. 単一のイベント名 (例: "connect"、"connect" と一致します)
string
hubPattern ハブ名の一致パターンを取得または設定します。 設定されていない場合は、任意のハブと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のハブ名に一致します
2. "hub1,hub2" など、複数のハブを "," と組み合わせると、"hub1" と "hub2" と一致します
3. "hub1" などの単一のハブ名は、"hub1" と一致します
string
urlTemplate アップストリーム URL テンプレートを取得または設定します。 テンプレート内には 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 string (必須)

ResourceSku

名前 説明
capacity 省略可能、整数。 SignalR リソースの単位数。 既定では 1 です。

存在する場合は、次の値を使用できます。
無料: 1
標準: 1,2,5,10,20,50,100
INT
name SKU の名前。 必須。

使用できる値: Standard_S1、Free_F1
string (必須)
レベル この特定の SKU のオプションレベル。 'Standard' または 'Free' です。

Basic は非推奨です。代わりに Standard を使用してください。
'Basic'
'Free'
'Premium'
'Standard'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure SignalR サービスをデプロイする

Azure にデプロイする
このテンプレートは、テンプレートを使用してAzure SignalR Serviceを作成します。

ARM テンプレート リソース定義

signalR リソースの種類は、次を対象とする操作でデプロイできます。

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.SignalRService/signalR リソースを作成するには、次の JSON をテンプレートに追加します。

{
  "type": "Microsoft.SignalRService/signalR",
  "apiVersion": "2020-05-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "kind": "string",
  "properties": {
    "cors": {
      "allowedOrigins": [ "string" ]
    },
    "features": [
      {
        "flag": "string",
        "properties": {
          "{customized property}": "string"
        },
        "value": "string"
      }
    ],
    "networkACLs": {
      "defaultAction": "string",
      "privateEndpoints": [
        {
          "allow": [ "string" ],
          "deny": [ "string" ],
          "name": "string"
        }
      ],
      "publicNetwork": {
        "allow": [ "string" ],
        "deny": [ "string" ]
      }
    },
    "upstream": {
      "templates": [
        {
          "categoryPattern": "string",
          "eventPattern": "string",
          "hubPattern": "string",
          "urlTemplate": "string"
        }
      ]
    }
  }
}

プロパティ値

signalR

名前 説明
type リソースの種類 'Microsoft.SignalRService/signalR'
apiVersion リソース API のバージョン '2020-05-01'
name リソース名 string (必須)

文字数制限: 3 から 63

有効な文字:
英数字とハイフン。

文字で開始します。 文字または数字で終了します。

リソース名は、Azure 全体で一意である必要があります。
location SignalR サービスの GEO の場所。 たとえば、米国西部、米国東部、米国中北部、米国中南部などです。 string
tags リソースを記述するキー値ペアの一覧であるサービスのタグ。 タグ名と値のディクショナリ。 「テンプレートのタグ」を参照してください
sku リソースの課金情報。(例: Free、Standard) ResourceSku
kind サービスの種類 ( "SignalR"、または "Microsoft.SignalRService/SignalR" の "RawWebSockets" など) 'RawWebSockets'
'SignalR'
properties リソースのプロビジョニングまたは構成に使用される設定 SignalRProperties

SignalRProperties

名前 説明
cors クロスオリジン リソース共有 (CORS) 設定。 SignalRCorsSettings
features SignalR featureFlags の一覧。 例: ServiceMode。

更新操作のパラメーターに含まれていない FeatureFlags は変更されません。
応答には、明示的に設定された featureFlags のみが含まれます。
featureFlag が明示的に設定されていない場合、SignalR サービスではグローバルな既定値が使用されます。
ただし、既定値は "false" を意味するわけではない点に注意してください。 これは、異なる FeatureFlags の観点から異なります。
SignalRFeature[]
networkACLs ネットワーク ACL SignalRNetworkACLs
アップストリーム Azure SignalR がサーバーレス モードの場合のアップストリーム設定。 ServerlessUpstreamSettings

SignalRCorsSettings

名前 説明
allowedOrigins クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345)。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべて許可します。 string[]

SignalRFeature

名前 説明
flag FeatureFlags は、Azure SignalR サービスでサポートされている機能です。
- ServiceMode: SignalR サービスのバックエンド サーバーにフラグを設定します。 使用できる値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来使用します。
- EnableConnectivityLogs: "true"/"false"、接続ログ カテゴリをそれぞれ有効または無効にします。
'EnableConnectivityLogs'
'EnableMessagingLogs'
'ServiceMode' (必須)
properties この機能に関連する省略可能なプロパティ。 SignalRFeatureProperties
value 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ string (必須)

制約:
最小長 = 1
最大長 = 128

SignalRFeatureProperties

名前 説明
{カスタマイズされたプロパティ} string

SignalRNetworkACLs

名前 説明
defaultAction 他のルールが一致しない場合の既定のアクション 'Allow'
'Deny'
privateEndpoints プライベート エンドポイントからの要求の ACL PrivateEndpointACL[]
publicNetwork パブリック ネットワークからの要求の ACL NetworkACL

PrivateEndpointACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
name プライベート エンドポイント接続の名前 string (必須)

NetworkACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
'ClientConnection'
'RESTAPI'
'ServerConnection'
'Trace'

ServerlessUpstreamSettings

名前 説明
テンプレート アップストリーム URL テンプレートの一覧を取得または設定します。 順序は重要であり、最初に一致するテンプレートが効果を受け取ります。 UpstreamTemplate[]

UpstreamTemplate

名前 説明
categoryPattern カテゴリ名の一致パターンを取得または設定します。 設定されていない場合は、任意のカテゴリと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のカテゴリ名に一致します
2. 複数のカテゴリを "," と組み合わせます。たとえば、"connections,messages",it matches category "connections" and "messages"
3. 単一のカテゴリ名 ("connections"など) は、カテゴリ "connections" と一致します
string
eventPattern イベント名の一致パターンを取得または設定します。 設定されていない場合は、任意のイベントと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のイベント名に一致します
2. 複数のイベントを "," と組み合わせます(例: "connect,disconnect", it matches event "connect" and "disconnect"
3. 単一のイベント名 (例: "connect"、"connect" と一致します)
string
hubPattern ハブ名の一致パターンを取得または設定します。 設定されていない場合は、任意のハブと一致します。
次の 3 種類のパターンがサポートされています。
1. "*"、任意のハブ名と一致します
2. "hub1,hub2" など、複数のハブを "," と組み合わせると、"hub1" と "hub2" と一致します
3. 単一のハブ名 ("hub1"など) は、"hub1" と一致します
string
urlTemplate アップストリーム URL テンプレートを取得または設定します。 テンプレート内で 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 string (必須)

ResourceSku

名前 説明
capacity 省略可能、整数。 SignalR リソースの単位数。 既定では 1。

存在する場合は、次の値を使用できます。
無料: 1
標準: 1,2,5,10,20,50,100
INT
name SKU の名前。 必須。

使用できる値: Standard_S1、Free_F1
string (必須)
レベル この特定の SKU のオプションレベル。 'Standard' または 'Free' です。

Basic は非推奨です。代わりに Standard を使用してください。
'Basic'
'Free'
'Premium'
'Standard'

クイック スタート テンプレート

次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。

Template 説明
Azure SignalR サービスをデプロイする

Azure にデプロイする
このテンプレートは、テンプレートを使用してAzure SignalR Serviceを作成します。

Terraform (AzAPI プロバイダー) リソース定義

signalR リソースの種類は、次をターゲットとする操作と共にデプロイできます。

  • リソース グループ

各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。

リソース形式

Microsoft.SignalRService/signalR リソースを作成するには、次の Terraform をテンプレートに追加します。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.SignalRService/signalR@2020-05-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      cors = {
        allowedOrigins = [
          "string"
        ]
      }
      features = [
        {
          flag = "string"
          properties = {
            {customized property} = "string"
          }
          value = "string"
        }
      ]
      networkACLs = {
        defaultAction = "string"
        privateEndpoints = [
          {
            allow = [
              "string"
            ]
            deny = [
              "string"
            ]
            name = "string"
          }
        ]
        publicNetwork = {
          allow = [
            "string"
          ]
          deny = [
            "string"
          ]
        }
      }
      upstream = {
        templates = [
          {
            categoryPattern = "string"
            eventPattern = "string"
            hubPattern = "string"
            urlTemplate = "string"
          }
        ]
      }
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
    kind = "string"
  })
}

プロパティ値

signalR

名前 説明
type リソースの種類 "Microsoft.SignalRService/signalR@2020-05-01"
name リソース名 string (必須)

文字制限: 3 から 63

有効な文字:
英数字とハイフン。

文字で開始します。 文字または数字で終了します。

リソース名は、Azure 全体で一意である必要があります。
location SignalR サービスの GEO の場所。 例: 米国西部、米国東部、米国中北部、米国中南部。 string
parent_id リソース グループにデプロイするには、そのリソース グループの ID を使用します。 string (必須)
tags リソースを記述するキー値ペアの一覧であるサービスのタグ。 タグの名前と値のディクショナリ。
sku リソースの課金情報。(無料、標準など) ResourceSku
kind サービスの種類 ("SignalR"、"Microsoft.SignalRService/SignalR" の "RawWebSockets" など) "RawWebSockets"
"SignalR"
properties リソースのプロビジョニングまたは構成に使用される設定 SignalRProperties

SignalRProperties

名前 説明
cors クロスオリジン リソース共有 (CORS) 設定。 SignalRCorsSettings
features SignalR featureFlags の一覧。 例: ServiceMode。

更新操作のパラメーターに含まれていない FeatureFlags は変更されません。
応答には、明示的に設定された featureFlags のみが含まれます。
featureFlag が明示的に設定されていない場合、SignalR サービスではグローバルな既定値が使用されます。
ただし、既定値は "false" を意味するわけではない点に注意してください。 これは、異なる FeatureFlags の観点から異なります。
SignalRFeature[]
networkACLs ネットワーク ACL SignalRNetworkACLs
アップストリーム Azure SignalR がサーバーレス モードの場合のアップストリーム設定。 ServerlessUpstreamSettings

SignalRCorsSettings

名前 説明
allowedOrigins クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345)。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべて許可します。 string[]

SignalRFeature

名前 説明
flag FeatureFlags は、Azure SignalR サービスでサポートされている機能です。
- ServiceMode: SignalR サービスのバックエンド サーバーにフラグを設定します。 使用できる値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来使用します。
- EnableConnectivityLogs: "true"/"false"、接続ログ カテゴリをそれぞれ有効または無効にします。
"EnableConnectivityLogs"
"EnableMessagingLogs"
"ServiceMode" (必須)
properties この機能に関連する省略可能なプロパティ。 SignalRFeatureProperties
value 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ string (必須)

制約:
最小長 = 1
最大長 = 128

SignalRFeatureProperties

名前 説明
{カスタマイズされたプロパティ} string

SignalRNetworkACLs

名前 説明
defaultAction 他のルールが一致しない場合の既定のアクション "許可"
"Deny"
privateEndpoints プライベート エンドポイントからの要求の ACL PrivateEndpointACL[]
publicNetwork パブリック ネットワークからの要求の ACL NetworkACL

PrivateEndpointACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Trace"
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Trace"
name プライベート エンドポイント接続の名前 string (必須)

NetworkACL

名前 説明
allow 許可される要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Trace"
deny 拒否された要求の種類。 値には、ClientConnection、ServerConnection、RESTAPI の 1 つ以上を指定できます。 次のいずれかを含む文字列配列:
"ClientConnection"
"RESTAPI"
"ServerConnection"
"Trace"

ServerlessUpstreamSettings

名前 説明
テンプレート アップストリーム URL テンプレートの一覧を取得または設定します。 順序は重要であり、最初に一致するテンプレートが効果を受け取ります。 UpstreamTemplate[]

UpstreamTemplate

名前 説明
categoryPattern カテゴリ名の一致パターンを取得または設定します。 設定されていない場合は、任意のカテゴリと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のカテゴリ名に一致します
2. 複数のカテゴリを "," と組み合わせます。たとえば、"connections,messages",it matches category "connections" and "messages"
3. 単一のカテゴリ名 ("connections"など) は、カテゴリ "connections" と一致します
string
eventPattern イベント名の一致パターンを取得または設定します。 設定されていない場合は、任意のイベントと一致します。
次の 3 種類のパターンがサポートされています。
1. "*", それは任意のイベント名に一致します
2. 複数のイベントを "," と組み合わせます(例: "connect,disconnect", it matches event "connect" and "disconnect"
3. 単一のイベント名 (例: "connect"、"connect" と一致します)
string
hubPattern ハブ名の一致パターンを取得または設定します。 設定されていない場合は、任意のハブと一致します。
次の 3 種類のパターンがサポートされています。
1. "*"、任意のハブ名と一致します
2. "hub1,hub2" など、複数のハブを "," と組み合わせると、"hub1" と "hub2" と一致します
3. 単一のハブ名 ("hub1"など) は、"hub1" と一致します
string
urlTemplate アップストリーム URL テンプレートを取得または設定します。 テンプレート内で 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 string (必須)

ResourceSku

名前 説明
capacity 省略可能、整数。 SignalR リソースの単位数。 既定では 1。

存在する場合は、次の値を使用できます。
無料: 1
標準: 1,2,5,10,20,50,100
INT
name SKU の名前。 必須。

使用できる値: Standard_S1、Free_F1
string (必須)
レベル この特定の SKU のオプションレベル。 'Standard' または 'Free' です。

Basic は非推奨です。代わりに Standard を使用してください。
"Basic"
"Free"
"Premium"
"Standard"