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 |
---|---|---|---|---|
mobile
|
path | True |
string |
O nome da rede móvel. Padrão Regex: |
resource
|
path | True |
string |
O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas. |
service
|
path | True |
string |
O nome do serviço. Você não deve usar nenhuma das seguintes cadeias de caracteres reservadas – Padrão Regex: |
subscription
|
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 |
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 |
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 |
Atualização bem-sucedida. A operação retorna o recurso de serviço resultante. |
|
201 Created |
Create bem-sucedido. A operação retorna o recurso de serviço resultante. |
|
Other Status Codes |
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. |
created |
O tipo de identidade que criou o recurso. |
Error |
As informações adicionais do erro de gerenciamento de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta de erro |
Pcc |
Configuração da regra de política de fluxo de dados |
Pcc |
Política de QoS da regra de fluxo de dados |
Preemption |
Capacidade de preempção. |
Preemption |
Vulnerabilidade de preempção. |
Provisioning |
O estado de provisionamento atual. |
Qos |
Política de QoS |
Sdf |
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. |
Service |
Modelo de fluxo de dados |
system |
Metadados relativos à criação e à última modificação do recurso. |
Traffic |
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 |
As informações adicionais do erro. |
|
code |
string |
O código de erro. |
details |
Os detalhes do erro. |
|
message |
string |
A mensagem de erro. |
target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
Nome | Tipo | Description |
---|---|---|
error |
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 – |
|
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 |
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 |
O conjunto de modelos de fluxo de dados a serem usados para essa regra de política de fluxo de dados. |
||
trafficControl | 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 |
guaranteedBitRate |
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 |
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 | 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 | 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 |
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. |
||
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 | 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 |
O conjunto de regras de política de fluxo de dados que compõem esse serviço. |
|
properties.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 |
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 |
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 |
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 |
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 |
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 |
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 – |
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 |
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 |
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. |