Microsoft.MobileNetwork mobileNetworks/services
Bicep リソース定義
mobileNetworks/services リソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.MobileNetwork/mobileNetworks/services リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
pccRules: [
{
ruleName: 'string'
rulePrecedence: int
ruleQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
guaranteedBitRate: {
downlink: 'string'
uplink: 'string'
}
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
serviceDataFlowTemplates: [
{
direction: 'string'
ports: [
'string'
]
protocol: [
'string'
]
remoteIpList: [
'string'
]
templateName: 'string'
}
]
trafficControl: 'string'
}
]
servicePrecedence: int
serviceQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
プロパティ値
Ambr
| 名前 | 形容 | 価値 |
|---|---|---|
| ダウンリンク | ダウンリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
| アップリンク | アップリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
Microsoft.MobileNetwork/mobileNetworks/services
| 名前 | 形容 | 価値 |
|---|---|---|
| 場所 | リソースが存在する地理的な場所 | string (必須) |
| 名前 | リソース名 | 糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| 親 | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「親リソースの外部 |
種類のリソースのシンボリック名: mobileNetworks |
| プロパティ | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
PccRuleConfiguration
| 名前 | 形容 | 価値 |
|---|---|---|
| ruleName | ルールの名前。 これは、親サービス内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルール間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルールで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| ruleQosPolicy | このルールに一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
| serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) |
| trafficControl | このデータ フロー ポリシー ルールに一致するフローを許可するかどうかを決定します。 | 'Blocked' 'Enabled' |
PccRuleQosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| guaranteedBitRate | このデータ フロー ポリシー ルールを使用するすべてのサービス データ フローの保証ビット レート (GBR)。 これは省略可能な設定です。 値を指定しない場合、この QoS 定義を使用するデータ フロー ポリシー ルールには GBR が設定されません。 | Ambr |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
QosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
ServiceDataFlowTemplate
| 名前 | 形容 | 価値 |
|---|---|---|
| 方向 | このフローの方向。 | '双方向' 'Downlink' 'アップリンク' (必須) |
| ポート | このフローに対して UUID が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、protocol フィールドに ip 以外の値を指定する必要があります。 これは省略可能な設定です。 指定しない場合、すべてのポートで接続が許可されます。 ポート範囲は、FirstPort>-<LastPort><指定する必要があります。 例: [8080,8082-8085]。 |
糸 制約： パターン = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$[] |
| 議定書 | このフローで許可されているプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、ip値を使用します。 プロトコルの選択のみを許可する場合は、「https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml」で説明されているように、各プロトコルに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合、17 を使用する必要があります。
ip 値を使用する場合は、フィールド port 指定しない必要があります。 |
糸 制約： Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$[] (必須) |
| remoteIpList | このフローに対して UUID が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、any値を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。 |
糸 制約： Pattern = ^(any|(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2])))$[] (必須) |
| templateName | データ フロー テンプレートの名前。 これは、親データ フロー ポリシールール内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
ServicePropertiesFormat
| 名前 | 形容 | 価値 |
|---|---|---|
| pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) |
| servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのサービスで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy の |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|
クイック スタートのサンプル
次のクイック スタート サンプルでは、このリソースの種類をデプロイします。
| Bicep ファイル | 形容 |
|---|---|
| 完全な 5G Core デプロイ を作成する | このテンプレートでは、SIM のプロビジョニングやサンプル QoS ポリシーの作成など、プライベート 5G Core のデプロイに必要なすべてのリソースが作成されます。 必要に応じて、Azure Stack Edge デバイスで実行されている Kubernetes クラスターにデプロイできます。 |
| sim ポリシー を作成する | このテンプレートは、既存のモバイル ネットワークのサービスと SIM ポリシーを作成します。 |
ARM テンプレート リソース定義
mobileNetworks/services リソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの - リソース グループのデプロイ コマンド 参照
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.MobileNetwork/mobileNetworks/services リソースを作成するには、次の JSON をテンプレートに追加します。
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2024-04-01",
"name": "string",
"location": "string",
"properties": {
"pccRules": [
{
"ruleName": "string",
"rulePrecedence": "int",
"ruleQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"guaranteedBitRate": {
"downlink": "string",
"uplink": "string"
},
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
},
"serviceDataFlowTemplates": [
{
"direction": "string",
"ports": [ "string" ],
"protocol": [ "string" ],
"remoteIpList": [ "string" ],
"templateName": "string"
}
],
"trafficControl": "string"
}
],
"servicePrecedence": "int",
"serviceQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
プロパティ値
Ambr
| 名前 | 形容 | 価値 |
|---|---|---|
| ダウンリンク | ダウンリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
| アップリンク | アップリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
Microsoft.MobileNetwork/mobileNetworks/services
| 名前 | 形容 | 価値 |
|---|---|---|
| apiVersion | API のバージョン | '2024-04-01' |
| 場所 | リソースが存在する地理的な場所 | string (必須) |
| 名前 | リソース名 | 糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| プロパティ | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 テンプレート の |
| 種類 | リソースの種類 | 'Microsoft.MobileNetwork/mobileNetworks/services' |
PccRuleConfiguration
| 名前 | 形容 | 価値 |
|---|---|---|
| ruleName | ルールの名前。 これは、親サービス内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルール間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルールで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| ruleQosPolicy | このルールに一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
| serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) |
| trafficControl | このデータ フロー ポリシー ルールに一致するフローを許可するかどうかを決定します。 | 'Blocked' 'Enabled' |
PccRuleQosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| guaranteedBitRate | このデータ フロー ポリシー ルールを使用するすべてのサービス データ フローの保証ビット レート (GBR)。 これは省略可能な設定です。 値を指定しない場合、この QoS 定義を使用するデータ フロー ポリシー ルールには GBR が設定されません。 | Ambr |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
QosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
ServiceDataFlowTemplate
| 名前 | 形容 | 価値 |
|---|---|---|
| 方向 | このフローの方向。 | '双方向' 'Downlink' 'アップリンク' (必須) |
| ポート | このフローに対して UUID が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、protocol フィールドに ip 以外の値を指定する必要があります。 これは省略可能な設定です。 指定しない場合、すべてのポートで接続が許可されます。 ポート範囲は、FirstPort>-<LastPort><指定する必要があります。 例: [8080,8082-8085]。 |
糸 制約： パターン = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$[] |
| 議定書 | このフローで許可されているプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、ip値を使用します。 プロトコルの選択のみを許可する場合は、「https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml」で説明されているように、各プロトコルに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合、17 を使用する必要があります。
ip 値を使用する場合は、フィールド port 指定しない必要があります。 |
糸 制約： Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$[] (必須) |
| remoteIpList | このフローに対して UUID が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、any値を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。 |
糸 制約： Pattern = ^(any|(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2])))$[] (必須) |
| templateName | データ フロー テンプレートの名前。 これは、親データ フロー ポリシールール内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
ServicePropertiesFormat
| 名前 | 形容 | 価値 |
|---|---|---|
| pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) |
| servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのサービスで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy の |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|
クイック スタート テンプレート
次のクイック スタート テンプレートでは、このリソースの種類をデプロイします。
| テンプレート | 形容 |
|---|---|
|
完全な 5G Core デプロイ を作成する Azure にデプロイする |
このテンプレートでは、SIM のプロビジョニングやサンプル QoS ポリシーの作成など、プライベート 5G Core のデプロイに必要なすべてのリソースが作成されます。 必要に応じて、Azure Stack Edge デバイスで実行されている Kubernetes クラスターにデプロイできます。 |
|
sim ポリシー を作成する Azure にデプロイする |
このテンプレートは、既存のモバイル ネットワークのサービスと SIM ポリシーを作成します。 |
Terraform (AzAPI プロバイダー) リソース定義
mobileNetworks/services リソースの種類は、次を対象とする操作と共にデプロイできます。
- リソース グループの
各 API バージョンで変更されたプロパティの一覧については、変更ログの
リソースの形式
Microsoft.MobileNetwork/mobileNetworks/services リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
pccRules = [
{
ruleName = "string"
rulePrecedence = int
ruleQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
guaranteedBitRate = {
downlink = "string"
uplink = "string"
}
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
serviceDataFlowTemplates = [
{
direction = "string"
ports = [
"string"
]
protocol = [
"string"
]
remoteIpList = [
"string"
]
templateName = "string"
}
]
trafficControl = "string"
}
]
servicePrecedence = int
serviceQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
}
})
}
プロパティ値
Ambr
| 名前 | 形容 | 価値 |
|---|---|---|
| ダウンリンク | ダウンリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
| アップリンク | アップリンク ビット レート。 | 糸 制約： パターン = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (必須) |
Microsoft.MobileNetwork/mobileNetworks/services
| 名前 | 形容 | 価値 |
|---|---|---|
| 場所 | リソースが存在する地理的な場所 | string (必須) |
| 名前 | リソース名 | 糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: mobileNetworks |
| プロパティ | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
| タグ | リソース タグ | タグ名と値のディクショナリ。 |
| 種類 | リソースの種類 | "Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01" |
PccRuleConfiguration
| 名前 | 形容 | 価値 |
|---|---|---|
| ruleName | ルールの名前。 これは、親サービス内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
| rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルール間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルールで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| ruleQosPolicy | このルールに一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
| serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) |
| trafficControl | このデータ フロー ポリシー ルールに一致するフローを許可するかどうかを決定します。 | 'Blocked' 'Enabled' |
PccRuleQosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| guaranteedBitRate | このデータ フロー ポリシー ルールを使用するすべてのサービス データ フローの保証ビット レート (GBR)。 これは省略可能な設定です。 値を指定しない場合、この QoS 定義を使用するデータ フロー ポリシー ルールには GBR が設定されません。 | Ambr |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
QosPolicy
| 名前 | 形容 | 価値 |
|---|---|---|
| 5qi | 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。 | int 制約： 最小値 = 1 最大値 = 127 |
| allocationAndRetentionPriorityLevel | QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
int 制約： 最小値 = 1 最大値 = 15 |
| maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
| preemptionCapability | QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、優先順位の低い別の QoS フローをプリエンプションできるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | QoS フロープリエンプションの脆弱性。 QoS フローのプリエンプションの脆弱性は、優先順位の高い QoS フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 | 'NotPreemptable' 'Preemptable' |
ServiceDataFlowTemplate
| 名前 | 形容 | 価値 |
|---|---|---|
| 方向 | このフローの方向。 | '双方向' 'Downlink' 'アップリンク' (必須) |
| ポート | このフローに対して UUID が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、protocol フィールドに ip 以外の値を指定する必要があります。 これは省略可能な設定です。 指定しない場合、すべてのポートで接続が許可されます。 ポート範囲は、FirstPort>-<LastPort><指定する必要があります。 例: [8080,8082-8085]。 |
糸 制約： パターン = ^([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5])(-([1-9]|[1-9][0-9]{1,3}|[1-5][0-9]{4}|6[0-4][0-9]{3}|65[0-4][0-9]{2}|655[0-2][0-9]|6553[0-5]))?$[] |
| 議定書 | このフローで許可されているプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、ip値を使用します。 プロトコルの選択のみを許可する場合は、「https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml」で説明されているように、各プロトコルに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合、17 を使用する必要があります。
ip 値を使用する場合は、フィールド port 指定しない必要があります。 |
糸 制約： Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$[] (必須) |
| remoteIpList | このフローに対して UUID が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、any値を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。 |
糸 制約： Pattern = ^(any|(([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])\.){3}([0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])(\/([0-9]|[1-2][0-9]|3[0-2])))$[] (必須) |
| templateName | データ フロー テンプレートの名前。 これは、親データ フロー ポリシールール内で一意である必要があります。 次の予約文字列 (default、requested、または service) は使用しないでください。 |
糸 制約： 最大長 = パターン = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (必須) |
ServicePropertiesFormat
| 名前 | 形容 | 価値 |
|---|---|---|
| pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) |
| servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さい場合は、優先度が高いことを意味します。 この値は、モバイル ネットワークで構成されているすべてのサービスで一意である必要があります。 | int 制約： 最小値 = 0 最大値 = 255 (必須) |
| serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy の |
TrackedResourceTags
| 名前 | 形容 | 価値 |
|---|