Sdílet prostřednictvím


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

string

Název mobilní sítě.

Vzor regulárního výrazu: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

serviceName
path True

string

Název služby Nesmíte použít žádný z následujících rezervovaných řetězců – default, requested nebo service

Vzor regulárního výrazu: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
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

PccRuleConfiguration[]

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

QosPolicy

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

Service

Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek služby.

201 Created

Service

Create úspěšné. Operace vrátí výsledný prostředek služby.

Other Status Codes

ErrorResponse

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.

createdByType

Typ identity, která prostředek vytvořila.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

PccRuleConfiguration

Konfigurace pravidla zásad toku dat

PccRuleQosPolicy

Pravidlo zásad toku dat – zásady QoS

PreemptionCapability

Preempční schopnost.

PreemptionVulnerability

Ohrožení zabezpečení z hlediska preempce

ProvisioningState

Aktuální stav zřizování.

QosPolicy

Zásady QoS

SdfDirection

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íť.

ServiceDataFlowTemplate

Šablona toku dat

systemData

Metadata týkající se vytvoření a poslední změny prostředku.

TrafficControlPermission

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

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

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ů – default, requested nebo service.

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

PccRuleQosPolicy

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

ServiceDataFlowTemplate[]

Sada šablon toku dat, které se mají použít pro toto pravidlo zásad toku dat.

trafficControl

TrafficControlPermission

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í preemptionCapability a preemptionVulnerability umožňují. 1 je nejvyšší úroveň priority. Pokud toto pole není zadané 5qi , použije se k odvození hodnoty protokolu ARP. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2.

guaranteedBitRate

Ambr

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

Ambr

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

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

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í preemptionCapability a preemptionVulnerability umožňují. 1 je nejvyšší úroveň priority. Pokud toto pole není zadané 5qi , použije se k odvození hodnoty protokolu ARP. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2.

maximumBitRate

Ambr

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

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

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

PccRuleConfiguration[]

Sada pravidel zásad toku dat, která tvoří tuto službu.

properties.provisioningState

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

QosPolicy

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

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

SdfDirection

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ž ip v protocol poli . Toto nastavení je nepovinné. Pokud ho nezadáte, budou připojení povolená na všech portech. Rozsahy portů musí být zadané jako -. Příklad: [8080, 8082-8085].

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 ip. Pokud chcete povolit pouze výběr protokolů, musíte pro každý protokol použít odpovídající číslo přiřazeného protokolu INTERNET IANA, jak je popsáno v https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmltématu . Například pro UDP musíte použít 17. Pokud použijete hodnotu ip , musíte pole port ponechat nezadané.

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 any. Jinak musíte zadat všechny vzdálené IP adresy, ke kterým se bude instance jádra paketu pro tento tok připojovat. Každou IP adresu musíte zadat v zápisu CIDR, včetně síťové masky (například 192.0.2.54/24).

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ů – default, requested nebo service.

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

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

createdByType

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ý.