Microsoft.MobileNetwork mobileNetworks/services 2022-11-01
Bicep リソース定義
mobileNetworks/services リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ - リソース グループのデプロイ コマンドを参照してください
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.MobileNetwork/mobileNetworks/services リソースを作成するには、次の Bicep をテンプレートに追加します。
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2022-11-01' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
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'
}
}
}
プロパティ値
mobileNetworks/services
名前 | 説明 | 値 |
---|---|---|
name | リソース名 Bicep で子リソースの名前と型を設定する方法を参照してください。 |
string (必須) 文字制限: 1 から 64 有効な文字: 英数字とハイフン。 英数字で開始します。 次の単語を名前として単独で使用することはできません: default 、requested 、service 。 |
location | リソースが保存されている地理的な場所 | string (必須) |
tags | リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
parent | Bicep では、子リソースの親リソースを指定できます。 このプロパティを追加する必要があるのは、子リソースが親リソースの外部で宣言されている場合のみです。 詳細については、「 親リソースの外部の子リソース」を参照してください。 |
種類のリソースのシンボル名: mobileNetworks |
properties | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
ServicePropertiesFormat
名前 | 説明 | 値 |
---|---|---|
pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) 制約: 最小長 = 1 |
servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy |
PccRuleConfiguration
名前 | 説明 | 値 |
---|---|---|
ruleName | ルールの名前です。 これは親サービス内で一意である必要があります。 予約文字列 default requested 、、または service のいずれかを使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルールを決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルール間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
ruleQosPolicy | この規則に一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) 制約: 最小長 = 1 |
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) レベル。 優先度が高いフローは、 の設定とpreemptionVulnerability 許可の場合、優先順位のpreemptionCapability 低いフローです。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 フローを、優先度レベルが低い別の 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' |
Ambr
名前 | 説明 | 値 |
---|---|---|
ダウンリンク | ダウンリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
アップリンク | アップリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名前 | 説明 | 値 |
---|---|---|
方向 | このフローの方向。 | '双方向' 'Downlink' 'アップリンク' (必須) |
ports | このフローに対して UA が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、 フィールドに 以外 ip の値を指定する protocol 必要があります。 この設定は省略可能です。 指定しない場合は、すべてのポートで接続が許可されます。 ポート範囲は{FirstPort}-{LastPort}として指定する必要があります。 例: [8080 , 8082-8085 ]. |
string[] 制約: Pattern = ^([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]))?$ |
protocol | このフローで許可されるプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、値 ip を使用します。 プロトコルの選択のみを許可する場合は、「」で説明 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml されているように、プロトコルごとに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合は 17 を使用する必要があります。 値 ip を使用する場合は、フィールド port を指定しない必要があります。 |
string (必須) 制約: 最小長 = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | このフローに対して UE が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、 の値 any を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。 |
string (必須) 制約: 最小長 = 1 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 のいずれかを使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
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) レベル。 優先度が高いフローは、 の設定とpreemptionVulnerability 許可の場合、優先順位のpreemptionCapability 低いフローです。1 が最も優先度の高いレベルです。 このフィールドが指定されていない場合は、 5qi ARP 値の派生に 使用されます。 ARP パラメータの詳細な説明については、「3GPP TS23.501 セクション 5.7.2.2」を参照してください。 |
INT 制約: 最小値 = 1 最大値 = 15 |
maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
preemptionCapability | QoS フロープリエンプション機能。 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' |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
完全な 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": "2022-11-01",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"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"
}
}
}
プロパティ値
mobileNetworks/services
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | 'Microsoft.MobileNetwork/mobileNetworks/services' |
apiVersion | リソース API のバージョン | '2022-11-01' |
name | リソース名 JSON ARM テンプレートで子リソースの名前と型を設定する方法を参照してください。 |
string (必須) 文字制限: 1 から 64 有効な文字: 英数字とハイフン。 英数字で開始します。 次の単語を名前として単独で使用することはできません: default 、requested 、service 。 |
location | リソースが保存されている地理的な場所 | string (必須) |
tags | リソース タグ。 | タグの名前と値のディクショナリ。 「テンプレート内のタグ」を参照してください |
properties | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
ServicePropertiesFormat
名前 | 説明 | 値 |
---|---|---|
pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) 制約: 最小長 = 1 |
servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy |
PccRuleConfiguration
名前 | 説明 | 値 |
---|---|---|
ruleName | ルールの名前です。 これは親サービス内で一意である必要があります。 予約文字列 default requested 、、または service のいずれかを使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルールを決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルール間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
ruleQosPolicy | この規則に一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) 制約: 最小長 = 1 |
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) レベル。 優先度が高いフローは、 の設定とpreemptionVulnerability 許可の場合、優先順位のpreemptionCapability 低いフローです。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 フローを、優先度レベルが低い別の 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' |
Ambr
名前 | 説明 | 値 |
---|---|---|
ダウンリンク | ダウンリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
アップリンク | アップリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名前 | 説明 | 値 |
---|---|---|
方向 | このフローの方向。 | '双方向' 'Downlink' 'アップリンク' (必須) |
ports | このフローに対して UUID が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、 フィールドに 以外 ip の値を指定する protocol 必要があります。 この設定は省略可能です。 指定しない場合、すべてのポートで接続が許可されます。 ポート範囲は{FirstPort}-{LastPort}として指定する必要があります。 例: [8080 , 8082-8085 ]. |
string[] 制約: Pattern = ^([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]))?$ |
protocol | このフローで許可されているプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、値 ip を使用します。 プロトコルの選択のみを許可する場合は、「」で説明 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml されているように、各プロトコルに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合は、17 を使用する必要があります。 値 ip を使用する場合は、フィールド port を指定しない必要があります。 |
string (必須) 制約: 最小長 = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | このフローに対して UE が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、値 any を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 各 IP アドレスは、ネットマスク (192.0.2.54/24 など) を含む CIDR 表記で指定する必要があります。 |
string (必須) 制約: 最小長 = 1 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 | データ フロー テンプレートの名前。 これは、親データ フロー ポリシー ルール内で一意である必要があります。 、または service のいずれかの予約文字列default requested を使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
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) レベル。 優先度が高いプリエンプト フローは、 と preemptionVulnerability のpreemptionCapability 設定で許可されている場合は、優先順位が低いフローです。1 が最も優先度の高いレベルです。 このフィールドが指定されていない場合は、 5qi が ARP 値の派生に使用されます。 ARP パラメーターの詳細については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。 |
INT 制約: 最小値 = 1 最大値 = 15 |
maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
preemptionCapability | QoS フロープリエンプション機能。 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' |
クイック スタート テンプレート
次のクイックスタート テンプレートでは、このリソースの種類をデプロイします。
Template | 説明 |
---|---|
完全な 5G Core デプロイを作成する |
このテンプレートでは、sims のプロビジョニングやサンプル QoS ポリシーの作成など、プライベート 5G Core のデプロイに必要なすべてのリソースが作成されます。 必要に応じて、Azure Stack Edge デバイスで実行されている Kubernetes クラスターにデプロイできます。 |
sim ポリシーを作成する |
このテンプレートでは、既存のモバイル ネットワークのサービスと SIM ポリシーを作成します。 |
Terraform (AzAPI プロバイダー) リソース定義
mobileNetworks/services リソースの種類は、次を対象とする操作でデプロイできます。
- リソース グループ
各 API バージョンの変更されたプロパティの一覧については、「 変更ログ」を参照してください。
リソース形式
Microsoft.MobileNetwork/mobileNetworks/services リソースを作成するには、次の Terraform をテンプレートに追加します。
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2022-11-01"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
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"
}
}
})
}
プロパティ値
mobileNetworks/services
名前 | 説明 | 値 |
---|---|---|
type | リソースの種類 | "Microsoft.MobileNetwork/mobileNetworks/services@2022-11-01" |
name | リソース名 | string (必須) 文字制限: 1 から 64 有効な文字: 英数字とハイフン。 英数字で開始します。 次の単語を名前として単独で使用することはできません: default 、requested 、service 。 |
location | リソースが保存されている地理的な場所 | string (必須) |
parent_id | このリソースの親であるリソースの ID。 | 種類のリソースの ID: mobileNetworks |
tags | リソース タグ。 | タグの名前と値のディクショナリ。 |
properties | サービスのプロパティ。 | ServicePropertiesFormat (必須) |
ServicePropertiesFormat
名前 | 説明 | 値 |
---|---|---|
pccRules | このサービスを構成するデータ フロー ポリシー ルールのセット。 | PccRuleConfiguration[] (必須) 制約: 最小長 = 1 |
servicePrecedence | 特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
serviceQosPolicy | このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 | QosPolicy |
PccRuleConfiguration
名前 | 説明 | 値 |
---|---|---|
ruleName | ルールの名前です。 これは親サービス内で一意である必要があります。 予約文字列 default requested 、、または service のいずれかを使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | 特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルールを決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルール間で一意である必要があります。 | int (必須) 制約: 最小値 = 0 最大値 = 255 |
ruleQosPolicy | この規則に一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 | PccRuleQosPolicy |
serviceDataFlowTemplates | このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 | ServiceDataFlowTemplate[] (必須) 制約: 最小長 = 1 |
trafficControl | このデータ フロー ポリシー ルールに一致するフローを許可するかどうかを決定します。 | "ブロック" "有効" |
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) レベル。 優先度が高いフローは、 の設定とpreemptionVulnerability 許可の場合、優先順位のpreemptionCapability 低いフローです。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 フローを、優先度レベルが低い別の 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" |
Ambr
名前 | 説明 | 値 |
---|---|---|
ダウンリンク | ダウンリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
アップリンク | アップリンク ビット レート。 | string (必須) 制約: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名前 | 説明 | 値 |
---|---|---|
方向 | このフローの方向。 | "双方向" "下りリンク" "アップリンク" (必須) |
ports | このフローに対して UA が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、 フィールドに 以外 ip の値を指定する protocol 必要があります。 この設定は省略可能です。 指定しない場合は、すべてのポートで接続が許可されます。 ポート範囲は{FirstPort}-{LastPort}として指定する必要があります。 例: [8080 , 8082-8085 ]. |
string[] 制約: Pattern = ^([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]))?$ |
protocol | このフローで許可されるプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、値 ip を使用します。 プロトコルの選択のみを許可する場合は、「」で説明 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml されているように、プロトコルごとに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合は 17 を使用する必要があります。 値 ip を使用する場合は、フィールド port を指定しない必要があります。 |
string (必須) 制約: 最小長 = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | このフローに対して UE が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、 の値 any を使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。 |
string (必須) 制約: 最小長 = 1 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 のいずれかを使用しないでください。 |
string (必須) 制約: 最大長 = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
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) レベル。 優先度が高いフローは、 の設定とpreemptionVulnerability 許可の場合、優先順位のpreemptionCapability 低いフローです。1 が最も優先度の高いレベルです。 このフィールドが指定されていない場合は、 5qi ARP 値の派生に 使用されます。 ARP パラメータの詳細な説明については、「3GPP TS23.501 セクション 5.7.2.2」を参照してください。 |
INT 制約: 最小値 = 1 最大値 = 15 |
maximumBitRate | このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 | Ambr (必須) |
preemptionCapability | QoS フロープリエンプション機能。 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" |