Microsoft.MobileNetwork mobileNetworks/services 2023-06-01

Artigo
03/15/2024

Definição de recurso do Bicep

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 Bicep ao seu 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/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ó 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
principal	No Bicep, pode especificar o recurso principal de um recurso subordinado. Só tem 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 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 – `default`ou `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 – `default`ou `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": "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/serviços

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 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 – `default`ou `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 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 – `default`ou `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. Veja 3GPP TS23.501 secção 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 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"

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 Núcleo 5G Privado, incluindo o aprovisionamento de sims e a criação de uma política 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 Terraform (fornecedor AzAPI)

O tipo de recurso mobileNetworks/services pode ser implementado com operações que visam:

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 Terraform 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/serviços

Nome	Descrição	Valor
tipo	O tipo de recurso	"Microsoft.MobileNetwork/mobileNetworks/services@2023-06-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 – `default`ou `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 – `default`ou `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. Veja 3GPP TS23.501 secção 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 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"

Partilhar via

Microsoft.MobileNetwork mobileNetworks/services 2023-06-01

Definição de recurso do Bicep

Formato do recurso

Valores de propriedade

mobileNetworks/serviços

ServicePropertiesFormat

PccRuleConfiguration

PccRuleQosPolicy

Ambr

ServiceDataFlowTemplate

QosPolicy

Modelos de início rápido

Definição de recurso do modelo arm

Formato do recurso

Valores de propriedade

mobileNetworks/serviços

ServicePropertiesFormat

PccRuleConfiguration

PccRuleQosPolicy

Ambr

ServiceDataFlowTemplate

QosPolicy

Modelos de início rápido

Definição de recurso do Terraform (fornecedor AzAPI)

Formato do recurso

Valores de propriedade

mobileNetworks/serviços

ServicePropertiesFormat

PccRuleConfiguration

PccRuleQosPolicy

Ambr

ServiceDataFlowTemplate

QosPolicy

Comentários

Recursos adicionais