Microsoft.MobileNetwork mobileNetworks/services 2023-06-01
Definição de recurso do Bicep
O tipo de recurso mobileNetworks/services pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o seguinte Bicep ao modelo.
resource symbolicname 'Microsoft.MobileNetwork/mobileNetworks/services@2023-06-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 propriedade
mobileNetworks/services
Nome | Descrição | Valor |
---|---|---|
name | O nome do recurso Veja como definir nomes e tipos para recursos filho no Bicep. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 64 Caracteres válidos: Caracteres alfanuméricos e hifens. Comece com caractere alfanumérico. As seguintes palavras não podem ser usadas sozinhas como o nome: default , requested , service . |
local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Consulte Marcas em modelos |
pai | No Bicep, você pode especificar o recurso pai para um recurso filho. Você só precisa adicionar essa propriedade quando o recurso filho é declarado fora do recurso pai. Para obter mais informações, consulte Recurso filho fora do recurso pai. |
Nome simbólico para o recurso do tipo: mobileNetworks |
properties | Propriedades do Serviço. | ServicePropertiesFormat (obrigatório) |
ServicePropertiesFormat
Nome | Descrição | Valor |
---|---|---|
pccRules | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
servicePrecedence | Um valor de precedência usado para decidir entre os serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todos os serviços configurados na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
serviceQosPolicy | A política de QoS a ser usada para pacotes correspondentes a esse serviço. Isso pode ser substituído para fluxos específicos usando o campo ruleQosPolicy em um PccRuleConfiguration. Se esse campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
PccRuleConfiguration
Nome | Descrição | Valor |
---|---|---|
ruleName | O nome da regra. Isso deve ser exclusivo dentro do serviço pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Um valor de precedência usado para decidir entre as regras de política de fluxo de dados ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
ruleQosPolicy | A política de QoS a ser usada para pacotes que correspondem a essa regra. Se esse campo for nulo, o serviço pai definirá as configurações de QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a serem usados para essa regra de política de fluxo de dados. | ServiceDataFlowTemplate[] (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 15 |
trafficControl | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | 'Bloqueado' 'Enabled' |
PccRuleQosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (alocação e prioridade de retenção) do Fluxo de QoS. Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
guaranteedBitRate | A GBR (taxa de bits) garantida para todos os fluxos de dados de serviço que usam essa regra de política de fluxo de dados. Esta é uma configuração opcional. Se você não fornecer um valor, não haverá nenhum GBR definido para a regra de política de fluxo de dados que usa essa definição de QoS. | Ambr |
maximumBitRate | A taxa máxima de bits (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'NotPreemptable' 'Preemptable' |
Ambr
Nome | Descrição | Valor |
---|---|---|
Downlink | Taxa de bits de downlink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Uplink | Taxa de bits de uplink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nome | Descrição | Valor |
---|---|---|
direction | A direção desse fluxo. | 'Bidirecional' 'Downlink' 'Uplink' (obrigatório) |
ports | As portas às quais os UEs se conectarão para esse fluxo. Você pode especificar zero ou mais portas ou intervalos de portas. Se você especificar uma ou mais portas ou intervalos de portas, deverá especificar um valor diferente de ip no protocol campo . Esta é uma configuração opcional. Se você não especificá-lo, as conexões serão permitidas em todas as portas. Os intervalos de portas devem ser especificados como {FirstPort}-{LastPort}. Por exemplo: [8080 , 8082-8085 ]. |
string[] Restrições: Padrão = ^([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]))?$ |
protocolo | Uma lista dos protocolos permitidos para esse fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos da Internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, deverá usar o número de protocolo de Internet atribuído IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Por exemplo, para UDP, você deve usar 17. Se você usar o valor ip , deverá deixar o campo port não especificado. |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Os endereços IP remotos aos quais os UEs se conectarão nesse fluxo. Se você quiser permitir conexões em qualquer endereço IP, use o valor any . Caso contrário, você deve fornecer cada um dos endereços IP remotos aos quais a instância do núcleo de pacotes se conectará para esse fluxo. Você deve fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24). |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(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 | O nome da tarefa de fluxo de dados. Isso deve ser exclusivo dentro da regra de política de fluxo de dados pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'NotPreemptable' 'Preemptable' |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Modelo | Descrição |
---|---|
Criar uma implantação completa do 5G Core |
Esse modelo cria todos os recursos necessários para implantar um Private 5G Core, incluindo o provisionamento de sims e a criação de uma política de QoS de exemplo. Opcionalmente, ele pode ser implantado em um cluster do Kubernetes em execução em um dispositivo do Azure Stack Edge. |
Criar uma política sim |
Este modelo cria um serviço e uma política sim para uma rede móvel existente. |
Definição de recurso de modelo do ARM
O tipo de recurso mobileNetworks/services pode ser implantado com operações direcionadas:
- Grupos de recursos – Consulte comandos de implantação do grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o JSON a seguir ao modelo.
{
"type": "Microsoft.MobileNetwork/mobileNetworks/services",
"apiVersion": "2023-06-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 propriedade
mobileNetworks/services
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | 'Microsoft.MobileNetwork/mobileNetworks/services' |
apiVersion | A versão da API de recursos | '2023-06-01' |
name | O nome do recurso Veja como definir nomes e tipos para recursos filho em modelos do ARM JSON. |
cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 64 Caracteres válidos: Caracteres alfanuméricos e hifens. Comece com caractere alfanumérico. As seguintes palavras não podem ser usadas sozinhas como o nome: default , requested , service . |
local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. Consulte Marcas em modelos |
properties | Propriedades do Serviço. | ServicePropertiesFormat (obrigatório) |
ServicePropertiesFormat
Nome | Descrição | Valor |
---|---|---|
pccRules | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
servicePrecedence | Um valor de precedência usado para decidir entre os serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todos os serviços configurados na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
serviceQosPolicy | A política de QoS a ser usada para pacotes correspondentes a esse serviço. Isso pode ser substituído para fluxos específicos usando o campo ruleQosPolicy em um PccRuleConfiguration. Se esse campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
PccRuleConfiguration
Nome | Descrição | Valor |
---|---|---|
ruleName | O nome da regra. Isso deve ser exclusivo dentro do serviço pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Um valor de precedência usado para decidir entre as regras de política de fluxo de dados ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
ruleQosPolicy | A política de QoS a ser usada para pacotes que correspondem a essa regra. Se esse campo for nulo, o serviço pai definirá as configurações de QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a serem usados para essa regra de política de fluxo de dados. | ServiceDataFlowTemplate[] (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 15 |
trafficControl | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | 'Bloqueado' 'Enabled' |
PccRuleQosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
guaranteedBitRate | A GBR (taxa de bits) garantida para todos os fluxos de dados de serviço que usam essa regra de política de fluxo de dados. Esta é uma configuração opcional. Se você não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que use essa definição de QoS. | Ambr |
maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'NotPreemptable' 'Preemptable' |
Ambr
Nome | Descrição | Valor |
---|---|---|
Downlink | Taxa de bits de downlink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Uplink | Taxa de bits de uplink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nome | Descrição | Valor |
---|---|---|
direction | A direção desse fluxo. | 'Bidirecional' 'Downlink' 'Uplink' (obrigatório) |
ports | As portas às quais os UEs se conectarão para esse fluxo. Você pode especificar zero ou mais portas ou intervalos de portas. Se você especificar uma ou mais portas ou intervalos de portas, deverá especificar um valor diferente de ip no protocol campo . Esta é uma configuração opcional. Se você não especificá-lo, as conexões serão permitidas em todas as portas. Os intervalos de portas devem ser especificados como {FirstPort}-{LastPort}. Por exemplo: [8080 , 8082-8085 ]. |
string[] Restrições: Padrão = ^([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]))?$ |
protocolo | Uma lista dos protocolos permitidos para esse fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos da Internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, deverá usar o número de protocolo de Internet atribuído IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Por exemplo, para UDP, você deve usar 17. Se você usar o valor ip , deverá deixar o campo port não especificado. |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Os endereços IP remotos aos quais os UEs se conectarão nesse fluxo. Se você quiser permitir conexões em qualquer endereço IP, use o valor any . Caso contrário, você deve fornecer cada um dos endereços IP remotos aos quais a instância do núcleo de pacotes se conectará para esse fluxo. Você deve fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24). |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(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 | O nome da tarefa de fluxo de dados. Isso deve ser exclusivo dentro da regra de política de fluxo de dados pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (alocação e prioridade de retenção) do Fluxo de QoS. Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
maximumBitRate | A taxa máxima de bits (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | 'NotPreemptable' 'Preemptable' |
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Modelo | Descrição |
---|---|
Criar uma implantação completa do 5G Core |
Esse modelo cria todos os recursos necessários para implantar um 5G Core Privado, incluindo o provisionamento de sims e a criação de uma política de QoS de exemplo. Opcionalmente, ele pode ser implantado em um cluster do Kubernetes em execução em um dispositivo do Azure Stack Edge. |
Criar uma política sim |
Esse modelo cria uma política de serviço e sim para uma rede móvel existente. |
Definição de recurso do Terraform (provedor de AzAPI)
O tipo de recurso mobileNetworks/services pode ser implantado com operações direcionadas:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, consulte log de alterações.
Formato de recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o Terraform a seguir ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.MobileNetwork/mobileNetworks/services@2023-06-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 propriedade
mobileNetworks/services
Nome | Descrição | Valor |
---|---|---|
tipo | O tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services@2023-06-01" |
name | O nome do recurso | cadeia de caracteres (obrigatório) Limite de caracteres: 1 a 64 Caracteres válidos: Caracteres alfanuméricos e hifens. Comece com caractere alfanumérico. As seguintes palavras não podem ser usadas sozinhas como o nome: default , requested , service . |
local | A localização geográfica em que o recurso reside | cadeia de caracteres (obrigatório) |
parent_id | A ID do recurso que é o pai desse recurso. | ID do recurso do tipo: mobileNetworks |
marcas | Marcas de recurso. | Dicionário de nomes e valores de marcas. |
properties | Propriedades do Serviço. | ServicePropertiesFormat (obrigatório) |
ServicePropertiesFormat
Nome | Descrição | Valor |
---|---|---|
pccRules | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
servicePrecedence | Um valor de precedência usado para decidir entre os serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todos os serviços configurados na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
serviceQosPolicy | A política de QoS a ser usada para pacotes correspondentes a esse serviço. Isso pode ser substituído para fluxos específicos usando o campo ruleQosPolicy em um PccRuleConfiguration. Se esse campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
PccRuleConfiguration
Nome | Descrição | Valor |
---|---|---|
ruleName | O nome da regra. Isso deve ser exclusivo dentro do serviço pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
rulePrecedence | Um valor de precedência usado para decidir entre as regras de política de fluxo de dados ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | int (obrigatório) Restrições: Valor mínimo = 0 Valor máximo = 255 |
ruleQosPolicy | A política de QoS a ser usada para pacotes que correspondem a essa regra. Se esse campo for nulo, o serviço pai definirá as configurações de QoS. | PccRuleQosPolicy |
serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a serem usados para essa regra de política de fluxo de dados. | ServiceDataFlowTemplate[] (obrigatório) Restrições: Comprimento mínimo = 1 Comprimento máximo = 15 |
trafficControl | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | "Bloqueado" "Habilitado" |
PccRuleQosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
guaranteedBitRate | A GBR (taxa de bits) garantida para todos os fluxos de dados de serviço que usam essa regra de política de fluxo de dados. Esta é uma configuração opcional. Se você não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que use essa definição de QoS. | Ambr |
maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | "MayPreempt" "NotPreempt" |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | "NotPreemptable" "Preemptable" |
Ambr
Nome | Descrição | Valor |
---|---|---|
Downlink | Taxa de bits de downlink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Uplink | Taxa de bits de uplink. | cadeia de caracteres (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
Nome | Descrição | Valor |
---|---|---|
direction | A direção desse fluxo. | "Bidirecional" "Downlink" "Uplink" (obrigatório) |
ports | As portas às quais os UEs se conectarão para esse fluxo. Você pode especificar zero ou mais portas ou intervalos de portas. Se você especificar uma ou mais portas ou intervalos de portas, deverá especificar um valor diferente do ip protocol campo . Esta é uma configuração opcional. Se você não especificá-lo, as conexões serão permitidas em todas as portas. Os intervalos de portas devem ser especificados como {FirstPort}-{LastPort}. Por exemplo: [8080 , 8082-8085 ]. |
string[] Restrições: Padrão = ^([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]))?$ |
protocolo | Uma lista dos protocolos permitidos para esse fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos da Internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, deverá usar o número de protocolo de Internet atribuído IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml . Por exemplo, para UDP, você deve usar 17. Se você usar o valor ip , deverá deixar o campo port não especificado. |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$"} |
remoteIpList | Os endereços IP remotos aos quais os UEs se conectarão nesse fluxo. Se você quiser permitir conexões em qualquer endereço IP, use o valor any . Caso contrário, você deve fornecer cada um dos endereços IP remotos aos quais a instância do núcleo de pacotes se conectará para esse fluxo. Você deve fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24). |
cadeia de caracteres (obrigatório) Restrições: Comprimento mínimo = 1 Padrão = ^(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 | O nome da tarefa de fluxo de dados. Isso deve ser exclusivo dentro da regra de política de fluxo de dados pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default ou requested service . |
cadeia de caracteres (obrigatório) Restrições: Comprimento máximo = 64 Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
QosPolicy
Nome | Descrição | Valor |
---|---|---|
5qi | Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI. | INT Restrições: Valor mínimo = 1 Valor máximo = 127 |
allocationAndRetentionPriorityLevel | Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. |
INT Restrições: Valor mínimo = 1 Valor máximo = 15 |
maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que usam essa regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
preemptionCapability | Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | "MayPreempt" "NotPreempt" |
preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP. | "NotPreemptable" "Preemptable" |