Microsoft.MobileNetwork mobileNetworks/services
Bicep-resursdefinition
Resurstypen mobileNetworks/services kan distribueras med åtgärder som mål:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Microsoft.MobileNetwork/mobileNetworks/services-resurs lägger du till följande Bicep i mallen.
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'
}
}
}
Egenskapsvärden
mobileNetworks/services
| Name | Beskrivning | Värde |
|---|---|---|
| name | Resursnamnet Se hur du anger namn och typer för underordnade resurser i Bicep. |
sträng (krävs) Teckengräns: 1–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med alfanumeriskt. Följande ord kan inte användas på egen hand som namn: default, requested, service. |
| location | Den geo-plats där resursen finns | sträng (krävs) |
| tags | Resurstaggar. | Ordlista med taggnamn och värden. Se Taggar i mallar |
| parent | I Bicep kan du ange den överordnade resursen för en underordnad resurs. Du behöver bara lägga till den här egenskapen när den underordnade resursen deklareras utanför den överordnade resursen. Mer information finns i Underordnad resurs utanför överordnad resurs. |
Symboliskt namn för resurs av typen: mobileNetworks |
| properties | Tjänstegenskaper. | ServicePropertiesFormat (krävs) |
ServicePropertiesFormat
| Name | Beskrivning | Värde |
|---|---|---|
| pccRules | Den uppsättning dataflödesprincipregler som utgör den här tjänsten. | PccRuleConfiguration[] (krävs) Begränsningar: Minsta längd = 1 |
| servicePrecedence | Ett prioritetsvärde som används för att bestämma mellan tjänster när du identifierar de QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet ska vara unikt bland alla tjänster som konfigurerats i det mobila nätverket. | int (obligatoriskt) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| serviceQosPolicy | QoS-principen som ska användas för paket som matchar den här tjänsten. Detta kan åsidosättas för vissa flöden med hjälp av fältet ruleQosPolicy i en PccRuleConfiguration. Om det här fältet är null definierar UE:s SIM-princip QoS-inställningarna. | QosPolicy |
PccRuleConfiguration
| Name | Beskrivning | Värde |
|---|---|---|
| ruleName | Namnet på regeln. Detta måste vara unikt inom den överordnade tjänsten. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maxlängd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Ett prioritetsvärde som används för att bestämma mellan dataflödesprincipregler när du identifierar de QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet ska vara unikt bland alla dataflödesprincipregler som konfigurerats i det mobila nätverket. | int (obligatoriskt) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| ruleQosPolicy | Den QoS-princip som ska användas för paket som matchar den här regeln. Om det här fältet är null definierar den överordnade tjänsten QoS-inställningarna. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Den uppsättning dataflödesmallar som ska användas för den här dataflödesprincipregeln. | ServiceDataFlowTemplate[] (krävs) Begränsningar: Minsta längd = 1 Maxlängd = 15 |
| trafficControl | Avgör om flöden som matchar den här dataflödesprincipregeln är tillåtna. | "Blockerad" "Aktiverad" |
PccRuleQosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska ges till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| guaranteedBitRate | Garanterad bithastighet (GBR) för alla tjänstdataflöden som använder den här policyregeln för dataflöde. Den här inställningen är valfri. Om du inte anger något värde finns det ingen GBR-uppsättning för dataflödesprincipregeln som använder den här QoS-definitionen. | Ambr |
| maximumBitRate | Maximal bithastighet (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow-preemptionsfunktion. Preemptionsfunktionen för ett QoS-flöde styr om det kan förhindra ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Sårbarhet för QoS-flödespreemption. Preemptionssårbarheten för ett QoS-flöde styr om det kan förhindras av ett QoS-flöde med högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |
Ambr
| Name | Beskrivning | Värde |
|---|---|---|
| Nedlänk | Bithastighet för nedlänk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Bithastighet för överordnad länk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Name | Beskrivning | Värde |
|---|---|---|
| riktning | Flödets riktning. | "Dubbelriktad" "Nedlänk" "Överordnad länk" (krävs) |
| ports | De portar som UE:er ska ansluta till för det här flödet. Du kan ange noll eller flera portar eller portintervall. Om du anger en eller flera portar eller portintervall måste du ange ett annat värde än ip i fältet protocol . Den här inställningen är valfri. Om du inte anger det tillåts anslutningar på alla portar. Portintervall måste anges som {FirstPort}-{LastPort}. Till exempel: [8080, 8082-8085]. |
string[] Begränsningar: Mönster = ^([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]))?$ |
| Protokollet | En lista över tillåtna protokoll för det här flödet. Om du vill att det här flödet ska kunna använda vilket protokoll som helst i Internet Protocol Suite använder du värdet ip. Om du bara vill tillåta ett urval av protokoll måste du använda motsvarande IANA-tilldelade Internet Protocol Number för varje protokoll enligt beskrivningen i https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. För UDP måste du till exempel använda 17. Om du använder värdet ip måste du lämna fältet port ospecificerat. |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Den fjärranslutna IP-adress(er) som UEs ansluter till för det här flödet. Om du vill tillåta anslutningar på valfri IP-adress använder du värdet any. Annars måste du ange var och en av de fjärranslutna IP-adresser som paketkärninstansen ska ansluta till för det här flödet. Du måste ange varje IP-adress i CIDR-notation, inklusive nätmasken (till exempel 192.0.2.54/24). |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(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 | Namnet på dataflödesmallen. Detta måste vara unikt inom den överordnade dataflödesprincipregeln. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maxlängd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska ges till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| maximumBitRate | Maximal bithastighet (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow-preemptionsfunktion. Preemptionsfunktionen för ett QoS-flöde styr om det kan förhindra ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Sårbarhet för QoS-flödespreemption. Preemptionssårbarheten för ett QoS-flöde styr om det kan förhindras av ett QoS-flöde med högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
| Mall | Description |
|---|---|
Skapa en fullständig 5G Core-distribution |
Den här mallen skapar alla resurser som krävs för att distribuera en privat 5G Core, inklusive etablering av simmar och skapandet av QoS-exempelprincip. Du kan också distribuera den till ett Kubernetes-kluster som körs på en Azure Stack Edge-enhet. |
| Skapa en sim-princip |
Den här mallen skapar en tjänst- och sim-princip för ett befintligt mobilt nätverk. |
Resursdefinition för ARM-mall
Resurstypen mobileNetworks/services kan distribueras med åtgärder som mål:
- Resursgrupper – Se kommandon för resursgruppsdistribution
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Resurs för Microsoft.MobileNetwork/mobileNetworks/services lägger du till följande JSON i mallen.
{
"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"
}
}
}
Egenskapsvärden
mobileNetworks/services
| Name | Beskrivning | Värde |
|---|---|---|
| typ | Resurstypen | "Microsoft.MobileNetwork/mobileNetworks/services" |
| apiVersion | Resurs-API-versionen | '2024-02-01' |
| name | Resursnamnet Se hur du anger namn och typer för underordnade resurser i JSON ARM-mallar. |
sträng (krävs) Teckengräns: 1–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med alfanumeriskt. Följande ord kan inte användas på egen hand som namn: default, requested, service. |
| location | Den geo-plats där resursen finns | sträng (krävs) |
| tags | Resurstaggar. | Ordlista med taggnamn och värden. Se Taggar i mallar |
| properties | Tjänstegenskaper. | ServicePropertiesFormat (krävs) |
ServicePropertiesFormat
| Name | Beskrivning | Värde |
|---|---|---|
| pccRules | Den uppsättning dataflödesprincipregler som utgör den här tjänsten. | PccRuleConfiguration[] (krävs) Begränsningar: Minsta längd = 1 |
| servicePrecedence | Ett prioritetsvärde som används för att bestämma mellan tjänster när du identifierar de QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet ska vara unikt bland alla tjänster som konfigurerats i det mobila nätverket. | int (krävs) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| serviceQosPolicy | QoS-principen som ska användas för paket som matchar den här tjänsten. Detta kan åsidosättas för vissa flöden med fältet ruleQosPolicy i en PccRuleConfiguration. Om det här fältet är null definierar UE:s SIM-princip QoS-inställningarna. | QosPolicy |
PccRuleConfiguration
| Name | Beskrivning | Värde |
|---|---|---|
| ruleName | Namnet på regeln. Detta måste vara unikt i den överordnade tjänsten. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maximal längd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Ett prioritetsvärde som används för att bestämma mellan dataflödesprincipregler när du identifierar QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet bör vara unikt bland alla dataflödesprincipregler som konfigurerats i det mobila nätverket. | int (krävs) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| ruleQosPolicy | QoS-principen som ska användas för paket som matchar den här regeln. Om det här fältet är null definierar den överordnade tjänsten QoS-inställningarna. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Den uppsättning dataflödesmallar som ska användas för den här dataflödesprincipregeln. | ServiceDataFlowTemplate[] (krävs) Begränsningar: Minsta längd = 1 Maximal längd = 15 |
| trafficControl | Avgör om flöden som matchar den här dataflödesprincipregeln är tillåtna. | "Blockerad" "Aktiverad" |
PccRuleQosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska tillhandahållas till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| guaranteedBitRate | Garanterad bithastighet (GBR) för alla tjänstdataflöden som använder den här dataflödesprincipregeln. Den här inställningen är valfri. Om du inte anger något värde kommer det inte att finnas någon GBR-uppsättning för dataflödesprincipregeln som använder den här QoS-definitionen. | Ambr |
| maximumBitRate | Den maximala bithastigheten (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow preemption-funktion. Preemption-funktionen för ett QoS Flow styr om det kan föregripa ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Säkerhetsrisk för QoS Flow-preemption. Säkerhetsrisken för ett QoS-flöde styr om det kan föregripas av ett QoS-flöde med en högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |
Ambr
| Name | Beskrivning | Värde |
|---|---|---|
| Nedlänk | Bithastighet för nedlänk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Bithastighet för överordnad länk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Name | Beskrivning | Värde |
|---|---|---|
| riktning | Flödets riktning. | "Dubbelriktad" "Nedlänk" "Överordnad länk" (krävs) |
| ports | De portar som UE:er ska ansluta till för det här flödet. Du kan ange noll eller flera portar eller portintervall. Om du anger en eller flera portar eller portintervall måste du ange ett annat värde än ip i fältet protocol . Den här inställningen är valfri. Om du inte anger det tillåts anslutningar på alla portar. Portintervall måste anges som {FirstPort}-{LastPort}. Till exempel: [8080, 8082-8085]. |
string[] Begränsningar: Mönster = ^([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]))?$ |
| Protokollet | En lista över tillåtna protokoll för det här flödet. Om du vill att det här flödet ska kunna använda vilket protokoll som helst i Internet Protocol Suite använder du värdet ip. Om du bara vill tillåta ett urval av protokoll måste du använda motsvarande IANA-tilldelade Internet Protocol Number för varje protokoll enligt beskrivningen i https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. För UDP måste du till exempel använda 17. Om du använder värdet ip måste du lämna fältet port ospecificerat. |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Den fjärranslutna IP-adress(er) som UEs ansluter till för det här flödet. Om du vill tillåta anslutningar på valfri IP-adress använder du värdet any. Annars måste du ange var och en av de fjärranslutna IP-adresser som paketkärninstansen ska ansluta till för det här flödet. Du måste ange varje IP-adress i CIDR-notation, inklusive nätmasken (till exempel 192.0.2.54/24). |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(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 | Namnet på dataflödesmallen. Detta måste vara unikt inom den överordnade dataflödesprincipregeln. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maxlängd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska ges till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| maximumBitRate | Maximal bithastighet (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow-preemptionsfunktion. Preemptionsfunktionen för ett QoS-flöde styr om det kan förhindra ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Sårbarhet för QoS-flödespreemption. Preemptionssårbarheten för ett QoS-flöde styr om det kan förhindras av ett QoS-flöde med högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |
Snabbstartsmallar
Följande snabbstartsmallar distribuerar den här resurstypen.
| Mall | Description |
|---|---|
| Skapa en fullständig 5G Core-distribution |
Den här mallen skapar alla resurser som krävs för att distribuera en privat 5G Core, inklusive etablering av simmar och skapandet av QoS-exempelprincip. Du kan också distribuera den till ett Kubernetes-kluster som körs på en Azure Stack Edge-enhet. |
| Skapa en sim-princip |
Den här mallen skapar en tjänst- och sim-princip för ett befintligt mobilt nätverk. |
Resursdefinition för Terraform (AzAPI-provider)
Resurstypen mobileNetworks/services kan distribueras med åtgärder som mål:
- Resursgrupper
En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.
Resursformat
Om du vill skapa en Resurs för Microsoft.MobileNetwork/mobileNetworks/services lägger du till följande Terraform i mallen.
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"
}
}
})
}
Egenskapsvärden
mobileNetworks/services
| Name | Beskrivning | Värde |
|---|---|---|
| typ | Resurstypen | "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01" |
| name | Resursnamnet | sträng (krävs) Teckengräns: 1–64 Giltiga tecken: Alfanumeriska tecken och bindestreck. Börja med alfanumeriskt. Följande ord kan inte användas på egen hand som namn: default, requested, service. |
| location | Den geo-plats där resursen finns | sträng (krävs) |
| parent_id | ID:t för resursen som är överordnad för den här resursen. | ID för resurs av typen: mobileNetworks |
| tags | Resurstaggar. | Ordlista med taggnamn och värden. |
| properties | Tjänstegenskaper. | ServicePropertiesFormat (krävs) |
ServicePropertiesFormat
| Name | Beskrivning | Värde |
|---|---|---|
| pccRules | Den uppsättning dataflödesprincipregler som utgör den här tjänsten. | PccRuleConfiguration[] (krävs) Begränsningar: Minsta längd = 1 |
| servicePrecedence | Ett prioritetsvärde som används för att bestämma mellan tjänster när du identifierar de QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet ska vara unikt för alla tjänster som konfigurerats i mobilnätverket. | int (krävs) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| serviceQosPolicy | QoS-principen som ska användas för paket som matchar den här tjänsten. Detta kan åsidosättas för vissa flöden med fältet ruleQosPolicy i en PccRuleConfiguration. Om det här fältet är null definierar UE:s SIM-princip QoS-inställningarna. | QosPolicy |
PccRuleConfiguration
| Name | Beskrivning | Värde |
|---|---|---|
| ruleName | Namnet på regeln. Detta måste vara unikt i den överordnade tjänsten. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maximal längd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Ett prioritetsvärde som används för att bestämma mellan dataflödesprincipregler när du identifierar QoS-värden som ska användas för ett visst SIM-kort. Ett lägre värde innebär en högre prioritet. Det här värdet bör vara unikt bland alla dataflödesprincipregler som konfigurerats i det mobila nätverket. | int (krävs) Begränsningar: Minsta värde = 0 Maxvärde = 255 |
| ruleQosPolicy | QoS-principen som ska användas för paket som matchar den här regeln. Om det här fältet är null definierar den överordnade tjänsten QoS-inställningarna. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Den uppsättning dataflödesmallar som ska användas för den här dataflödesprincipregeln. | ServiceDataFlowTemplate[] (krävs) Begränsningar: Minsta längd = 1 Maximal längd = 15 |
| trafficControl | Avgör om flöden som matchar den här dataflödesprincipregeln är tillåtna. | "Blockerad" "Aktiverad" |
PccRuleQosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska tillhandahållas till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| guaranteedBitRate | Garanterad bithastighet (GBR) för alla tjänstdataflöden som använder den här dataflödesprincipregeln. Den här inställningen är valfri. Om du inte anger något värde kommer det inte att finnas någon GBR-uppsättning för dataflödesprincipregeln som använder den här QoS-definitionen. | Ambr |
| maximumBitRate | Den maximala bithastigheten (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow preemption-funktion. Preemption-funktionen för ett QoS Flow styr om det kan föregripa ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Säkerhetsrisk för QoS Flow-preemption. Säkerhetsrisken för ett QoS-flöde styr om det kan föregripas av ett QoS-flöde med en högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |
Ambr
| Name | Beskrivning | Värde |
|---|---|---|
| Nedlänk | Bithastighet för nedlänk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Bithastighet för överordnad länk. | sträng (krävs) Begränsningar: Mönster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Name | Beskrivning | Värde |
|---|---|---|
| riktning | Flödets riktning. | "Dubbelriktad" "Nedlänk" "Överordnad länk" (krävs) |
| ports | De portar som UEs ansluter till för det här flödet. Du kan ange noll eller flera portar eller portintervall. Om du anger en eller flera portar eller portintervall måste du ange ett annat värde än ip i fältet protocol . Den här inställningen är valfri. Om du inte anger det tillåts anslutningar på alla portar. Portintervall måste anges som {FirstPort}-{LastPort}. Till exempel: [8080, 8082-8085]. |
string[] Begränsningar: Mönster = ^([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]))?$ |
| Protokollet | En lista över tillåtna protokoll för det här flödet. Om du vill att det här flödet ska kunna använda alla protokoll i Internet Protocol Suite använder du värdet ip. Om du bara vill tillåta ett urval av protokoll måste du använda motsvarande IANA-tilldelade Internet Protocol-nummer för varje protokoll enligt beskrivningen i https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. För UDP måste du till exempel använda 17. Om du använder värdet ip måste du lämna fältet port ospecificerat. |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Den fjärranslutna IP-adress(er) som UEs ansluter till för det här flödet. Om du vill tillåta anslutningar på en IP-adress använder du värdet any. Annars måste du ange var och en av de fjärr-IP-adresser som paketkärninstansen ansluter till för det här flödet. Du måste ange varje IP-adress i CIDR-notationen, inklusive nätmasken (till exempel 192.0.2.54/24). |
sträng (krävs) Begränsningar: Minsta längd = 1 Mönster = ^(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 | Namnet på dataflödesmallen. Detta måste vara unikt i den överordnade dataflödesprincipregeln. Du får inte använda någon av följande reserverade strängar – default, requested eller service. |
sträng (krävs) Begränsningar: Maximal längd = 64 Mönster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Name | Beskrivning | Värde |
|---|---|---|
| 5qi | 5G QoS-flödesindikatorvärde. 5QI identifierar en specifik QoS-vidarebefordringsbehandling som ska tillhandahållas till ett flöde. Se 3GPP TS23.501 avsnitt 5.7.2.1 för en fullständig beskrivning av parametern 5QI och tabell 5.7.4-1 för definitionen av 5QI-värdena. | int Begränsningar: Minsta värde = 1 Maxvärde = 127 |
| allocationAndRetentionPriorityLevel | QoS Flow-allokerings- och kvarhållningsprioritetsnivå (ARP). Flöden med högre prioritet föregriper flöden med lägre prioritet, om inställningarna preemptionCapability för och preemptionVulnerability tillåter det. 1 är den högsta prioritetsnivån. Om det här fältet inte anges 5qi används det för att härleda ARP-värdet. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. |
int Begränsningar: Minsta värde = 1 Maxvärde = 15 |
| maximumBitRate | Maximal bithastighet (MBR) för alla tjänstdataflöden som använder den här policyregeln eller tjänsten för dataflöde. | Ambr (krävs) |
| preemptionCapability | QoS Flow-preemptionsfunktion. Preemptionsfunktionen för ett QoS-flöde styr om det kan förhindra ett annat QoS-flöde med en lägre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Sårbarhet för QoS-flödespreemption. Preemptionssårbarheten för ett QoS-flöde styr om det kan förhindras av ett QoS-flöde med högre prioritetsnivå. Se 3GPP TS23.501 avsnitt 5.7.2.2 för en fullständig beskrivning av ARP-parametrarna. | "NotPreemptable" "Preemptable" |