次の方法で共有

Sim Policies - Create Or Update

  • リファレンス
サービス:
Mobile Network
API バージョン:
2024-04-01

SIM ポリシーを作成または更新します。 親モバイル ネットワークと同じ場所に作成する必要があります。

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

URI パラメーター

名前 / 必須 型 説明
mobileNetworkName
 path True

string

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

モバイル ネットワークの名前。
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前では大文字と小文字が区別されません。
simPolicyName
 path True

string

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

SIM ポリシーの名前。
subscriptionId
 path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。
api-version
 query True

string

minLength: 1

この操作に使用する API バージョン。

要求本文

名前 必須 型 説明
location True

string

リソースが存在する地理的な場所
properties.defaultSlice True

SliceResourceId

UE で明示的に指定されていない場合に使用する既定のスライス。 このスライスは、sliceConfigurations マップに存在する必要があります。 スライスは、SIM ポリシーと同じ場所にある必要があります。
properties.sliceConfigurations True

SliceConfiguration[]

許可されているスライスと、それらに使用する設定。 リストに重複するアイテムを含めず、少なくとも 1 つの項目を含む必要があります。
properties.ueAmbr True

Ambr

特定の UE のすべての PDU セッションのすべての非 GBR QoS フローの最大ビット レートを集計します。 UE-AMBR の完全な説明については、3GPP TS23.501 セクション 5.7.2.6 を参照してください。
properties.registrationTimer

integer (int32)

minimum: 30

UE 定期登録更新タイマー (5G) または UE 定期追跡領域更新タイマー (4G)、秒単位。
properties.rfspIndex

integer (int32)

minimum: 1
maximum: 256

RAT/Frequency Selection Priority Index(3GPP TS 36.413 で定義)。 これは省略可能な設定であり、既定では指定されていません。
tags

object

リソース タグ。

応答

名前 型 説明
200 OK

SimPolicy

更新が成功しました。 この操作は、結果として得られる SIM ポリシー リソースを返します。
201 Created

SimPolicy

正常に作成されます。 この操作は、結果として得られる SIM ポリシー リソースを返します。
Other Status Codes

ErrorResponse

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
user_impersonation ユーザー アカウントを偽装する

例

Create SIM policy

要求のサンプル

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

応答のサンプル

状態コード:
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
          }
        ]
      }
    ]
  }
}
状態コード:
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
          }
        ]
      }
    ]
  }
}

定義

名前 説明
Ambr

最大ビット レートを集計します。
createdByType

リソースを作成した ID の種類。
DataNetworkConfiguration

データ ネットワークの使用を制御する設定
DataNetworkResourceId

データ ネットワーク リソースへの参照。
ErrorAdditionalInfo

リソース管理エラーの追加情報。
ErrorDetail

エラーの詳細。
ErrorResponse

エラー応答
PduSessionType

PDU セッションの種類 (IPv4/IPv6)。
PreemptionCapability

プリエンプション機能。
PreemptionVulnerability

プリエンプションの脆弱性。
ProvisioningState

現在のプロビジョニング状態。
ServiceResourceId

サービス リソースへの参照。
SimPolicy

SIM ポリシー リソース。
SliceConfiguration

スライスごとの設定
SliceResourceId

スライス リソースへの参照。
systemData

リソースの作成と最後の変更に関連するメタデータ。

Ambr

Object

最大ビット レートを集計します。

名前 型 説明
downlink

string

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

ダウンリンク ビット レート。
uplink

string

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

アップリンク ビット レート。

createdByType

列挙

リソースを作成した ID の種類。

値 説明
Application
Key
ManagedIdentity
User

DataNetworkConfiguration

Object

データ ネットワークの使用を制御する設定

名前 型 規定値 説明
5qi

integer (int32)

minimum: 0
maximum: 255 		9

既定の 5G QoS フロー インジケーター値。 5QI は、フローに提供される特定の QoS 転送処理を識別します。 5QI パラメーターの完全な説明については 3GPP TS23.501 セクション 5.7.2.1 を参照し、5QI 値の定義については表 5.7.4-1 を参照してください。
additionalAllowedSessionTypes

PduSessionType[]

既定のセッションの種類に加えて、許可されるセッションの種類。 既定のセッションの種類を複製することはできません。
allocationAndRetentionPriorityLevel

integer (int32)

minimum: 1
maximum: 15 		9

既定の QoS フローの割り当てとリテンション優先度 (ARP) レベル。 優先順位の高いフローは、preemptionCapability と preemptionVulnerability の設定で許可される場合、優先順位の低いフローです。1 は最も高い優先度です。 このフィールドが指定されていない場合は、5qi を使用して ARP 値が派生します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。
allowedServices

ServiceResourceId[]

この SIM ポリシーの一部として使用できるサービスの一覧。 リストに重複するアイテムを含めず、少なくとも 1 つの項目を含む必要があります。 サービスは、SIM ポリシーと同じ場所にある必要があります。
dataNetwork

DataNetworkResourceId

これらの設定が適用されるデータ ネットワークへの参照。 データ ネットワークは、SIM ポリシーと同じ場所にある必要があります。
defaultSessionType

PduSessionType

IPv4

既定の PDU セッションの種類。UE が特定のセッションの種類を要求しない場合に使用されます。
maximumNumberOfBufferedPackets

integer (int32)

minimum: 0 		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 フローが優先できるかどうかを制御します。 ARP パラメータの詳細な説明については、3GPP TS23.501 セクション 5.7.2.2 を参照してください。
sessionAmbr

Ambr

特定の PDU セッションのすべての非 GBR QoS フローの最大ビット レートを集計します。 Session-AMBR の完全な説明については、3GPP TS23.501 セクション 5.7.2.6 を参照してください。

DataNetworkResourceId

Object

データ ネットワーク リソースへの参照。

名前 型 説明
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]/[^/?#]+$

データ ネットワーク リソース ID。

ErrorAdditionalInfo

Object

リソース管理エラーの追加情報。

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

PduSessionType

列挙

PDU セッションの種類 (IPv4/IPv6)。

値 説明
IPv4
IPv6

PreemptionCapability

列挙

プリエンプション機能。

値 説明
MayPreempt

5 月の割り込み
NotPreempt

プリエンプションできない

PreemptionVulnerability

列挙

プリエンプションの脆弱性。

値 説明
NotPreemptable

割り込むことができません
Preemptable

割り込まれる可能性がある

ProvisioningState

列挙

現在のプロビジョニング状態。

値 説明
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

ServiceResourceId

Object

サービス リソースへの参照。

名前 型 説明
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]/[^/?#]+$

サービス リソース ID。

SimPolicy

Object

SIM ポリシー リソース。

名前 型 規定値 説明
id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/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 (int32)

minimum: 30 		3240

UE 定期登録更新タイマー (5G) または UE 定期追跡領域更新タイマー (4G)、秒単位。
properties.rfspIndex

integer (int32)

minimum: 1
maximum: 256

RAT/Frequency Selection Priority Index(3GPP TS 36.413 で定義)。 これは省略可能な設定であり、既定では指定されていません。
properties.siteProvisioningState

object

サイト上のこの SIM ポリシーのプロビジョニング状態に対するサイトのディクショナリ。
properties.sliceConfigurations

SliceConfiguration[]

許可されているスライスと、それらに使用する設定。 リストに重複するアイテムを含めず、少なくとも 1 つの項目を含む必要があります。
properties.ueAmbr

Ambr

特定の UE のすべての PDU セッションのすべての非 GBR QoS フローの最大ビット レートを集計します。 UE-AMBR の完全な説明については、3GPP TS23.501 セクション 5.7.2.6 を参照してください。
systemData

systemData

createdBy と modifiedBy 情報を含む Azure Resource Manager メタデータ。
tags

object

リソース タグ。
type

string

リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts"

SliceConfiguration

Object

スライスごとの設定

名前 型 説明
dataNetworkConfigurations

DataNetworkConfiguration[]

許可されているデータ ネットワークと、それらに使用する設定。 リストに重複するアイテムを含めず、少なくとも 1 つの項目を含む必要があります。
defaultDataNetwork

DataNetworkResourceId

UE で明示的に指定されていない場合に使用する既定のデータ ネットワーク。 このオブジェクトの構成は、dataNetworkConfigurations マップに存在する必要があります。 データ ネットワークは、SIM ポリシーと同じ場所にある必要があります。
slice

SliceResourceId

これらの設定が適用されるスライスへの参照。 スライスは、SIM ポリシーと同じ場所にある必要があります。

SliceResourceId

Object

スライス リソースへの参照。

名前 型 説明
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]/[^/?#]+$

スライス リソース ID。

systemData

Object

リソースの作成と最後の変更に関連するメタデータ。

名前 型 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。
createdBy

string

リソースを作成した ID。
createdByType

createdByType

リソースを作成した ID の種類。
lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy

string

リソースを最後に変更した ID。
lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。