Microsoft.MobileNetwork mobileNetworks/services
Bicep 資源定義
mobileNetworks/services 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.MobileNetwork/mobileNetworks/services 資源,請將下列 Bicep 新增至您的範本。
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2024-02-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 中設定子資源的名稱和類型。 |
需要字串 () 字元限制:1-64 合法字元: 英數字元和連字號。 以英數字元開頭。 下列單字不能單獨作為名稱使用: default 、、requested service 。 |
location | 資源所在的地理位置 | 需要字串 () |
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 。 |
需要字串 () 約束: 最大長度 = 64 模式 = ^(?!(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 最大長度 = 15 |
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 | ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程,如果的 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' |
Ambr
名稱 | 描述 | 值 |
---|---|---|
下行 | 下行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
上行 | 上行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名稱 | 描述 | 值 |
---|---|---|
direction | 此流程的方向。 | '雙向' 'Downlink' 必要 ('Uplink') |
連接埠 | 埠 (要連線到此流程的 UE) 。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍,則必須在欄位中指定以外的ip protocol 值。 這是選擇性的設定。 如果您未指定,則會在所有埠上允許連線。 埠範圍必須指定為 {FirstPort}-{LastPort}。 例如: [8080 , 8082-8085 ]。 |
string[] 約束: 模式 = ^([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 。 如果您只想允許選取通訊協定,則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼,如 中所述 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml 。 例如,針對 UDP,您必須使用 17。 如果您使用 此值 ip ,則必須將字段 port 保留為未指定。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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位址。 您必須以 CIDR 表示法提供每個 IP 位址,包括 netmask (,例如 192.0.2.54/24) 。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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 。 |
字串 (必要) 約束: 最大長度 = 64 模式 = ^(?!(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 | ARP) 層級 (QoS 流量配置和保留優先順序。 如果的設定 preemptionCapability 允許, preemptionVulnerability 具有較高優先順序的流程優先處理流程。1 是優先順序最高的層級。 如果未指定此欄位,則會 5qi 用來衍生 ARP 值。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 |
int 約束: 最小值 = 1 最大值 = 15 |
maximumBitRate | 使用此數據流原則規則或服務之所有服務數據流的最大比特率 (MBR) 。 | Ambr (必要) |
preemptionCapability | QoS Flow 先占功能。 QoS 流程的先佔功能可控制其是否可以優先於優先順序較低的另一個 QoS 流程。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | QoS 流程先占弱點。 QoS 流程的先佔弱點可控制 QoS 流程是否可以優先取用優先順序較高的 QoS 流程。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 | 'NotPreemptable' 'Preemptable' |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
建立完整的 5G 核心部署 |
此範本會建立部署私人 5G 核心所需的所有資源,包括布建 sims 和建立範例 QoS 原則。 您可以選擇性地部署到在 Azure Stack Edge 裝置上執行的 Kubernetes 叢集。 |
建立 sim 卡原則 |
此範本會為現有的行動網路建立服務和 sim 原則。 |
ARM 範本資源定義
mobileNetworks/services 資源類型可以使用目標作業來部署:
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單,請參閱 變更記錄。
資源格式
若要建立 Microsoft.MobileNetwork/mobileNetworks/services 資源,請將下列 JSON 新增至您的範本。
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2024-02-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
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | 'Microsoft.MobileNetwork/mobileNetworks/services' |
apiVersion | 資源 API 版本 | '2024-02-01' |
NAME | 資源名稱 請參閱如何在 JSON ARM 樣本中設定子資源的名稱和類型。 |
字串 (必要) 字元限制:1-64 合法字元: 英數字元和連字號。 以英數字元開頭。 下列單字不能單獨用來做為名稱: default 、、requested service 。 |
location | 資源所在的地理位置 | 字串 (必要) |
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 。 |
需要字串 () 約束: 最大長度 = 64 模式 = ^(?!(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 最大長度 = 15 |
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 | ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程,如果的 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' |
Ambr
名稱 | 描述 | 值 |
---|---|---|
下行 | 下行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
上行 | 上行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名稱 | 描述 | 值 |
---|---|---|
direction | 此流程的方向。 | '雙向' 'Downlink' 必要 ('Uplink') |
連接埠 | 埠 (要連線到此流程的 UE) 。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍,則必須在欄位中指定以外的ip protocol 值。 這是選擇性的設定。 如果您未指定,則會在所有埠上允許連線。 埠範圍必須指定為 {FirstPort}-{LastPort}。 例如: [8080 , 8082-8085 ]。 |
string[] 約束: 模式 = ^([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 。 如果您只想允許選取通訊協定,則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼,如 中所述 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml 。 例如,針對 UDP,您必須使用 17。 如果您使用 此值 ip ,則必須將字段 port 保留為未指定。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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位址。 您必須以 CIDR 表示法提供每個 IP 位址,包括 netmask (,例如 192.0.2.54/24) 。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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 。 |
需要字串 () 約束: 最大長度 = 64 模式 = ^(?!(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 | ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程,如果的 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' |
快速入門範本
下列快速入門範本會部署此資源類型。
範本 | 描述 |
---|---|
建立完整的 5G 核心部署 |
此範本會建立部署私人 5G 核心所需的所有資源,包括布建 sims 和建立範例 QoS 原則。 您可以選擇性地部署到在 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@2024-02-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
名稱 | 描述 | 值 |
---|---|---|
類型 | 資源類型 | “Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01” |
NAME | 資源名稱 | 需要字串 () 字元限制:1-64 合法字元: 英數字元和連字號。 以英數字元開頭。 下列單字不能單獨作為名稱使用: default 、、requested service 。 |
location | 資源所在的地理位置 | 需要字串 () |
parent_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 。 |
需要字串 () 約束: 最大長度 = 64 模式 = ^(?!(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 最大長度 = 15 |
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 | ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程,如果的 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” |
Ambr
名稱 | 描述 | 值 |
---|---|---|
下行 | 下行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
上行 | 上行連結比特率。 | 需要字串 () 約束: 模式 = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
名稱 | 描述 | 值 |
---|---|---|
direction | 此流程的方向。 | “雙向” “Downlink” 「上行連結」 (必要) |
連接埠 | 埠 (要連線到此流程的 UE) 。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍,則必須在欄位中指定以外的ip protocol 值。 這是選擇性的設定。 如果您未指定,則會在所有埠上允許連線。 埠範圍必須指定為 {FirstPort}-{LastPort}。 例如: [8080 , 8082-8085 ]。 |
string[] 約束: 模式 = ^([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 。 如果您只想允許選取通訊協定,則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼,如 中所述 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml 。 例如,針對 UDP,您必須使用 17。 如果您使用 此值 ip ,則必須將字段 port 保留為未指定。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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位址。 您必須以 CIDR 表示法提供每個 IP 位址,包括 netmask (,例如 192.0.2.54/24) 。 |
需要字串 () 約束: 最小長度 = 1 模式 = ^(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 。 |
需要字串 () 約束: 最大長度 = 64 模式 = ^(?!(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 | ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程,如果的 preemptionCapability 設定允許 preemptionVulnerability ,則為 。1 是優先順序最高的層級。 如果未指定此欄位,則會 5qi 用來衍生 ARP 值。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 |
int 約束: 最小值 = 1 最大值 = 15 |
maximumBitRate | 使用此數據流原則規則或服務之所有服務數據流的最大比特率 (MBR) 。 | Ambr (必要) |
preemptionCapability | QoS Flow 先占功能。 QoS 流程的先佔功能可控制其是否可以優先於優先順序較低的另一個 QoS 流程。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 | “MayPreempt” “NotPreempt” |
preemptionVulnerability | QoS 流程先占弱點。 QoS 流程的先佔弱點可控制 QoS 流程是否可以優先取用優先順序較高的 QoS 流程。 如需 ARP 參數的完整描述,請參閱 3GPP TS23.501 節 5.7.2.2。 | “NotPreemptable” “Preemptable” |
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應