Udostępnij za pośrednictwem


Sim Policies - Get

Pobiera informacje o określonych zasadach SIM.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
mobileNetworkName
path True

string

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

Nazwa sieci komórkowej.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

simPolicyName
path True

string

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

Nazwa zasad SIM.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

SimPolicy

Żądanie powiodło się. Operacja zwraca wynikowy zasób zasad SIM.

Other Status Codes

ErrorResponse

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

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

Get SIM policy

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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": "Accepted",
    "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
          }
        ]
      }
    ]
  }
}

Definicje

Nazwa Opis
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 fragmentatora.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Ambr

Agregacja maksymalnej szybkości bitów.

Nazwa Typ Opis
downlink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

Szybkość ściągnięć bitów.

uplink

string

pattern: ^\d+(\.\d+)? (bps|Kbps|Mbps|Gbps|Tbps)$

Szybkość pasma bitów.

createdByType

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

Wartość Opis
Application
Key
ManagedIdentity
User

DataNetworkConfiguration

Ustawienia kontrolujące użycie sieci danych

Nazwa Typ Domyślna wartość Opis
5qi

integer (int32)

minimum: 0
maximum: 255
9

Domyślna wartość wskaźnika przepływu QoS 5G. 5QI identyfikuje konkretne leczenie przekazywania QoS, które ma zostać dostarczone do przepływu. Zobacz sekcję 3GPP TS23.501 5.7.2.1, aby uzyskać pełny opis parametru 5QI i tabeli 5.7.4-1, aby uzyskać definicję wartości 5QI.

additionalAllowedSessionTypes

PduSessionType[]

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

allocationAndRetentionPriorityLevel

integer (int32)

minimum: 1
maximum: 15
9

Domyślny poziom alokacji i przechowywania przepływu QoS (ARP). Przepływy z wywłaszczanym priorytetem przepływy o niższym prioryfiksie, jeśli zezwalają na to ustawienia preemptionCapability i preemptionVulnerability. 1 jest najwyższym poziomem priorytetu. Jeśli to pole nie zostanie określone, 5qi zostanie użyta 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

ServiceResourceId[]

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. Usługi muszą znajdować się w tej samej lokalizacji co zasady sim.

dataNetwork

DataNetworkResourceId

Odwołanie do sieci danych, do których mają zastosowanie te ustawienia. Sieć danych musi znajdować się w tej samej lokalizacji co zasady sim.

defaultSessionType

PduSessionType

IPv4

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

maximumNumberOfBufferedPackets

integer (int32)

minimum: 0
10

Maksymalna liczba pakietów pasma do buforowania na płaszczyźnie użytkownika dla komunikacji o dużym opóźnieniu — rozszerzone buforowanie. Pełny opis zawiera sekcja 3GPP TS29.272 v15.10.0 7.3.188. Ta wartość maksymalna nie jest gwarantowana, ponieważ istnieje wewnętrzny limit dla buforowanych pakietów we wszystkich sesjach pdU.

preemptionCapability

PreemptionCapability

NotPreempt

Domyślna możliwość wywłaszczania przepływu QoS. Możliwość wywłaszczania przepływu QoS steruje tym, czy może wyprzedać 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

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

Ambr

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

DataNetworkResourceId

Odwołanie do zasobu sieciowego danych.

Nazwa Typ Opis
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[dD][aA][tT][aA][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+$

Identyfikator zasobu sieci danych.

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

PduSessionType

Typ sesji PDU (IPv4/IPv6).

Wartość Opis
IPv4
IPv6

PreemptionCapability

Możliwość wywłaszczania.

Wartość Opis
MayPreempt

Może przewłaszczać

NotPreempt

Nie można wyprzedać

PreemptionVulnerability

Luka w zabezpieczeniach dotycząca wywłaszczania.

Wartość Opis
NotPreemptable

Nie można wywłaszać

Preemptable

Może zostać wywłaszczone

ProvisioningState

Bieżący stan aprowizacji.

Wartość Opis
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

ServiceResourceId

Odwołanie do zasobu usługi.

Nazwa Typ Opis
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][eE][rR][vV][iI][cC][eE][sS]/[^/?#]+$

Identyfikator zasobu usługi.

SimPolicy

Zasób zasad SIM.

Nazwa Typ Domyślna wartość Opis
id

string (arm-id)

W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/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

SliceResourceId

Domyślny wycinek, który ma być używany, jeśli ue nie określa go jawnie. Ten wycinek musi istnieć na mapie sliceConfigurations. Wycinek musi znajdować się w tej samej lokalizacji co zasady sim.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu zasad SIM.

properties.registrationTimer

integer (int32)

minimum: 30
3240

Czasomierz okresowych aktualizacji rejestracji UE (5G) lub czasomierz okresowych aktualizacji obszaru śledzenia UE (4G), w sekundach.

properties.rfspIndex

integer (int32)

minimum: 1
maximum: 256

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

object

Słownik witryn do stanu aprowizacji tych zasad SIM w tej witrynie.

properties.sliceConfigurations

SliceConfiguration[]

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

Ambr

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

systemData

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

tags

object

Tagi zasobów.

type

string

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

SliceConfiguration

Ustawienia poszczególnych wycinków

Nazwa Typ Opis
dataNetworkConfigurations

DataNetworkConfiguration[]

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

DataNetworkResourceId

Domyślna sieć danych, która ma być używana, jeśli ue nie określa jej jawnie. Konfiguracja tego obiektu musi istnieć na mapie dataNetworkConfigurations. Sieć danych musi znajdować się w tej samej lokalizacji co zasady sim.

slice

SliceResourceId

Odwołanie do wycinka, do którego mają zastosowanie te ustawienia. Wycinek musi znajdować się w tej samej lokalizacji co zasady sim.

SliceResourceId

Odwołanie do zasobu fragmentatora.

Nazwa Typ Opis
id

string

pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][lL][iI][cC][eE][sS]/[^/?#]+$

Identyfikator zasobu fragmentatora.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

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

createdByType

createdByType

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

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

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

lastModifiedByType

createdByType

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