Microsoft.MobileNetwork mobileNetworks/services
Definición de recursos de Bicep
El tipo de recurso mobileNetworks/services se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.MobileNetwork/mobileNetworks/services, agregue el siguiente bicep a la plantilla.
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'
}
}
}
Valores de propiedad
mobileNetworks/services
| Nombre | Descripción | Value |
|---|---|---|
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en Bicep. |
string (obligatorio) Límite de caracteres: 1-64 Caracteres válidos: Caracteres alfanuméricos y guiones. Comience con un carácter alfanumérico. Las palabras siguientes no se pueden usar por sí mismas como nombre: default, requested, service. |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| primario | En Bicep, puede especificar el recurso primario para un recurso secundario. Solo tiene que agregar esta propiedad cuando el recurso secundario se declara fuera del recurso primario. Para más información, consulte Recurso secundario fuera del recurso primario. |
Nombre simbólico del recurso de tipo: mobileNetworks |
| properties | Propiedades del servicio. | ServicePropertiesFormat (obligatorio) |
ServicePropertiesFormat
| Nombre | Descripción | Valor |
|---|---|---|
| pccRules | Conjunto de reglas de directiva de flujo de datos que componen este servicio. | PccRuleConfiguration[] (obligatorio) Restricciones: Longitud mínima = 1 |
| servicePrecedence | Valor de precedencia que se usa para decidir entre servicios al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todos los servicios configurados en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| serviceQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con este servicio. Esto se puede invalidar para flujos concretos mediante el campo ruleQosPolicy en una PccRuleConfiguration. Si este campo es null, la directiva sim de la UE definirá la configuración de QoS. | QosPolicy |
PccRuleConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| ruleName | Nombre de la regla. Debe ser único dentro del servicio primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Valor de precedencia que se usa para decidir entre las reglas de directiva de flujo de datos al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todas las reglas de directiva de flujo de datos configuradas en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| ruleQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con esta regla. Si este campo es null, el servicio primario definirá la configuración de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Conjunto de plantillas de flujo de datos que se van a usar para esta regla de directiva de flujo de datos. | ServiceDataFlowTemplate[] (obligatorio) Restricciones: Longitud mínima = 1 Longitud máxima = 15 |
| trafficControl | Determina si se permiten flujos que coincidan con esta regla de directiva de flujo de datos. | "Bloqueado" 'Habilitado' |
PccRuleQosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento de reenvío de QoS específico que se proporcionará a un flujo. Consulte 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un adelantamiento de prioridad más alto con menor prioridad, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel más alto de prioridad. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | Velocidad de bits garantizada (GBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos. Se trata de un parámetro opcional. Si no proporciona un valor, no habrá ningún conjunto de GBR para la regla de directiva de flujo de datos que use esta definición de QoS. | Ambr |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'NotPreemptable' 'Preemptable' |
Ambr
| Nombre | Descripción | Valor |
|---|---|---|
| Enlace descendente | Velocidad de bits de vínculo descendente. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Velocidad de bits de vínculo superior. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nombre | Descripción | Valor |
|---|---|---|
| direction | Dirección de este flujo. | 'Bidireccional' 'Vínculo hacia abajo' 'Vínculo superior' (obligatorio) |
| ports | Los puertos a los que se conectarán los ESTADOS para este flujo. Puede especificar cero o más puertos o intervalos de puertos. Si especifica uno o varios puertos o intervalos de puertos, debe especificar un valor distinto ip de en el protocol campo . Se trata de un parámetro opcional. Si no lo especifica, se permitirán conexiones en todos los puertos. Los intervalos de puertos deben especificarse como {FirstPort}-{LastPort}. Por ejemplo: [8080, 8082-8085]. |
string[] Restricciones: Patrón = ^([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 | Lista de los protocolos permitidos para este flujo. Si desea que este flujo pueda usar cualquier protocolo dentro del conjunto de protocolos de Internet, use el valor ip. Si solo desea permitir una selección de protocolos, debe usar el número de protocolo asignado de Internet de IANA correspondiente para cada protocolo, como se describe en https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por ejemplo, para UDP, debe usar 17. Si usa el valor ip , debe dejar el campo port sin especificar. |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Direcciones IP remotas a las que se conectarán los UE para este flujo. Si desea permitir conexiones en cualquier dirección IP, use el valor any. De lo contrario, debe proporcionar cada una de las direcciones IP remotas a las que se conectará la instancia de núcleo del paquete para este flujo. Debe proporcionar cada dirección IP en notación CIDR, incluida la máscara de red (por ejemplo, 192.0.2.54/24). |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(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 | Nombre de la plantilla de flujo de datos. Debe ser único dentro de la regla de directiva de flujo de datos primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento de reenvío de QoS específico que se proporcionará a un flujo. Consulte 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un adelantamiento de prioridad más alto con menor prioridad, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel más alto de prioridad. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'NotPreemptable' 'Preemptable' |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
Creación de una implementación completa de 5G Core |
Esta plantilla crea todos los recursos necesarios para implementar un núcleo 5G privado, incluidos los sims de aprovisionamiento y la creación de una directiva de QoS de ejemplo. Opcionalmente, se puede implementar en un clúster de Kubernetes que se ejecuta en un dispositivo Azure Stack Edge. |
| Creación de una directiva sim |
Esta plantilla crea una directiva de servicio y sim para una red móvil existente. |
Definición de recursos de plantilla de ARM
El tipo de recurso mobileNetworks/services se puede implementar con operaciones destinadas a:
- Grupos de recursos: consulte los comandos de implementación del grupo de recursos.
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.MobileNetwork/mobileNetworks/services, agregue el siguiente JSON a la plantilla.
{
"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"
}
}
}
Valores de propiedad
mobileNetworks/services
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services" |
| apiVersion | La versión de la API de recursos | '2024-02-01' |
| name | El nombre del recurso Vea cómo establecer nombres y tipos para recursos secundarios en plantillas de ARM JSON. |
string (obligatorio) Límite de caracteres: 1-64 Caracteres válidos: Caracteres alfanuméricos y guiones. Comience con un carácter alfanumérico. Las palabras siguientes no se pueden usar por sí mismas como nombre: default, requested, service. |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. Consulte Etiquetas en plantillas. |
| properties | Propiedades del servicio. | ServicePropertiesFormat (obligatorio) |
ServicePropertiesFormat
| Nombre | Descripción | Valor |
|---|---|---|
| pccRules | Conjunto de reglas de directiva de flujo de datos que componen este servicio. | PccRuleConfiguration[] (obligatorio) Restricciones: Longitud mínima = 1 |
| servicePrecedence | Valor de precedencia que se usa para decidir entre servicios al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todos los servicios configurados en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| serviceQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con este servicio. Esto se puede invalidar para flujos concretos mediante el campo ruleQosPolicy en una PccRuleConfiguration. Si este campo es null, la directiva sim de la UE definirá la configuración de QoS. | QosPolicy |
PccRuleConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| ruleName | Nombre de la regla. Debe ser único dentro del servicio primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Valor de precedencia que se usa para decidir entre reglas de directiva de flujo de datos al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todas las reglas de directiva de flujo de datos configuradas en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| ruleQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con esta regla. Si este campo es null, el servicio primario definirá la configuración de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Conjunto de plantillas de flujo de datos que se van a usar para esta regla de directiva de flujo de datos. | ServiceDataFlowTemplate[] (obligatorio) Restricciones: Longitud mínima = 1 Longitud máxima = 15 |
| trafficControl | Determina si se permiten flujos que coincidan con esta regla de directiva de flujo de datos. | "Bloqueado" 'Habilitado' |
PccRuleQosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento específico de reenvío de QoS que se va a proporcionar a un flujo. Vea 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores de 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un preempt de prioridad más alta con prioridad más baja, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel de prioridad más alto. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | Velocidad de bits garantizada (GBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos. Se trata de un parámetro opcional. Si no proporciona un valor, no habrá ningún GBR establecido para la regla de directiva de flujo de datos que use esta definición de QoS. | Ambr |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si puede ser adelantada por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'NotPreemptable' 'Preemptable' |
Ambr
| Nombre | Descripción | Valor |
|---|---|---|
| Enlace descendente | Velocidad de bits de vínculo descendente. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Velocidad de bits de vínculo superior. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nombre | Descripción | Valor |
|---|---|---|
| direction | Dirección de este flujo. | "Bidireccional" "Vínculo descendente" 'Vínculo superior' (obligatorio) |
| ports | Los puertos a los que se conectarán los UE para este flujo. Puede especificar cero o más puertos o intervalos de puertos. Si especifica uno o varios puertos o intervalos de puertos, debe especificar un valor que no ip sea en el protocol campo . Se trata de un parámetro opcional. Si no lo especifica, se permitirán las conexiones en todos los puertos. Los intervalos de puertos se deben especificar como {FirstPort}-{LastPort}. Por ejemplo: [8080, 8082-8085]. |
string[] Restricciones: Patrón = ^([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 | Lista de los protocolos permitidos para este flujo. Si desea que este flujo pueda usar cualquier protocolo dentro del conjunto de protocolos de Internet, use el valor ip. Si solo desea permitir una selección de protocolos, debe usar el número de protocolo de Internet asignado de IANA correspondiente para cada protocolo, como se describe en https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por ejemplo, para UDP, debe usar 17. Si usa el valor ip , debe dejar el campo port sin especificar. |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Direcciones IP remotas a las que se conectarán los UE para este flujo. Si desea permitir conexiones en cualquier dirección IP, use el valor any. De lo contrario, debe proporcionar cada una de las direcciones IP remotas a las que se conectará la instancia de núcleo del paquete para este flujo. Debe proporcionar cada dirección IP en la notación CIDR, incluida la máscara de red (por ejemplo, 192.0.2.54/24). |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(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 | Nombre de la plantilla de flujo de datos. Debe ser único dentro de la regla de directiva de flujo de datos principal. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento específico de reenvío de QoS que se va a proporcionar a un flujo. Vea 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores de 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un preempt de prioridad más alta con prioridad más baja, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel de prioridad más alto. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'MayPreempt' 'NotPreempt' |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si puede ser adelantada por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | 'NotPreemptable' 'Preemptable' |
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
| Plantilla | Descripción |
|---|---|
| Creación de una implementación completa de 5G Core |
Esta plantilla crea todos los recursos necesarios para implementar un núcleo 5G privado, incluidos los sims de aprovisionamiento y la creación de una directiva de QoS de ejemplo. Opcionalmente, se puede implementar en un clúster de Kubernetes que se ejecuta en un dispositivo De Azure Stack Edge. |
| Creación de una directiva sim |
Esta plantilla crea un servicio y una directiva sim para una red móvil existente. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso mobileNetworks/services se puede implementar con operaciones destinadas a:
- Grupos de recursos
Para obtener una lista de las propiedades modificadas en cada versión de api, consulte registro de cambios.
Formato de los recursos
Para crear un recurso Microsoft.MobileNetwork/mobileNetworks/services, agregue el siguiente terraform a la plantilla.
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"
}
}
})
}
Valores de propiedad
mobileNetworks/services
| Nombre | Descripción | Value |
|---|---|---|
| type | Tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01" |
| name | El nombre del recurso | string (obligatorio) Límite de caracteres: 1-64 Caracteres válidos: Caracteres alfanuméricos y guiones. Comience con un carácter alfanumérico. Las palabras siguientes no se pueden usar por sí mismas como nombre: default, requested, service. |
| ubicación | Ubicación geográfica donde reside el recurso | string (obligatorio) |
| parent_id | Identificador del recurso que es el elemento primario de este recurso. | Identificador del recurso de tipo: mobileNetworks |
| etiquetas | Etiquetas del recurso. | Diccionario de nombres y valores de etiqueta. |
| properties | Propiedades del servicio. | ServicePropertiesFormat (obligatorio) |
ServicePropertiesFormat
| Nombre | Descripción | Valor |
|---|---|---|
| pccRules | Conjunto de reglas de directiva de flujo de datos que componen este servicio. | PccRuleConfiguration[] (obligatorio) Restricciones: Longitud mínima = 1 |
| servicePrecedence | Valor de precedencia que se usa para decidir entre servicios al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todos los servicios configurados en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| serviceQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con este servicio. Esto se puede invalidar para flujos concretos mediante el campo ruleQosPolicy en una PccRuleConfiguration. Si este campo es null, la directiva sim de la UE definirá la configuración de QoS. | QosPolicy |
PccRuleConfiguration
| Nombre | Descripción | Valor |
|---|---|---|
| ruleName | Nombre de la regla. Debe ser único dentro del servicio primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
| rulePrecedence | Valor de precedencia que se usa para decidir entre las reglas de directiva de flujo de datos al identificar los valores de QoS que se van a usar para una SIM determinada. Un valor más bajo representa una prioridad más alta. Este valor debe ser único entre todas las reglas de directiva de flujo de datos configuradas en la red móvil. | int (obligatorio) Restricciones: Valor mínimo = 0 Valor máximo = 255 |
| ruleQosPolicy | La directiva QoS que se va a usar para los paquetes que coinciden con esta regla. Si este campo es null, el servicio primario definirá la configuración de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | Conjunto de plantillas de flujo de datos que se van a usar para esta regla de directiva de flujo de datos. | ServiceDataFlowTemplate[] (obligatorio) Restricciones: Longitud mínima = 1 Longitud máxima = 15 |
| trafficControl | Determina si se permiten flujos que coincidan con esta regla de directiva de flujo de datos. | "Bloqueado" "Habilitado" |
PccRuleQosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento de reenvío de QoS específico que se proporcionará a un flujo. Consulte 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un adelantamiento de prioridad más alto con menor prioridad, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel más alto de prioridad. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | Velocidad de bits garantizada (GBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos. Se trata de un parámetro opcional. Si no proporciona un valor, no habrá ningún conjunto de GBR para la regla de directiva de flujo de datos que use esta definición de QoS. | Ambr |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | "NotPreemptable" "Preemptable" |
Ambr
| Nombre | Descripción | Valor |
|---|---|---|
| Enlace descendente | Velocidad de bits de vínculo descendente. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| Uplink | Velocidad de bits de vínculo superior. | string (obligatorio) Restricciones: Patrón = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nombre | Descripción | Valor |
|---|---|---|
| direction | Dirección de este flujo. | "Bidireccional" "Vínculo descendente" "Vínculo superior" (obligatorio) |
| ports | Los puertos a los que se conectarán los ESTADOS para este flujo. Puede especificar cero o más puertos o intervalos de puertos. Si especifica uno o varios puertos o intervalos de puertos, debe especificar un valor distinto ip de en el protocol campo . Se trata de un parámetro opcional. Si no lo especifica, se permitirán conexiones en todos los puertos. Los intervalos de puertos deben especificarse como {FirstPort}-{LastPort}. Por ejemplo: [8080, 8082-8085]. |
string[] Restricciones: Patrón = ^([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 | Lista de los protocolos permitidos para este flujo. Si desea que este flujo pueda usar cualquier protocolo dentro del conjunto de protocolos de Internet, use el valor ip. Si solo desea permitir una selección de protocolos, debe usar el número de protocolo asignado de Internet de IANA correspondiente para cada protocolo, como se describe en https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por ejemplo, para UDP, debe usar 17. Si usa el valor ip , debe dejar el campo port sin especificar. |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
| remoteIpList | Direcciones IP remotas a las que se conectarán los UE para este flujo. Si desea permitir conexiones en cualquier dirección IP, use el valor any. De lo contrario, debe proporcionar cada una de las direcciones IP remotas a las que se conectará la instancia de núcleo del paquete para este flujo. Debe proporcionar cada dirección IP en notación CIDR, incluida la máscara de red (por ejemplo, 192.0.2.54/24). |
string (obligatorio) Restricciones: Longitud mínima = 1 Patrón = ^(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 | Nombre de la plantilla de flujo de datos. Debe ser único dentro de la regla de directiva de flujo de datos primario. No debe usar ninguna de las siguientes cadenas reservadas: default, requested o service. |
string (obligatorio) Restricciones: Longitud máxima = 64 Patrón = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
| Nombre | Descripción | Valor |
|---|---|---|
| 5qi | Valor del indicador de flujo de QoS 5G. El 5QI identifica un tratamiento de reenvío de QoS específico que se proporcionará a un flujo. Consulte 3GPP TS23.501 sección 5.7.2.1 para obtener una descripción completa del parámetro 5QI y la tabla 5.7.4-1 para la definición de los valores 5QI. | int Restricciones: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nivel de prioridad de retención y asignación de flujo de QoS (ARP). Fluye con un adelantamiento de prioridad más alto con menor prioridad, si la configuración de preemptionCapability y preemptionVulnerability la permite. 1 es el nivel más alto de prioridad. Si no se especifica este campo, 5qi se usa para derivar el valor de ARP. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. |
int Restricciones: Valor mínimo = 1 Valor máximo = 15 |
| maximumBitRate | Velocidad de bits máxima (MBR) para todos los flujos de datos de servicio que usan esta regla de directiva de flujo de datos o servicio. | Ambr (obligatorio) |
| preemptionCapability | Funcionalidad de adelantamiento de QoS Flow. La funcionalidad de adelantamiento de un flujo de QoS controla si puede adelantar a otro flujo de QoS con un nivel de prioridad inferior. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Vulnerabilidad de adelantamiento de QoS Flow. La vulnerabilidad de adelantamiento de un flujo de QoS controla si un flujo de QoS puede ser reemplazado por un flujo de QoS con un nivel de prioridad más alto. Consulte la sección 5.7.2.2.2 de 3GPP TS23.501 para obtener una descripción completa de los parámetros de ARP. | "NotPreemptable" "Preemptable" |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de