Dela via

Microsoft.MobileNetwork mobileNetworks/services 2022-11-01

  • Artikel

Bicep-resursdefinition

Resurstypen mobileNetworks/services kan distribueras med åtgärder som mål:

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@2022-11-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  parent: resourceSymbolicName
  properties: {
    pccRules: [
      {
        ruleName: 'string'
        rulePrecedence: int
        ruleQosPolicy: {
          5qi: int
          allocationAndRetentionPriorityLevel: int
          guaranteedBitRate: {
            downlink: 'string'
            uplink: 'string'
          }
          maximumBitRate: {
            downlink: 'string'
            uplink: 'string'
          }
          preemptionCapability: 'string'
          preemptionVulnerability: 'string'
        }
        serviceDataFlowTemplates: [
          {
            direction: 'string'
            ports: [
              'string'
            ]
            protocol: 'string'
            remoteIpList: 'string'
            templateName: 'string'
          }
        ]
        trafficControl: 'string'
      }
    ]
    servicePrecedence: int
    serviceQosPolicy: {
      5qi: int
      allocationAndRetentionPriorityLevel: int
      maximumBitRate: {
        downlink: 'string'
        uplink: 'string'
      }
      preemptionCapability: 'string'
      preemptionVulnerability: 'string'
    }
  }
}

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 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
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:
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

Distribuera till Azure 		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

Distribuera till Azure 		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:

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": "2022-11-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "properties": {
    "pccRules": [
      {
        "ruleName": "string",
        "rulePrecedence": "int",
        "ruleQosPolicy": {
          "5qi": "int",
          "allocationAndRetentionPriorityLevel": "int",
          "guaranteedBitRate": {
            "downlink": "string",
            "uplink": "string"
          },
          "maximumBitRate": {
            "downlink": "string",
            "uplink": "string"
          },
          "preemptionCapability": "string",
          "preemptionVulnerability": "string"
        },
        "serviceDataFlowTemplates": [
          {
            "direction": "string",
            "ports": [ "string" ],
            "protocol": "string",
            "remoteIpList": "string",
            "templateName": "string"
          }
        ],
        "trafficControl": "string"
      }
    ],
    "servicePrecedence": "int",
    "serviceQosPolicy": {
      "5qi": "int",
      "allocationAndRetentionPriorityLevel": "int",
      "maximumBitRate": {
        "downlink": "string",
        "uplink": "string"
      },
      "preemptionCapability": "string",
      "preemptionVulnerability": "string"
    }
  }
}

Egenskapsvärden

mobileNetworks/services

Name Beskrivning Värde
typ Resurstypen "Microsoft.MobileNetwork/mobileNetworks/services"
apiVersion Resurs-API-versionen '2022-11-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 (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 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
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

Distribuera till Azure 		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

Distribuera till Azure 		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@2022-11-01"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  body = jsonencode({
    properties = {
      pccRules = [
        {
          ruleName = "string"
          rulePrecedence = int
          ruleQosPolicy = {
            5qi = int
            allocationAndRetentionPriorityLevel = int
            guaranteedBitRate = {
              downlink = "string"
              uplink = "string"
            }
            maximumBitRate = {
              downlink = "string"
              uplink = "string"
            }
            preemptionCapability = "string"
            preemptionVulnerability = "string"
          }
          serviceDataFlowTemplates = [
            {
              direction = "string"
              ports = [
                "string"
              ]
              protocol = "string"
              remoteIpList = "string"
              templateName = "string"
            }
          ]
          trafficControl = "string"
        }
      ]
      servicePrecedence = int
      serviceQosPolicy = {
        5qi = int
        allocationAndRetentionPriorityLevel = int
        maximumBitRate = {
          downlink = "string"
          uplink = "string"
        }
        preemptionCapability = "string"
        preemptionVulnerability = "string"
      }
    }
  })
}

Egenskapsvärden

mobileNetworks/services

Name Beskrivning Värde
typ Resurstypen "Microsoft.MobileNetwork/mobileNetworks/services@2022-11-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 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 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
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 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"