Microsoft.SignalRService signalR 2022-02-01
Bicep リソース定義
signalR リソースの種類は、次をターゲットとする操作と共にデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.SignalRService/signalR リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.SignalRService/signalR@2022-02-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
sku: {
capacity: int
name: 'string'
tier: 'string'
}
kind: 'string'
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
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'
}
]
}
tls: {
clientCertEnabled: bool
}
upstream: {
templates: [
{
auth: {
managedIdentity: {
resource: 'string'
}
type: 'string'
}
categoryPattern: 'string'
eventPattern: 'string'
hubPattern: 'string'
urlTemplate: 'string'
}
]
}
}
}
プロパティ値
signalR
名前 | 説明 | 値 |
---|---|---|
name | リソース名 | string (必須) 文字制限: 3 から 63 有効な文字: 英数字とハイフン。 文字で開始します。 文字または数字で終了します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースの GEO の場所。 例: 米国西部、米国東部、米国中北部、米国中南部。 | string |
tags | リソースを記述するキー値ペアの一覧であるサービスのタグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
sku | リソースの課金情報。 | ResourceSku |
kind | サービスの種類は、SignalR または RawWebSocket です | 'RawWebSockets' 'SignalR' |
identity | クラスは、要求と応答に使用されるマネージド ID を表します | ManagedIdentity |
properties | リソースのプロパティを記述するクラス | SignalRProperties |
ManagedIdentity
名前 | 説明 | 値 |
---|---|---|
type | id の種類を表します: systemAssigned、userAssigned、None | 'None' 'SystemAssigned' 'UserAssigned' |
userAssignedIdentities | ユーザー割り当て ID を取得または設定する | ManagedIdentityUserAssignedIdentities |
ManagedIdentityUserAssignedIdentities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | UserAssignedIdentityProperty |
UserAssignedIdentityProperty
このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
SignalRProperties
名前 | 説明 | 値 |
---|---|---|
cors | クロスオリジン リソース共有 (CORS) 設定。 | SignalRCorsSettings |
disableAadAuth | DisableLocalAuth aad 認証を有効または無効にする true に設定すると、AuthType=aad との接続は機能しません。 |
[bool] |
disableLocalAuth | DisableLocalAuth AccessKey を使用してローカル認証を有効または無効にする true に設定すると、AccessKey=xxx との接続は機能しません。 |
[bool] |
features | featureFlags の一覧。 更新操作のパラメーターに含まれていない FeatureFlags は変更されません。 また、応答には、明示的に設定された featureFlags のみが含まれます。 featureFlag が明示的に設定されていない場合、そのグローバルな既定値が使用されます ただし、既定値は "false" を意味するものではありません。 FeatureFlags によって異なります。 |
SignalRFeature[] |
liveTraceConfiguration | Microsoft.SignalRService リソースのライブ トレース構成。 | LiveTraceConfiguration |
networkACLs | リソースのネットワーク ACL | SignalRNetworkACL |
publicNetworkAccess | パブリック ネットワーク アクセスを有効または無効にします。 既定値は "Enabled" です。 有効にすると、ネットワーク ACL は引き続き適用されます。 [無効] にすると、ネットワーク ACL で設定した内容に関係なく、パブリック ネットワーク アクセスは常に無効になります。 |
string |
resourceLogConfiguration | Microsoft.SignalRService リソースのリソース ログ構成。 | ResourceLogConfiguration |
Tls | リソースの TLS 設定 | SignalRTlsSettings |
アップストリーム | サービスがサーバーレス モードの場合のアップストリームの設定。 | ServerlessUpstreamSettings |
SignalRCorsSettings
名前 | 説明 | 値 |
---|---|---|
allowedOrigins | クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345 )。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべての を許可します。 |
string[] |
SignalRFeature
名前 | 説明 | 値 |
---|---|---|
flag | FeatureFlags は、Azure SignalR サービスでサポートされている機能です。 - ServiceMode: SignalR サービスのバックエンド サーバーのフラグ。 許可される値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来の使用に使用します。 - EnableConnectivityLogs: "true"/"false"。接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableMessagingLogs: "true"/"false"。接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableLiveTrace: ライブ トレースを使用すると、Azure SignalR サービス内で何が起こっているかを知ることができます。リアルタイムでライブ トレースが提供されます。独自の Azure SignalR ベースの Web アプリケーションを開発したり、いくつかの問題を自己トラブルシューティングしたりする場合に役立ちます。 ライブ トレースは、課金される送信メッセージとしてカウントされることに注意してください。 許可される値: "true"/"false"。ライブ トレース機能を有効または無効にします。 |
'EnableConnectivityLogs' 'EnableLiveTrace' 'EnableMessagingLogs' 'ServiceMode' (必須) |
properties | この機能に関連する省略可能なプロパティ。 | SignalRFeatureProperties |
value | 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ 。 |
string (必須) 制約: 最小長 = 1 最大長 = 128 |
SignalRFeatureProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
LiveTraceConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | LiveTraceCategory[] |
enabled | ライブ トレースを有効にするかどうかを示します。 true に設定すると、ライブ トレース クライアントはサービスに接続できます。 それ以外の場合、ライブ トレース クライアントはサービスに接続できないため、"カテゴリ" で構成した内容に関係なく、ログを受信できなくなります。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
LiveTraceCategory
名前 | 説明 | 値 |
---|---|---|
enabled | ライブ トレース カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | ライブ トレース カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRNetworkACL
名前 | 説明 | 値 |
---|---|---|
defaultAction | Azure ネットワーク ACL アクション。 | 'Allow' 'Deny' |
privateEndpoints | プライベート エンドポイントからの要求の ACL | PrivateEndpointACL[] |
publicNetwork | Network 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' |
ResourceLogConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | ResourceLogCategory[] |
ResourceLogCategory
名前 | 説明 | 値 |
---|---|---|
enabled | リソース ログ カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | リソース ログ カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRTlsSettings
名前 | 説明 | 値 |
---|---|---|
clientCertEnabled | TLS ハンドシェイク中にクライアント証明書を要求する (有効な場合) | [bool] |
ServerlessUpstreamSettings
名前 | 説明 | 値 |
---|---|---|
テンプレート | アップストリーム URL テンプレートの一覧を取得または設定します。 順序が重要であり、最初に一致するテンプレートが効果を受け取ります。 | UpstreamTemplate[] |
UpstreamTemplate
名前 | 説明 | 値 |
---|---|---|
auth | アップストリーム認証設定。 設定されていない場合、アップストリーム メッセージには認証は使用されません。 | UpstreamAuthSettings |
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. 1 つのハブ名 ("hub1" など) は、"hub1" と一致します。 |
string |
urlTemplate | アップストリーム URL テンプレートを取得または設定します。 テンプレート内には 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 たとえば、urlTemplate が の http://example.com/{hub}/api/{event} 場合、ハブchat からのクライアント要求が接続されると、最初に次の URL に POST されます。 http://example.com/chat/api/connect |
string (必須) |
UpstreamAuthSettings
名前 | 説明 | 値 |
---|---|---|
managedIdentity | アップストリームのマネージド ID 設定。 | ManagedIdentitySettings |
型 | アップストリーム認証の種類列挙型。 | 'ManagedIdentity' 'None' |
ManagedIdentitySettings
名前 | 説明 | 値 |
---|---|---|
resource | ターゲット リソースのアプリ ID URI を示すリソース。 また、発行されたトークンの aud (対象ユーザー) 要求にも表示されます。 |
string |
ResourceSku
名前 | 説明 | 値 |
---|---|---|
capacity | 省略可能、整数。 リソースの単位数。 既定では 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 SignalR Serviceを作成します。 |
ARM テンプレート リソース定義
signalR リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドに関するページを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.SignalRService/signalR リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.SignalRService/signalR",
"apiVersion": "2022-02-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"sku": {
"capacity": "int",
"name": "string",
"tier": "string"
},
"kind": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {}
}
},
"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"
}
]
},
"tls": {
"clientCertEnabled": "bool"
},
"upstream": {
"templates": [
{
"auth": {
"managedIdentity": {
"resource": "string"
},
"type": "string"
},
"categoryPattern": "string",
"eventPattern": "string",
"hubPattern": "string",
"urlTemplate": "string"
}
]
}
}
}
プロパティ値
signalR
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.SignalRService/signalR' |
apiVersion | リソース API のバージョン | '2022-02-01' |
name | リソース名 | string (必須) 文字数制限: 3 から 63 有効な文字: 英数字とハイフン。 文字で開始します。 文字または数字で終了します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースの GEO の場所。 例: 米国西部、米国東部、米国中北部、米国中南部。 | string |
tags | リソースを記述するキー値ペアの一覧であるサービスのタグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
sku | リソースの課金情報。 | ResourceSku |
kind | サービスの種類は、SignalR または RawWebSocket です | 'RawWebSockets' 'SignalR' |
identity | クラスは、要求と応答に使用されるマネージド ID を表します | ManagedIdentity |
properties | リソースのプロパティを記述するクラス | SignalRProperties |
ManagedIdentity
名前 | 説明 | 値 |
---|---|---|
type | id の種類を表します: systemAssigned、userAssigned、None | 'None' 'SystemAssigned' 'UserAssigned' |
userAssignedIdentities | ユーザー割り当て ID を取得または設定する | ManagedIdentityUserAssignedIdentities |
ManagedIdentityUserAssignedIdentities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | UserAssignedIdentityProperty |
UserAssignedIdentityProperty
このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
SignalRProperties
名前 | 説明 | 値 |
---|---|---|
cors | クロスオリジン リソース共有 (CORS) 設定。 | SignalRCorsSettings |
disableAadAuth | DisableLocalAuth aad 認証を有効または無効にする true に設定すると、AuthType=aad との接続は機能しません。 |
[bool] |
disableLocalAuth | DisableLocalAuth AccessKey を使用してローカル認証を有効または無効にする true に設定すると、AccessKey=xxx との接続は機能しません。 |
[bool] |
features | featureFlags の一覧。 更新操作のパラメーターに含まれていない FeatureFlags は変更されません。 応答には、明示的に設定された featureFlags のみが含まれます。 featureFlag が明示的に設定されていない場合、グローバルな既定値が使用されます ただし、既定値は "false" を意味するわけではない点に注意してください。 これは、異なる FeatureFlags の観点から異なります。 |
SignalRFeature[] |
liveTraceConfiguration | Microsoft.SignalRService リソースのライブ トレース構成。 | LiveTraceConfiguration |
networkACLs | リソースのネットワーク ACL | SignalRNetworkACLs |
publicNetworkAccess | パブリック ネットワーク アクセスを有効または無効にします。 既定値は "Enabled" です。 有効になっている場合でも、ネットワーク ACL が適用されます。 [無効] にすると、ネットワーク ACL で設定した内容に関係なく、パブリック ネットワーク アクセスは常に無効になります。 |
string |
resourceLogConfiguration | Microsoft.SignalRService リソースのリソース ログ構成。 | ResourceLogConfiguration |
Tls | リソースの TLS 設定 | SignalRTlsSettings |
アップストリーム | サービスがサーバーレス モードの場合のアップストリームの設定。 | ServerlessUpstreamSettings |
SignalRCorsSettings
名前 | 説明 | 値 |
---|---|---|
allowedOrigins | クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345 )。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべて許可します。 |
string[] |
SignalRFeature
名前 | 説明 | 値 |
---|---|---|
flag | FeatureFlags は、Azure SignalR サービスでサポートされている機能です。 - ServiceMode: SignalR サービスのバックエンド サーバーにフラグを設定します。 使用できる値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来使用します。 - EnableConnectivityLogs: "true"/"false"、接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableMessagingLogs: "true"/"false"、接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableLiveTrace: Live Trace を使用すると、Azure SignalR サービス内で何が起こっているかを知ることができます。リアルタイムでライブ トレースが提供されます。独自の Azure SignalR ベースの Web アプリケーションを開発したり、いくつかの問題を自己トラブルシューティングしたりする場合に役立ちます。 ライブ トレースは、課金される送信メッセージとしてカウントされることに注意してください。 使用可能な値: "true"/"false"。ライブ トレース機能を有効または無効にします。 |
'EnableConnectivityLogs' 'EnableLiveTrace' 'EnableMessagingLogs' 'ServiceMode' (必須) |
properties | この機能に関連する省略可能なプロパティ。 | SignalRFeatureProperties |
value | 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ 。 |
string (必須) 制約: 最小長 = 1 最大長 = 128 |
SignalRFeatureProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
LiveTraceConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | LiveTraceCategory[] |
enabled | ライブ トレースを有効にするかどうかを示します。 true に設定すると、ライブ トレース クライアントはサービスに接続できます。 それ以外の場合、ライブ トレース クライアントはサービスに接続できないため、"カテゴリ" で構成した内容に関係なく、ログを受信できなくなります。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
LiveTraceCategory
名前 | 説明 | 値 |
---|---|---|
enabled | ライブ トレース カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | ライブ トレース カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRNetworkACLs
名前 | 説明 | 値 |
---|---|---|
defaultAction | Azure ネットワーク ACL アクション。 | 'Allow' 'Deny' |
privateEndpoints | プライベート エンドポイントからの要求の ACL | PrivateEndpointACL[] |
publicNetwork | Network 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' |
ResourceLogConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | ResourceLogCategory[] |
ResourceLogCategory
名前 | 説明 | 値 |
---|---|---|
enabled | リソース ログ カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | リソース ログ カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRTlsSettings
名前 | 説明 | 値 |
---|---|---|
clientCertEnabled | TLS ハンドシェイク中にクライアント証明書を要求する (有効な場合) | [bool] |
ServerlessUpstreamSettings
名前 | 説明 | 値 |
---|---|---|
テンプレート | アップストリーム URL テンプレートの一覧を取得または設定します。 順序が重要であり、最初に一致するテンプレートが効果を受け取ります。 | UpstreamTemplate[] |
UpstreamTemplate
名前 | 説明 | 値 |
---|---|---|
auth | アップストリーム認証設定。 設定されていない場合、アップストリーム メッセージには認証は使用されません。 | UpstreamAuthSettings |
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. 1 つのハブ名 ("hub1" など) は、"hub1" と一致します。 |
string |
urlTemplate | アップストリーム URL テンプレートを取得または設定します。 テンプレート内には 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 たとえば、urlTemplate が の http://example.com/{hub}/api/{event} 場合、ハブchat からのクライアント要求が接続されると、最初に次の URL に POST されます。 http://example.com/chat/api/connect |
string (必須) |
UpstreamAuthSettings
名前 | 説明 | 値 |
---|---|---|
managedIdentity | アップストリームのマネージド ID 設定。 | ManagedIdentitySettings |
型 | アップストリーム認証の種類列挙型。 | 'ManagedIdentity' 'None' |
ManagedIdentitySettings
名前 | 説明 | 値 |
---|---|---|
resource | ターゲット リソースのアプリ ID URI を示すリソース。 また、発行されたトークンの aud (対象ユーザー) 要求にも表示されます。 |
string |
ResourceSku
名前 | 説明 | 値 |
---|---|---|
capacity | 省略可能、整数。 リソースの単位数。 既定では 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 SignalR Serviceを作成します。 |
Terraform (AzAPI プロバイダー) リソース定義
signalR リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.SignalRService/signalR リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.SignalRService/signalR@2022-02-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
identity {
type = "string"
identity_ids = []
}
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"
}
]
}
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"
}
kind = "string"
})
}
プロパティ値
signalR
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.SignalRService/signalR@2022-02-01" |
name | リソース名 | string (必須) 文字数制限: 3 から 63 有効な文字: 英数字とハイフン。 文字で開始します。 文字または数字で終了します。 リソース名は、Azure 全体で一意である必要があります。 |
location | リソースの GEO の場所。 たとえば、米国西部、米国東部、米国中北部、米国中南部などです。 | string |
parent_id | リソース グループにデプロイするには、そのリソース グループの ID を使用します。 | string (必須) |
tags | リソースを記述するキー値ペアの一覧であるサービスのタグ。 | タグ名と値のディクショナリ。 |
sku | リソースの課金情報。 | ResourceSku |
kind | サービスの種類は、SignalR または RawWebSocket です | "RawWebSockets" "SignalR" |
identity | クラスは、要求と応答に使用されるマネージド ID を表します | ManagedIdentity |
properties | リソースのプロパティを記述するクラス | SignalRProperties |
ManagedIdentity
名前 | 説明 | 値 |
---|---|---|
type | id の種類を表します: systemAssigned、userAssigned、None | "SystemAssigned" "UserAssigned" |
identity_ids | ユーザー割り当て ID を取得または設定する | ユーザー ID ID の配列。 |
ManagedIdentityUserAssignedIdentities
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | UserAssignedIdentityProperty |
UserAssignedIdentityProperty
このオブジェクトには、デプロイ中に設定するプロパティは含まれません。 すべてのプロパティは ReadOnly です。
SignalRProperties
名前 | 説明 | 値 |
---|---|---|
cors | クロスオリジン リソース共有 (CORS) 設定。 | SignalRCorsSettings |
disableAadAuth | DisableLocalAuth aad 認証を有効または無効にする true に設定すると、AuthType=aad との接続は機能しません。 |
[bool] |
disableLocalAuth | DisableLocalAuth AccessKey を使用してローカル認証を有効または無効にする true に設定すると、AccessKey=xxx との接続は機能しません。 |
[bool] |
features | featureFlags の一覧。 更新操作のパラメーターに含まれていない FeatureFlags は変更されません。 また、応答には、明示的に設定された featureFlags のみが含まれます。 featureFlag が明示的に設定されていない場合、そのグローバルな既定値が使用されます ただし、既定値は "false" を意味するものではありません。 FeatureFlags によって異なります。 |
SignalRFeature[] |
liveTraceConfiguration | Microsoft.SignalRService リソースのライブ トレース構成。 | LiveTraceConfiguration |
networkACLs | リソースのネットワーク ACL | SignalRNetworkACL |
publicNetworkAccess | パブリック ネットワーク アクセスを有効または無効にします。 既定値は "Enabled" です。 有効にすると、ネットワーク ACL は引き続き適用されます。 [無効] にすると、ネットワーク ACL で設定した内容に関係なく、パブリック ネットワーク アクセスは常に無効になります。 |
string |
resourceLogConfiguration | Microsoft.SignalRService リソースのリソース ログ構成。 | ResourceLogConfiguration |
Tls | リソースの TLS 設定 | SignalRTlsSettings |
アップストリーム | サービスがサーバーレス モードの場合のアップストリームの設定。 | ServerlessUpstreamSettings |
SignalRCorsSettings
名前 | 説明 | 値 |
---|---|---|
allowedOrigins | クロスオリジン呼び出しを許可する必要がある配信元の一覧を取得または設定します (例: http://example.com:12345 )。 すべてを許可するには "*" を使用します。 省略した場合は、既定ですべての を許可します。 |
string[] |
SignalRFeature
名前 | 説明 | 値 |
---|---|---|
flag | FeatureFlags は、Azure SignalR サービスでサポートされている機能です。 - ServiceMode: SignalR サービスのバックエンド サーバーのフラグ。 許可される値: "Default": 独自のバックエンド サーバーがあります。"サーバーレス": アプリケーションにバックエンド サーバーがありません。"クラシック": 下位互換性のため。 既定モードとサーバーレス モードの両方をサポートしますが、推奨されません。"PredefinedOnly": 将来の使用に使用します。 - EnableConnectivityLogs: "true"/"false"。接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableMessagingLogs: "true"/"false"。接続ログ カテゴリをそれぞれ有効または無効にします。 - EnableLiveTrace: ライブ トレースを使用すると、Azure SignalR サービス内で何が起こっているかを知ることができます。リアルタイムでライブ トレースが提供されます。独自の Azure SignalR ベースの Web アプリケーションを開発したり、いくつかの問題を自己トラブルシューティングしたりする場合に役立ちます。 ライブ トレースは、課金される送信メッセージとしてカウントされることに注意してください。 許可される値: "true"/"false"。ライブ トレース機能を有効または無効にします。 |
"EnableConnectivityLogs" "EnableLiveTrace" "EnableMessagingLogs" "ServiceMode" (必須) |
properties | この機能に関連する省略可能なプロパティ。 | SignalRFeatureProperties |
value | 機能フラグの値。 許可される値については、Azure SignalR サービスのドキュメントを参照してください https://docs.microsoft.com/azure/azure-signalr/ 。 |
string (必須) 制約: 最小長 = 1 最大長 = 128 |
SignalRFeatureProperties
名前 | 説明 | 値 |
---|---|---|
{カスタマイズされたプロパティ} | string |
LiveTraceConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | LiveTraceCategory[] |
enabled | ライブ トレースを有効にするかどうかを示します。 true に設定すると、ライブ トレース クライアントはサービスに接続できます。 それ以外の場合、ライブ トレース クライアントはサービスに接続できないため、"カテゴリ" で構成した内容に関係なく、ログを受信できなくなります。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
LiveTraceCategory
名前 | 説明 | 値 |
---|---|---|
enabled | ライブ トレース カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | ライブ トレース カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRNetworkACLs
名前 | 説明 | 値 |
---|---|---|
defaultAction | Azure ネットワーク ACL アクション。 | "許可" "Deny" |
privateEndpoints | プライベート エンドポイントからの要求の ACL | PrivateEndpointACL[] |
publicNetwork | Network 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" |
ResourceLogConfiguration
名前 | 説明 | 値 |
---|---|---|
categories | カテゴリ構成の一覧を取得または設定します。 | ResourceLogCategory[] |
ResourceLogCategory
名前 | 説明 | 値 |
---|---|---|
enabled | リソース ログ カテゴリが有効かどうかを示します。 使用可能な値: true、false。 大文字と小文字は区別されません。 |
string |
name | リソース ログ カテゴリの名前を取得または設定します。 使用可能な値: ConnectivityLogs、MessagingLogs。 大文字と小文字は区別されません。 |
string |
SignalRTlsSettings
名前 | 説明 | 値 |
---|---|---|
clientCertEnabled | TLS ハンドシェイク中にクライアント証明書を要求する (有効な場合) | [bool] |
ServerlessUpstreamSettings
名前 | 説明 | 値 |
---|---|---|
テンプレート | アップストリーム URL テンプレートの一覧を取得または設定します。 順序は重要であり、最初に一致するテンプレートが効果を受け取ります。 | UpstreamTemplate[] |
UpstreamTemplate
名前 | 説明 | 値 |
---|---|---|
auth | アップストリーム認証設定。 設定されていない場合、アップストリーム メッセージには認証は使用されません。 | UpstreamAuthSettings |
categoryPattern | カテゴリ名の一致パターンを取得または設定します。 設定されていない場合は、任意のカテゴリと一致します。 次の 3 種類のパターンがサポートされています。 1. "*", それは、任意のカテゴリ名に一致します. 2. 複数のカテゴリを "," ("connections,messages" など) と組み合わせると、カテゴリ "connections" と "messages" と一致します。 3. 単一のカテゴリ名 ("connections"など) は、カテゴリ "connections" と一致します。 |
string |
eventPattern | イベント名の一致パターンを取得または設定します。 設定されていない場合は、任意のイベントと一致します。 次の 3 種類のパターンがサポートされています。 1. "*" は、任意のイベント名と一致します。 2.複数のイベントを "、"connect,disconnect" などと組み合わせると、イベント "connect" と "disconnect" と一致します。 3. 単一のイベント名 (例: "connect"、"connect" と一致します)。 |
string |
hubPattern | ハブ名の一致パターンを取得または設定します。 設定されていない場合は、任意のハブと一致します。 次の 3 種類のパターンがサポートされています。 1. "*" は、任意のハブ名と一致します。 2. 複数のハブを ","(たとえば"hub1,hub2") と組み合わせると、"hub1" と "hub2" と一致します。 3. 単一のハブ名 ("hub1" など) は、"hub1" と一致します。 |
string |
urlTemplate | アップストリーム URL テンプレートを取得または設定します。 テンプレート内で 3 つの定義済みパラメーター {hub}、{category} {event} を使用できます。アップストリーム URL の値は、クライアント要求が入ったときに動的に計算されます。 たとえば、urlTemplate が の http://example.com/{hub}/api/{event} 場合、ハブchat からのクライアント要求が接続されると、最初に次の URL に POST されます。 http://example.com/chat/api/connect |
string (必須) |
UpstreamAuthSettings
名前 | 説明 | 値 |
---|---|---|
managedIdentity | アップストリームのマネージド ID 設定。 | ManagedIdentitySettings |
型 | アップストリーム認証の種類列挙型。 | "ManagedIdentity" "None" |
ManagedIdentitySettings
名前 | 説明 | 値 |
---|---|---|
resource | ターゲット リソースのアプリ ID URI を示すリソース。 また、発行されたトークンの aud (対象ユーザー) 要求にも表示されます。 |
string |
ResourceSku
名前 | 説明 | 値 |
---|---|---|
capacity | 省略可能、整数。 リソースの単位数。 既定では 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" |