Partilhar via


Services - Create Or Update

Cria ou atualiza um serviço. Tem de ser criado na mesma localização que a respetiva rede móvel principal.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01

Parâmetros do URI

Name Em Necessário Tipo Description
mobileNetworkName
path True

string

O nome da rede móvel.

Padrão Regex: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

resourceGroupName
path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.

serviceName
path True

string

O nome do serviço. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice

Padrão Regex: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

O ID da subscrição de destino. O valor tem de ser um UUID.

api-version
query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

A localização geográfica onde reside o recurso

properties.pccRules True

PccRuleConfiguration[]

O conjunto de regras de política de fluxo de dados que compõem este serviço.

properties.servicePrecedence True

integer

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.

properties.serviceQosPolicy

QosPolicy

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.

tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

Service

Atualização bem-sucedida. A operação devolve o recurso de serviço resultante.

201 Created

Service

Create com êxito. A operação devolve o recurso de serviço resultante.

Other Status Codes

ErrorResponse

Resposta de erro que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create service

Pedido de amostra

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Resposta da amostra

{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Succeeded",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}
Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01
{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "systemData": {
    "createdBy": "user1",
    "createdByType": "User",
    "createdAt": "2020-01-01T17:18:19.1234567Z",
    "lastModifiedBy": "user2",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
  },
  "location": "eastus",
  "tags": {},
  "properties": {
    "provisioningState": "Created",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

Definições

Name Description
Ambr

Taxa máxima de bits agregada.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta a erros

PccRuleConfiguration

Configuração da regra de política de fluxo de dados

PccRuleQosPolicy

Política QoS da regra de fluxo de dados

PreemptionCapability

Capacidade de preempção.

PreemptionVulnerability

Vulnerabilidade de preempção.

ProvisioningState

O estado de aprovisionamento atual.

QosPolicy

Política de QoS

SdfDirection

Direção do fluxo de dados do serviço.

Service

Recurso de serviço. Tem de ser criado na mesma localização que a respetiva rede móvel principal.

ServiceDataFlowTemplate

Modelo de fluxo de dados

systemData

Metadados relativos à criação e última modificação do recurso.

TrafficControlPermission

Permissão de controlo de tráfego.

Ambr

Taxa máxima de bits agregada.

Name Tipo Description
downlink

string

Taxa de bits de downlink.

uplink

string

Taxa de bits de uplink.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informações adicionais.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

PccRuleConfiguration

Configuração da regra de política de fluxo de dados

Name Tipo Default value Description
ruleName

string

O nome da regra. Tem de ser exclusivo no serviço principal. Não pode utilizar nenhuma das seguintes cadeias reservadas – defaultou requestedservice.

rulePrecedence

integer

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.

ruleQosPolicy

PccRuleQosPolicy

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.

serviceDataFlowTemplates

ServiceDataFlowTemplate[]

O conjunto de modelos de fluxo de dados a utilizar para esta regra de política de fluxo de dados.

trafficControl

TrafficControlPermission

Enabled

Determina se os fluxos que correspondem a esta regra de política de fluxo de dados são permitidos.

PccRuleQosPolicy

Política QoS da regra de fluxo de dados

Name Tipo Default value Description
5qi

integer

9

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.

allocationAndRetentionPriorityLevel

integer

9

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.

guaranteedBitRate

Ambr

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.

maximumBitRate

Ambr

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.

preemptionCapability

PreemptionCapability

NotPreempt

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.

preemptionVulnerability

PreemptionVulnerability

Preemptable

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.

PreemptionCapability

Capacidade de preempção.

Name Tipo Description
MayPreempt

string

Pode antecipar

NotPreempt

string

Não é possível preemptar

PreemptionVulnerability

Vulnerabilidade de preempção.

Name Tipo Description
NotPreemptable

string

Não é possível preemptar

Preemptable

string

Pode ser preempida

ProvisioningState

O estado de aprovisionamento atual.

Name Tipo Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

QosPolicy

Política de QoS

Name Tipo Default value Description
5qi

integer

9

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.

allocationAndRetentionPriorityLevel

integer

9

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.

maximumBitRate

Ambr

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.

preemptionCapability

PreemptionCapability

NotPreempt

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.

preemptionVulnerability

PreemptionVulnerability

Preemptable

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.

SdfDirection

Direção do fluxo de dados do serviço.

Name Tipo Description
Bidirectional

string

Tráfego a fluir de e para a UE.

Downlink

string

Tráfego a fluir da rede de dados para a UE.

Uplink

string

Tráfego a fluir da UE para a rede de dados.

Service

Recurso de serviço. Tem de ser criado na mesma localização que a respetiva rede móvel principal.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

A localização geográfica onde reside o recurso

name

string

O nome do recurso

properties.pccRules

PccRuleConfiguration[]

O conjunto de regras de política de fluxo de dados que compõem este serviço.

properties.provisioningState

ProvisioningState

O estado de aprovisionamento do recurso de serviço.

properties.servicePrecedence

integer

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.

properties.serviceQosPolicy

QosPolicy

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.

systemData

systemData

O Azure Resource Manager metadados que contêm createdBy e modifiedBy information.

tags

object

Etiquetas de recursos.

type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Modelo de fluxo de dados

Name Tipo Description
direction

SdfDirection

A direção deste fluxo.

ports

string[]

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 -. Por exemplo: [8080, 8082-8085].

protocol

string[]

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.

remoteIpList

string[]

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).

templateName

string

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.

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

TrafficControlPermission

Permissão de controlo de tráfego.

Name Tipo Description
Blocked

string

O tráfego correspondente a esta regra não está autorizado a fluir.

Enabled

string

O tráfego correspondente a esta regra pode fluir.