Sdílet prostřednictvím

Sim Policies - Create Or Update

  • Reference
Služba:
Mobile Network
Verze rozhraní API:
2024-04-01

Vytvoří nebo aktualizuje zásady SIM karty. 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}/simPolicies/{simPolicyName}?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.
simPolicyName
 path True

string

Název zásady SIM karty.

Vzor regulárního výrazu: ^[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í, ve kterém se nachází prostředek
properties.defaultSlice True

SliceResourceId

Výchozí řez, který se má použít, pokud ho uživatelské prostředí explicitně nezadá. Tento řez musí existovat v mapě sliceConfigurations . Řez musí být ve stejném umístění jako zásady SIM karty.
properties.sliceConfigurations True

SliceConfiguration[]

Povolené řezy a nastavení, která se pro ně mají použít. Seznam nesmí obsahovat duplicitní položky a musí obsahovat alespoň jednu položku.
properties.ueAmbr True

Ambr

Agregovat maximální přenosovou rychlost napříč všemi toky QoS, které nejsou GBR, ve všech relacích pdu daného uživatelského prostředí. Úplný popis UE-AMBR najdete v článku 3GPP TS23.501 v části 5.7.2.6.
properties.registrationTimer

integer

Časovač pravidelné aktualizace registrace uživatele (5G) nebo časovač aktualizace oblasti pravidelného sledování UE (4G) v sekundách.
properties.rfspIndex

integer

Rat/Frequency Selection Priority Index, definovaný v 3GPP TS 36.413. Toto nastavení je volitelné a ve výchozím nastavení není zadané.
tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

SimPolicy

Aktualizace byla úspěšná. Operace vrátí výsledný prostředek zásad SIM karty.
201 Created

SimPolicy

Create úspěšné. Operace vrátí výsledný prostředek zásad SIM karty.
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 SIM policy

Ukázkový požadavek

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
          }
        ]
      }
    ]
  }
}

Ukázková odpověď

Stavový kód:
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
          }
        ]
      }
    ]
  }
}
Stavový kód:
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
          }
        ]
      }
    ]
  }
}

Definice

Name Description
Ambr

Agregovat maximální přenosovou rychlost.
createdByType

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

Nastavení, která řídí použití datové sítě
DataNetworkResourceId

Odkaz na prostředek datové sítě.
ErrorAdditionalInfo

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

Podrobnosti o chybě.
ErrorResponse

Odpověď na chybu
PduSessionType

Typ relace PDU (IPv4/IPv6).
PreemptionCapability

Možnost preempce.
PreemptionVulnerability

Ohrožení zabezpečení z preempce.
ProvisioningState

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

Odkaz na prostředek služby.
SimPolicy

Prostředek zásad SIM karty.
SliceConfiguration

Nastavení jednotlivých řezů
SliceResourceId

Odkaz na prostředek řezu.
systemData

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

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á vytvořila prostředek.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataNetworkConfiguration

Nastavení, která řídí použití datové sítě

Name Typ Default value Description
5qi

integer

9

Výchozí hodnota ukazatele toku QoS 5G 5QI identifikuje konkrétní metodu předávání QoS, která se má poskytnout toku. Úplný popis parametru 5QI najdete v článku 3GPP TS23.501 v části 5.7.2.1 a v tabulce 5.7.4-1 pro definici hodnot 5QI.
additionalAllowedSessionTypes

PduSessionType[]

Povolené typy relací kromě výchozího typu relace. Výchozí typ relace nesmí duplikovat.
allocationAndRetentionPriorityLevel

integer

9

Výchozí úroveň priority ARP (ARP) toku QoS. Toky s vyšší prioritou preempt toky s nižší prioritou, pokud to nastavení preemptionCapability a preemptionVulnerability umožňují. 1 je nejvyšší úroveň priority. Pokud toto pole není zadáno, 5qi použije se k odvození hodnoty ARP. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2.
allowedServices

ServiceResourceId[]

Seznam služeb, které je možné použít jako součást těchto zásad SIM. Seznam nesmí obsahovat duplicitní položky a musí obsahovat alespoň jednu položku. Služby musí být ve stejném umístění jako zásady SIM karty.
dataNetwork

DataNetworkResourceId

Odkaz na datovou síť, na kterou se tato nastavení vztahují. Datová síť musí být ve stejném umístění jako zásady SIM karty.
defaultSessionType

PduSessionType

IPv4

Výchozí typ relace pdu, který se používá, pokud uživatelské prostředí nevyžaduje konkrétní typ relace.
maximumNumberOfBufferedPackets

integer

10

Maximální počet paketů downlinku, které se mají ukládat do vyrovnávací paměti v rovině uživatele pro komunikaci s vysokou latencí – rozšířené ukládání do vyrovnávací paměti. Úplný popis najdete v článku 3GPP TS29.272 v15.10.0 bodě 7.3.188. Toto maximum není zaručeno, protože existuje interní limit pro pakety ve vyrovnávací paměti ve všech relacích PDU.
preemptionCapability

PreemptionCapability

NotPreempt

Výchozí funkce preempce toku QoS Funkce preempce toku QoS určuje, jestli může předejde jinému toku QoS s nižší úrovní priority. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2.
preemptionVulnerability

PreemptionVulnerability

Preemptable

Výchozí ohrožení zabezpečení preempce toku QoS Ohrožení zabezpečení preempce toku QoS určuje, jestli ji může předcházet tok QoS s vyšší úrovní priority. Úplný popis parametrů ARP najdete v článku 3GPP TS23.501 v části 5.7.2.2.
sessionAmbr

Ambr

Agregovat maximální přenosovou rychlost napříč všemi toky QoS mimo GBR dané relace primárního procesoru. Úplný popis session-AMBR najdete v článku 3GPP TS23.501 v části 5.7.2.6.

DataNetworkResourceId

Odkaz na prostředek datové sítě.

Name Typ Description
id

string

ID prostředku datové sítě.

ErrorAdditionalInfo

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

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

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

Odpověď na chybu

Name Typ Description
error

ErrorDetail

Objekt chyby.

PduSessionType

Typ relace PDU (IPv4/IPv6).

Name Typ Description
IPv4

string

IPv6

string

PreemptionCapability

Možnost preempce.

Name Typ Description
MayPreempt

string

Může být preempt
NotPreempt

string

Nelze provést

PreemptionVulnerability

Ohrožení zabezpečení z preempce.

Name Typ Description
NotPreemptable

string

Nelze ho předeptovat.
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

ServiceResourceId

Odkaz na prostředek služby.

Name Typ Description
id

string

ID prostředku služby.

SimPolicy

Prostředek zásad SIM karty.

Name Typ Default value Description
id

string

Plně kvalifikované ID prostředku. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location

string

Geografické umístění, ve kterém se nachází prostředek
name

string

Název prostředku
properties.defaultSlice

SliceResourceId

Výchozí řez, který se má použít, pokud ho uživatelské prostředí explicitně nezadá. Tento řez musí existovat v mapě sliceConfigurations . Řez musí být ve stejném umístění jako zásady SIM karty.
properties.provisioningState

ProvisioningState

Stav zřizování prostředku zásad SIM.
properties.registrationTimer

integer

3240

Časovač pravidelné aktualizace registrace uživatele (5G) nebo časovač aktualizace oblasti pravidelného sledování UE (4G) v sekundách.
properties.rfspIndex

integer

Rat/Frequency Selection Priority Index, definovaný v 3GPP TS 36.413. Toto nastavení je volitelné a ve výchozím nastavení není zadané.
properties.siteProvisioningState

object

Slovník webů do stavu zřizování této zásady SIM na daném webu.
properties.sliceConfigurations

SliceConfiguration[]

Povolené řezy a nastavení, která se pro ně mají použít. Seznam nesmí obsahovat duplicitní položky a musí obsahovat alespoň jednu položku.
properties.ueAmbr

Ambr

Agregovat maximální přenosovou rychlost napříč všemi toky QoS, které nejsou GBR, ve všech relacích pdu daného uživatelského prostředí. Úplný popis UE-AMBR najdete v článku 3GPP TS23.501 v části 5.7.2.6.
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

SliceConfiguration

Nastavení jednotlivých řezů

Name Typ Description
dataNetworkConfigurations

DataNetworkConfiguration[]

Povolené datové sítě a nastavení, která se pro ně mají použít. Seznam nesmí obsahovat duplicitní položky a musí obsahovat alespoň jednu položku.
defaultDataNetwork

DataNetworkResourceId

Výchozí datová síť, která se má použít, pokud ji uživatelské prostředí explicitně nezadá. Konfigurace pro tento objekt musí existovat v mapě dataNetworkConfigurations . Datová síť musí být ve stejném umístění jako zásady SIM karty.
slice

SliceResourceId

Odkaz na řez, na který se tato nastavení vztahují. Řez musí být ve stejném umístění jako zásady SIM karty.

SliceResourceId

Odkaz na prostředek řezu.

Name Typ Description
id

string

ID prostředku řezu.

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á prostředek vytvořila.
createdByType

createdByType

Typ identity, která vytvořila prostředek.
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.