Freigeben über

Sim Policies - Create Or Update

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

Erstellt oder aktualisiert eine SIM-Richtlinie. Muss am gleichen Speicherort wie das übergeordnete Mobilfunknetz erstellt werden.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/simPolicies/{simPolicyName}?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.
simPolicyName
 path True

string

Der Name der SIM-Richtlinie.

RegEx-Muster: ^[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.defaultSlice True

SliceResourceId

Der Standardslice, der verwendet werden soll, wenn die UE es nicht explizit angibt. Dieser Slice muss in der sliceConfigurations Zuordnung vorhanden sein. Der Slice muss sich am gleichen Speicherort wie die SIM-Richtlinie befinden.
properties.sliceConfigurations True

SliceConfiguration[]

Die zulässigen Slices und die Einstellungen, die für sie verwendet werden sollen. Die Liste darf keine doppelten Elemente enthalten und muss mindestens ein Element enthalten.
properties.ueAmbr True

Ambr

Aggregieren der maximalen Bitrate für alle QoS-Flows ohne GBR aller PDU-Sitzungen einer bestimmten UE. Eine vollständige Beschreibung der UE-AMBR finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.6.
properties.registrationTimer

integer

UE Periodische Registrierung Update-Timer (5G) oder UE periodische Nachverfolgungsbereich Update-Timer (4G) in Sekunden.
properties.rfspIndex

integer

RAT/Frequency Selection Priority Index, definiert in 3GPP TS 36.413. Dies ist eine optionale Einstellung, die standardmäßig nicht angegeben ist.
tags

object

Ressourcentags.

Antworten

Name Typ Beschreibung
200 OK

SimPolicy

Aktualisierung erfolgreich. Der Vorgang gibt die resultierende SIM-Richtlinienressource zurück.
201 Created

SimPolicy

Create erfolgreich. Der Vorgang gibt die resultierende SIM-Richtlinienressource 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 SIM policy

Beispielanforderung

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
            },
            "sessionAmbr": {
              "uplink": "500 Mbps",
              "downlink": "1 Gbps"
            },
            "5qi": 9,
            "allocationAndRetentionPriorityLevel": 9,
            "preemptionCapability": "NotPreempt",
            "preemptionVulnerability": "Preemptable",
            "defaultSessionType": "IPv4",
            "additionalAllowedSessionTypes": [],
            "allowedServices": [
              {
                "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ],
            "maximumNumberOfBufferedPackets": 200
          }
        ]
      }
    ]
  }
}

Beispiel für eine Antwort

Statuscode:
200 
{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy",
  "type": "Microsoft.MobileNetwork/simPolicy",
  "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",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Provisioned",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Provisioned"
    },
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
            },
            "sessionAmbr": {
              "uplink": "500 Mbps",
              "downlink": "1 Gbps"
            },
            "5qi": 9,
            "allocationAndRetentionPriorityLevel": 9,
            "preemptionCapability": "NotPreempt",
            "preemptionVulnerability": "Preemptable",
            "defaultSessionType": "IPv4",
            "additionalAllowedSessionTypes": [],
            "allowedServices": [
              {
                "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ],
            "maximumNumberOfBufferedPackets": 200
          }
        ]
      }
    ]
  }
}
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/simPolicies/testPolicy",
  "type": "Microsoft.MobileNetwork/simPolicy",
  "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",
    "siteProvisioningState": {
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite": "Adding",
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite2": "Adding"
    },
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
            },
            "sessionAmbr": {
              "uplink": "500 Mbps",
              "downlink": "1 Gbps"
            },
            "5qi": 9,
            "allocationAndRetentionPriorityLevel": 9,
            "preemptionCapability": "NotPreempt",
            "preemptionVulnerability": "Preemptable",
            "defaultSessionType": "IPv4",
            "additionalAllowedSessionTypes": [],
            "allowedServices": [
              {
                "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ],
            "maximumNumberOfBufferedPackets": 200
          }
        ]
      }
    ]
  }
}

Definitionen

Name Beschreibung
Ambr

Maximale Bitrate aggregieren.
createdByType

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

Einstellungen, die die Verwendung des Datennetzwerks steuern
DataNetworkResourceId

Verweis auf eine Datennetzwerkressource.
ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
ErrorDetail

Die Fehlerdetails.
ErrorResponse

Fehlerantwort
PduSessionType

PDU-Sitzungstyp (IPv4/IPv6).
PreemptionCapability

Vorzeitige Entfernungsfunktion.
PreemptionVulnerability

Sicherheitsrisiko bei vorzeitiger Entfernung.
ProvisioningState

Der aktuelle Bereitstellungsstatus.
ServiceResourceId

Verweis auf eine Dienstressource.
SimPolicy

SIM-Richtlinienressource.
SliceConfiguration

Einstellungen pro Slice
SliceResourceId

Verweis auf eine Sliceressource.
systemData

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

Ambr

Maximale Bitrate aggregieren.

Name Typ Beschreibung
downlink

string

Downlink-Bitrate.
uplink

string

Uplink-Bitrate.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

DataNetworkConfiguration

Einstellungen, die die Verwendung des Datennetzwerks steuern

Name Typ Standardwert Beschreibung
5qi

integer

9

Standardmäßiger 5G-QoS-Flussindikatorwert. Der 5QI identifiziert eine spezifische QoS-Weiterleitungsbehandlung, die einem Flow zur Verfügung gestellt werden soll. Eine vollständige Beschreibung des 5QI-Parameters finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.1 und Tabelle 5.7.4-1 für die Definition der 5QI-Werte.
additionalAllowedSessionTypes

PduSessionType[]

Zugelassene Sitzungstypen zusätzlich zum Standardsitzungstyp. Der Standardsitzungstyp darf nicht dupliziert werden.
allocationAndRetentionPriorityLevel

integer

9

Standardebene der QoS-Flusszuordnung und -Aufbewahrungspriorität (ARP). Flows mit vorzeitiger Entfernung mit höherer Priorität mit niedrigerer Priorität, wenn die Einstellungen von preemptionCapability und preemptionVulnerability zulassen. 1 ist die höchste Prioritätsstufe. Wenn dieses Feld nicht angegeben 5qi ist, wird verwendet, um den ARP-Wert abzuleiten. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
allowedServices

ServiceResourceId[]

Liste der Dienste, die als Teil dieser SIM-Richtlinie verwendet werden können. Die Liste darf keine doppelten Elemente enthalten und muss mindestens ein Element enthalten. Die Dienste müssen sich am selben Ort wie die SIM-Richtlinie befinden.
dataNetwork

DataNetworkResourceId

Ein Verweis auf das Datennetzwerk, für das diese Einstellungen gelten. Das Datennetzwerk muss sich am gleichen Ort wie die SIM-Richtlinie befinden.
defaultSessionType

PduSessionType

IPv4

Der Standard-PDU-Sitzungstyp, der verwendet wird, wenn die UE keinen bestimmten Sitzungstyp angibt.
maximumNumberOfBufferedPackets

integer

10

Die maximale Anzahl von Downlinkpaketen, die auf Benutzerebene für die Kommunikation mit hoher Latenz – erweiterte Pufferung gepuffert werden sollen. Eine vollständige Beschreibung finden Sie unter 3GPP TS29.272 v15.10.0, Abschnitt 7.3.188. Dieser Höchstwert ist nicht garantiert, da für gepufferte Pakete in allen PDU-Sitzungen ein internes Limit gilt.
preemptionCapability

PreemptionCapability

NotPreempt

Standardmäßige QoS-Flow-Funktion zur Vorzeitigen Entfernung. 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

Sicherheitsanfälligkeit beim Standardmäßigen QoS-Flow bei vorzeitiger Entfernung. Die Sicherheitslücke vor der Entfernung eines QoS-Flusses steuert, ob er von einem QoS-Flow mit einer höheren Prioritätsstufe vorzeitig entfernt werden kann. Eine vollständige Beschreibung der ARP-Parameter finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.2.
sessionAmbr

Ambr

Aggregieren der maximalen Bitrate für alle QoS-Flows ohne GBR einer bestimmten PDU-Sitzung. Eine vollständige Beschreibung des Session-AMBR finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.6.

DataNetworkResourceId

Verweis auf eine Datennetzwerkressource.

Name Typ Beschreibung
id

string

Ressourcen-ID des Datennetzwerks.

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.

PduSessionType

PDU-Sitzungstyp (IPv4/IPv6).

Name Typ Beschreibung
IPv4

string

IPv6

string

PreemptionCapability

Vorzeitige Entfernungsfunktion.

Name Typ Beschreibung
MayPreempt

string

Kann vorzeitig entfernt werden
NotPreempt

string

Kann nicht vorzeitig entfernt werden.

PreemptionVulnerability

Sicherheitsrisiko bei vorzeitiger Entfernung.

Name Typ Beschreibung
NotPreemptable

string

Kann nicht vorzeitig entfernt 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

ServiceResourceId

Verweis auf eine Dienstressource.

Name Typ Beschreibung
id

string

Dienstressourcen-ID.

SimPolicy

SIM-Richtlinienressource.

Name Typ Standardwert Beschreibung
id

string

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

string

Der geografische Standort, an dem sich die Ressource befindet
name

string

Der Name der Ressource
properties.defaultSlice

SliceResourceId

Der Standardslice, der verwendet werden soll, wenn die UE es nicht explizit angibt. Dieser Slice muss in der sliceConfigurations Zuordnung vorhanden sein. Der Slice muss sich am gleichen Speicherort wie die SIM-Richtlinie befinden.
properties.provisioningState

ProvisioningState

Der Bereitstellungsstatus der SIM-Richtlinienressource.
properties.registrationTimer

integer

3240

UE Periodische Registrierungsaktualisierungstimer (5G) oder UE periodische Aktualisierungsbereichsupdatetimer (4G) in Sekunden.
properties.rfspIndex

integer

RAT/Frequency Selection Priority Index, definiert in 3GPP TS 36.413. Dies ist eine optionale Einstellung, die standardmäßig nicht angegeben ist.
properties.siteProvisioningState

object

Ein Wörterbuch der Websites zum Bereitstellungsstatus dieser SIM-Richtlinie auf dieser Website.
properties.sliceConfigurations

SliceConfiguration[]

Die zulässigen Slices und die Einstellungen, die für sie verwendet werden sollen. Die Liste darf keine doppelten Elemente enthalten und muss mindestens ein Element enthalten.
properties.ueAmbr

Ambr

Aggregieren der maximalen Bitrate für alle QoS-Flows ohne GBR aller PDU-Sitzungen einer bestimmten UE. Eine vollständige Beschreibung der UE-AMBR finden Sie unter 3GPP TS23.501, Abschnitt 5.7.2.6.
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"

SliceConfiguration

Einstellungen pro Slice

Name Typ Beschreibung
dataNetworkConfigurations

DataNetworkConfiguration[]

Die zulässigen Datennetzwerke und die Einstellungen, die für sie verwendet werden sollen. Die Liste darf keine doppelten Elemente enthalten und muss mindestens ein Element enthalten.
defaultDataNetwork

DataNetworkResourceId

Das Standarddatennetzwerk, das verwendet werden soll, wenn die UE es nicht explizit angibt. Die Konfiguration für dieses Objekt muss in der dataNetworkConfigurations Zuordnung vorhanden sein. Das Datennetzwerk muss sich am gleichen Ort wie die SIM-Richtlinie befinden.
slice

SliceResourceId

Ein Verweis auf den Slice, auf den diese Einstellungen angewendet werden. Der Slice muss sich am gleichen Speicherort wie die SIM-Richtlinie befinden.

SliceResourceId

Verweis auf eine Sliceressource.

Name Typ Beschreibung
id

string

Slice-Ressourcen-ID.

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.