Microsoft.MobileNetwork mobileNetworks/services

Articolo
12/20/2024

Definizione di risorsa Bicep

Il tipo di risorsa mobileNetworks/services può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.MobileNetwork/mobileNetworks/services, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01' = {
  parent: resourceSymbolicName
  location: 'string'
  name: 'string'
  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'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Valori delle proprietà

Ambr

Nome	Descrizione	Valore
Downlink	Velocità in bit di downlink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)
Uplink	Velocità in bit uplink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)

Microsoft.MobileNetwork/mobileNetworks/services

Nome	Descrizione	Valore
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
genitore	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: mobileNetworks
proprietà	Proprietà del servizio.	ServicePropertiesFormat (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli

PccRuleConfiguration

Nome	Descrizione	Valore
ruleName	Nome della regola. Deve essere univoco all'interno del servizio padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
rulePrecedence	Valore di precedenza usato per decidere tra le regole dei criteri del flusso di dati quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutte le regole dei criteri del flusso di dati configurate nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
ruleQosPolicy	Criterio QoS da usare per i pacchetti corrispondenti a questa regola. Se questo campo è Null, il servizio padre definirà le impostazioni QoS.	PccRuleQosPolicy
serviceDataFlowTemplates	Set di modelli di flusso di dati da usare per questa regola dei criteri del flusso di dati.	serviceDataFlowTemplate[] (obbligatorio)
trafficControl	Determina se i flussi che corrispondono a questa regola dei criteri del flusso di dati sono consentiti.	'Bloccato' 'Enabled'

PccRuleQosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
guaranteedBitRate	Velocità in bit garantita (GBR) per tutti i flussi di dati del servizio che usano questa regola dei criteri del flusso di dati. Si tratta di un'impostazione facoltativa. Se non si specifica un valore, non verrà impostato alcun GBR per la regola dei criteri del flusso di dati che usa questa definizione QoS.	Ambr
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

QosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

ServiceDataFlowTemplate

Nome	Descrizione	Valore
direzione	Direzione di questo flusso.	'Bidirezionale' 'Downlink' 'Uplink' (obbligatorio)
Porte	Le porte a cui si connetteranno gli UES per questo flusso. È possibile specificare zero o più porte o intervalli di porte. Se si specificano una o più porte o intervalli di porte, è necessario specificare un valore diverso da `ip` nel campo `protocol`. Si tratta di un'impostazione facoltativa. Se non si specifica, le connessioni saranno consentite su tutte le porte. Gli intervalli di porte devono essere specificati come <FirstPort>-<LastPort>. Ad esempio: [`8080`, `8082-8085`].	corda Vincoli: Pattern = `^([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5])(-([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5]))?$`[]
protocollo	Elenco dei protocolli consentiti per questo flusso. Se si vuole che questo flusso sia in grado di usare qualsiasi protocollo all'interno della suite di protocolli Internet, usare il valore `ip`. Se si vuole consentire solo una selezione di protocolli, è necessario usare il numero di protocollo Internet assegnato IANA corrispondente per ogni protocollo, come descritto in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Ad esempio, per UDP, è necessario usare 17. Se si usa il valore `ip`, è necessario lasciare il campo `port` non specificato.	corda Vincoli: Pattern = `^(ip\|[0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])$`[] (obbligatorio)
remoteIpList	Indirizzo IP remoto a cui si connetteranno gli entità utente per questo flusso. Se si desidera consentire le connessioni su qualsiasi indirizzo IP, usare il valore `any`. In caso contrario, è necessario specificare ognuno degli indirizzi IP remoti a cui si connetterà l'istanza di base del pacchetto per questo flusso. È necessario specificare ogni indirizzo IP nella notazione CIDR, inclusa la maschera di rete (ad esempio, 192.0.2.54/24).	corda Vincoli: Pattern = `^(any\|(([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])\.){3}([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])(\/([0-9]\|[1-2][0-9]\|3[0-2])))$`[] (obbligatorio)
templateName	Nome del modello di flusso di dati. Deve essere univoco all'interno della regola dei criteri del flusso di dati padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)

ServicePropertiesFormat

Nome	Descrizione	Valore
pccRules	Set di regole dei criteri del flusso di dati che costituiscono questo servizio.	PccRuleConfiguration[] (obbligatorio)
servicePrecedence	Valore di precedenza usato per decidere tra i servizi quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutti i servizi configurati nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
serviceQosPolicy	Criteri QoS da usare per i pacchetti corrispondenti a questo servizio. Questo può essere sottoposto a override per determinati flussi usando il campo ruleQosPolicy in un pccRuleConfiguration. Se questo campo è null, i criteri SIM di UE definiranno le impostazioni QoS.	QosPolicy

TrackedResourceTags

Nome	Descrizione	Valore

Esempi di avvio rapido

Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Bicep File	Descrizione
Creare una distribuzione completa 5G Core	Questo modello crea tutte le risorse necessarie per distribuire un core 5G privato, inclusi il provisioning dei sims e la creazione di criteri QoS di esempio. Può essere distribuito facoltativamente in un cluster Kubernetes in esecuzione in un dispositivo Azure Stack Edge.
Creare un criterio sim	Questo modello crea un servizio e criteri sim per una rete mobile esistente.

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa mobileNetworks/services può essere distribuito con operazioni destinate a:

gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.MobileNetwork/mobileNetworks/services, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.MobileNetwork/mobileNetworks/services",
  "apiVersion": "2024-04-01",
  "name": "string",
  "location": "string",
  "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"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valori delle proprietà

Ambr

Nome	Descrizione	Valore
Downlink	Velocità in bit di downlink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)
Uplink	Velocità in bit uplink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)

Microsoft.MobileNetwork/mobileNetworks/services

Nome	Descrizione	Valore
apiVersion	Versione dell'API	'2024-04-01'
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
proprietà	Proprietà del servizio.	ServicePropertiesFormat (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag. Vedere tag nei modelli
digitare	Tipo di risorsa	'Microsoft.MobileNetwork/mobileNetworks/services'

PccRuleConfiguration

Nome	Descrizione	Valore
ruleName	Nome della regola. Deve essere univoco all'interno del servizio padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
rulePrecedence	Valore di precedenza usato per decidere tra le regole dei criteri del flusso di dati quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutte le regole dei criteri del flusso di dati configurate nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
ruleQosPolicy	Criterio QoS da usare per i pacchetti corrispondenti a questa regola. Se questo campo è Null, il servizio padre definirà le impostazioni QoS.	PccRuleQosPolicy
serviceDataFlowTemplates	Set di modelli di flusso di dati da usare per questa regola dei criteri del flusso di dati.	serviceDataFlowTemplate[] (obbligatorio)
trafficControl	Determina se i flussi che corrispondono a questa regola dei criteri del flusso di dati sono consentiti.	'Bloccato' 'Enabled'

PccRuleQosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
guaranteedBitRate	Velocità in bit garantita (GBR) per tutti i flussi di dati del servizio che usano questa regola dei criteri del flusso di dati. Si tratta di un'impostazione facoltativa. Se non si specifica un valore, non verrà impostato alcun GBR per la regola dei criteri del flusso di dati che usa questa definizione QoS.	Ambr
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

QosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

ServiceDataFlowTemplate

Nome	Descrizione	Valore
direzione	Direzione di questo flusso.	'Bidirezionale' 'Downlink' 'Uplink' (obbligatorio)
Porte	Le porte a cui si connetteranno gli UES per questo flusso. È possibile specificare zero o più porte o intervalli di porte. Se si specificano una o più porte o intervalli di porte, è necessario specificare un valore diverso da `ip` nel campo `protocol`. Si tratta di un'impostazione facoltativa. Se non si specifica, le connessioni saranno consentite su tutte le porte. Gli intervalli di porte devono essere specificati come <FirstPort>-<LastPort>. Ad esempio: [`8080`, `8082-8085`].	corda Vincoli: Pattern = `^([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5])(-([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5]))?$`[]
protocollo	Elenco dei protocolli consentiti per questo flusso. Se si vuole che questo flusso sia in grado di usare qualsiasi protocollo all'interno della suite di protocolli Internet, usare il valore `ip`. Se si vuole consentire solo una selezione di protocolli, è necessario usare il numero di protocollo Internet assegnato IANA corrispondente per ogni protocollo, come descritto in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Ad esempio, per UDP, è necessario usare 17. Se si usa il valore `ip`, è necessario lasciare il campo `port` non specificato.	corda Vincoli: Pattern = `^(ip\|[0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])$`[] (obbligatorio)
remoteIpList	Indirizzo IP remoto a cui si connetteranno gli entità utente per questo flusso. Se si desidera consentire le connessioni su qualsiasi indirizzo IP, usare il valore `any`. In caso contrario, è necessario specificare ognuno degli indirizzi IP remoti a cui si connetterà l'istanza di base del pacchetto per questo flusso. È necessario specificare ogni indirizzo IP nella notazione CIDR, inclusa la maschera di rete (ad esempio, 192.0.2.54/24).	corda Vincoli: Pattern = `^(any\|(([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])\.){3}([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])(\/([0-9]\|[1-2][0-9]\|3[0-2])))$`[] (obbligatorio)
templateName	Nome del modello di flusso di dati. Deve essere univoco all'interno della regola dei criteri del flusso di dati padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)

ServicePropertiesFormat

Nome	Descrizione	Valore
pccRules	Set di regole dei criteri del flusso di dati che costituiscono questo servizio.	PccRuleConfiguration[] (obbligatorio)
servicePrecedence	Valore di precedenza usato per decidere tra i servizi quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutti i servizi configurati nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
serviceQosPolicy	Criteri QoS da usare per i pacchetti corrispondenti a questo servizio. Questo può essere sottoposto a override per determinati flussi usando il campo ruleQosPolicy in un pccRuleConfiguration. Se questo campo è null, i criteri SIM di UE definiranno le impostazioni QoS.	QosPolicy

TrackedResourceTags

Nome	Descrizione	Valore

Modelli di avvio rapido

I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.

Sagoma	Descrizione
Creare una distribuzione completa 5G Core	Questo modello crea tutte le risorse necessarie per distribuire un core 5G privato, inclusi il provisioning dei sims e la creazione di criteri QoS di esempio. Può essere distribuito facoltativamente in un cluster Kubernetes in esecuzione in un dispositivo Azure Stack Edge.
Creare un criterio sim	Questo modello crea un servizio e criteri sim per una rete mobile esistente.

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa mobileNetworks/services può essere distribuito con operazioni destinate a:

gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.MobileNetwork/mobileNetworks/services, aggiungere il comando Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01"
  name = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  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"
      }
    }
  })
}

Valori delle proprietà

Ambr

Nome	Descrizione	Valore
Downlink	Velocità in bit di downlink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)
Uplink	Velocità in bit uplink.	corda Vincoli: Pattern = `^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$` (obbligatorio)

Microsoft.MobileNetwork/mobileNetworks/services

Nome	Descrizione	Valore
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: mobileNetworks
proprietà	Proprietà del servizio.	ServicePropertiesFormat (obbligatorio)
Tag	Tag delle risorse	Dizionario di nomi e valori di tag.
digitare	Tipo di risorsa	"Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01"

PccRuleConfiguration

Nome	Descrizione	Valore
ruleName	Nome della regola. Deve essere univoco all'interno del servizio padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)
rulePrecedence	Valore di precedenza usato per decidere tra le regole dei criteri del flusso di dati quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutte le regole dei criteri del flusso di dati configurate nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
ruleQosPolicy	Criterio QoS da usare per i pacchetti corrispondenti a questa regola. Se questo campo è Null, il servizio padre definirà le impostazioni QoS.	PccRuleQosPolicy
serviceDataFlowTemplates	Set di modelli di flusso di dati da usare per questa regola dei criteri del flusso di dati.	serviceDataFlowTemplate[] (obbligatorio)
trafficControl	Determina se i flussi che corrispondono a questa regola dei criteri del flusso di dati sono consentiti.	'Bloccato' 'Enabled'

PccRuleQosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
guaranteedBitRate	Velocità in bit garantita (GBR) per tutti i flussi di dati del servizio che usano questa regola dei criteri del flusso di dati. Si tratta di un'impostazione facoltativa. Se non si specifica un valore, non verrà impostato alcun GBR per la regola dei criteri del flusso di dati che usa questa definizione QoS.	Ambr
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

QosPolicy

Nome	Descrizione	Valore
5qi	Valore indicatore flusso QoS 5G. La 5QI identifica un trattamento di inoltro QoS specifico da fornire a un flusso. Vedere la sezione 3GPP TS23.501 5.7.2.1 per una descrizione completa del parametro 5QI e la tabella 5.7.4-1 per la definizione dei valori 5QI.	Int Vincoli: Valore minimo = 1 Valore massimo = 127
allocationAndRetentionPriorityLevel	Livello di allocazione del flusso QoS e priorità di conservazione (ARP). I flussi con priorità più alta precedono i flussi con priorità più bassa, se le impostazioni di `preemptionCapability` e `preemptionVulnerability` consentirlo. 1 è il livello di priorità più alto. Se questo campo non viene specificato, `5qi` viene usato per derivare il valore ARP. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	Int Vincoli: Valore minimo = 1 Valore massimo = 15
maximumBitRate	Velocità massima in bit (MBR) per tutti i flussi di dati del servizio che usano questa regola o servizio dei criteri del flusso di dati.	Ambr (obbligatorio)
preemptionCapability	Funzionalità di preemption del flusso QoS. La funzionalità di precedenza di un flusso QoS controlla se può anteporre un altro flusso QoS con un livello di priorità inferiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'MayPreempt' 'NotPreempt'
preemptionVulnerability	Vulnerabilità di precedenza del flusso QoS. La vulnerabilità di precedenza di un flusso QoS controlla se può essere annullata da un flusso QoS con un livello di priorità superiore. Per una descrizione completa dei parametri ARP, vedere 3GPP TS23.501 sezione 5.7.2.2.	'NotPreemptable' 'Preemptable'

ServiceDataFlowTemplate

Nome	Descrizione	Valore
direzione	Direzione di questo flusso.	'Bidirezionale' 'Downlink' 'Uplink' (obbligatorio)
Porte	Le porte a cui si connetteranno gli UES per questo flusso. È possibile specificare zero o più porte o intervalli di porte. Se si specificano una o più porte o intervalli di porte, è necessario specificare un valore diverso da `ip` nel campo `protocol`. Si tratta di un'impostazione facoltativa. Se non si specifica, le connessioni saranno consentite su tutte le porte. Gli intervalli di porte devono essere specificati come <FirstPort>-<LastPort>. Ad esempio: [`8080`, `8082-8085`].	corda Vincoli: Pattern = `^([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5])(-([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5]))?$`[]
protocollo	Elenco dei protocolli consentiti per questo flusso. Se si vuole che questo flusso sia in grado di usare qualsiasi protocollo all'interno della suite di protocolli Internet, usare il valore `ip`. Se si vuole consentire solo una selezione di protocolli, è necessario usare il numero di protocollo Internet assegnato IANA corrispondente per ogni protocollo, come descritto in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Ad esempio, per UDP, è necessario usare 17. Se si usa il valore `ip`, è necessario lasciare il campo `port` non specificato.	corda Vincoli: Pattern = `^(ip\|[0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])$`[] (obbligatorio)
remoteIpList	Indirizzo IP remoto a cui si connetteranno gli entità utente per questo flusso. Se si desidera consentire le connessioni su qualsiasi indirizzo IP, usare il valore `any`. In caso contrario, è necessario specificare ognuno degli indirizzi IP remoti a cui si connetterà l'istanza di base del pacchetto per questo flusso. È necessario specificare ogni indirizzo IP nella notazione CIDR, inclusa la maschera di rete (ad esempio, 192.0.2.54/24).	corda Vincoli: Pattern = `^(any\|(([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])\.){3}([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])(\/([0-9]\|[1-2][0-9]\|3[0-2])))$`[] (obbligatorio)
templateName	Nome del modello di flusso di dati. Deve essere univoco all'interno della regola dei criteri del flusso di dati padre. Non è necessario usare alcuna delle stringhe riservate seguenti: `default`, `requested` o `service`.	corda Vincoli: Lunghezza massima = Pattern = `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$` (obbligatorio)

ServicePropertiesFormat

Nome	Descrizione	Valore
pccRules	Set di regole dei criteri del flusso di dati che costituiscono questo servizio.	PccRuleConfiguration[] (obbligatorio)
servicePrecedence	Valore di precedenza usato per decidere tra i servizi quando si identificano i valori QoS da usare per una determinata SIM. Un valore inferiore indica una priorità più alta. Questo valore deve essere univoco tra tutti i servizi configurati nella rete mobile.	Int Vincoli: Valore minimo = 0 Valore massimo = 255 (obbligatorio)
serviceQosPolicy	Criteri QoS da usare per i pacchetti corrispondenti a questo servizio. Questo può essere sottoposto a override per determinati flussi usando il campo ruleQosPolicy in un pccRuleConfiguration. Se questo campo è null, i criteri SIM di UE definiranno le impostazioni QoS.	QosPolicy

TrackedResourceTags

Nome	Descrizione	Valore

Condividi tramite

Microsoft.MobileNetwork mobileNetworks/services

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Ambr

Microsoft.MobileNetwork/mobileNetworks/services

PccRuleConfiguration

PccRuleQosPolicy

QosPolicy

ServiceDataFlowTemplate

ServicePropertiesFormat

TrackedResourceTags

Esempi di avvio rapido

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Ambr

Microsoft.MobileNetwork/mobileNetworks/services

PccRuleConfiguration

PccRuleQosPolicy

QosPolicy

ServiceDataFlowTemplate

ServicePropertiesFormat

TrackedResourceTags

Modelli di avvio rapido

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Ambr

Microsoft.MobileNetwork/mobileNetworks/services

PccRuleConfiguration

PccRuleQosPolicy

QosPolicy

ServiceDataFlowTemplate

ServicePropertiesFormat

TrackedResourceTags

Commenti e suggerimenti

Risorse aggiuntive