共用方式為

Sim Policies - Get

  • 參考
服務:
Mobile Network
API 版本:
2024-04-01

取得指定 SIM 卡原則的相關信息。

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

URI 參數

名稱 位於 必要 類型 Description
mobileNetworkName
 path True

string

行動網路的名稱。

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
resourceGroupName
 path True

string

資源群組的名稱。 名稱不區分大小寫。
simPolicyName
 path True

string

SIM 原則的名稱。

Regex 模式: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

目標訂用帳戶的標識碼。 此值必須是 UUID。
api-version
 query True

string

用於此作業的 API 版本。

回應

名稱 類型 Description
200 OK

SimPolicy

要求成功。 作業會傳回產生的 SIM 原則資源。
Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
user_impersonation 模擬您的用戶帳戶

範例

Get SIM policy

範例要求

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

範例回覆

狀態碼:
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": "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
          }
        ]
      }
    ]
  }
}

定義

名稱 Description
Ambr

匯總最大比特率。
createdByType

建立資源的身分識別類型。
DataNetworkConfiguration

控制數據網路使用的設定
DataNetworkResourceId

數據網路資源的參考。
ErrorAdditionalInfo

資源管理錯誤其他資訊。
ErrorDetail

錯誤詳細數據。
ErrorResponse

錯誤回應
PduSessionType

PDU 會話類型 (IPv4/IPv6) 。
PreemptionCapability

先占功能。
PreemptionVulnerability

先占弱點。
ProvisioningState

目前的布建狀態。
ServiceResourceId

服務資源的參考。
SimPolicy

SIM 卡原則資源。
SliceConfiguration

個別配量設定
SliceResourceId

配量資源的參考。
systemData

與建立和上次修改資源相關的元數據。

Ambr

匯總最大比特率。

名稱 類型 Description
downlink

string

下行連結位速率。
uplink

string

上行連結位速率。

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

DataNetworkConfiguration

控制數據網路使用的設定

名稱 類型 預設值 Description
5qi

integer

9

預設的 5G QoS 流量指標值。 5QI 會識別要提供給流程的特定 QoS 轉送處理。 如需 5QI 參數的完整描述，請參閱 3GPP TS23.501 節 5.7.2.1，如需 5QI 值的定義，請參閱 5.7.4-1。
additionalAllowedSessionTypes

PduSessionType[]

除了預設會話類型之外，允許的會話類型。 不得複製預設會話類型。
allocationAndRetentionPriorityLevel

integer

9

ARP) 層級 (預設 QoS 流量配置和保留優先順序。 如果的設定 preemptionCapability 允許， preemptionVulnerability 具有較高優先順序的流程優先處理流程。1 是優先順序最高的層級。 如果未指定此欄位，則會 5qi 用來衍生 ARP 值。 如需 ARP 參數的完整描述，請參閱 3GPP TS23.501 節 5.7.2.2。
allowedServices

ServiceResourceId[]

可作為此 SIM 卡原則一部分的服務清單。 清單不得包含重複的專案，而且必須至少包含一個專案。 服務必須位於與 SIM 卡原則相同的位置。
dataNetwork

DataNetworkResourceId

這些設定所套用之數據網路的參考。 數據網路必須與 SIM 卡原則位於相同的位置。
defaultSessionType

PduSessionType

IPv4

默認的 PDU 工作話類型，如果 UE 未要求特定工作階段類型，則會使用這個類型。
maximumNumberOfBufferedPackets

integer

10

高延遲通訊 - 擴充緩衝的使用者平面上要緩衝的下行連結封包數目上限。 如需完整描述，請參閱 3GPP TS29.272 v15.10.0 一節 7.3.188。 無法保證此最大值，因為所有 PDU 工作階段的緩衝封包有內部限制。
preemptionCapability

PreemptionCapability

NotPreempt

預設 QoS 流程先佔功能。 QoS 流程的先佔功能可控制其是否可以優先於優先順序較低的另一個 QoS 流程。 如需 ARP 參數的完整描述，請參閱 3GPP TS23.501 節 5.7.2.2。
preemptionVulnerability

PreemptionVulnerability

Preemptable

預設 QoS 流程先占弱點。 QoS 流程的先佔弱點可控制 QoS 流程是否可以優先取用優先順序較高的 QoS 流程。 如需 ARP 參數的完整描述，請參閱 3GPP TS23.501 節 5.7.2.2。
sessionAmbr

Ambr

匯總指定 PDU 會話所有非 GBR QoS 流程的最大比特率。 如需 Session-AMBR 的完整描述，請參閱 3GPP TS23.501 節 5.7.2.6。

DataNetworkResourceId

數據網路資源的參考。

名稱 類型 Description
id

string

數據網路資源標識碼。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。
type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
code

string

錯誤碼。
details

ErrorDetail[]

錯誤詳細資料。
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

PduSessionType

PDU 會話類型 (IPv4/IPv6) 。

名稱 類型 Description
IPv4

string

IPv6

string

PreemptionCapability

先占功能。

名稱 類型 Description
MayPreempt

string

5 月優先
NotPreempt

string

無法先佔

PreemptionVulnerability

先占弱點。

名稱 類型 Description
NotPreemptable

string

無法先佔
Preemptable

string

可能先佔

ProvisioningState

目前的布建狀態。

名稱 類型 Description
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

ServiceResourceId

服務資源的參考。

名稱 類型 Description
id

string

服務資源標識碼。

SimPolicy

SIM 卡原則資源。

名稱 類型 預設值 Description
id

string

資源的完整資源識別碼。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location

string

資源所在的地理位置
name

string

資源的名稱
properties.defaultSlice

SliceResourceId

如果 UE 未明確指定，要使用的預設配量。 此配量必須存在於地圖中 sliceConfigurations 。 配量必須位於與 SIM 卡原則相同的位置。
properties.provisioningState

ProvisioningState

SIM 原則資源的布建狀態。
properties.registrationTimer

integer

3240

UE 定期註冊更新定時器 (5G) 或 UE 定期追蹤區域更新定時器，以秒為單位 (4G) 。
properties.rfspIndex

integer

在 3GPP TS 36.413 中定義的 RAT/頻率選取優先順序索引。 這是選擇性設定，預設為未指定。
properties.siteProvisioningState

object

月臺字典，指向該站臺上此 SIM 卡原則的布建狀態。
properties.sliceConfigurations

SliceConfiguration[]

允許的配量和要用於它們的設定。 清單不得包含重複的專案，而且必須至少包含一個專案。
properties.ueAmbr

Ambr

匯總指定 UE 所有 PDU 工作階段之所有非 GBR QoS 流程的最大比特率。 如需 UE-AMBR 的完整描述，請參閱 3GPP TS23.501 節 5.7.2.6。
systemData

systemData

Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。
tags

object

資源標籤。
type

string

資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

SliceConfiguration

個別配量設定

名稱 類型 Description
dataNetworkConfigurations

DataNetworkConfiguration[]

允許的數據網路和用於它們的設定。 清單不得包含重複的專案，而且必須至少包含一個專案。
defaultDataNetwork

DataNetworkResourceId

如果 UE 未明確指定，要使用的預設數據網路。 此物件的組態必須存在於對應中 dataNetworkConfigurations 。 數據網路必須與 SIM 卡原則位於相同的位置。
slice

SliceResourceId

這些設定所套用配量的參考。 配量必須位於與 SIM 卡原則相同的位置。

SliceResourceId

配量資源的參考。

名稱 類型 Description
id

string

配量資源標識碼。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。
createdBy

string

建立資源的身分識別。
createdByType

createdByType

建立資源的身分識別類型。
lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。
lastModifiedByType

createdByType

上次修改資源的身分識別類型。