Microsoft.MobileNetwork mobileNetworks/services
Bicep-Ressourcendefinition
Der Ressourcentyp mobileNetworks/services kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
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.xhtml beschrieben. 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 |
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 |
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:
- Ressourcengruppen – Siehe Bereitstellungsbefehle für Ressourcengruppen
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.xhtml beschrieben. 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 |
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 |
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.xhtml beschrieben. 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" |