Megosztás a következőn keresztül:


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
mobileNetworkName
path True

string

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

A mobilhálózat neve.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.

serviceName
path True

string

maxLength: 64
pattern: ^(?!(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 : default, requested vagy service

subscriptionId
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

PccRuleConfiguration[]

A szolgáltatást alkotó adatfolyam-szabályzatszabályok készlete.

properties.servicePrecedence True

integer (int32)

minimum: 0
maximum: 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

QosPolicy

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

Service

A frissítés sikeres. A művelet az eredményül kapott szolgáltatáserőforrást adja vissza.

201 Created

Service

Sikeres létrehozás. A művelet az eredményül kapott szolgáltatáserőforrást adja vissza.

Other Status Codes

ErrorResponse

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.

createdByType

Az erőforrást létrehozó identitás típusa.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

PccRuleConfiguration

Adatfolyam-szabályzatszabály konfigurálása

PccRuleQosPolicy

Adatfolyam-szabályzatszabály QoS-szabályzata

PreemptionCapability

Preemption képesség.

PreemptionVulnerability

Preemption biztonsági rés.

ProvisioningState

Az aktuális kiépítési állapot.

QosPolicy

QoS-szabályzat

SdfDirection

Szolgáltatás adatfolyam-iránya.

Service

Szolgáltatáserőforrás. A szülő mobilhálózatával megegyező helyen kell létrehozni.

ServiceDataFlowTemplate

Adatfolyam-sablon

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

TrafficControlPermission

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

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hibacél.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

PccRuleConfiguration

Adatfolyam-szabályzatszabály konfigurálása

Name Típus Alapértelmezett érték Description
ruleName

string

maxLength: 64
pattern: ^(?!(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 : default, requested vagy service.

rulePrecedence

integer (int32)

minimum: 0
maximum: 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

PccRuleQosPolicy

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

ServiceDataFlowTemplate[]

Az adatfolyamszabályhoz használandó adatfolyamsablonok készlete.

trafficControl

TrafficControlPermission

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: 1
maximum: 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: 1
maximum: 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 preemptionCapability és preemptionVulnerability beállításai engedélyezik. Az 1 a legmagasabb prioritási szint. Ha ez a mező nincs megadva, 5qi az ARP-érték származtatására szolgál. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja.

guaranteedBitRate

Ambr

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

Ambr

Az adatfolyam-szabályzatszabályt vagy szolgáltatást használó összes szolgáltatásadatfolyam maximális bitsebessége (MBR).

preemptionCapability

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

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: 1
maximum: 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: 1
maximum: 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 preemptionCapability és preemptionVulnerability beállításai engedélyezik. Az 1 a legmagasabb prioritási szint. Ha ez a mező nincs megadva, 5qi az ARP-érték származtatására szolgál. Az ARP-paraméterek teljes leírását a 3GPP TS23.501 5.7.2.2. szakaszában találja.

maximumBitRate

Ambr

Az adatfolyam-szabályzatszabályt vagy szolgáltatást használó összes szolgáltatásadatfolyam maximális bitsebessége (MBR).

preemptionCapability

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

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

PccRuleConfiguration[]

A szolgáltatást alkotó adatfolyam-szabályzatszabályok készlete.

properties.provisioningState

ProvisioningState

A szolgáltatáserőforrás kiépítési állapota.

properties.servicePrecedence

integer (int32)

minimum: 0
maximum: 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

QosPolicy

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

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

SdfDirection

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 ip mezőben nem protocol értéket kell megadnia. Ez nem kötelező beállítás. Ha nem adja meg, akkor a kapcsolatok minden porton engedélyezve lesznek. A porttartományokat -értékként kell megadni. Például: [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])$

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 ipértéket. Ha csak a protokollok kiválasztását szeretné engedélyezni, a megfelelő IANA által hozzárendelt internetprotokoll-számot kell használnia az egyes protokollokhoz, az https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml. Az UDP esetében például a 17-et kell használnia. Ha a ip értéket használja, a mezőt meg nem határozott port kell hagynia.

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 anyértéket. Ellenkező esetben meg kell adnia azokat a távoli IP-címeket, amelyekhez a csomagmagpéldány csatlakozik ehhez a folyamathoz. Minden IP-címet meg kell adnia a CIDR-jelölésben, beleértve a hálómaszkot is (például 192.0.2.54/24).

templateName

string

maxLength: 64
pattern: ^(?!(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 : default, requested vagy service.

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

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

createdByType

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.