次の方法で共有


Services - Create Or Update

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

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

URI パラメーター

名前 / 必須 説明
mobileNetworkName
path True

string

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

正規表現パターン: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$

resourceGroupName
path True

string

リソース グループの名前。 名前の大文字と小文字は区別されます。

serviceName
path True

string

サービスの名前。 次の予約文字列 (、requestedまたは) defaultは使用しないでください。service

正規表現パターン: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$

subscriptionId
path True

string

uuid

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

api-version
query True

string

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

要求本文

名前 必須 説明
location True

string

リソースが保存されている地理的な場所

properties.pccRules True

PccRuleConfiguration[]

このサービスを構成するデータ フロー ポリシー ルールのセット。

properties.servicePrecedence True

integer

特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。

properties.serviceQosPolicy

QosPolicy

このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。

tags

object

リソース タグ。

応答

名前 説明
200 OK

Service

更新が成功しました。 操作は、結果のサービス リソースを返します。

201 Created

Service

成功Create。 操作は、結果のサービス リソースを返します。

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 service

要求のサンプル

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

{
  "location": "eastus",
  "properties": {
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

応答のサンプル

{
  "name": "testPolicy",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "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",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}
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/services/TestService",
  "type": "Microsoft.MobileNetwork/service",
  "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",
    "servicePrecedence": 255,
    "serviceQosPolicy": {
      "5qi": 9,
      "allocationAndRetentionPriorityLevel": 9,
      "preemptionCapability": "NotPreempt",
      "preemptionVulnerability": "Preemptable",
      "maximumBitRate": {
        "uplink": "500 Mbps",
        "downlink": "1 Gbps"
      }
    },
    "pccRules": [
      {
        "ruleName": "default-rule",
        "rulePrecedence": 255,
        "ruleQosPolicy": {
          "5qi": 9,
          "allocationAndRetentionPriorityLevel": 9,
          "preemptionCapability": "NotPreempt",
          "preemptionVulnerability": "Preemptable",
          "maximumBitRate": {
            "uplink": "500 Mbps",
            "downlink": "1 Gbps"
          }
        },
        "trafficControl": "Enabled",
        "serviceDataFlowTemplates": [
          {
            "templateName": "IP-to-server",
            "direction": "Uplink",
            "protocol": [
              "ip"
            ],
            "remoteIpList": [
              "10.3.4.0/24"
            ],
            "ports": []
          }
        ]
      }
    ]
  }
}

定義

名前 説明
Ambr

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

createdByType

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

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

PccRuleConfiguration

データ フロー ポリシールールの構成

PccRuleQosPolicy

データ フロー ポリシー ルール QoS ポリシー

PreemptionCapability

プリエンプション機能。

PreemptionVulnerability

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

ProvisioningState

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

QosPolicy

QoS ポリシー

SdfDirection

サービス データ フローの方向。

Service

サービス リソース。 親モバイル ネットワークと同じ場所に作成する必要があります。

ServiceDataFlowTemplate

データ フロー テンプレート

systemData

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

TrafficControlPermission

トラフィック制御のアクセス許可。

Ambr

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

名前 説明
downlink

string

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

uplink

string

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

createdByType

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

名前 説明
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

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

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ErrorResponse

エラー応答

名前 説明
error

ErrorDetail

error オブジェクト。

PccRuleConfiguration

データ フロー ポリシールールの構成

名前 規定値 説明
ruleName

string

ルールの名前です。 これは親サービス内で一意である必要があります。 予約文字列 defaultrequested 、、または serviceのいずれかを使用しないでください。

rulePrecedence

integer

特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルールを決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルール間で一意である必要があります。

ruleQosPolicy

PccRuleQosPolicy

この規則に一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。

serviceDataFlowTemplates

ServiceDataFlowTemplate[]

このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。

trafficControl

TrafficControlPermission

Enabled

このデータ フロー ポリシー ルールに一致するフローを許可するかどうかを決定します。

PccRuleQosPolicy

データ フロー ポリシー ルール QoS ポリシー

名前 規定値 説明
5qi

integer

9

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

allocationAndRetentionPriorityLevel

integer

9

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

guaranteedBitRate

Ambr

このデータ フロー ポリシー規則を使用するすべてのサービス データ フローの保証ビット レート (GBR)。 この設定は省略可能です。 値を指定しない場合、この QoS 定義を使用するデータ フロー ポリシー ルールに GBR は設定されません。

maximumBitRate

Ambr

このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。

preemptionCapability

PreemptionCapability

NotPreempt

QoS フロープリエンプション機能。 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」を参照してください。

PreemptionCapability

プリエンプション機能。

名前 説明
MayPreempt

string

5 月

NotPreempt

string

プリエンプトできない

PreemptionVulnerability

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

名前 説明
NotPreemptable

string

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

Preemptable

string

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

ProvisioningState

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

名前 説明
Accepted

string

Canceled

string

Deleted

string

Deleting

string

Failed

string

Succeeded

string

Unknown

string

QosPolicy

QoS ポリシー

名前 規定値 説明
5qi

integer

9

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

allocationAndRetentionPriorityLevel

integer

9

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

maximumBitRate

Ambr

このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。

preemptionCapability

PreemptionCapability

NotPreempt

QoS フロープリエンプション機能。 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」を参照してください。

SdfDirection

サービス データ フローの方向。

名前 説明
Bidirectional

string

UE との間で送受信されるトラフィック。

Downlink

string

データ ネットワークから UE に流れるトラフィック。

Uplink

string

UE からデータ ネットワークに流れるトラフィック。

Service

サービス リソース。 親モバイル ネットワークと同じ場所に作成する必要があります。

名前 説明
id

string

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

location

string

リソースが保存されている地理的な場所

name

string

リソースの名前

properties.pccRules

PccRuleConfiguration[]

このサービスを構成するデータ フロー ポリシー ルールのセット。

properties.provisioningState

ProvisioningState

サービス リソースのプロビジョニング状態。

properties.servicePrecedence

integer

特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。

properties.serviceQosPolicy

QosPolicy

このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。

systemData

systemData

createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。

tags

object

リソース タグ。

type

string

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

ServiceDataFlowTemplate

データ フロー テンプレート

名前 説明
direction

SdfDirection

このフローの方向。

ports

string[]

このフローに対して UA が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、 フィールドに 以外 ip の値を指定する protocol 必要があります。 この設定は省略可能です。 指定しない場合、すべてのポートで接続が許可されます。 ポート範囲は、-として指定する必要があります。 例: [8080, 8082-8085].

protocol

string[]

このフローで許可されるプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、値 ipを使用します。 プロトコルの選択のみを許可する場合は、「」で説明 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtmlされているように、プロトコルごとに対応する IANA 割り当てインターネット プロトコル番号を使用する必要があります。 たとえば、UDP の場合は 17 を使用する必要があります。 値 ip を使用する場合は、フィールド port を指定しない必要があります。

remoteIpList

string[]

このフローに対して UE が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、 の値 anyを使用します。 それ以外の場合は、パケット コア インスタンスがこのフローに接続する各リモート IP アドレスを指定する必要があります。 ネットマスク (192.0.2.54/24 など) を含め、各 IP アドレスを CIDR 表記で指定する必要があります。

templateName

string

データ フロー テンプレートの名前。 これは、親データ フロー ポリシー ルール内で一意である必要があります。 予約文字列 defaultrequested 、、または serviceのいずれかを使用しないでください。

systemData

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

名前 説明
createdAt

string

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

createdBy

string

リソースを作成した ID。

createdByType

createdByType

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

lastModifiedAt

string

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

lastModifiedBy

string

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

lastModifiedByType

createdByType

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

TrafficControlPermission

トラフィック制御のアクセス許可。

名前 説明
Blocked

string

このルールに一致するトラフィックはフローできません。

Enabled

string

この規則に一致するトラフィックのフローが許可されます。