Compartilhar via


Services - Update Tags

Atualiza marcas de serviço.

PATCH 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

maxLength: 64
pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

O nome da rede móvel.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

serviceName
path True

string

maxLength: 64
pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

O nome do serviço. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – default, requested ou service

subscriptionId
path True

string (uuid)

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

api-version
query True

string

minLength: 1

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

Corpo da solicitação

Nome Tipo Description
tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

Service

Atualize com êxito. 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

Update service tags

Solicitação de exemplo

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

{
  "tags": {
    "tag1": "value1",
    "tag2": "value2"
  }
}

Resposta de exemplo

{
  "name": "TestService",
  "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": {
    "tag1": "value1",
    "tag2": "value2"
  },
  "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": []
          }
        ]
      }
    ]
  }
}

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 política de fluxo de dados QoS

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.

TagsObject

Marca o objeto para operações de patch.

TrafficControlPermission

Permissão de controle de tráfego.

Ambr

Taxa máxima de bits agregada.

Nome Tipo Description
downlink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

Taxa de bits de downlink.

uplink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

Taxa de bits de uplink.

createdByType

O tipo de identidade que criou o recurso.

Valor Description
Application
Key
ManagedIdentity
User

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

maxLength: 64
pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

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.

rulePrecedence

integer (int32)

minimum: 0
maximum: 255

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 correspondentes 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 política de fluxo de dados QoS

Nome Tipo Valor padrão Description
5qi

integer (int32)

minimum: 1
maximum: 127
9

Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido para 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 a definição dos valores 5QI.

allocationAndRetentionPriorityLevel

integer (int32)

minimum: 1
maximum: 15
9

Nível de ARP (alocação e prioridade de retenção) de fluxo de QoS. Flui com fluxos de preempção de prioridade mais alta 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, 5qi será 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. Essa é 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 prever 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.

Valor Description
MayPreempt

Preempto de maio

NotPreempt

Não é possível prever

PreemptionVulnerability

Vulnerabilidade de preempção.

Valor Description
NotPreemptable

Não é possível preempi-lo

Preemptable

Pode ser preempido

ProvisioningState

O estado de provisionamento atual.

Valor Description
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

QosPolicy

Política de QoS

Nome Tipo Valor padrão Description
5qi

integer (int32)

minimum: 1
maximum: 127
9

Valor do Indicador de Fluxo de QoS 5G. O 5QI identifica um tratamento de encaminhamento de QoS específico a ser fornecido para 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 a definição dos valores 5QI.

allocationAndRetentionPriorityLevel

integer (int32)

minimum: 1
maximum: 15
9

Nível de ARP (alocação e prioridade de retenção) de fluxo de QoS. Flui com fluxos de preempção de prioridade mais alta 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, 5qi será 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 prever 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.

Valor Description
Bidirectional

Tráfego fluindo de e para a UE.

Downlink

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

Uplink

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 (arm-id)

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 onde 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 (int32)

minimum: 0
maximum: 255

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

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

tags

object

Marcas de recurso.

type

string

O 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[]

pattern: ^([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]))?$

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 porta, deverá especificar um valor diferente de ip no campo protocol. Essa é 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[]

pattern: ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$

Uma lista dos protocolos permitidos para esse fluxo. Se você quiser que esse fluxo possa usar qualquer protocolo no 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[]

pattern: ^(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])))$

O endereço IP remoto ao qual 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).

templateName

string

maxLength: 64
pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

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.

systemData

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

Nome Tipo Description
createdAt

string (date-time)

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 (date-time)

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.

TagsObject

Marca o objeto para operações de patch.

Nome Tipo Description
tags

object

Marcas de recurso.

TrafficControlPermission

Permissão de controle de tráfego.

Valor Description
Blocked

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

Enabled

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