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 |
---|---|---|---|---|
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 não é sensível a maiúsculas e minúsculas. |
service
|
path | True |
string |
O nome do serviço. Não pode utilizar nenhuma das seguintes cadeias reservadas – Padrão Regex: |
subscription
|
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 |
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 |
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 |
Atualização bem-sucedida. A operação devolve o recurso de serviço resultante. |
|
201 Created |
Create com êxito. A operação devolve o recurso de serviço resultante. |
|
Other Status Codes |
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. |
created |
O tipo de identidade que criou o recurso. |
Error |
Informações adicionais sobre o erro de gestão de recursos. |
Error |
O detalhe do erro. |
Error |
Resposta a erros |
Pcc |
Configuração da regra de política de fluxo de dados |
Pcc |
Política QoS da regra de fluxo de dados |
Preemption |
Capacidade de preempção. |
Preemption |
Vulnerabilidade de preempção. |
Provisioning |
O estado de aprovisionamento atual. |
Qos |
Política de QoS |
Sdf |
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. |
Service |
Modelo de fluxo de dados |
system |
Metadados relativos à criação e última modificação do recurso. |
Traffic |
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 |
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 a erros
Name | Tipo | Description |
---|---|---|
error |
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 – |
|
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 |
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 |
O conjunto de modelos de fluxo de dados a utilizar para esta regra de política de fluxo de dados. |
||
trafficControl | 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 |
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. |
||
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. |
||
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 | 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 |
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. |
||
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 | 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 |
O conjunto de regras de política de fluxo de dados que compõem este serviço. |
|
properties.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 |
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 |
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 |
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 |
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 |
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 |
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 – |
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 |
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 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. |