Compartilhar via


Services - Create Or Update

Cria ou atualiza um serviço. Deve ser criado no mesmo local que sua rede móvel pai.

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

Parâmetros de URI

Nome Em Obrigató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 diferencia maiúsculas de minúsculas.

serviceName
path True

string

O nome do serviço. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – defaultou requestedservice

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

subscriptionId
path True

string

uuid

A ID da assinatura de destino. O valor deve ser um UUID.

api-version
query True

string

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

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

A localização geográfica em que o recurso reside

properties.pccRules True

PccRuleConfiguration[]

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

properties.servicePrecedence True

integer

Um valor de precedência usado para decidir entre os serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todos os serviços configurados na rede móvel.

properties.serviceQosPolicy

QosPolicy

A política de QoS a ser usada para pacotes correspondentes a esse serviço. Isso pode ser substituído para fluxos específicos usando o campo ruleQosPolicy em um PccRuleConfiguration. Se esse campo for nulo, a política SIM da UE definirá as configurações de QoS.

tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

Service

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

201 Created

Service

Create bem-sucedido. A operação retorna o recurso de serviço resultante.

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Create service

Solicitação de exemplo

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 de exemplo

{
  "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

Nome Description
Ambr

Taxa máxima de bits agregada.

createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

PccRuleConfiguration

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

PccRuleQosPolicy

Política de QoS da regra de fluxo de dados

PreemptionCapability

Capacidade de preempção.

PreemptionVulnerability

Vulnerabilidade de preempção.

ProvisioningState

O estado de provisionamento atual.

QosPolicy

Política de QoS

SdfDirection

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

Service

Recurso de serviço. Deve ser criado no mesmo local que sua rede móvel pai.

ServiceDataFlowTemplate

Modelo de fluxo de dados

systemData

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

TrafficControlPermission

Permissão de controle de tráfego.

Ambr

Taxa máxima de bits agregada.

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

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome 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 de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

PccRuleConfiguration

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

Nome Tipo Valor padrão Description
ruleName

string

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 – defaultou requestedservice.

rulePrecedence

integer

Um valor de precedência usado para decidir entre as regras de política de fluxo de dados ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todas as regras de política de fluxo de dados configuradas na rede móvel.

ruleQosPolicy

PccRuleQosPolicy

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.

serviceDataFlowTemplates

ServiceDataFlowTemplate[]

O conjunto de modelos de fluxo de dados a serem usados para essa regra de política de fluxo de dados.

trafficControl

TrafficControlPermission

Enabled

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

PccRuleQosPolicy

Política de QoS da regra de fluxo de dados

Nome Tipo Valor padrão Description
5qi

integer

9

Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI.

allocationAndRetentionPriorityLevel

integer

9

Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

guaranteedBitRate

Ambr

A GBR (taxa de bits) garantida para todos os fluxos de dados de serviço que usam essa regra de política de fluxo de dados. Esta é uma configuração opcional. Se você não fornecer um valor, não haverá nenhum conjunto de GBR para a regra de política de fluxo de dados que use essa definição de QoS.

maximumBitRate

Ambr

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.

preemptionCapability

PreemptionCapability

NotPreempt

Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

preemptionVulnerability

PreemptionVulnerability

Preemptable

Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

PreemptionCapability

Capacidade de preempção.

Nome Tipo Description
MayPreempt

string

Preempção de maio

NotPreempt

string

Não é possível preemplá-lo

PreemptionVulnerability

Vulnerabilidade de preempção.

Nome Tipo Description
NotPreemptable

string

Não é possível preemplê-lo

Preemptable

string

Pode ser preempto

ProvisioningState

O estado de provisionamento atual.

Nome Tipo Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

QosPolicy

Política de QoS

Nome Tipo Valor padrão Description
5qi

integer

9

Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido a um fluxo. Consulte 3GPP TS23.501 seção 5.7.2.1 para obter uma descrição completa do parâmetro 5QI e tabela 5.7.4-1 para obter a definição dos valores 5QI.

allocationAndRetentionPriorityLevel

integer

9

Nível de ARP (prioridade de retenção e alocação de fluxo de QoS). Fluxos com prioridade mais alta preempõem fluxos com prioridade mais baixa, se as configurações de preemptionCapability e preemptionVulnerability permitirem. 1 é o nível mais alto de prioridade. Se esse campo não for especificado, será 5qi usado para derivar o valor do ARP. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

maximumBitRate

Ambr

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.

preemptionCapability

PreemptionCapability

NotPreempt

Funcionalidade de preempção do Fluxo de QoS. A capacidade de preempção de um Fluxo de QoS controla se ele pode fazer a preempção de outro Fluxo de QoS com um nível de prioridade mais baixo. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

preemptionVulnerability

PreemptionVulnerability

Preemptable

Vulnerabilidade de preempção do Fluxo de QoS. A vulnerabilidade de preempção de um Fluxo de QoS controla se ele pode ser preempído por um Fluxo de QoS com um nível de prioridade mais alto. Consulte 3GPP TS23.501 seção 5.7.2.2 para obter uma descrição completa dos parâmetros ARP.

SdfDirection

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

Nome Tipo Description
Bidirectional

string

Tráfego fluindo de e para a UE.

Downlink

string

Tráfego que flui da rede de dados para a UE.

Uplink

string

Tráfego que flui da UE para a rede de dados.

Service

Recurso de serviço. Deve ser criado no mesmo local que sua rede móvel pai.

Nome Tipo Description
id

string

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

location

string

A localização geográfica em que o recurso reside

name

string

O nome do recurso

properties.pccRules

PccRuleConfiguration[]

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

properties.provisioningState

ProvisioningState

O estado de provisionamento do recurso de serviço.

properties.servicePrecedence

integer

Um valor de precedência usado para decidir entre os serviços ao identificar os valores de QoS a serem usados para um SIM específico. Um valor mais baixo significa uma prioridade mais alta. Esse valor deve ser exclusivo entre todos os serviços configurados na rede móvel.

properties.serviceQosPolicy

QosPolicy

A política de QoS a ser usada para pacotes correspondentes a esse serviço. Isso pode ser substituído para fluxos específicos usando o campo ruleQosPolicy em um PccRuleConfiguration. Se esse campo for nulo, a política SIM da UE definirá as configurações de QoS.

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

tags

object

Marcas de recurso.

type

string

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

ServiceDataFlowTemplate

Modelo de fluxo de dados

Nome Tipo Description
direction

SdfDirection

A direção desse fluxo.

ports

string[]

As portas às quais os UEs se conectarão para esse fluxo. Você pode especificar zero ou mais portas ou intervalos de portas. Se você especificar uma ou mais portas ou intervalos de portas, deverá especificar um valor diferente do ipprotocol campo . Esta é uma configuração opcional. Se você não especificá-lo, as conexões serão permitidas em todas as portas. Os intervalos de portas devem ser especificados como -. Por exemplo: [8080, 8082-8085].

protocol

string[]

Uma lista dos protocolos permitidos para esse fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo dentro do pacote de protocolos da Internet, use o valor ip. Se você quiser permitir apenas uma seleção de protocolos, deverá usar o número de protocolo de Internet atribuído IANA correspondente para cada protocolo, conforme descrito em https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Por exemplo, para UDP, você deve usar 17. Se você usar o valor ip , deverá deixar o campo port não especificado.

remoteIpList

string[]

Os endereços IP remotos aos quais os UEs se conectarão nesse fluxo. Se você quiser permitir conexões em qualquer endereço IP, use o valor any. Caso contrário, você deve fornecer cada um dos endereços IP remotos aos quais a instância do núcleo de pacotes se conectará para esse fluxo. Você deve fornecer cada endereço IP na notação CIDR, incluindo a máscara de rede (por exemplo, 192.0.2.54/24).

templateName

string

O nome da tarefa de fluxo de dados. Isso deve ser exclusivo dentro da regra de política de fluxo de dados pai. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – defaultou requestedservice.

systemData

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

Nome 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 controle de tráfego.

Nome Tipo Description
Blocked

string

O tráfego correspondente a essa regra não tem permissão para fluir.

Enabled

string

O tráfego correspondente a essa regra tem permissão para fluir.