Microsoft.MobileNetwork mobileNetworks/services
Definição de recurso do Bicep
O tipo de recurso mobileNetworks/services pode ser implementado com operações que visam:
- Grupos de recursos – veja comandos de implementação de grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, veja registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o seguinte Bicep ao seu modelo.
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 propriedade
mobileNetworks/serviços
| Nome | Descrição | Valor |
|---|---|---|
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados no Bicep. |
cadeia (obrigatório) Limite de carateres: 1-64 Carateres válidos: Alfanuméricos e hífenes. Comece com alfanumérico. As seguintes palavras não podem ser utilizadas por si sós como o nome: default, , requestedservice. |
| localização | A localização geográfica onde o recurso se encontra | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| principal | No Bicep, pode especificar o recurso principal de um recurso subordinado. Só precisa de adicionar esta propriedade quando o recurso subordinado for declarado fora do recurso principal. Para obter mais informações, veja Recurso subordinado fora do recurso principal. |
Nome simbólico para recurso do tipo: mobileNetworks |
| propriedades | 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 este serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
| servicePrecedence | Um valor de precedência que é utilizado para decidir entre serviços ao identificar os valores QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a este serviço. Isto pode ser substituído por fluxos específicos com o campo ruleQosPolicy numa PccRuleConfiguration. Se este campo for nulo, a política sim da UE definirá as definições de QoS. | QosPolicy |
PccRuleConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ruleName | O nome da regra. Tem de ser exclusivo no serviço principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 que é utilizado para decidir entre regras de política de fluxo de dados ao identificar os valores QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a esta regra. Se este campo for nulo, o serviço principal definirá as definições de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a utilizar para esta 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 esta regra de política de fluxo de dados são permitidos. | "Bloqueado" "Ativado" |
PccRuleQosPolicy
| Nome | Descrição | Valor |
|---|---|---|
| 5qi | Valor do Indicador de Fluxo QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Consulte a secção 5.7.2.1 do TS23.501 do TS23.501 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição os valores 5QI. | int Restrições: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nível de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com prioridade mais alta impedem fluxos com prioridade mais baixa, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. |
int Restrições: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | A taxa de bits garantida (GBR) para todos os fluxos de dados de serviço que utilizam esta regra de política de fluxo de dados. Esta definição é opcional. Se não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que utiliza esta definição de QoS. | Ambr |
| maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que utilizam este serviço ou regra de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | 'MayPreempt' "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreempível" "Preemptable" |
Ambr
| Nome | Descrição | Valor |
|---|---|---|
| ligação para baixo | Taxa de bits de downlink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| uplink | Taxa de bits de uplink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nome | Descrição | Valor |
|---|---|---|
| direção | A direção deste fluxo. | 'Bidirecional' 'Downlink' "Uplink" (obrigatório) |
| ports | As portas às quais os UEs se ligarão para este fluxo. Pode especificar zero ou mais portas ou intervalos de portas. Se especificar uma ou mais portas ou intervalos de portas, tem de especificar um valor diferente ip do que está no protocol campo. Esta definição é opcional. Se não a especificar, as ligações serão permitidas em todas as portas. Os intervalos de portas têm de 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 este fluxo. Se quiser que este fluxo possa utilizar qualquer protocolo no conjunto de protocolos da Internet, utilize o valor ip. Se apenas quiser permitir uma seleção de protocolos, tem de utilizar o Número de Protocolo de Internet Atribuído da IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por exemplo, para UDP, tem de utilizar 17. Se utilizar o valor ip , tem de deixar o campo port não especificado. |
cadeia (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 ligarão a este fluxo. Se quiser permitir ligações em qualquer endereço IP, utilize o valor any. Caso contrário, tem de fornecer cada um dos endereços IP remotos aos quais a instância do núcleo do pacote irá ligar para este fluxo. Tem de fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24). |
cadeia (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 do modelo de fluxo de dados. Tem de ser exclusivo na regra de política de fluxo de dados principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Consulte a secção 5.7.2.1 do TS23.501 do TS23.501 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição os valores 5QI. | int Restrições: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nível de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com prioridade mais alta impedem fluxos com prioridade mais baixa, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do 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 utilizam este serviço ou regra de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | 'MayPreempt' "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreempível" "Preemptable" |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
Criar uma implementação completa do 5G Core |
Este modelo cria todos os recursos necessários para implementar um Private 5G Core, incluindo o aprovisionamento de sims e a criação da política de QoS de exemplo. Opcionalmente, pode ser implementado num cluster do Kubernetes em execução num dispositivo do Azure Stack Edge. |
| Criar uma política sim |
Este modelo cria uma política de serviço e sim para uma rede móvel existente. |
Definição de recurso do modelo arm
O tipo de recurso mobileNetworks/services pode ser implementado com operações direcionadas:
- Grupos de recursos – veja os comandos de implementação do grupo de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o seguinte JSON ao seu modelo.
{
"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 propriedade
mobileNetworks/serviços
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services" |
| apiVersion | A versão da API de recursos | '2024-02-01' |
| name | O nome do recurso Veja como definir nomes e tipos para recursos subordinados em modelos arm JSON. |
cadeia (obrigatório) Limite de carateres: 1-64 Carateres válidos: Alfanuméricos e hífenes. Comece com alfanumérico. As seguintes palavras não podem ser utilizadas por si só como o nome: default, requested, service. |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. Ver Etiquetas em modelos |
| propriedades | 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 este serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
| servicePrecedence | Um valor de precedência que é utilizado para decidir entre serviços ao identificar os valores QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a este serviço. Isto pode ser substituído para fluxos específicos com o campo ruleQosPolicy numa PccRuleConfiguration. Se este campo for nulo, a política SIM da UE definirá as definições de QoS. | QosPolicy |
PccRuleConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ruleName | O nome da regra. Tem de ser exclusivo no serviço principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 que é utilizado para decidir entre regras de política de fluxo de dados ao identificar os valores de QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a esta regra. Se este campo for nulo, o serviço principal definirá as definições de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a utilizar para esta 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 esta regra de política de fluxo de dados são permitidos. | "Bloqueado" "Ativado" |
PccRuleQosPolicy
| Nome | Descrição | Valor |
|---|---|---|
| 5qi | Valor do Indicador de Fluxo QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Consulte a secção 5.7.2.1 do TS23.501 do TS23.501 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição os valores 5QI. | int Restrições: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nível de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com prioridade mais alta impedem fluxos com prioridade mais baixa, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. |
int Restrições: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | A taxa de bits garantida (GBR) para todos os fluxos de dados de serviço que utilizam esta regra de política de fluxo de dados. Esta definição é opcional. Se não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que utiliza esta definição de QoS. | Ambr |
| maximumBitRate | A taxa de bits máxima (MBR) para todos os fluxos de dados de serviço que utilizam este serviço ou regra de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | 'MayPreempt' "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreempível" "Preemptable" |
Ambr
| Nome | Descrição | Valor |
|---|---|---|
| ligação para baixo | Taxa de bits de downlink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| uplink | Taxa de bits de uplink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nome | Descrição | Valor |
|---|---|---|
| direção | A direção deste fluxo. | 'Bidirecional' 'Downlink' "Uplink" (obrigatório) |
| ports | As portas às quais os UEs se ligarão para este fluxo. Pode especificar zero ou mais portas ou intervalos de portas. Se especificar uma ou mais portas ou intervalos de portas, tem de especificar um valor diferente ip do que está no protocol campo. Esta definição é opcional. Se não a especificar, as ligações serão permitidas em todas as portas. Os intervalos de portas têm de 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 este fluxo. Se quiser que este fluxo possa utilizar qualquer protocolo no conjunto de protocolos da Internet, utilize o valor ip. Se apenas quiser permitir uma seleção de protocolos, tem de utilizar o Número de Protocolo de Internet Atribuído da IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por exemplo, para UDP, tem de utilizar 17. Se utilizar o valor ip , tem de deixar o campo port não especificado. |
cadeia (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 ligarão a este fluxo. Se quiser permitir ligações em qualquer endereço IP, utilize o valor any. Caso contrário, tem de fornecer cada um dos endereços IP remotos aos quais a instância do núcleo do pacote irá ligar para este fluxo. Tem de fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24). |
cadeia (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 do modelo de fluxo de dados. Tem de ser exclusivo na regra de política de fluxo de dados principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Consulte a secção 5.7.2.1 do TS23.501 do TS23.501 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição os valores 5QI. | int Restrições: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nível de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com prioridade mais alta impedem fluxos com prioridade mais baixa, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do 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 utilizam este serviço ou regra de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | 'MayPreempt' "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreempível" "Preemptable" |
Modelos de início rápido
Os seguintes modelos de início rápido implementam este tipo de recurso.
| Modelo | Description |
|---|---|
| Criar uma implementação completa do 5G Core |
Este modelo cria todos os recursos necessários para implementar um Private 5G Core, incluindo o aprovisionamento de sims e a criação da política de QoS de exemplo. Opcionalmente, pode ser implementado num cluster do Kubernetes em execução num dispositivo do Azure Stack Edge. |
| Criar uma política sim |
Este modelo cria uma política de serviço e sim para uma rede móvel existente. |
Definição de recurso terraform (fornecedor AzAPI)
O tipo de recurso mobileNetworks/services pode ser implementado com operações direcionadas:
- Grupos de recursos
Para obter uma lista das propriedades alteradas em cada versão da API, veja Registo de alterações.
Formato do recurso
Para criar um recurso Microsoft.MobileNetwork/mobileNetworks/services, adicione o seguinte Terraform ao seu modelo.
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 propriedade
mobileNetworks/serviços
| Nome | Descrição | Valor |
|---|---|---|
| tipo | O tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services@2024-02-01" |
| name | O nome do recurso | cadeia (obrigatório) Limite de carateres: 1-64 Carateres válidos: Alfanuméricos e hífenes. Comece com alfanumérico. As seguintes palavras não podem ser utilizadas por si só como o nome: default, requested, service. |
| localização | A localização geográfica onde reside o recurso | cadeia (obrigatório) |
| parent_id | O ID do recurso que é o principal para este recurso. | ID do recurso do tipo: mobileNetworks |
| etiquetas | Etiquetas de recursos. | Dicionário de nomes e valores de etiquetas. |
| propriedades | 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 este serviço. | PccRuleConfiguration[] (obrigatório) Restrições: Comprimento mínimo = 1 |
| servicePrecedence | Um valor de precedência que é utilizado para decidir entre serviços ao identificar os valores QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a este serviço. Isto pode ser substituído para fluxos específicos com o campo ruleQosPolicy numa PccRuleConfiguration. Se este campo for nulo, a política SIM da UE definirá as definições de QoS. | QosPolicy |
PccRuleConfiguration
| Nome | Descrição | Valor |
|---|---|---|
| ruleName | O nome da regra. Tem de ser exclusivo no serviço principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 que é utilizado para decidir entre regras de política de fluxo de dados ao identificar os valores de QoS a utilizar para um DETERMINADO SIM. Um valor mais baixo significa uma prioridade mais alta. Este 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 QoS a utilizar para pacotes que correspondam a esta regra. Se este campo for nulo, o serviço principal definirá as definições de QoS. | PccRuleQosPolicy |
| serviceDataFlowTemplates | O conjunto de modelos de fluxo de dados a utilizar para esta 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 esta regra de política de fluxo de dados são permitidos. | "Bloqueado" "Ativado" |
PccRuleQosPolicy
| Nome | Descrição | Valor |
|---|---|---|
| 5qi | Valor do Indicador de Fluxo QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Consulte a secção 5.7.2.1 do TS23.501 do TS23.501 para obter uma descrição completa do parâmetro 5QI e a tabela 5.7.4-1 para a definição os valores 5QI. | int Restrições: Valor mínimo = 1 Valor máximo = 127 |
| allocationAndRetentionPriorityLevel | Nível de prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com prioridade mais alta impedem fluxos com prioridade mais baixa, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. |
int Restrições: Valor mínimo = 1 Valor máximo = 15 |
| guaranteedBitRate | A taxa de bits garantida (GBR) para todos os fluxos de dados de serviço que utilizam esta regra de política de fluxo de dados. Esta definição é opcional. Se não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que utiliza esta definição de QoS. | Ambr |
| maximumBitRate | A taxa máxima de bits (MBR) para todos os fluxos de dados de serviço que utilizam esta regra ou serviço de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade inferior. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Veja 3GPP TS23.501 secção 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreemptável" "Preemptable" |
Ambr
| Nome | Descrição | Valor |
|---|---|---|
| downlink | Taxa de bits de downlink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
| uplink | Taxa de bits de uplink. | cadeia (obrigatório) Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
ServiceDataFlowTemplate
| Nome | Descrição | Valor |
|---|---|---|
| direção | A direção deste fluxo. | "Bidirecional" "Downlink" "Uplink" (obrigatório) |
| ports | As portas às quais os UEs se ligarão para este fluxo. Pode especificar zero ou mais portas ou intervalos de portas. Se especificar uma ou mais portas ou intervalos de portas, tem de especificar um valor diferente ip do no protocol campo. Esta definição é opcional. Se não o especificar, as ligações serão permitidas em todas as portas. Os intervalos de portas têm de ser especificados como {FirstPort}-{LastPort}. Por exemplo: [8080, 8082-8085]. |
cadeia[] 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 este fluxo. Se quiser que este fluxo possa utilizar qualquer protocolo no conjunto de protocolos da Internet, utilize o valor ip. Se apenas quiser permitir uma seleção de protocolos, tem de utilizar o Número de Protocolo de Internet Atribuído da IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por exemplo, para UDP, tem de utilizar 17. Se utilizar o valor ip , tem de deixar o campo port não especificado. |
cadeia (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 | O endereço IP remoto ao qual os UEs se ligarão para este fluxo. Se quiser permitir ligações em qualquer endereço IP, utilize o valor any. Caso contrário, tem de fornecer cada um dos endereços IP remotos aos quais a instância do núcleo do pacote se ligará para este fluxo. Tem de fornecer cada endereço IP na notação CIDR, incluindo o netmask (por exemplo, 192.0.2.54/24). |
cadeia (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 do modelo de fluxo de dados. Isto tem de ser exclusivo na regra de política de fluxo de dados principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice. |
cadeia (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 QoS de 5G. O 5QI identifica um tratamento de reencaminhamento QoS específico a ser fornecido a um fluxo. Veja 3GPP TS23.501 secção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e a 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 prioridade de alocação e retenção do Fluxo QoS (ARP). Os fluxos com maior prioridade preempõem fluxos com prioridade inferior, se as definições de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível de prioridade mais elevado. Se este campo não for especificado, 5qi será utilizado para derivar o valor ARP. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do 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 utilizam este serviço ou regra de política de fluxo de dados. | Ambr (obrigatório) |
| preemptionCapability | Capacidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se pode antecipar outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "MayPreempt" "NotPreempt" |
| preemptionVulnerability | Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se pode ser preempida por um Fluxo de QoS com um nível de prioridade mais elevado. Consulte a secção 3GPP TS23.501 5.7.2.2 para obter uma descrição completa dos parâmetros do ARP. | "NãoPreempível" "Preemptable" |
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários