Microsoft.MobileNetwork mobileNetworks/services 2022-03-01-preview
Bicep resource definition
The mobileNetworks/services resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.MobileNetwork/mobileNetworks/services resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2022-03-01-preview' = {
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'
}
}
}
Property values
mobileNetworks/services
Name | Description | Value |
---|---|---|
name | The resource name See how to set names and types for child resources in Bicep. |
string (required) Character limit: 1-64 Valid characters: Alphanumerics and hyphens. Start with alphanumeric. The following words cannot be used on their own as the name: default , requested , service . |
location | The geo-location where the resource lives | string (required) |
tags | Resource tags. | Dictionary of tag names and values. See Tags in templates |
parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. |
Symbolic name for resource of type: mobileNetworks |
properties | Service Properties. | ServicePropertiesFormat (required) |
ServicePropertiesFormat
Name | Description | Value |
---|---|---|
pccRules | The set of PCC Rules that make up this service. | PccRuleConfiguration[] (required) Constraints: Min length = 1 |
servicePrecedence | A precedence value that is used to decide between services when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all services configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
serviceQosPolicy | The QoS policy to use for packets matching this service. This can be overridden for particular flows using the ruleQosPolicy field in a PccRuleConfiguration. If this field is null then the UE's simPolicy will define the QoS settings. | QosPolicy |
PccRuleConfiguration
Name | Description | Value |
---|---|---|
ruleName | The name of the rule. This must be unique within the parent Service. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | A precedence value that is used to decide between PCC Rules when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all PCC Rules configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
ruleQosPolicy | The QoS policy to use for packets matching this rule. If this field is null then the Service will define the QoS settings. | PccRuleQosPolicy |
serviceDataFlowTemplates | The set of service data flow templates to use for this PCC Rule. | ServiceDataFlowTemplate[] (required) Constraints: Min length = 1 |
trafficControl | Determines whether flows that match this PCC Rule are permitted. | 'Blocked' 'Enabled' |
PccRuleQosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
guaranteedBitRate | The Guaranteed Bit Rate (GBR) for all service data flows that use this PCC Rule. This is an optional setting. If you do not provide a value, there will be no GBR set for the PCC Rule that uses this QoS definition. | Ambr |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'NotPreemptable' 'Preemptable' |
Ambr
Name | Description | Value |
---|---|---|
downlink | Downlink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
uplink | Uplink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Name | Description | Value |
---|---|---|
direction | The direction of this flow. | 'Bidirectional' 'Downlink' 'Uplink' (required) |
ports | The port(s) to which UEs will connect for this flow. You can specify zero or more ports or port ranges. If you specify one or more ports or port ranges then you must specify a value other than ip in the protocol field. This is an optional setting. If you do not specify it then connections will be allowed on all ports. Port ranges must be specified as {FirstPort}-{LastPort}. For example: [8080 , 8082-8085 ]. |
string[] Constraints: 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 | A list of the allowed protocol(s) for this flow. If you want this flow to be able to use any protocol within the internet protocol suite, use the value ip . If you only want to allow a selection of protocols, you must use the corresponding IANA Assigned Internet Protocol Number for each protocol, as described in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . For example, for UDP, you must use 17. If you use the value ip then you must leave the field port unspecified. |
string (required) Constraints: Min length = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | The remote IP address(es) to which UEs will connect for this flow. If you want to allow connections on any IP address, use the value any . Otherwise, you must provide each of the remote IP addresses to which Fusion Core will connect for this flow. You must provide each IP address in CIDR notation, including the netmask (for example, 192.0.2.54/24). |
string (required) Constraints: Min length = 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 | The name of the SDF template. This must be unique within the parent PccRuleConfiguration. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'NotPreemptable' 'Preemptable' |
Quickstart templates
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
Create a full 5G Core deployment |
This template creates all resources required to deploy a Private 5G Core, including provisioning sims and creating sample QoS policy. It can optionally be deployed to a Kubernetes cluster running on an Azure Stack Edge device. |
Create a sim policy |
This template creates a service and sim policy for an existing mobile network. |
ARM template resource definition
The mobileNetworks/services resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.MobileNetwork/mobileNetworks/services resource, add the following JSON to your template.
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2022-03-01-preview",
"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"
}
}
}
Property values
mobileNetworks/services
Name | Description | Value |
---|---|---|
type | The resource type | 'Microsoft.MobileNetwork/mobileNetworks/services' |
apiVersion | The resource api version | '2022-03-01-preview' |
name | The resource name See how to set names and types for child resources in JSON ARM templates. |
string (required) Character limit: 1-64 Valid characters: Alphanumerics and hyphens. Start with alphanumeric. The following words cannot be used on their own as the name: default , requested , service . |
location | The geo-location where the resource lives | string (required) |
tags | Resource tags. | Dictionary of tag names and values. See Tags in templates |
properties | Service Properties. | ServicePropertiesFormat (required) |
ServicePropertiesFormat
Name | Description | Value |
---|---|---|
pccRules | The set of PCC Rules that make up this service. | PccRuleConfiguration[] (required) Constraints: Min length = 1 |
servicePrecedence | A precedence value that is used to decide between services when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all services configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
serviceQosPolicy | The QoS policy to use for packets matching this service. This can be overridden for particular flows using the ruleQosPolicy field in a PccRuleConfiguration. If this field is null then the UE's simPolicy will define the QoS settings. | QosPolicy |
PccRuleConfiguration
Name | Description | Value |
---|---|---|
ruleName | The name of the rule. This must be unique within the parent Service. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | A precedence value that is used to decide between PCC Rules when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all PCC Rules configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
ruleQosPolicy | The QoS policy to use for packets matching this rule. If this field is null then the Service will define the QoS settings. | PccRuleQosPolicy |
serviceDataFlowTemplates | The set of service data flow templates to use for this PCC Rule. | ServiceDataFlowTemplate[] (required) Constraints: Min length = 1 |
trafficControl | Determines whether flows that match this PCC Rule are permitted. | 'Blocked' 'Enabled' |
PccRuleQosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
guaranteedBitRate | The Guaranteed Bit Rate (GBR) for all service data flows that use this PCC Rule. This is an optional setting. If you do not provide a value, there will be no GBR set for the PCC Rule that uses this QoS definition. | Ambr |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'NotPreemptable' 'Preemptable' |
Ambr
Name | Description | Value |
---|---|---|
downlink | Downlink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
uplink | Uplink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Name | Description | Value |
---|---|---|
direction | The direction of this flow. | 'Bidirectional' 'Downlink' 'Uplink' (required) |
ports | The port(s) to which UEs will connect for this flow. You can specify zero or more ports or port ranges. If you specify one or more ports or port ranges then you must specify a value other than ip in the protocol field. This is an optional setting. If you do not specify it then connections will be allowed on all ports. Port ranges must be specified as {FirstPort}-{LastPort}. For example: [8080 , 8082-8085 ]. |
string[] Constraints: 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 | A list of the allowed protocol(s) for this flow. If you want this flow to be able to use any protocol within the internet protocol suite, use the value ip . If you only want to allow a selection of protocols, you must use the corresponding IANA Assigned Internet Protocol Number for each protocol, as described in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . For example, for UDP, you must use 17. If you use the value ip then you must leave the field port unspecified. |
string (required) Constraints: Min length = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | The remote IP address(es) to which UEs will connect for this flow. If you want to allow connections on any IP address, use the value any . Otherwise, you must provide each of the remote IP addresses to which Fusion Core will connect for this flow. You must provide each IP address in CIDR notation, including the netmask (for example, 192.0.2.54/24). |
string (required) Constraints: Min length = 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 | The name of the SDF template. This must be unique within the parent PccRuleConfiguration. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | 'NotPreemptable' 'Preemptable' |
Quickstart templates
The following quickstart templates deploy this resource type.
Template | Description |
---|---|
Create a full 5G Core deployment |
This template creates all resources required to deploy a Private 5G Core, including provisioning sims and creating sample QoS policy. It can optionally be deployed to a Kubernetes cluster running on an Azure Stack Edge device. |
Create a sim policy |
This template creates a service and sim policy for an existing mobile network. |
Terraform (AzAPI provider) resource definition
The mobileNetworks/services resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.MobileNetwork/mobileNetworks/services resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2022-03-01-preview"
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"
}
}
})
}
Property values
mobileNetworks/services
Name | Description | Value |
---|---|---|
type | The resource type | "Microsoft.MobileNetwork/mobileNetworks/services@2022-03-01-preview" |
name | The resource name | string (required) Character limit: 1-64 Valid characters: Alphanumerics and hyphens. Start with alphanumeric. The following words cannot be used on their own as the name: default , requested , service . |
location | The geo-location where the resource lives | string (required) |
parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: mobileNetworks |
tags | Resource tags. | Dictionary of tag names and values. |
properties | Service Properties. | ServicePropertiesFormat (required) |
ServicePropertiesFormat
Name | Description | Value |
---|---|---|
pccRules | The set of PCC Rules that make up this service. | PccRuleConfiguration[] (required) Constraints: Min length = 1 |
servicePrecedence | A precedence value that is used to decide between services when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all services configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
serviceQosPolicy | The QoS policy to use for packets matching this service. This can be overridden for particular flows using the ruleQosPolicy field in a PccRuleConfiguration. If this field is null then the UE's simPolicy will define the QoS settings. | QosPolicy |
PccRuleConfiguration
Name | Description | Value |
---|---|---|
ruleName | The name of the rule. This must be unique within the parent Service. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | A precedence value that is used to decide between PCC Rules when identifying the QoS values to use for a particular Sim. A lower value means a higher priority. This value should be unique among all PCC Rules configured in the Mobile Network. | int (required) Constraints: Min value = 0 Max value = 255 |
ruleQosPolicy | The QoS policy to use for packets matching this rule. If this field is null then the Service will define the QoS settings. | PccRuleQosPolicy |
serviceDataFlowTemplates | The set of service data flow templates to use for this PCC Rule. | ServiceDataFlowTemplate[] (required) Constraints: Min length = 1 |
trafficControl | Determines whether flows that match this PCC Rule are permitted. | "Blocked" "Enabled" |
PccRuleQosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
guaranteedBitRate | The Guaranteed Bit Rate (GBR) for all service data flows that use this PCC Rule. This is an optional setting. If you do not provide a value, there will be no GBR set for the PCC Rule that uses this QoS definition. | Ambr |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | "MayPreempt" "NotPreempt" |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | "NotPreemptable" "Preemptable" |
Ambr
Name | Description | Value |
---|---|---|
downlink | Downlink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
uplink | Uplink bit rate. | string (required) Constraints: Pattern = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Name | Description | Value |
---|---|---|
direction | The direction of this flow. | "Bidirectional" "Downlink" "Uplink" (required) |
ports | The port(s) to which UEs will connect for this flow. You can specify zero or more ports or port ranges. If you specify one or more ports or port ranges then you must specify a value other than ip in the protocol field. This is an optional setting. If you do not specify it then connections will be allowed on all ports. Port ranges must be specified as {FirstPort}-{LastPort}. For example: [8080 , 8082-8085 ]. |
string[] Constraints: 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 | A list of the allowed protocol(s) for this flow. If you want this flow to be able to use any protocol within the internet protocol suite, use the value ip . If you only want to allow a selection of protocols, you must use the corresponding IANA Assigned Internet Protocol Number for each protocol, as described in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . For example, for UDP, you must use 17. If you use the value ip then you must leave the field port unspecified. |
string (required) Constraints: Min length = 1 Pattern = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | The remote IP address(es) to which UEs will connect for this flow. If you want to allow connections on any IP address, use the value any . Otherwise, you must provide each of the remote IP addresses to which Fusion Core will connect for this flow. You must provide each IP address in CIDR notation, including the netmask (for example, 192.0.2.54/24). |
string (required) Constraints: Min length = 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 | The name of the SDF template. This must be unique within the parent PccRuleConfiguration. You must not use any of the following reserved strings - default , requested or service . |
string (required) Constraints: Max length = 64 Pattern = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Name | Description | Value |
---|---|---|
5qi | QoS Flow 5G QoS Indicator value. The 5QI identifies a specific QoS forwarding treatment to be provided to a flow. This must not be a standardized 5QI value selecting a GBR (Guaranteed Bit Rate) QoS. The illegal GBR 5QI values are: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84, and 85. See 3GPP TS23.501 section 5.7.2.1 for a full description of the 5Qi parameter, and table 5.7.4-1 for the definition of which are the GBR 5QI values. | int Constraints: Min value = 1 Max value = 127 |
allocationAndRetentionPriorityLevel | QoS Flow allocation and retention priority (ARP) level. Flows with higher priority preempt flows with lower priority, if the settings of preemptionCapability and preemptionVulnerability allow it. 1 is the highest level of priority. If this field is not specified then 5qi is used to derive the ARP value. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. |
int Constraints: Min value = 1 Max value = 15 |
maximumBitRate | The Maximum Bit Rate (MBR) for all service data flows that use this PCC Rule or Service. | Ambr (required) |
preemptionCapability | QoS Flow preemption capability. The Preemption Capability of a QoS Flow controls whether it can preempt another QoS Flow with a lower priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | "MayPreempt" "NotPreempt" |
preemptionVulnerability | QoS Flow preemption vulnerability. The Preemption Vulnerability of a QoS Flow controls whether it can be preempted by QoS Flow with a higher priority level. See 3GPP TS23.501 section 5.7.2.2 for a full description of the ARP parameters. | "NotPreemptable" "Preemptable" |