Services - Create Or Update
Létrehoz vagy frissít egy szolgáltatást. A szülő mobilhálózatával megegyező helyen kell létrehozni.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
mobile
|
path | True |
string maxLength: 64pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
A mobilhálózat neve. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket. |
service
|
path | True |
string maxLength: 64pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
A szolgáltatás neve. A következő fenntartott sztringek egyikét sem használhatja : |
subscription
|
path | True |
string (uuid) |
A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie. |
api-version
|
query | True |
string minLength: 1 |
A művelethez használni kívánt API-verzió. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
location | True |
string |
Az a földrajzi hely, ahol az erőforrás él |
properties.pccRules | True |
A szolgáltatást alkotó adatfolyam-szabályzatszabályok készlete. |
|
properties.servicePrecedence | True |
integer (int32) minimum: 0maximum: 255 |
Az adott SIM-hez használandó QoS-értékek azonosításakor a szolgáltatások közötti döntéshez használt elsőbbségi érték. Az alacsonyabb érték magasabb prioritást jelent. Ennek az értéknek egyedinek kell lennie a mobilhálózaton konfigurált összes szolgáltatás között. |
properties.serviceQosPolicy |
A szolgáltatásnak megfelelő csomagokhoz használandó QoS-szabályzat. Ezt felül lehet bírálni bizonyos folyamatok esetében a PccRuleConfiguration ruleQosPolicy mezőjével. Ha ez a mező null értékű, akkor az UE SIM-szabályzata határozza meg a QoS-beállításokat. |
||
tags |
object |
Erőforráscímkék. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
A frissítés sikeres. A művelet az eredményül kapott szolgáltatáserőforrást adja vissza. |
|
201 Created |
Sikeres létrehozás. A művelet az eredményül kapott szolgáltatáserőforrást adja vissza. |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy miért nem sikerült a művelet. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow.
Típus:
oauth2
Folyamat:
implicit
Engedélyezési URL:
https://login.microsoftonline.com/common/oauth2/authorize
Hatókörök
Name | Description |
---|---|
user_impersonation | a felhasználói fiók megszemélyesítése |
Példák
Create service
Mintakérelem
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": []
}
]
}
]
}
}
Mintaválasz
{
"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": []
}
]
}
]
}
}
Definíciók
Name | Description |
---|---|
Ambr |
Maximális bitsebesség összesítése. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Pcc |
Adatfolyam-szabályzatszabály konfigurálása |
Pcc |
Adatfolyam-szabályzatszabály QoS-szabályzata |
Preemption |
Preemption képesség. |
Preemption |
Preemption biztonsági rés. |
Provisioning |
Az aktuális kiépítési állapot. |
Qos |
QoS-szabályzat |
Sdf |
Szolgáltatás adatfolyam-iránya. |
Service |
Szolgáltatáserőforrás. A szülő mobilhálózatával megegyező helyen kell létrehozni. |
Service |
Adatfolyam-sablon |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
Traffic |
Forgalomirányítási engedély. |
Ambr
Maximális bitsebesség összesítése.
Name | Típus | Description |
---|---|---|
downlink |
string pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Leválasztási bit sebessége. |
uplink |
string pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$ |
Kimenő bit sebessége. |
createdByType
Az erőforrást létrehozó identitás típusa.
Érték | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
PccRuleConfiguration
Adatfolyam-szabályzatszabály konfigurálása
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
ruleName |
string maxLength: 64pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
A szabály neve. Ennek egyedinek kell lennie a szülőszolgáltatásban. A következő fenntartott sztringek egyikét sem használhatja : |
|
rulePrecedence |
integer (int32) minimum: 0maximum: 255 |
Egy elsőbbséget élvező érték, amely az adatfolyam-szabályzatszabályok közötti döntésre szolgál az adott SIM-hez használandó QoS-értékek azonosításakor. Az alacsonyabb érték magasabb prioritást jelent. Ennek az értéknek egyedinek kell lennie a mobilhálózaton konfigurált összes adatfolyam-házirend-szabály között. |
|
ruleQosPolicy |
A szabálynak megfelelő csomagokhoz használandó QoS-szabályzat. Ha ez a mező null értékű, akkor a szülőszolgáltatás határozza meg a QoS-beállításokat. |
||
serviceDataFlowTemplates |
Az adatfolyamszabályhoz használandó adatfolyamsablonok készlete. |
||
trafficControl | Enabled |
Meghatározza, hogy engedélyezettek-e az adatfolyam-szabályzatszabálynak megfelelő folyamatok. |
PccRuleQosPolicy
Adatfolyam-szabályzatszabály QoS-szabályzata
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
5qi |
integer (int32) minimum: 1maximum: 127 |
9 |
5G QoS-folyamatjelző értéke. Az 5QI azonosítja a folyamatnak nyújtandó adott QoS-továbbítási kezelést. Az 5QI-értékek definíciójához lásd a 3GPP TS23.501 5.7.2.1. szakaszát. |
allocationAndRetentionPriorityLevel |
integer (int32) minimum: 1maximum: 15 |
9 |
A QoS-folyamat kiosztási és megőrzési prioritása (ARP) szintje. A magasabb prioritású előkezelésű folyamatok alacsonyabb prioritással, ha a |
guaranteedBitRate |
Az ezen adatfolyamszabályt használó összes szolgáltatásadatfolyam garantált bitsebessége (GBR). Ez nem kötelező beállítás. Ha nem ad meg értéket, a QoS-definíciót használó adatfolyam-szabályzatszabályhoz nem lesz GBR-beállítás. |
||
maximumBitRate |
Az adatfolyam-szabályzatszabályt vagy szolgáltatást használó összes szolgáltatásadatfolyam maximális bitsebessége (MBR). |
||
preemptionCapability | NotPreempt |
QoS-folyamat előképelési képessége. A QoS-folyamat preempciós képessége határozza meg, hogy elő tud-e elővenni egy másik, alacsonyabb prioritási szintű QoS-folyamatot. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja. |
|
preemptionVulnerability | Preemptable |
QoS-folyamat elővizsgálati biztonsági rése. A QoS-folyamat preempciós biztonsági rése szabályozza, hogy egy magasabb prioritású QoS-folyamat előzhető-e meg. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja. |
PreemptionCapability
Preemption képesség.
Érték | Description |
---|---|
MayPreempt |
Májusi előzmény |
NotPreempt |
Nem lehet előtagot megadni |
PreemptionVulnerability
Preemption biztonsági rés.
Érték | Description |
---|---|
NotPreemptable |
Nem lehet előre beszúrni |
Preemptable |
Előfordulhat, hogy előre fel van iktatva |
ProvisioningState
Az aktuális kiépítési állapot.
Érték | Description |
---|---|
Accepted | |
Canceled | |
Deleted | |
Deleting | |
Failed | |
Succeeded | |
Unknown |
QosPolicy
QoS-szabályzat
Name | Típus | Alapértelmezett érték | Description |
---|---|---|---|
5qi |
integer (int32) minimum: 1maximum: 127 |
9 |
5G QoS-folyamatjelző értéke. Az 5QI azonosítja a folyamatnak nyújtandó adott QoS-továbbítási kezelést. Az 5QI-értékek definíciójához lásd a 3GPP TS23.501 5.7.2.1. szakaszát. |
allocationAndRetentionPriorityLevel |
integer (int32) minimum: 1maximum: 15 |
9 |
A QoS-folyamat kiosztási és megőrzési prioritása (ARP) szintje. A magasabb prioritású előkezelésű folyamatok alacsonyabb prioritással, ha a |
maximumBitRate |
Az adatfolyam-szabályzatszabályt vagy szolgáltatást használó összes szolgáltatásadatfolyam maximális bitsebessége (MBR). |
||
preemptionCapability | NotPreempt |
QoS-folyamat előképelési képessége. A QoS-folyamat preempciós képessége határozza meg, hogy elő tud-e elővenni egy másik, alacsonyabb prioritási szintű QoS-folyamatot. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja. |
|
preemptionVulnerability | Preemptable |
QoS-folyamat elővizsgálati biztonsági rése. A QoS-folyamat preempciós biztonsági rése szabályozza, hogy egy magasabb prioritású QoS-folyamat előzhető-e meg. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja. |
SdfDirection
Szolgáltatás adatfolyam-iránya.
Érték | Description |
---|---|
Bidirectional |
Az UE felé és az UE-ből egyaránt áramló forgalom. |
Downlink |
Az adathálózatról az UE-be áramló forgalom. |
Uplink |
Az UE-ből az adathálózatba áramló forgalom. |
Service
Szolgáltatáserőforrás. A szülő mobilhálózatával megegyező helyen kell létrehozni.
Name | Típus | Description |
---|---|---|
id |
string (arm-id) |
Az erőforrás teljes erőforrás-azonosítója. Például: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
location |
string |
Az a földrajzi hely, ahol az erőforrás él |
name |
string |
Az erőforrás neve |
properties.pccRules |
A szolgáltatást alkotó adatfolyam-szabályzatszabályok készlete. |
|
properties.provisioningState |
A szolgáltatáserőforrás kiépítési állapota. |
|
properties.servicePrecedence |
integer (int32) minimum: 0maximum: 255 |
Az adott SIM-hez használandó QoS-értékek azonosításakor a szolgáltatások közötti döntéshez használt elsőbbségi érték. Az alacsonyabb érték magasabb prioritást jelent. Ennek az értéknek egyedinek kell lennie a mobilhálózaton konfigurált összes szolgáltatás között. |
properties.serviceQosPolicy |
A szolgáltatásnak megfelelő csomagokhoz használandó QoS-szabályzat. Ezt felül lehet bírálni bizonyos folyamatok esetében a PccRuleConfiguration ruleQosPolicy mezőjével. Ha ez a mező null értékű, akkor az UE SIM-szabályzata határozza meg a QoS-beállításokat. |
|
systemData |
A createdBy és a modifiedBy adatokat tartalmazó Azure Resource Manager-metaadatok. |
|
tags |
object |
Erőforráscímkék. |
type |
string |
Az erőforrás típusa. Pl. "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
ServiceDataFlowTemplate
Adatfolyam-sablon
Name | Típus | Description |
---|---|---|
direction |
A folyamat iránya. |
|
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]))?$ |
Az a port(ok), amelyhez a UE-k csatlakozni fognak ehhez a folyamathoz. Megadhat nulla vagy több portot vagy porttartományt. Ha egy vagy több portot vagy porttartományt ad meg, akkor a |
protocol |
string[] pattern: ^(ip|[0-9]|[1-9][0-9]|1[0-9][0-9]|2[0-4][0-9]|25[0-5])$ |
A folyamathoz engedélyezett protokoll(ok) listája. Ha azt szeretné, hogy ez a folyamat bármilyen protokollt használhasson az internetprotokoll-csomagban, használja a |
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])))$ |
Az a távoli IP-cím(ek), amelyhez a felhasználói felületek csatlakozni fognak ehhez a folyamathoz. Ha bármilyen IP-címen engedélyezni szeretné a kapcsolatokat, használja a |
templateName |
string maxLength: 64pattern: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$ |
Az adatfolyam-sablon neve. Ennek egyedinek kell lennie a szülő adatfolyamszabályzatában. A következő fenntartott sztringek egyikét sem használhatja : |
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string (date-time) |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string (date-time) |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az erőforrást legutóbb módosító identitás. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |
TrafficControlPermission
Forgalomirányítási engedély.
Érték | Description |
---|---|
Blocked |
A szabálynak megfelelő forgalom nem haladhat. |
Enabled |
A szabálynak megfelelő forgalom engedélyezett. |