Microsoft.MobileNetwork mobileRedes/serviços
Definição de recursos do bíceps
O tipo de recurso mobileNetworks/services pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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-04-01' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
pccRules: [
{
ruleName: 'string'
rulePrecedence: int
ruleQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
guaranteedBitRate: {
downlink: 'string'
uplink: 'string'
}
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
serviceDataFlowTemplates: [
{
direction: 'string'
ports: [
'string'
]
protocol: [
'string'
]
remoteIpList: [
'string'
]
templateName: 'string'
}
]
trafficControl: 'string'
}
]
servicePrecedence: int
serviceQosPolicy: {
5qi: int
allocationAndRetentionPriorityLevel: int
maximumBitRate: {
downlink: 'string'
uplink: 'string'
}
preemptionCapability: 'string'
preemptionVulnerability: 'string'
}
}
tags: {
{customized property}: 'string'
}
}
Valores de propriedade
Âmbar
Designação | Descrição | Valor |
---|---|---|
ligação descendente | Taxa de bits de downlink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
ligação ascendente | Taxa de bits de uplink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
Microsoft.MobileNetwork/mobileNetworks/serviços
Designação | Descrição | Valor |
---|---|---|
Localização | A geolocalização onde o recurso vive | string (obrigatório) |
Designação | O nome do recurso | string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
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 recurso do tipo: mobileNetworks |
propriedades | Propriedades do serviço. | ServicePropertiesFormat (obrigatório) |
Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
PccRuleConfiguration
Designação | 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
rulePrecedence | Um valor de precedência que é 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 elevada. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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) |
Controlo de tráfego | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | 'Bloqueado' 'Habilitado' |
PccRuleQosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. |
Int Restrições: Valor mínimo = 1 Valor máximo = 15 |
garantidoBitRate | A taxa de bits garantida (GBR) 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 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
QosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
ServiceDataFlowTemplate
Designação | Descrição | Valor |
---|---|---|
Direção | A direção desse fluxo. | 'Bidirecional' 'Ligação descendente' 'Uplink' (obrigatório) |
portos | A(s) porta(s) à qual as 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 campo protocol . 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 do(s) protocolo(s) permitido(s) para este fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos de internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, você deve 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 então você deve deixar o campo port não especificado. |
string Restrições: Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$ [] (obrigatório) |
remoteIpList | O(s) endereço(s) IP(s) remoto(s) ao(s) qual(is) os UEs se conectarão para esse 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 principal do pacote 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). |
string Restrições: 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])))$ [] (obrigatório) |
nome_modelo | O nome do modelo 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
ServicePropertiesFormat
Designação | Descrição | Valor |
---|---|---|
pccRegras | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) |
servicePrecedence | Um valor de precedência que é usado para decidir entre serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais elevada. Este valor deve ser único entre todos os serviços configurados na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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 este campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
TrackedResourceTags
Designação | Descrição | Valor |
---|
Exemplos de início rápido
Os exemplos de início rápido a seguir implantam esse tipo de recurso.
Arquivo Bicep | Descrição |
---|---|
Crie um completo de implantação do 5G Core | Este modelo cria todos os recursos necessários para implantar um Private 5G Core, incluindo o provisionamento de sims e a criação de exemplos de política de QoS. Opcionalmente, ele pode ser implantado em um cluster Kubernetes em execução em um dispositivo Azure Stack Edge. |
Criar uma política de SIM | Este modelo cria uma política de serviço e sim para uma rede móvel existente. |
Definição de recurso de modelo ARM
O tipo de recurso mobileNetworks/services pode ser implantado com operações que visam:
- Grupos de recursos - Consulte comandos de implantação de grupo de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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-04-01",
"name": "string",
"location": "string",
"properties": {
"pccRules": [
{
"ruleName": "string",
"rulePrecedence": "int",
"ruleQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"guaranteedBitRate": {
"downlink": "string",
"uplink": "string"
},
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
},
"serviceDataFlowTemplates": [
{
"direction": "string",
"ports": [ "string" ],
"protocol": [ "string" ],
"remoteIpList": [ "string" ],
"templateName": "string"
}
],
"trafficControl": "string"
}
],
"servicePrecedence": "int",
"serviceQosPolicy": {
"5qi": "int",
"allocationAndRetentionPriorityLevel": "int",
"maximumBitRate": {
"downlink": "string",
"uplink": "string"
},
"preemptionCapability": "string",
"preemptionVulnerability": "string"
}
},
"tags": {
"{customized property}": "string"
}
}
Valores de propriedade
Âmbar
Designação | Descrição | Valor |
---|---|---|
ligação descendente | Taxa de bits de downlink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
ligação ascendente | Taxa de bits de uplink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
Microsoft.MobileNetwork/mobileNetworks/serviços
Designação | Descrição | Valor |
---|---|---|
apiVersion | A versão api | '2024-04-01' |
Localização | A geolocalização onde o recurso vive | string (obrigatório) |
Designação | O nome do recurso | string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
propriedades | Propriedades do serviço. | ServicePropertiesFormat (obrigatório) |
Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. Consulte Tags em modelos |
tipo | O tipo de recurso | 'Microsoft.MobileNetwork/mobileNetworks/services' |
PccRuleConfiguration
Designação | 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
rulePrecedence | Um valor de precedência que é 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 elevada. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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) |
Controlo de tráfego | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | 'Bloqueado' 'Habilitado' |
PccRuleQosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. |
Int Restrições: Valor mínimo = 1 Valor máximo = 15 |
garantidoBitRate | A taxa de bits garantida (GBR) 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 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
QosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
ServiceDataFlowTemplate
Designação | Descrição | Valor |
---|---|---|
Direção | A direção desse fluxo. | 'Bidirecional' 'Ligação descendente' 'Uplink' (obrigatório) |
portos | A(s) porta(s) à qual as 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 campo protocol . 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 do(s) protocolo(s) permitido(s) para este fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos de internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, você deve 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 então você deve deixar o campo port não especificado. |
string Restrições: Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$ [] (obrigatório) |
remoteIpList | O(s) endereço(s) IP(s) remoto(s) ao(s) qual(is) os UEs se conectarão para esse 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 principal do pacote 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). |
string Restrições: 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])))$ [] (obrigatório) |
nome_modelo | O nome do modelo 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
ServicePropertiesFormat
Designação | Descrição | Valor |
---|---|---|
pccRegras | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) |
servicePrecedence | Um valor de precedência que é usado para decidir entre serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais elevada. Este valor deve ser único entre todos os serviços configurados na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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 este campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
TrackedResourceTags
Designação | Descrição | Valor |
---|
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Modelo | Descrição |
---|---|
Crie um completo de implantação do 5G Core |
Este modelo cria todos os recursos necessários para implantar um Private 5G Core, incluindo o provisionamento de sims e a criação de exemplos de política de QoS. Opcionalmente, ele pode ser implantado em um cluster Kubernetes em execução em um dispositivo Azure Stack Edge. |
Criar uma política de SIM |
Este modelo cria uma política de serviço e sim para uma rede móvel existente. |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso mobileNetworks/services pode ser implantado com operações que visam:
- Grupos de recursos
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log 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-04-01"
name = "string"
location = "string"
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
pccRules = [
{
ruleName = "string"
rulePrecedence = int
ruleQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
guaranteedBitRate = {
downlink = "string"
uplink = "string"
}
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
serviceDataFlowTemplates = [
{
direction = "string"
ports = [
"string"
]
protocol = [
"string"
]
remoteIpList = [
"string"
]
templateName = "string"
}
]
trafficControl = "string"
}
]
servicePrecedence = int
serviceQosPolicy = {
5qi = int
allocationAndRetentionPriorityLevel = int
maximumBitRate = {
downlink = "string"
uplink = "string"
}
preemptionCapability = "string"
preemptionVulnerability = "string"
}
}
})
}
Valores de propriedade
Âmbar
Designação | Descrição | Valor |
---|---|---|
ligação descendente | Taxa de bits de downlink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
ligação ascendente | Taxa de bits de uplink. | string Restrições: Padrão = ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ (obrigatório) |
Microsoft.MobileNetwork/mobileNetworks/serviços
Designação | Descrição | Valor |
---|---|---|
Localização | A geolocalização onde o recurso vive | string (obrigatório) |
Designação | O nome do recurso | string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
parent_id | A ID do recurso que é o pai para este recurso. | ID do recurso do tipo: mobileNetworks |
propriedades | Propriedades do serviço. | ServicePropertiesFormat (obrigatório) |
Etiquetas | Tags de recursos | Dicionário de nomes e valores de tags. |
tipo | O tipo de recurso | "Microsoft.MobileNetwork/mobileNetworks/services@2024-04-01" |
PccRuleConfiguration
Designação | 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
rulePrecedence | Um valor de precedência que é 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 elevada. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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) |
Controlo de tráfego | Determina se os fluxos que correspondem a essa regra de política de fluxo de dados são permitidos. | 'Bloqueado' 'Habilitado' |
PccRuleQosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. |
Int Restrições: Valor mínimo = 1 Valor máximo = 15 |
garantidoBitRate | A taxa de bits garantida (GBR) 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 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
QosPolicy
Designação | Descrição | Valor |
---|---|---|
5QI | Valor do indicador de fluxo QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Ver 3GPP TS23.501 secção 5.7.2.1 para uma descrição completa do parâmetro 5QI e quadro 5.7.4-1 para a definição dos valores 5QI. | Int Restrições: Valor mínimo = 1 Valor máximo = 127 |
alocaçãoAndRetençãoNível de Prioridade | Alocação de fluxo de QoS e nível de prioridade de retenção (ARP). Fluxos com prioridade mais alta antecipam fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais elevado de prioridade. Se este campo não for especificado, então 5qi é usado para derivar o valor ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para 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) |
preempçãoCapacidade | Capacidade de preempção de fluxo de QoS. A capacidade de preempção de um fluxo de QoS controla se ele pode antecipar outro fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'MayPreempt' 'NotPreempt' |
preemptionVulnerabilidade | Vulnerabilidade de preempção de fluxo de QoS. A vulnerabilidade de preempção de um fluxo de QoS controla se ele pode ser antecipado por um fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para uma descrição completa dos parâmetros ARP. | 'Nãopreemptable' 'Preemptable' |
ServiceDataFlowTemplate
Designação | Descrição | Valor |
---|---|---|
Direção | A direção desse fluxo. | 'Bidirecional' 'Ligação descendente' 'Uplink' (obrigatório) |
portos | A(s) porta(s) à qual as 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 campo protocol . 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 do(s) protocolo(s) permitido(s) para este fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos de internet, use o valor ip . Se você quiser permitir apenas uma seleção de protocolos, você deve 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 então você deve deixar o campo port não especificado. |
string Restrições: Padrão = ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$ [] (obrigatório) |
remoteIpList | O(s) endereço(s) IP(s) remoto(s) ao(s) qual(is) os UEs se conectarão para esse 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 principal do pacote 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). |
string Restrições: 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])))$ [] (obrigatório) |
nome_modelo | O nome do modelo 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 , requested ou service . |
string Restrições: Comprimento máximo = Padrão = ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ (obrigatório) |
ServicePropertiesFormat
Designação | Descrição | Valor |
---|---|---|
pccRegras | O conjunto de regras de política de fluxo de dados que compõem esse serviço. | PccRuleConfiguration[] (obrigatório) |
servicePrecedence | Um valor de precedência que é usado para decidir entre serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais elevada. Este valor deve ser único entre todos os serviços configurados na rede móvel. | Int Restrições: Valor mínimo = 0 Valor máximo = 255 (obrigatório) |
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 este campo for nulo, a política SIM da UE definirá as configurações de QoS. | QosPolicy |
TrackedResourceTags
Designação | Descrição | Valor |
---|