Sim Policies - Create Or Update

Tworzy lub aktualizuje zasady SIM.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MobileNetwork/mobileNetworks/{mobileNetworkName}/simPolicies/{simPolicyName}?api-version=2022-04-01-preview

Parametry identyfikatora URI

Name In Required Type Description
mobileNetworkName
path True
  • string

Nazwa sieci komórkowej.

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

resourceGroupName
path True
  • string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

simPolicyName
path True
  • string

Nazwa zasad SIM.

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

subscriptionId
path True
  • string

Identyfikator subskrypcji docelowej.

api-version
query True
  • string

Wersja interfejsu API do użycia na potrzeby tej operacji.

Treść żądania

Name Required Type Description
location True
  • string

Lokalizacja geograficzna, w której znajduje się zasób

properties.defaultSlice True

Domyślny wycinek, który ma być używany, jeśli ue nie określa go jawnie. Ten wycinek musi istnieć na mapie sliceConfigurations .

properties.sliceConfigurations True

Dozwolone wycinki i ustawienia do użycia dla nich. Lista nie może zawierać zduplikowanych elementów i musi zawierać co najmniej jeden element.

properties.ueAmbr True

Zagreguj maksymalną szybkość bitów dla wszystkich przepływów QoS innych niż GBR wszystkich sesji pdU danego ue. Aby uzyskać pełny opis ue-AMBR, zobacz sekcję 3GPP TS23.501 5.7.2.6.

properties.registrationTimer
  • integer

Interwał okresowej procedury aktualizacji rejestracji ue w sekundach.

properties.rfspIndex
  • integer

Indeks priorytetu wyboru rat/częstotliwości zdefiniowany w 3GPP TS 36.413. Jest to ustawienie opcjonalne i domyślnie nie jest określone.

systemData.createdAt
  • string

Sygnatura czasowa tworzenia zasobów (UTC).

systemData.createdBy
  • string

Tożsamość, która utworzyła zasób.

systemData.createdByType

Typ tożsamości, która utworzyła zasób.

systemData.lastModifiedAt
  • string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

systemData.lastModifiedBy
  • string

Tożsamość, która ostatnio zmodyfikowała zasób.

systemData.lastModifiedByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

tags
  • object

Tagi zasobów.

Odpowiedzi

Name Type Description
200 OK

Aktualizacja powiodła się. Operacja zwraca wynikowy zasób zasad SIM.

201 Created

Tworzenie powiodło się. Operacja zwraca wynikowy zasób zasad SIM.

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

Create SIM policy

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/simPolicies/testPolicy?api-version=2022-04-01-preview

{
  "location": "eastus",
  "properties": {
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}

Sample Response

{
  "name": "testPolicy",
  "id": "/subscriptions/subid/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",
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}
{
  "name": "testPolicy",
  "id": "/subscriptions/subid/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": "Accepted",
    "registrationTimer": 3240,
    "ueAmbr": {
      "uplink": "500 Mbps",
      "downlink": "1 Gbps"
    },
    "defaultSlice": {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
    },
    "sliceConfigurations": [
      {
        "slice": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/slices/testSlice"
        },
        "defaultDataNetwork": {
          "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/dataNetworks/testdataNetwork"
        },
        "dataNetworkConfigurations": [
          {
            "dataNetwork": {
              "id": "/subscriptions/subid/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/subid/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/testService"
              }
            ]
          }
        ]
      }
    ]
  }
}

Definicje

Ambr

Agregacja maksymalnej szybkości bitów.

createdByType

Typ tożsamości, która utworzyła zasób.

DataNetworkConfiguration

Ustawienia kontrolujące użycie sieci danych

DataNetworkResourceId

Odwołanie do zasobu sieciowego danych.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

PduSessionType

Typ sesji pdU (IPv4/IPv6).

PreemptionCapability

Możliwość wywłaszczania.

PreemptionVulnerability

Luka w zabezpieczeniach dotycząca wywłaszczania.

ProvisioningState

Bieżący stan aprowizacji.

ServiceResourceId

Odwołanie do zasobu usługi.

SimPolicy

Zasób zasad SIM.

SliceConfiguration

Ustawienia poszczególnych wycinków

SliceResourceId

Odwołanie do zasobu wycinka.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Ambr

Agregacja maksymalnej szybkości bitów.

Name Type Description
downlink
  • string

Szybkość bitów pasma.

uplink
  • string

Szybkość połączenia bitowego.

createdByType

Typ tożsamości, która utworzyła zasób.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

DataNetworkConfiguration

Ustawienia kontrolujące użycie sieci danych

Name Type Default Value Description
5qi
  • integer
9

Domyślna wartość wskaźnika QoS przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Nie może to być ustandaryzowana wartość 5QI odpowiadająca przepływowi QoS GBR (gwarantowana szybkość bitów). Niedozwolone wartości GBR 5QI to: 1, 2, 3, 4, 65, 66, 67, 71, 72, 73, 74, 75, 76, 82, 83, 84 i 85. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabelę 5.7.4-1, aby uzyskać definicję wartości GBR 5QI.

additionalAllowedSessionTypes
  • string[]

Dozwolone typy sesji oprócz domyślnego typu sesji. Nie może duplikować domyślnego typu sesji.

allocationAndRetentionPriorityLevel
  • integer
9

Domyślny poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym priorytcie, jeśli ustawienia preemptionCapability i preemptionVulnerability zezwalają na nie. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyte do uzyskania wartości ARP. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.

allowedServices

Lista usług, które mogą być używane w ramach tych zasad SIM. Lista nie może zawierać zduplikowanych elementów i musi zawierać co najmniej jeden element.

dataNetwork

Odwołanie do sieci danych, do których mają zastosowanie te ustawienia

defaultSessionType IPv4

Domyślny typ sesji pdU, który jest używany, jeśli UE nie żąda określonego typu sesji.

preemptionCapability NotPreempt

Domyślna możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wywłaszczać inny przepływ QoS z niższym priorytetem. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.

preemptionVulnerability Preemptable

Domyślna luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS. Luka w zabezpieczeniach dotycząca wywłaszczania przepływu QoS steruje tym, czy może zostać wywłaszczone przez przepływ QoS z wyższym poziomem priorytetu. Aby uzyskać pełny opis parametrów protokołu ARP, zobacz sekcję 3GPP TS23.501 5.7.2.2.

sessionAmbr

Zagreguj maksymalną szybkość bitów we wszystkich przepływach QoS innych niż GBR danej sesji pdU. Zobacz sekcję 3GPP TS23.501 5.7.2.6, aby uzyskać pełny opis sesji-AMBR.

DataNetworkResourceId

Odwołanie do zasobu sieciowego danych.

Name Type Description
id
  • string

Identyfikator zasobu sieciowego danych.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Name Type Description
info
  • object

Dodatkowe informacje.

type
  • string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Name Type Description
additionalInfo

Dodatkowe informacje o błędzie.

code
  • string

Kod błędu.

details

Szczegóły błędu.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Name Type Description
error

Obiekt error.

PduSessionType

Typ sesji pdU (IPv4/IPv6).

Name Type Description
IPv4
  • string
IPv6
  • string

PreemptionCapability

Możliwość wywłaszczania.

Name Type Description
MayPreempt
  • string

Może wywłaszczać

NotPreempt
  • string

Nie można wywłaszczyć

PreemptionVulnerability

Luka w zabezpieczeniach dotycząca wywłaszczania.

Name Type Description
NotPreemptable
  • string

Nie można wywłaszać

Preemptable
  • string

Może zostać wywłaszczone

ProvisioningState

Bieżący stan aprowizacji.

Name Type Description
Accepted
  • string
Canceled
  • string
Deleted
  • string
Deleting
  • string
Failed
  • string
Succeeded
  • string
Unknown
  • string

ServiceResourceId

Odwołanie do zasobu usługi.

Name Type Description
id
  • string

Identyfikator zasobu usługi.

SimPolicy

Zasób zasad SIM.

Name Type Default Value Description
id
  • string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location
  • string

Lokalizacja geograficzna, w której znajduje się zasób

name
  • string

Nazwa zasobu

properties.defaultSlice

Domyślny wycinek, który ma być używany, jeśli ue nie określa go jawnie. Ten wycinek musi istnieć na mapie sliceConfigurations .

properties.provisioningState

Stan aprowizacji zasobu zasad SIM.

properties.registrationTimer
  • integer
3240

Interwał okresowej procedury aktualizacji rejestracji ue w sekundach.

properties.rfspIndex
  • integer

Indeks priorytetu wyboru rat/częstotliwości zdefiniowany w 3GPP TS 36.413. Jest to ustawienie opcjonalne i domyślnie nie jest określone.

properties.sliceConfigurations

Dozwolone wycinki i ustawienia do użycia dla nich. Lista nie może zawierać zduplikowanych elementów i musi zawierać co najmniej jeden element.

properties.ueAmbr

Zagreguj maksymalną szybkość bitów dla wszystkich przepływów QoS innych niż GBR wszystkich sesji pdU danego ue. Aby uzyskać pełny opis ue-AMBR, zobacz sekcję 3GPP TS23.501 5.7.2.6.

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

systemData.createdAt
  • string

Sygnatura czasowa tworzenia zasobów (UTC).

systemData.createdBy
  • string

Tożsamość, która utworzyła zasób.

systemData.createdByType

Typ tożsamości, która utworzyła zasób.

systemData.lastModifiedAt
  • string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

systemData.lastModifiedBy
  • string

Tożsamość, która ostatnio zmodyfikowała zasób.

systemData.lastModifiedByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.

tags
  • object

Tagi zasobów.

type
  • string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

SliceConfiguration

Ustawienia poszczególnych wycinków

Name Type Description
dataNetworkConfigurations

Dozwolone sieci danych i ustawienia do użycia dla nich. Lista nie może zawierać zduplikowanych elementów i musi zawierać co najmniej jeden element.

defaultDataNetwork

Domyślna sieć danych, która ma być używana, jeśli ue nie określi jej jawnie. Konfiguracja tego obiektu musi istnieć na mapie dataNetworkConfigurations .

slice

Odwołanie do wycinka, do którego mają zastosowanie te ustawienia

SliceResourceId

Odwołanie do zasobu wycinka.

Name Type Description
id
  • string

Identyfikator zasobu fragmentatora.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Name Type Description
createdAt
  • string

Sygnatura czasowa tworzenia zasobów (UTC).

createdBy
  • string

Tożsamość, która utworzyła zasób.

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt
  • string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy
  • string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.