Microsoft.MobileNetwork mobileNetworks/services 2023-09-01
Définition de ressource Bicep
Le type de ressource mobileNetworks/services peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupe de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.MobileNetwork/mobileNetworks/services, ajoutez le Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2023-09-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'
}
}
}
Valeurs de propriétés
mobileNetworks/services
Nom | Description | Valeur |
---|---|---|
name | Nom de la ressource Découvrez comment définir des noms et des types pour des ressources enfants dans Bicep. |
string (obligatoire) Limite de caractères : 1-64 Caractères valides : Caractères alphanumériques et traits d’union. Doit commencer par un caractère alphanumérique. Les mots suivants ne peuvent pas être utilisés seuls comme nom : default , requested , service . |
location | Emplacement géographique où réside la ressource | string (obligatoire) |
tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
parent | Dans Bicep, vous pouvez spécifier la ressource parente pour une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente. Pour plus d’informations, consultez Ressource enfant en dehors de la ressource parente. |
Nom symbolique de la ressource de type : mobileNetworks |
properties | Propriétés du service. | ServicePropertiesFormat (obligatoire) |
ServicePropertiesFormat
Nom | Description | Valeur |
---|---|---|
pccRules | Ensemble de règles de stratégie de flux de données qui composent ce service. | PccRuleConfiguration[] (obligatoire) Contraintes : Longueur minimale = 1 |
servicePrecedence | Valeur de précédence utilisée pour choisir entre les services lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi tous les services configurés dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
serviceQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à ce service. Cela peut être remplacé pour des flux particuliers à l’aide du champ ruleQosPolicy dans un PccRuleConfiguration. Si ce champ est null, la stratégie SIM de l’ue définit les paramètres QoS. | QosPolicy |
PccRuleConfiguration
Nom | Description | Valeur |
---|---|---|
ruleName | nom de la règle. Cela doit être unique au sein du service parent. Vous ne devez utiliser aucune des chaînes réservées suivantes : default , requested ou service . |
string (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Valeur de précédence utilisée pour choisir entre les règles de stratégie de flux de données lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi toutes les règles de stratégie de flux de données configurées dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
ruleQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à cette règle. Si ce champ a la valeur Null, le service parent définit les paramètres QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | Ensemble de modèles de flux de données à utiliser pour cette règle de stratégie de flux de données. | ServiceDataFlowTemplate[] (obligatoire) Contraintes : Longueur minimale = 1 Longueur maximale = 15 |
trafficControl | Détermine si les flux qui correspondent à cette règle de stratégie de flux de données sont autorisés. | 'Bloqué' 'Enabled' |
PccRuleQosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez la section 5.7.2.1 du 3GPP TS23.501 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau d’allocation et de priorité de rétention (ARP) du flux QoS. Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
guaranteedBitRate | Débit binaire garanti (GBR) pour tous les flux de données de service qui utilisent cette règle de stratégie de flux de données. Ce paramètre est facultatif. Si vous ne fournissez pas de valeur, il n’y aura pas de jeu GBR pour la règle de stratégie de flux de données qui utilise cette définition QoS. | Ambr |
maximumBitRate | Débit maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
préemptionCapability | Fonctionnalité de préemption qoS Flow. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. | 'MayPreempt' 'NotPreempt' |
préemptionVulnerability | Vulnérabilité de préemption qoS Flow. La vulnérabilité de préemption d’un flux QoS contrôle s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. | 'NotPreemptable' 'Préemptable' |
Ambr
Nom | Description | Valeur |
---|---|---|
Descendante | Débit de liaison descendante. | chaîne (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Liaison montante | Débit de liaison montante. | chaîne (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nom | Description | Valeur |
---|---|---|
direction | Sens de ce flux. | 'Bidirectionnel' 'Liaison descendante' 'Liaison montante' (obligatoire) |
ports | Port(s) auxquels les UE se connecteront pour ce flux. Vous pouvez spécifier zéro ou plusieurs ports ou plages de ports. Si vous spécifiez un ou plusieurs ports ou plages de ports, vous devez spécifier une valeur autre que ip dans le protocol champ . Ce paramètre est facultatif. Si vous ne le spécifiez pas, les connexions seront autorisées sur tous les ports. Les plages de ports doivent être spécifiées en tant que {FirstPort}-{LastPort}. Par exemple : [8080 , 8082-8085 ]. |
string[] Contraintes : Modèle = ^([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]))?$ |
protocol | Liste des protocoles autorisés pour ce flux. Si vous souhaitez que ce flux puisse utiliser n’importe quel protocole au sein de la suite de protocoles Internet, utilisez la valeur ip . Si vous souhaitez autoriser uniquement une sélection de protocoles, vous devez utiliser le numéro de protocole Internet attribué IANA correspondant pour chaque protocole, comme décrit dans https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Par exemple, pour UDP, vous devez utiliser 17. Si vous utilisez la valeur ip , vous devez laisser le champ port non spécifié. |
chaîne (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Chaque adresse IP distante à laquelle les UE se connecteront pour ce flux. Si vous souhaitez autoriser les connexions sur n’importe quelle adresse IP, utilisez la valeur any . Sinon, vous devez fournir chacune des adresses IP distantes auxquelles le cœur de paquet instance se connectera pour ce flux. Vous devez fournir chaque adresse IP en notation CIDR, y compris le masque de réseau (par exemple, 192.0.2.54/24). |
chaîne (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(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 | Nom du modèle de flux de données. Cela doit être unique au sein de la règle de stratégie de flux de données parente. Vous ne devez pas utiliser les chaînes réservées suivantes : default , requested ou service . |
chaîne (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez la section 5.7.2.1 du 3GPP TS23.501 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau d’allocation et de priorité de rétention (ARP) du flux QoS. Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
maximumBitRate | Débit maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
préemptionCapability | Fonctionnalité de préemption qoS Flow. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. | 'MayPreempt' 'NotPreempt' |
préemptionVulnerability | Vulnérabilité de préemption qoS Flow. La vulnérabilité de préemption d’un flux QoS contrôle s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 du 3GPP TS23.501. | 'NotPreemptable' 'Préemptable' |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
Modèle | Description |
---|---|
Créer un déploiement 5G Core complet |
Ce modèle crée toutes les ressources nécessaires au déploiement d’un private 5G Core, y compris l’approvisionnement de sims et la création d’un exemple de stratégie QoS. Il peut éventuellement être déployé sur un cluster Kubernetes s’exécutant sur un appareil Azure Stack Edge. |
Créer une stratégie sim |
Ce modèle crée une stratégie de service et de sim pour un réseau mobile existant. |
Définition de ressources de modèle ARM
Le type de ressource mobileNetworks/services peut être déployé avec des opérations qui ciblent :
- Groupes de ressources - Voir commandes de déploiement de groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.MobileNetwork/mobileNetworks/services, ajoutez le JSON suivant à votre modèle.
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2023-09-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"
}
}
}
Valeurs de propriétés
mobileNetworks/services
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.MobileNetwork/mobileNetworks/services » |
apiVersion | Version de l’API de ressource | '2023-09-01' |
name | Nom de la ressource Découvrez comment définir des noms et des types pour des ressources enfants dans des modèles ARM JSON. |
chaîne (obligatoire) Limite de caractères : 1-64 Caractères valides : Caractères alphanumériques et traits d’union. Doit commencer par un caractère alphanumérique. Les mots suivants ne peuvent pas être utilisés seuls comme nom : default , requested , service . |
location | Emplacement géographique où réside la ressource | chaîne (obligatoire) |
tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles |
properties | Propriétés du service. | ServicePropertiesFormat (obligatoire) |
ServicePropertiesFormat
Nom | Description | Valeur |
---|---|---|
pccRules | Ensemble de règles de stratégie de flux de données qui composent ce service. | PccRuleConfiguration[] (obligatoire) Contraintes : Longueur minimale = 1 |
servicePrecedence | Valeur de précédence utilisée pour choisir entre les services lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi tous les services configurés dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
serviceQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à ce service. Cela peut être remplacé pour des flux particuliers à l’aide du champ ruleQosPolicy dans un PccRuleConfiguration. Si ce champ est null, la stratégie SIM de l’ue définit les paramètres QoS. | QosPolicy |
PccRuleConfiguration
Nom | Description | Valeur |
---|---|---|
ruleName | nom de la règle. Cela doit être unique au sein du service parent. Vous ne devez utiliser aucune des chaînes réservées suivantes : default , requested ou service . |
string (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Valeur de précédence utilisée pour choisir entre les règles de stratégie de flux de données lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi toutes les règles de stratégie de flux de données configurées dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
ruleQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à cette règle. Si ce champ a la valeur Null, le service parent définit les paramètres QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | Ensemble de modèles de flux de données à utiliser pour cette règle de stratégie de flux de données. | ServiceDataFlowTemplate[] (obligatoire) Contraintes : Longueur minimale = 1 Longueur maximale = 15 |
trafficControl | Détermine si les flux qui correspondent à cette règle de stratégie de flux de données sont autorisés. | 'Bloqué' 'Enabled' |
PccRuleQosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez 3GPP TS23.501 section 5.7.2.1 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau de priorité d’allocation et de rétention de flux QoS (ARP). Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
guaranteedBitRate | Débit binaire garanti (GBR) pour tous les flux de données de service qui utilisent cette règle de stratégie de flux de données. Ce paramètre est facultatif. Si vous ne fournissez pas de valeur, il n’y aura pas de paramètre GBR défini pour la règle de stratégie de flux de données qui utilise cette définition qoS. | Ambr |
maximumBitRate | Débit binaire maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
preemptionCapability | Fonctionnalité de préemption de flux QoS. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnérabilité de préemption de flux QoS. La vulnérabilité de préemption d’un flux QoS détermine s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | 'NotPreemptable' 'Préemptable' |
Ambr
Nom | Description | Valeur |
---|---|---|
Descendante | Débit de liaison descendante. | string (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Liaison montante | Débit de liaison montante. | string (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nom | Description | Valeur |
---|---|---|
direction | Sens de ce flux. | 'Bidirectionnel' 'Lien descendant' 'Uplink' (obligatoire) |
ports | Port(s) auquel les E/S se connectent pour ce flux. Vous pouvez spécifier zéro ou plusieurs ports ou plages de ports. Si vous spécifiez un ou plusieurs ports ou plages de ports, vous devez spécifier une valeur autre que ip dans le protocol champ . Ce paramètre est facultatif. Si vous ne le spécifiez pas, les connexions sont autorisées sur tous les ports. Les plages de ports doivent être spécifiées comme {FirstPort}-{LastPort}. Par exemple : [8080 , 8082-8085 ]. |
string[] Contraintes : Modèle = ^([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]))?$ |
protocol | Liste des protocoles autorisés pour ce flux. Si vous souhaitez que ce flux puisse utiliser n’importe quel protocole dans la suite de protocoles Internet, utilisez la valeur ip . Si vous souhaitez uniquement autoriser une sélection de protocoles, vous devez utiliser le numéro de protocole Internet attribué IANA correspondant pour chaque protocole, comme décrit dans https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Par exemple, pour UDP, vous devez utiliser 17. Si vous utilisez la valeur ip , vous devez laisser le champ port non spécifié. |
string (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Chaque adresse IP distante à laquelle les UE se connecteront pour ce flux. Si vous souhaitez autoriser les connexions sur n’importe quelle adresse IP, utilisez la valeur any . Sinon, vous devez fournir chacune des adresses IP distantes auxquelles le cœur de paquets instance se connectera pour ce flux. Vous devez fournir chaque adresse IP en notation CIDR, y compris le masque réseau (par exemple, 192.0.2.54/24). |
string (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(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 | Nom du modèle de flux de données. Cela doit être unique dans la règle de stratégie de flux de données parent. Vous ne devez utiliser aucune des chaînes réservées suivantes : default , requested ou service . |
string (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez 3GPP TS23.501 section 5.7.2.1 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau de priorité d’allocation et de rétention de flux QoS (ARP). Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
maximumBitRate | Débit binaire maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
preemptionCapability | Fonctionnalité de préemption de flux QoS. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnérabilité de préemption de flux QoS. La vulnérabilité de préemption d’un flux QoS détermine s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | 'NotPreemptable' 'Préemptable' |
Modèles de démarrage rapide
Les modèles de démarrage rapide suivants déploient ce type de ressource.
Modèle | Description |
---|---|
Créer un déploiement 5G Core complet |
Ce modèle crée toutes les ressources requises pour déployer un cœur 5G privé, y compris l’approvisionnement de sims et la création d’un exemple de stratégie QoS. Il peut éventuellement être déployé sur un cluster Kubernetes s’exécutant sur un appareil Azure Stack Edge. |
Créer une stratégie sim |
Ce modèle crée une stratégie de service et de sim pour un réseau mobile existant. |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource mobileNetworks/services peut être déployé avec des opérations qui ciblent :
- Groupes de ressources
Pour obtenir la liste des propriétés modifiées dans chaque version d’API, consultez journal des modifications.
Format des ressources
Pour créer une ressource Microsoft.MobileNetwork/mobileNetworks/services, ajoutez le Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2023-09-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"
}
}
})
}
Valeurs de propriétés
mobileNetworks/services
Nom | Description | Valeur |
---|---|---|
type | Type de ressource | « Microsoft.MobileNetwork/mobileNetworks/services@2023-09-01 » |
name | Nom de la ressource | string (obligatoire) Limite de caractères : 1-64 Caractères valides : Caractères alphanumériques et traits d’union. Doit commencer par un caractère alphanumérique. Les mots suivants ne peuvent pas être utilisés seuls comme nom : default , requested , service . |
location | Emplacement géographique où réside la ressource | string (obligatoire) |
parent_id | ID de la ressource qui est le parent de cette ressource. | ID de ressource de type : mobileNetworks |
tags | Balises de ressource. | Dictionnaire de noms et de valeurs d’étiquettes. |
properties | Propriétés du service. | ServicePropertiesFormat (obligatoire) |
ServicePropertiesFormat
Nom | Description | Valeur |
---|---|---|
pccRules | Ensemble de règles de stratégie de flux de données qui composent ce service. | PccRuleConfiguration[] (obligatoire) Contraintes : Longueur minimale = 1 |
servicePrecedence | Valeur de précédence utilisée pour choisir entre les services lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi tous les services configurés dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
serviceQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à ce service. Cela peut être remplacé pour des flux particuliers à l’aide du champ ruleQosPolicy dans un PccRuleConfiguration. Si ce champ est null, la stratégie SIM de l’ue définit les paramètres QoS. | QosPolicy |
PccRuleConfiguration
Nom | Description | Valeur |
---|---|---|
ruleName | nom de la règle. Cela doit être unique au sein du service parent. Vous ne devez utiliser aucune des chaînes réservées suivantes : default , requested ou service . |
string (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Valeur de précédence utilisée pour choisir entre les règles de stratégie de flux de données lors de l’identification des valeurs QoS à utiliser pour une carte SIM particulière. Une valeur inférieure indique une priorité plus élevée. Cette valeur doit être unique parmi toutes les règles de stratégie de flux de données configurées dans le réseau mobile. | int (obligatoire) Contraintes : Valeur minimale = 0 Valeur maximale = 255 |
ruleQosPolicy | Stratégie QoS à utiliser pour les paquets correspondant à cette règle. Si ce champ a la valeur Null, le service parent définit les paramètres QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | Ensemble de modèles de flux de données à utiliser pour cette règle de stratégie de flux de données. | ServiceDataFlowTemplate[] (obligatoire) Contraintes : Longueur minimale = 1 Longueur maximale = 15 |
trafficControl | Détermine si les flux qui correspondent à cette règle de stratégie de flux de données sont autorisés. | « Bloqué » « Activé » |
PccRuleQosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez 3GPP TS23.501 section 5.7.2.1 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau de priorité d’allocation et de rétention de flux QoS (ARP). Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
guaranteedBitRate | Débit binaire garanti (GBR) pour tous les flux de données de service qui utilisent cette règle de stratégie de flux de données. Ce paramètre est facultatif. Si vous ne fournissez pas de valeur, il n’y aura pas de paramètre GBR défini pour la règle de stratégie de flux de données qui utilise cette définition qoS. | Ambr |
maximumBitRate | Débit binaire maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
preemptionCapability | Fonctionnalité de préemption de flux QoS. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | « MayPreempt » « NotPreempt » |
preemptionVulnerability | Vulnérabilité de préemption de flux QoS. La vulnérabilité de préemption d’un flux QoS détermine s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | « NotPreemptable » « Préemptable » |
Ambr
Nom | Description | Valeur |
---|---|---|
Descendante | Débit de liaison descendante. | string (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Liaison montante | Débit de liaison montante. | string (obligatoire) Contraintes : Modèle = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nom | Description | Valeur |
---|---|---|
direction | Sens de ce flux. | « Bidirectionnel » « Lien vers le bas » « Liaison montante » (obligatoire) |
ports | Port(s) auquel les E/S se connectent pour ce flux. Vous pouvez spécifier zéro ou plusieurs ports ou plages de ports. Si vous spécifiez un ou plusieurs ports ou plages de ports, vous devez spécifier une valeur autre que ip dans le protocol champ . Ce paramètre est facultatif. Si vous ne le spécifiez pas, les connexions sont autorisées sur tous les ports. Les plages de ports doivent être spécifiées comme {FirstPort}-{LastPort}. Par exemple : [8080 , 8082-8085 ]. |
string[] Contraintes : Modèle = ^([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]))?$ |
protocol | Liste des protocoles autorisés pour ce flux. Si vous souhaitez que ce flux puisse utiliser n’importe quel protocole dans la suite de protocoles Internet, utilisez la valeur ip . Si vous souhaitez uniquement autoriser une sélection de protocoles, vous devez utiliser le numéro de protocole Internet attribué IANA correspondant pour chaque protocole, comme décrit dans https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Par exemple, pour UDP, vous devez utiliser 17. Si vous utilisez la valeur ip , vous devez laisser le champ port non spécifié. |
string (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Chaque adresse IP distante à laquelle les UE se connecteront pour ce flux. Si vous souhaitez autoriser les connexions sur n’importe quelle adresse IP, utilisez la valeur any . Sinon, vous devez fournir chacune des adresses IP distantes auxquelles le cœur de paquets instance se connectera pour ce flux. Vous devez fournir chaque adresse IP en notation CIDR, y compris le masque réseau (par exemple, 192.0.2.54/24). |
string (obligatoire) Contraintes : Longueur minimale = 1 Modèle = ^(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 | Nom du modèle de flux de données. Cela doit être unique dans la règle de stratégie de flux de données parent. Vous ne devez utiliser aucune des chaînes réservées suivantes : default , requested ou service . |
string (obligatoire) Contraintes : Longueur maximale = 64 Modèle = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nom | Description | Valeur |
---|---|---|
5qi | Valeur de l’indicateur de flux QoS 5G. Le 5QI identifie un traitement de transfert QoS spécifique à fournir à un flux. Consultez 3GPP TS23.501 section 5.7.2.1 pour obtenir une description complète du paramètre 5QI et le tableau 5.7.4-1 pour la définition des valeurs 5QI. | int Contraintes : Valeur minimale = 1 Valeur maximale = 127 |
allocationAndRetentionPriorityLevel | Niveau de priorité d’allocation et de rétention de flux QoS (ARP). Les flux avec une priorité plus élevée préemptent les flux avec une priorité inférieure, si les paramètres de preemptionCapability et preemptionVulnerability l’autorisent. 1 est le niveau de priorité le plus élevé. Si ce champ n’est pas spécifié, 5qi est utilisé pour dériver la valeur ARP. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. |
int Contraintes : Valeur minimale = 1 Valeur maximale = 15 |
maximumBitRate | Débit binaire maximal (MBR) pour tous les flux de données de service qui utilisent cette règle ou ce service de stratégie de flux de données. | Ambr (obligatoire) |
preemptionCapability | Fonctionnalité de préemption de flux QoS. La capacité de préemption d’un flux QoS détermine si ce flux peut préempter un autre flux QoS ayant un niveau de priorité inférieur. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | « MayPreempt » « NotPreempt » |
preemptionVulnerability | Vulnérabilité de préemption de flux QoS. La vulnérabilité de préemption d’un flux QoS détermine s’il peut être préempté par un flux QoS avec un niveau de priorité plus élevé. Pour obtenir une description complète des paramètres ARP, consultez la section 5.7.2.2 de 3GPP TS23.501. | « NotPreemptable » « Préemptable » |