Microsoft.MobileNetwork mobileNetworks/services 2023-06-01
Bicep 資源定義
mobileNetworks/services 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.MobileNetwork/mobileNetworks/services 資源，請將下列 Bicep 新增至範本。
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2023-06-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
| 名字 | 描述 | 價值 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最大長度 = 模式 = ^(?!(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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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' '上行連結' （必要） |
| 港口 | UE 會針對此流程連線到的埠。。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍，則必須在 [protocol] 欄位中指定 ip 以外的值。 這是選擇性設定。 如果您未指定，則會在所有埠上允許連線。 連接埠範圍必須指定為 <FirstPort>-<LastPort>。 例如： [8080， 8082-8085]。 |
字串 約束： 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]))?$[] |
| 協定 | 此流程允許的通訊協定清單。 如果您要此流程能夠在網通訊協定套件內使用任何通訊協定，請使用 值 ip。 如果您只想要允許選取通訊協定，則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼，如 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml中所述。 例如，針對 UDP，您必須使用 17。 如果您使用值 ip，則必須將欄位保留 port 未指定。 |
字串 約束： 模式 = ^(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）。 |
字串 約束： 模式 = ^(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 核心部署 | 此範本會建立部署私人 5G 核心所需的所有資源，包括布建 sim 卡和建立範例 QoS 原則。 您可以選擇性地部署到在 Azure Stack Edge 裝置上執行的 Kubernetes 叢集。 |
| 建立 sim 原則 | 此範本會為現有的行動網路建立服務和 sim 原則。 |
ARM 樣本資源定義
mobileNetworks/services 資源類型可以使用目標作業來部署：
- 資源群組 - 請參閱 資源群組部署命令
如需每個 API 版本中已變更屬性的清單，請參閱 變更記錄檔。
資源格式
若要建立 Microsoft.MobileNetwork/mobileNetworks/services 資源，請將下列 JSON 新增至範本。
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2023-06-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 版本 | '2023-06-01' |
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最大長度 = 模式 = ^(?!(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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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' '上行連結' （必要） |
| 港口 | UE 會針對此流程連線到的埠。。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍，則必須在 [protocol] 欄位中指定 ip 以外的值。 這是選擇性設定。 如果您未指定，則會在所有埠上允許連線。 連接埠範圍必須指定為 <FirstPort>-<LastPort>。 例如： [8080， 8082-8085]。 |
字串 約束： 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]))?$[] |
| 協定 | 此流程允許的通訊協定清單。 如果您要此流程能夠在網通訊協定套件內使用任何通訊協定，請使用 值 ip。 如果您只想要允許選取通訊協定，則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼，如 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml中所述。 例如，針對 UDP，您必須使用 17。 如果您使用值 ip，則必須將欄位保留 port 未指定。 |
字串 約束： 模式 = ^(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）。 |
字串 約束： 模式 = ^(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 核心部署
|
此範本會建立部署私人 5G 核心所需的所有資源，包括布建 sim 卡和建立範例 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@2023-06-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
| 名字 | 描述 | 價值 |
|---|---|---|
| 位置 | 資源所在的地理位置 | 字串 （必要） |
| 名字 | 資源名稱 | 字串 約束： 最大長度 = 模式 = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ （必要） |
| parent_id | 此資源為父系之資源的標識碼。 | 類型資源的標識碼：mobileNetworks |
| 性能 | 服務屬性。 | ServicePropertiesFormat （必要） |
| 標籤 | 資源標籤 | 標記名稱和值的字典。 |
| 類型 | 資源類型 | “Microsoft.MobileNetwork/mobileNetworks/services@2023-06-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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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.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 Flow 先占功能。 QoS Flow 的先占功能可控制它是否可以先佔優先順序較低的另一個 QoS Flow。 如需 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' '上行連結' （必要） |
| 港口 | UE 會針對此流程連線到的埠。。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍，則必須在 [protocol] 欄位中指定 ip 以外的值。 這是選擇性設定。 如果您未指定，則會在所有埠上允許連線。 連接埠範圍必須指定為 <FirstPort>-<LastPort>。 例如： [8080， 8082-8085]。 |
字串 約束： 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]))?$[] |
| 協定 | 此流程允許的通訊協定清單。 如果您要此流程能夠在網通訊協定套件內使用任何通訊協定，請使用 值 ip。 如果您只想要允許選取通訊協定，則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼，如 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml中所述。 例如，針對 UDP，您必須使用 17。 如果您使用值 ip，則必須將欄位保留 port 未指定。 |
字串 約束： 模式 = ^(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）。 |
字串 約束： 模式 = ^(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
| 名字 | 描述 | 價值 |
|---|