Services - Create Or Update
Vytvoří nebo aktualizuje službu. Musí být vytvořen ve stejném umístění jako nadřazená mobilní síť.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
mobile
|
path | True |
string |
Název mobilní sítě. Vzor regulárního výrazu: |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
service
|
path | True |
string |
Název služby Nesmíte použít žádný z následujících rezervovaných řetězců – Vzor regulárního výrazu: |
subscription
|
path | True |
string uuid |
ID cílového předplatného. Hodnota musí být UUID. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
location | True |
string |
Geografické umístění, kde se prostředek nachází |
properties.pccRules | True |
Sada pravidel zásad toku dat, která tvoří tuto službu. |
|
properties.servicePrecedence | True |
integer |
Hodnota priority, která se používá k rozhodování mezi službami při identifikaci hodnot QoS, které se mají použít pro konkrétní SIM kartu. Nižší hodnota znamená vyšší prioritu. Tato hodnota by měla být jedinečná mezi všemi službami nakonfigurovaným v mobilní síti. |
properties.serviceQosPolicy |
Zásady QoS, které se mají použít pro pakety odpovídající této službě. Toto je možné přepsat pro konkrétní toky pomocí pole ruleQosPolicy v PccRuleConfiguration. Pokud má toto pole hodnotu null, budou nastavení QoS definovat zásady SIM uživatelského prostředí. |
||
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek služby. |
|
201 Created |
Create úspěšné. Operace vrátí výsledný prostředek služby. |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2.
Typ:
oauth2
Tok:
implicit
URL autorizace:
https://login.microsoftonline.com/common/oauth2/authorize
Rozsahy
Name | Description |
---|---|
user_impersonation | zosobnění uživatelského účtu |
Příklady
Create service
Ukázkový požadavek
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": []
}
]
}
]
}
}
Ukázková odpověď
{
"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": []
}
]
}
]
}
}
Definice
Name | Description |
---|---|
Ambr |
Agregovat maximální přenosovou rychlost. |
created |
Typ identity, která prostředek vytvořila. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Pcc |
Konfigurace pravidla zásad toku dat |
Pcc |
Pravidlo zásad toku dat – zásady QoS |
Preemption |
Preempční schopnost. |
Preemption |
Ohrožení zabezpečení z hlediska preempce |
Provisioning |
Aktuální stav zřizování. |
Qos |
Zásady QoS |
Sdf |
Směr toku dat služby |
Service |
Prostředek služby. Musí být vytvořen ve stejném umístění jako nadřazená mobilní síť. |
Service |
Šablona toku dat |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
Traffic |
Oprávnění řízení provozu. |
Ambr
Agregovat maximální přenosovou rychlost.
Name | Typ | Description |
---|---|---|
downlink |
string |
Přenosová rychlost downlinku. |
uplink |
string |
Přenosová rychlost odesílání. |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
PccRuleConfiguration
Konfigurace pravidla zásad toku dat
Name | Typ | Default value | Description |
---|---|---|---|
ruleName |
string |
Název pravidla. Musí být jedinečný v rámci nadřazené služby. Nesmíte použít žádný z následujících vyhrazených řetězců – |
|
rulePrecedence |
integer |
Hodnota priority, která se používá k rozhodování mezi pravidly zásad toku dat při identifikaci hodnot QoS, které se mají použít pro konkrétní SIM kartu. Nižší hodnota znamená vyšší prioritu. Tato hodnota by měla být jedinečná mezi všemi pravidly zásad toku dat nakonfigurovaná v mobilní síti. |
|
ruleQosPolicy |
Zásady QoS, které se mají použít pro pakety odpovídající tomuto pravidlu. Pokud má toto pole hodnotu null, nadřazená služba definuje nastavení QoS. |
||
serviceDataFlowTemplates |
Sada šablon toku dat, které se mají použít pro toto pravidlo zásad toku dat. |
||
trafficControl | Enabled |
Určuje, jestli jsou povolené toky, které odpovídají tomuto pravidlu zásad toku dat. |
PccRuleQosPolicy
Pravidlo zásad toku dat – zásady QoS
Name | Typ | Default value | Description |
---|---|---|---|
5qi |
integer |
9 |
Hodnota indikátoru toku QoS 5G 5QI identifikuje konkrétní proceduru předávání QoS, která se má toku poskytnout. Úplný popis parametru 5QI najdete v článku 3GPP TS23.501 v oddílu 5.7.2.1 a v tabulce 5.7.4-1 pro definici hodnot 5QI. |
allocationAndRetentionPriorityLevel |
integer |
9 |
Úroveň priority ARP (Allocation and Retention Priority) toku QoS. Toky s vyšší prioritou zaměňují toky s nižší prioritou, pokud to nastavení |
guaranteedBitRate |
Zaručená přenosová rychlost (GBR) pro všechny toky dat služby, které používají toto pravidlo zásad toku dat. Toto nastavení je nepovinné. Pokud nezadáte hodnotu, nebude pro pravidlo zásad toku dat, které tuto definici QoS používá, nastavená žádná GBR. |
||
maximumBitRate |
Maximální přenosová rychlost (MBR) pro všechny toky dat služby, které používají toto pravidlo zásad toku dat nebo službu. |
||
preemptionCapability | NotPreempt |
Funkce preempce toku QoS Funkce preempce toku QoS určuje, jestli může předejde jinému toku QoS s nižší prioritou. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2. |
|
preemptionVulnerability | Preemptable |
Ohrožení zabezpečení z hlediska preempce toku QoS Ohrožení zabezpečení preempce toku QoS určuje, jestli ho může tok QoS s vyšší úrovní priority zneužít. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2. |
PreemptionCapability
Preempční schopnost.
Name | Typ | Description |
---|---|---|
MayPreempt |
string |
Může dojít k preempt |
NotPreempt |
string |
Nelze přepít. |
PreemptionVulnerability
Ohrožení zabezpečení z hlediska preempce
Name | Typ | Description |
---|---|---|
NotPreemptable |
string |
Nelze ho zmácet. |
Preemptable |
string |
Může být zrušena |
ProvisioningState
Aktuální stav zřizování.
Name | Typ | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Unknown |
string |
QosPolicy
Zásady QoS
Name | Typ | Default value | Description |
---|---|---|---|
5qi |
integer |
9 |
Hodnota indikátoru toku QoS 5G 5QI identifikuje konkrétní proceduru předávání QoS, která se má toku poskytnout. Úplný popis parametru 5QI najdete v článku 3GPP TS23.501 v oddílu 5.7.2.1 a v tabulce 5.7.4-1 pro definici hodnot 5QI. |
allocationAndRetentionPriorityLevel |
integer |
9 |
Úroveň priority ARP (Allocation and Retention Priority) toku QoS. Toky s vyšší prioritou zaměňují toky s nižší prioritou, pokud to nastavení |
maximumBitRate |
Maximální přenosová rychlost (MBR) pro všechny toky dat služby, které používají toto pravidlo zásad toku dat nebo službu. |
||
preemptionCapability | NotPreempt |
Funkce preempce toku QoS Funkce preempce toku QoS určuje, jestli může předejde jinému toku QoS s nižší prioritou. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2. |
|
preemptionVulnerability | Preemptable |
Ohrožení zabezpečení z hlediska preempce toku QoS Ohrožení zabezpečení preempce toku QoS určuje, jestli ho může tok QoS s vyšší úrovní priority zneužít. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2. |
SdfDirection
Směr toku dat služby
Name | Typ | Description |
---|---|---|
Bidirectional |
string |
Provoz směřující do i z uživatelského prostředí. |
Downlink |
string |
Provoz směřující z datové sítě do UE. |
Uplink |
string |
Provoz směřující z UE do datové sítě. |
Service
Prostředek služby. Musí být vytvořen ve stejném umístění jako nadřazená mobilní síť.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Například /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{název_poskytovatele_prostředku}/{typ_prostředku}/{název_prostředku}. |
location |
string |
Geografické umístění, kde se prostředek nachází |
name |
string |
Název prostředku |
properties.pccRules |
Sada pravidel zásad toku dat, která tvoří tuto službu. |
|
properties.provisioningState |
Stav zřizování prostředku služby. |
|
properties.servicePrecedence |
integer |
Hodnota priority, která se používá k rozhodování mezi službami při identifikaci hodnot QoS, které se mají použít pro konkrétní SIM kartu. Nižší hodnota znamená vyšší prioritu. Tato hodnota by měla být jedinečná mezi všemi službami nakonfigurovaným v mobilní síti. |
properties.serviceQosPolicy |
Zásady QoS, které se mají použít pro pakety odpovídající této službě. Toto je možné přepsat pro konkrétní toky pomocí pole ruleQosPolicy v PccRuleConfiguration. Pokud má toto pole hodnotu null, budou nastavení QoS definovat zásady SIM uživatelského prostředí. |
|
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
ServiceDataFlowTemplate
Šablona toku dat
Name | Typ | Description |
---|---|---|
direction |
Směr tohoto toku. |
|
ports |
string[] |
Porty, ke kterým se uživatelská zařízení pro tento tok připojí. Můžete zadat nula nebo více portů nebo rozsahů portů. Pokud zadáte jeden nebo více portů nebo rozsahů portů, musíte zadat jinou hodnotu než |
protocol |
string[] |
Seznam povolených protokolů pro tento tok. Pokud chcete, aby tento tok mohl používat libovolný protokol v rámci sady internetových protokolů, použijte hodnotu |
remoteIpList |
string[] |
Vzdálené IP adresy, ke kterým se budou uživatelská zařízení pro tento tok připojovat. Pokud chcete povolit připojení na libovolné IP adrese, použijte hodnotu |
templateName |
string |
Název šablony toku dat. Musí být jedinečný v rámci nadřazeného pravidla zásad toku dat. Nesmíte použít žádný z následujících vyhrazených řetězců – |
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |
TrafficControlPermission
Oprávnění řízení provozu.
Name | Typ | Description |
---|---|---|
Blocked |
string |
Provoz odpovídající tomuto pravidlu není povolený. |
Enabled |
string |
Provoz odpovídající tomuto pravidlu je povolený. |