Freigeben über


Microsoft.MobileNetwork mobileNetworks/services

Bicep-Ressourcendefinition

Der Ressourcentyp mobileNetworks/services kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MobileNetwork/mobileNetworks/services-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

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'
    }
  }
}

Eigenschaftswerte

mobileNetworks/services

Name BESCHREIBUNG Wert
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in Bicep.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-64

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Beginnen Sie mit einem alphanumerischen Zeichen.

Die folgenden Wörter können nicht allein als Name verwendet werden: default, requested, service.
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
tags Ressourcentags. Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für Ressource vom Typ: mobileNetworks
properties Diensteigenschaften. ServicePropertiesFormat (erforderlich)

ServicePropertiesFormat

Name BESCHREIBUNG Wert
pccRules Der Satz von Datenflussrichtlinienregeln, aus denen dieser Dienst besteht. PccRuleConfiguration[] (erforderlich)

Einschränkungen:
Min. Länge = 1
servicePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Diensten zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle dienste eindeutig sein, die im mobilen Netzwerk konfiguriert sind. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
serviceQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die diesem Dienst entsprechen. Dies kann für bestimmte Flows mithilfe des RuleQosPolicy-Felds in einer PccRuleConfiguration überschrieben werden. Wenn dieses Feld NULL ist, definiert die SIM-Richtlinie der UE die QoS-Einstellungen. QosPolicy

PccRuleConfiguration

Name BESCHREIBUNG Wert
ruleName Der Name der Regel. Dies muss innerhalb des übergeordneten Diensts eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
rulePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Datenflussrichtlinienregeln zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle Datenflussrichtlinienregeln, die im mobilen Netzwerk konfiguriert sind, eindeutig sein. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
ruleQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die dieser Regel entsprechen. Wenn dieses Feld NULL ist, definiert der übergeordnete Dienst die QoS-Einstellungen. PccRuleQosPolicy
serviceDataFlowTemplates Der Satz von Datenflussvorlagen, die für diese Datenflussrichtlinienregel verwendet werden sollen. ServiceDataFlowTemplate[] (erforderlich)

Einschränkungen:
Min. Länge = 1
Maximale Länge = 15
trafficControl Bestimmt, ob Flows, die dieser Datenflussrichtlinienregel entsprechen, zulässig sind. "Blockiert"
"Aktiviert"

PccRuleQosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Der 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.1 und Tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel ARP-Ebene (QoS Flow Allocation and Retention Priority). Flows mit vorzeitiger Entfernung mit höherer Priorität mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsstufe. Wenn dieses Feld nicht angegeben 5qi ist, wird verwendet, um den ARP-Wert abzuleiten. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 15
guaranteedBitRate Die garantierte Bitrate (GBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel verwenden. Dies ist eine optionale Einstellung. Wenn Sie keinen Wert angeben, ist kein GBR für die Datenflussrichtlinienregel festgelegt, die diese QoS-Definition verwendet. Ambr
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
'NotPreempt'
preemptionVulnerability Sicherheitsrisiko bei vorzeitiger Entfernung von QoS-Fluss. Die Sicherheitslücke vor der Entfernung eines QoS-Flusses steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorzeitig entfernt werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. 'NotPreemptable'
"Preemptable"

Ambr

Name BESCHREIBUNG Wert
Downlink Downlink-Bitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
Uplink Uplink-Bitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

ServiceDataFlowTemplate

Name BESCHREIBUNG Wert
direction Die Richtung dieses Flows. "Bidirektional"
"Downlink"
"Uplink" (erforderlich)
ports Die Ports, mit denen UEs für diesen Flow eine Verbindung herstellen. Sie können null oder mehr Ports oder Portbereiche angeben. Wenn Sie einen oder mehrere Ports oder Portbereiche angeben, müssen Sie einen anderen Wert als ip im protocol Feld angeben. Dies ist eine optionale Einstellung. Wenn Sie dies nicht angeben, sind Verbindungen an allen Ports zulässig. Portbereiche müssen als {FirstPort}-{LastPort} angegeben werden. Beispiel: [8080, 8082-8085]. string[]

Einschränkungen:
Muster = ^([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]))?$
Protokoll Eine Liste der zulässigen Protokolle für diesen Flow. Wenn dieser Flow in der Lage sein soll, ein beliebiges Protokoll innerhalb der Internetprotokollsammlung zu verwenden, verwenden Sie den Wert ip. Wenn Sie nur eine Auswahl von Protokollen zulassen möchten, müssen Sie die entsprechende IANA Assigned Internet Protocol Number für jedes Protokoll verwenden, wie unter https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlbeschrieben. Für UDP müssen Sie beispielsweise 17 verwenden. Wenn Sie den Wert ip verwenden, müssen Sie das Feld port nicht angeben. Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"}
remoteIpList Die Remote-IP-Adressen, mit denen UEs eine Verbindung für diesen Flow herstellen. Wenn Sie Verbindungen für eine beliebige IP-Adresse zulassen möchten, verwenden Sie den Wert any. Andernfalls müssen Sie jede der Remote-IP-Adressen angeben, mit denen der Paketkern instance für diesen Flow eine Verbindung herstellen soll. Sie müssen jede IP-Adresse in CIDR-Notation angeben, einschließlich der Netzmaske (z. B. 192.0.2.54/24). Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(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 Der Name der Datenflussvorlage. Dies muss innerhalb der übergeordneten Datenflussrichtlinienregel eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

QosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Der 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.1 und Tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel ARP-Ebene (QoS Flow Allocation and Retention Priority). Flows mit vorzeitiger Entfernung mit höherer Priorität mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsstufe. Wenn dieses Feld nicht angegeben 5qi ist, wird verwendet, um den ARP-Wert abzuleiten. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 15
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
'NotPreempt'
preemptionVulnerability Sicherheitsrisiko bei vorzeitiger Entfernung von QoS-Fluss. Die Sicherheitslücke vor der Entfernung eines QoS-Flusses steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorzeitig entfernt werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. 'NotPreemptable'
"Preemptable"

Schnellstartvorlagen

In den folgenden Schnellstartvorlagen wird dieser Ressourcentyp bereitgestellt.

Vorlage BESCHREIBUNG
Erstellen einer vollständigen 5G Core-Bereitstellung

Bereitstellen in Azure
Mit dieser Vorlage werden alle Ressourcen erstellt, die für die Bereitstellung eines Privaten 5G Core erforderlich sind, einschließlich der Bereitstellung von Sims und der Erstellung einer QoS-Beispielrichtlinie. Sie kann optional in einem Kubernetes-Cluster bereitgestellt werden, der auf einem Azure Stack Edge-Gerät ausgeführt wird.
Erstellen einer Sim-Richtlinie

Bereitstellen in Azure
Mit dieser Vorlage wird eine Dienst- und Sim-Richtlinie für ein vorhandenes Mobilfunknetz erstellt.

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp mobileNetworks/services kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie im Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MobileNetwork/mobileNetworks/services-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "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"
    }
  }
}

Eigenschaftswerte

mobileNetworks/services

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.MobileNetwork/mobileNetworks/services"
apiVersion Die Version der Ressourcen-API '2024-02-01'
name Der Ressourcenname

Weitere Informationen finden Sie unter Festlegen von Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-64

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Beginnen Sie mit einem alphanumerischen Zeichen.

Die folgenden Wörter können nicht allein als Name verwendet werden: default, requested, service.
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
tags Ressourcentags. Wörterbuch der Tagnamen und -werte. Weitere Informationen finden Sie unter Tags in Vorlagen.
properties Diensteigenschaften. ServicePropertiesFormat (erforderlich)

ServicePropertiesFormat

Name BESCHREIBUNG Wert
pccRules Der Satz von Datenflussrichtlinienregeln, aus denen dieser Dienst besteht. PccRuleConfiguration[] (erforderlich)

Einschränkungen:
Min. Länge = 1
servicePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Diensten zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle dienste eindeutig sein, die im mobilen Netzwerk konfiguriert sind. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
serviceQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die diesem Dienst entsprechen. Dies kann für bestimmte Flows mithilfe des RuleQosPolicy-Felds in einer PccRuleConfiguration überschrieben werden. Wenn dieses Feld NULL ist, definiert die SIM-Richtlinie der UE die QoS-Einstellungen. QosPolicy

PccRuleConfiguration

Name BESCHREIBUNG Wert
ruleName Der Name der Regel. Dies muss innerhalb des übergeordneten Diensts eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
rulePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Datenflussrichtlinienregeln zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle Datenflussrichtlinienregeln, die im mobilen Netzwerk konfiguriert sind, eindeutig sein. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
ruleQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die dieser Regel entsprechen. Wenn dieses Feld NULL ist, definiert der übergeordnete Dienst die QoS-Einstellungen. PccRuleQosPolicy
serviceDataFlowTemplates Der Satz von Datenflussvorlagen, die für diese Datenflussrichtlinienregel verwendet werden sollen. ServiceDataFlowTemplate[] (erforderlich)

Einschränkungen:
Min. Länge = 1
Maximale Länge = 15
trafficControl Bestimmt, ob Flows, die dieser Datenflussrichtlinienregel entsprechen, zulässig sind. "Blockiert"
"Aktiviert"

PccRuleQosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Der 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.1 und Tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel ARP-Ebene (QoS Flow Allocation and Retention Priority). Flows mit vorzeitiger Entfernung mit höherer Priorität mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsstufe. Wenn dieses Feld nicht angegeben 5qi ist, wird verwendet, um den ARP-Wert abzuleiten. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 15
guaranteedBitRate Die garantierte Bitrate (GBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel verwenden. Dies ist eine optionale Einstellung. Wenn Sie keinen Wert angeben, ist kein GBR für die Datenflussrichtlinienregel festgelegt, die diese QoS-Definition verwendet. Ambr
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
'NotPreempt'
preemptionVulnerability Sicherheitsrisiko bei vorzeitiger Entfernung von QoS-Fluss. Die Sicherheitslücke vor der Entfernung eines QoS-Flusses steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorzeitig entfernt werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. 'NotPreemptable'
"Preemptable"

Ambr

Name BESCHREIBUNG Wert
Downlink Downlink-Bitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
Uplink Uplink-Bitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

ServiceDataFlowTemplate

Name BESCHREIBUNG Wert
direction Die Richtung dieses Flows. "Bidirektional"
"Downlink"
"Uplink" (erforderlich)
ports Die Ports, mit denen sich UEs für diesen Flow verbinden. Sie können null oder mehr Ports oder Portbereiche angeben. Wenn Sie einen oder mehrere Ports oder Portbereiche angeben, müssen Sie einen anderen Wert als ip im protocol Feld angeben. Dies ist eine optionale Einstellung. Wenn Sie es nicht angeben, sind Verbindungen an allen Ports zulässig. Portbereiche müssen als {FirstPort}-{LastPort} angegeben werden. Beispiel: [8080, 8082-8085]. string[]

Einschränkungen:
Muster = ^([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]))?$
Protokoll Eine Liste der zulässigen Protokolle für diesen Flow. Wenn dieser Flow ein beliebiges Protokoll innerhalb der Internetprotokollsuite verwenden soll, verwenden Sie den Wert ip. Wenn Sie nur eine Auswahl von Protokollen zulassen möchten, müssen Sie die entsprechende IANA zugewiesene Internetprotokollnummer für jedes Protokoll verwenden, wie in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlbeschrieben. Für UDP müssen Sie beispielsweise 17 verwenden. Wenn Sie den Wert ip verwenden, müssen Sie das Feld port nicht angegeben lassen. Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"}
remoteIpList Die Remote-IP-Adressen, mit denen UEs eine Verbindung für diesen Flow herstellen. Wenn Sie Verbindungen für eine beliebige IP-Adresse zulassen möchten, verwenden Sie den Wert any. Andernfalls müssen Sie jede der Remote-IP-Adressen angeben, mit denen der Paketkern instance für diesen Flow eine Verbindung herstellen soll. Sie müssen jede IP-Adresse in CIDR-Notation angeben, einschließlich der Netzmaske (z. B. 192.0.2.54/24). Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(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 Der Name der Datenflussvorlage. Dies muss innerhalb der übergeordneten Datenflussrichtlinienregel eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

QosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Das 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie in Abschnitt 5.7.2.1 von 3GPP TS23.501 und tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Min-Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel QoS Flow-Zuordnungs- und Aufbewahrungsprioritätsebene (ARP). Flows mit höherer Priorität für Vorabflüsse mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsebene. Wenn dieses Feld nicht angegeben wird, 5qi wird der ARP-Wert abgeleitet. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Min-Wert = 1
Maximaler Wert = 15
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
"NotPreempt"
PreemptionVulnerability QoS Flow Preemption-Sicherheitsrisiko. Die Sicherheitsanfälligkeit eines QoS-Flusses vor der Entfernung steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorgedrungen werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "NotPreemptable"
"Preemptable"

Schnellstartvorlagen

Diesen Ressourcentyp werden in den folgenden Schnellstartvorlagen bereitgestellt.

Vorlage BESCHREIBUNG
Erstellen einer vollständigen 5G Core-Bereitstellung

Bereitstellen in Azure
Mit dieser Vorlage werden alle Ressourcen erstellt, die für die Bereitstellung eines Privaten 5G Core erforderlich sind, einschließlich Bereitstellungs-Sims und Erstellen einer QoS-Beispielrichtlinie. Sie kann optional in einem Kubernetes-Cluster bereitgestellt werden, der auf einem Azure Stack Edge-Gerät ausgeführt wird.
Erstellen einer Sim-Richtlinie

Bereitstellen in Azure
Mit dieser Vorlage wird eine Dienst- und Sim-Richtlinie für ein vorhandenes Mobilfunknetz erstellt.

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Ressourcentyp mobileNetworks/services kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.MobileNetwork/mobileNetworks/services-Ressource zu erstellen, fügen Sie der Vorlage die folgende Terraform-Ressource hinzu.

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"
      }
    }
  })
}

Eigenschaftswerte

mobileNetworks/services

Name BESCHREIBUNG Wert
type Der Ressourcentyp "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-64

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Beginnen Sie mit einem alphanumerischen Zeichen.

Die folgenden Wörter können nicht allein als Name verwendet werden: default, requested, service.
location Der geografische Standort, an dem sich die Ressource befindet Zeichenfolge (erforderlich)
parent_id Die ID der Ressource, die das übergeordnete Element für diese Ressource ist. ID für Ressource vom Typ: mobileNetworks
tags Ressourcentags. Wörterbuch der Tagnamen und -werte.
properties Diensteigenschaften. ServicePropertiesFormat (erforderlich)

ServicePropertiesFormat

Name BESCHREIBUNG Wert
pccRules Der Satz von Datenflussrichtlinienregeln, aus denen dieser Dienst besteht. PccRuleConfiguration[] (erforderlich)

Einschränkungen:
Min. Länge = 1
servicePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Diensten zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle dienste eindeutig sein, die im mobilen Netzwerk konfiguriert sind. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
serviceQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die diesem Dienst entsprechen. Dies kann für bestimmte Flows mithilfe des RuleQosPolicy-Felds in einer PccRuleConfiguration überschrieben werden. Wenn dieses Feld NULL ist, definiert die SIM-Richtlinie der UE die QoS-Einstellungen. QosPolicy

PccRuleConfiguration

Name BESCHREIBUNG Wert
ruleName Der Name der Regel. Dies muss innerhalb des übergeordneten Diensts eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
rulePrecedence Ein Rangfolgewert, der verwendet wird, um zwischen Datenflussrichtlinienregeln zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM-Karte verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle Datenflussrichtlinienregeln, die im mobilen Netzwerk konfiguriert sind, eindeutig sein. int (erforderlich)

Einschränkungen:
Minimaler Wert = 0
Maximaler Wert = 255
ruleQosPolicy Die QoS-Richtlinie, die für Pakete verwendet werden soll, die dieser Regel entsprechen. Wenn dieses Feld NULL ist, definiert der übergeordnete Dienst die QoS-Einstellungen. PccRuleQosPolicy
serviceDataFlowTemplates Der Satz von Datenflussvorlagen, die für diese Datenflussrichtlinienregel verwendet werden sollen. ServiceDataFlowTemplate[] (erforderlich)

Einschränkungen:
Min. Länge = 1
Maximale Länge = 15
trafficControl Bestimmt, ob Flows, die dieser Datenflussrichtlinienregel entsprechen, zulässig sind. "Blockiert"
"Aktiviert"

PccRuleQosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Der 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.1 und Tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel ARP-Ebene (QoS Flow Allocation and Retention Priority). Flows mit vorzeitiger Entfernung mit höherer Priorität mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsstufe. Wenn dieses Feld nicht angegeben 5qi ist, wird verwendet, um den ARP-Wert abzuleiten. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Min-Wert = 1
Maximaler Wert = 15
guaranteedBitRate Die garantierte Bitrate (GBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel verwenden. Dies ist eine optionale Einstellung. Wenn Sie keinen Wert angeben, gibt es keinen GBR-Satz für die Datenflussrichtlinienregel, die diese QoS-Definition verwendet. Ambr
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
"NotPreempt"
PreemptionVulnerability QoS Flow Preemption-Sicherheitsrisiko. Die Sicherheitsanfälligkeit eines QoS-Flusses vor der Entfernung steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorgedrungen werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "NotPreemptable"
"Preemptable"

Ambr

Name BESCHREIBUNG Wert
Downlink Downlinkbitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$
Uplink Uplink-Bitrate. Zeichenfolge (erforderlich)

Einschränkungen:
Muster = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

ServiceDataFlowTemplate

Name BESCHREIBUNG Wert
direction Die Richtung dieses Flows. "Bidirektional"
"Downlink"
"Uplink" (erforderlich)
ports Die Ports, mit denen sich UEs für diesen Flow verbinden. Sie können null oder mehr Ports oder Portbereiche angeben. Wenn Sie einen oder mehrere Ports oder Portbereiche angeben, müssen Sie einen anderen Wert als ip im protocol Feld angeben. Dies ist eine optionale Einstellung. Wenn Sie es nicht angeben, sind Verbindungen an allen Ports zulässig. Portbereiche müssen als {FirstPort}-{LastPort} angegeben werden. Beispiel: [8080, 8082-8085]. string[]

Einschränkungen:
Muster = ^([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]))?$
Protokoll Eine Liste der zulässigen Protokolle für diesen Flow. Wenn dieser Flow ein beliebiges Protokoll innerhalb der Internetprotokollsuite verwenden soll, verwenden Sie den Wert ip. Wenn Sie nur eine Auswahl von Protokollen zulassen möchten, müssen Sie die entsprechende IANA zugewiesene Internetprotokollnummer für jedes Protokoll verwenden, wie in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlbeschrieben. Für UDP müssen Sie beispielsweise 17 verwenden. Wenn Sie den Wert ip verwenden, müssen Sie das Feld port nicht angegeben lassen. Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"}
remoteIpList Die Remote-IP-Adressen, mit denen UEs eine Verbindung für diesen Flow herstellen. Wenn Sie Verbindungen für eine beliebige IP-Adresse zulassen möchten, verwenden Sie den Wert any. Andernfalls müssen Sie jede der Remote-IP-Adressen angeben, mit denen der Paketkern instance für diesen Flow eine Verbindung herstellen soll. Sie müssen jede IP-Adresse in CIDR-Notation angeben, einschließlich der Netzmaske (z. B. 192.0.2.54/24). Zeichenfolge (erforderlich)

Einschränkungen:
Min. Länge = 1
Muster = ^(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 Der Name der Datenflussvorlage. Dies muss innerhalb der übergeordneten Datenflussrichtlinienregel eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service. Zeichenfolge (erforderlich)

Einschränkungen:
Maximale Länge = 64
Muster = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

QosPolicy

Name BESCHREIBUNG Wert
5qi 5G QoS Flow Indicator-Wert. Das 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie in Abschnitt 5.7.2.1 von 3GPP TS23.501 und tabelle 5.7.4-1 für die Definition der 5QI-Werte. INT

Einschränkungen:
Min-Wert = 1
Maximaler Wert = 127
allocationAndRetentionPriorityLevel QoS Flow-Zuordnungs- und Aufbewahrungsprioritätsebene (ARP). Flows mit höherer Priorität für Vorabflüsse mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsebene. Wenn dieses Feld nicht angegeben wird, 5qi wird der ARP-Wert abgeleitet. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. INT

Einschränkungen:
Minimaler Wert = 1
Maximaler Wert = 15
maximumBitRate Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden. Ambr (erforderlich)
preemptionCapability QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "MayPreempt"
"NotPreempt"
preemptionVulnerability Sicherheitsrisiko bei vorzeitiger Entfernung von QoS-Fluss. Die Sicherheitslücke vor der Entfernung eines QoS-Flusses steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorzeitig entfernt werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2. "NotPreemptable"
"Preemptable"