Freigeben über

Services - Create Or Update

  • Referenz
Dienst:
Mobile Network
API-Version:
2024-04-01

Erstellt oder aktualisiert einen Dienst. Muss am gleichen Speicherort wie das übergeordnete Mobilfunknetz erstellt werden.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/services/{serviceName}?api-version=2024-04-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
mobileNetworkName
 path True

string

Der Name des Mobilfunknetzes.

RegEx-Muster: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
resourceGroupName
 path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.
serviceName
 path True

string

Der Name des Diensts. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: defaultoder requestedservice

RegEx-Muster: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version
 query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Erforderlich Typ Beschreibung
location True

string

Der geografische Standort, an dem sich die Ressource befindet
properties.pccRules True

PccRuleConfiguration[]

Der Satz von Datenflussrichtlinienregeln, aus denen dieser Dienst besteht.
properties.servicePrecedence True

integer

Ein Rangfolgewert, der verwendet wird, um zwischen Diensten zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle im Mobilfunknetz konfigurierten Dienste eindeutig sein.
properties.serviceQosPolicy

QosPolicy

Die QoS-Richtlinie, die für Pakete verwendet werden soll, die diesem Dienst entsprechen. Dies kann für bestimmte Flows mithilfe des Felds ruleQosPolicy in einer PccRuleConfiguration überschrieben werden. Wenn dieses Feld NULL ist, definiert die SIM-Richtlinie der UE die QoS-Einstellungen.
tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

Service

Aktualisierung erfolgreich. Der Vorgang gibt die resultierende Dienstressource zurück.
201 Created

Service

Create erfolgreich. Der Vorgang gibt die resultierende Dienstressource zurück.
Other Status Codes

ErrorResponse

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

Create service

Beispielanforderung

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": []
          }
        ]
      }
    ]
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "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": []
          }
        ]
      }
    ]
  }
}
Statuscode:
201 
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": []
          }
        ]
      }
    ]
  }
}

Definitionen

Name Beschreibung
Ambr

Aggregieren Sie die maximale Bitrate.
createdByType

Der Identitätstyp, der die Ressource erstellt hat.
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail

Die Fehlerdetails.
ErrorResponse

Fehlerantwort
PccRuleConfiguration

Regelkonfiguration für Datenflussrichtlinien
PccRuleQosPolicy

Datenflussrichtlinienregel QoS-Richtlinie
PreemptionCapability

Preemption-Funktion.
PreemptionVulnerability

Sicherheitsrisiko bei vorzeitiger Entfernung.
ProvisioningState

Der aktuelle Bereitstellungsstatus.
QosPolicy

QoS-Richtlinie
SdfDirection

Richtung des Dienstdatenflusses.
Service

Dienstressource. Muss am gleichen Speicherort wie das übergeordnete Mobilfunknetz erstellt werden.
ServiceDataFlowTemplate

Datenflussvorlage
systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
TrafficControlPermission

Zugriffssteuerungsberechtigung.

Ambr

Aggregieren Sie die maximale Bitrate.

Name Typ Beschreibung
downlink

string

Downlinkbitrate.
uplink

string

Uplink-Bitrate.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

Name Typ Beschreibung
info

object

Zusätzliche Informationen.
type

string

Typ der zusätzlichen Informationen.

ErrorDetail

Die Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.
code

string

Der Fehlercode.
details

ErrorDetail[]

Die Fehlerdetails.
message

string

Die Fehlermeldung.
target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

PccRuleConfiguration

Regelkonfiguration für Datenflussrichtlinien

Name Typ Standardwert Beschreibung
ruleName

string

Der Name der Regel. Dies muss innerhalb des übergeordneten Diensts eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service.
rulePrecedence

integer

Ein Rangfolgewert, der verwendet wird, um zwischen Datenflussrichtlinienregeln zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle im Mobilfunknetz konfigurierten Datenflussrichtlinienregeln eindeutig sein.
ruleQosPolicy

PccRuleQosPolicy

Die QoS-Richtlinie, die für Pakete verwendet werden soll, die dieser Regel entsprechen. Wenn dieses Feld NULL ist, definiert der übergeordnete Dienst die QoS-Einstellungen.
serviceDataFlowTemplates

ServiceDataFlowTemplate[]

Der Satz von Datenflussvorlagen, die für diese Datenflussrichtlinienregel verwendet werden sollen.
trafficControl

TrafficControlPermission

Enabled

Bestimmt, ob Flows, die dieser Datenflussrichtlinienregel entsprechen, zulässig sind.

PccRuleQosPolicy

Datenflussrichtlinienregel QoS-Richtlinie

Name Typ Standardwert Beschreibung
5qi

integer

9

5G QoS Flow Indicator-Wert. Das 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie in Abschnitt 5.7.2.1 von 3GPP TS23.501 und tabelle 5.7.4-1 für die Definition der 5QI-Werte.
allocationAndRetentionPriorityLevel

integer

9

QoS Flow-Zuordnungs- und Aufbewahrungsprioritätsebene (ARP). Flows mit höherer Priorität für Vorabflüsse mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsebene. Wenn dieses Feld nicht angegeben wird, 5qi wird der ARP-Wert abgeleitet. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
guaranteedBitRate

Ambr

Die garantierte Bitrate (GBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel verwenden. Dies ist eine optionale Einstellung. Wenn Sie keinen Wert angeben, gibt es keinen GBR-Satz für die Datenflussrichtlinienregel, die diese QoS-Definition verwendet.
maximumBitRate

Ambr

Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden.
preemptionCapability

PreemptionCapability

NotPreempt

QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
preemptionVulnerability

PreemptionVulnerability

Preemptable

QoS Flow Preemption-Sicherheitsrisiko. Die Sicherheitsanfälligkeit eines QoS-Flusses vor der Entfernung steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorgedrungen werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.

PreemptionCapability

Preemption-Funktion.

Name Typ Beschreibung
MayPreempt

string

Vorbelasten
NotPreempt

string

Kann nicht vorbehalten werden

PreemptionVulnerability

Sicherheitsrisiko bei vorzeitiger Entfernung.

Name Typ Beschreibung
NotPreemptable

string

Kann nicht vorgedrängt werden
Preemptable

string

Kann vorzeitig entfernt werden

ProvisioningState

Der aktuelle Bereitstellungsstatus.

Name Typ Beschreibung
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

QosPolicy

QoS-Richtlinie

Name Typ Standardwert Beschreibung
5qi

integer

9

5G QoS Flow Indicator-Wert. Das 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie in Abschnitt 5.7.2.1 von 3GPP TS23.501 und tabelle 5.7.4-1 für die Definition der 5QI-Werte.
allocationAndRetentionPriorityLevel

integer

9

QoS Flow-Zuordnungs- und Aufbewahrungsprioritätsebene (ARP). Flows mit höherer Priorität für Vorabflüsse mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsebene. Wenn dieses Feld nicht angegeben wird, 5qi wird der ARP-Wert abgeleitet. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
maximumBitRate

Ambr

Die maximale Bitrate (MBR) für alle Dienstdatenflüsse, die diese Datenflussrichtlinienregel oder diesen Dienst verwenden.
preemptionCapability

PreemptionCapability

NotPreempt

QoS Flow Preemption-Funktion. Die Funktion für die vorübergehende Unterbrechung eines QoS-Flows steuert, ob er einem anderen QoS-Flow mit einer niedrigeren Prioritätsstufe vorübergehend unterbrechen kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
preemptionVulnerability

PreemptionVulnerability

Preemptable

QoS Flow Preemption-Sicherheitsrisiko. Die Sicherheitsanfälligkeit eines QoS-Flusses vor der Entfernung steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorgedrungen werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.

SdfDirection

Richtung des Dienstdatenflusses.

Name Typ Beschreibung
Bidirectional

string

Datenverkehr, der sowohl in die UE als auch aus der UE fließt.
Downlink

string

Datenverkehr, der vom Datennetzwerk an die UE fließt.
Uplink

string

Datenverkehr, der von der UE an das Datennetzwerk fließt.

Service

Dienstressource. Muss am gleichen Speicherort wie das übergeordnete Mobilfunknetz erstellt werden.

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Der geografische Standort, an dem sich die Ressource befindet
name

string

Der Name der Ressource
properties.pccRules

PccRuleConfiguration[]

Der Satz von Datenflussrichtlinienregeln, aus denen dieser Dienst besteht.
properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der Dienstressource.
properties.servicePrecedence

integer

Ein Rangfolgewert, der verwendet wird, um zwischen Diensten zu entscheiden, wenn die QoS-Werte identifiziert werden, die für eine bestimmte SIM verwendet werden sollen. Ein niedrigerer Wert bedeutet eine höhere Priorität. Dieser Wert sollte für alle im Mobilfunknetz konfigurierten Dienste eindeutig sein.
properties.serviceQosPolicy

QosPolicy

Die QoS-Richtlinie, die für Pakete verwendet werden soll, die diesem Dienst entsprechen. Dies kann für bestimmte Flows mithilfe des Felds ruleQosPolicy in einer PccRuleConfiguration überschrieben werden. Wenn dieses Feld NULL ist, definiert die SIM-Richtlinie der UE die QoS-Einstellungen.
systemData

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.
tags

object

Ressourcentags.
type

string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ServiceDataFlowTemplate

Datenflussvorlage

Name Typ Beschreibung
direction

SdfDirection

Die Richtung dieses Flows.
ports

string[]

Die Ports, mit denen sich UEs für diesen Flow verbinden. Sie können null oder mehr Ports oder Portbereiche angeben. Wenn Sie einen oder mehrere Ports oder Portbereiche angeben, müssen Sie einen anderen Wert als ip im protocol Feld angeben. Dies ist eine optionale Einstellung. Wenn Sie es nicht angeben, sind Verbindungen an allen Ports zulässig. Portbereiche müssen als -angegeben werden. Beispiel: [8080, 8082-8085].
protocol

string[]

Eine Liste der zulässigen Protokolle für diesen Flow. Wenn dieser Flow ein beliebiges Protokoll innerhalb der Internetprotokollsuite verwenden soll, verwenden Sie den Wert ip. Wenn Sie nur eine Auswahl von Protokollen zulassen möchten, müssen Sie die entsprechende IANA zugewiesene Internetprotokollnummer für jedes Protokoll verwenden, wie in https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlbeschrieben. Für UDP müssen Sie beispielsweise 17 verwenden. Wenn Sie den Wert ip verwenden, müssen Sie das Feld port nicht angegeben lassen.
remoteIpList

string[]

Die Remote-IP-Adressen, mit denen UEs eine Verbindung für diesen Flow herstellen. Wenn Sie Verbindungen für eine beliebige IP-Adresse zulassen möchten, verwenden Sie den Wert any. Andernfalls müssen Sie jede der Remote-IP-Adressen angeben, mit denen der Paketkern instance für diesen Flow eine Verbindung herstellen soll. Sie müssen jede IP-Adresse in CIDR-Notation angeben, einschließlich der Netzmaske (z. B. 192.0.2.54/24).
templateName

string

Der Name der Datenflussvorlage. Dies muss innerhalb der übergeordneten Datenflussrichtlinienregel eindeutig sein. Sie dürfen keine der folgenden reservierten Zeichenfolgen verwenden: default, requested oder service.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy

string

Die Identität, die die Ressource erstellt hat.
createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt

string

Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

TrafficControlPermission

Zugriffssteuerungsberechtigung.

Name Typ Beschreibung
Blocked

string

Datenverkehr, der mit dieser Regel übereinstimmt, darf nicht fließen.
Enabled

string

Datenverkehr, der diese Regel abgleicht, darf fließen.