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 パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
mobile
|
path | True |
string |
モバイル ネットワークの名前。 正規表現パターン: |
resource
|
path | True |
string |
リソース グループの名前。 名前の大文字と小文字は区別されます。 |
service
|
path | True |
string |
サービスの名前。 次の予約文字列 (、 正規表現パターン: |
subscription
|
path | True |
string uuid |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
location | True |
string |
リソースが保存されている地理的な場所 |
properties.pccRules | True |
このサービスを構成するデータ フロー ポリシー ルールのセット。 |
|
properties.servicePrecedence | True |
integer |
特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。 |
properties.serviceQosPolicy |
このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 |
||
tags |
object |
リソース タグ。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
更新が成功しました。 操作は、結果のサービス リソースを返します。 |
|
201 Created |
成功Create。 操作は、結果のサービス リソースを返します。 |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 |
セキュリティ
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 |
最大ビット レートを集計します。 |
created |
リソースを作成した ID の種類。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Pcc |
データ フロー ポリシールールの構成 |
Pcc |
データ フロー ポリシー ルール QoS ポリシー |
Preemption |
プリエンプション機能。 |
Preemption |
プリエンプションの脆弱性。 |
Provisioning |
現在のプロビジョニング状態。 |
Qos |
QoS ポリシー |
Sdf |
サービス データ フローの方向。 |
Service |
サービス リソース。 親モバイル ネットワークと同じ場所に作成する必要があります。 |
Service |
データ フロー テンプレート |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
Traffic |
トラフィック制御のアクセス許可。 |
Ambr
最大ビット レートを集計します。
名前 | 型 | 説明 |
---|---|---|
downlink |
string |
ダウンリンク ビット レート。 |
uplink |
string |
アップリンク ビット レート。 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
PccRuleConfiguration
データ フロー ポリシールールの構成
名前 | 型 | 規定値 | 説明 |
---|---|---|---|
ruleName |
string |
ルールの名前です。 これは親サービス内で一意である必要があります。 予約文字列 |
|
rulePrecedence |
integer |
特定の SIM に使用する QoS 値を識別するときに、データ フロー ポリシー ルールを決定するために使用される優先順位の値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのデータ フロー ポリシー ルール間で一意である必要があります。 |
|
ruleQosPolicy |
この規則に一致するパケットに使用する QoS ポリシー。 このフィールドが null の場合、親サービスは QoS 設定を定義します。 |
||
serviceDataFlowTemplates |
このデータ フロー ポリシー ルールに使用するデータ フロー テンプレートのセット。 |
||
trafficControl | 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) レベル。 優先度が高いフローは、 の設定と |
guaranteedBitRate |
このデータ フロー ポリシー規則を使用するすべてのサービス データ フローの保証ビット レート (GBR)。 この設定は省略可能です。 値を指定しない場合、この QoS 定義を使用するデータ フロー ポリシー ルールに GBR は設定されません。 |
||
maximumBitRate |
このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 |
||
preemptionCapability | NotPreempt |
QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、QoS フローを、優先度レベルが低い別の QoS フローよりも優先させるかどうかを制御します。 ARP パラメータの詳細な説明については、「3GPP TS23.501 セクション 5.7.2.2」を参照してください。 |
|
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) レベル。 優先度が高いフローは、 の設定と |
maximumBitRate |
このデータ フロー ポリシー ルールまたはサービスを使用するすべてのサービス データ フローの最大ビット レート (MBR)。 |
||
preemptionCapability | NotPreempt |
QoS フロープリエンプション機能。 QoS フローのプリエンプション機能は、QoS フローを、優先度レベルが低い別の QoS フローよりも優先させるかどうかを制御します。 ARP パラメータの詳細な説明については、「3GPP TS23.501 セクション 5.7.2.2」を参照してください。 |
|
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 |
このサービスを構成するデータ フロー ポリシー ルールのセット。 |
|
properties.provisioningState |
サービス リソースのプロビジョニング状態。 |
|
properties.servicePrecedence |
integer |
特定の SIM に使用する QoS 値を識別するときにサービス間で決定するために使用される優先順位値。 値が小さいほど、優先度が高くなります。 この値は、モバイル ネットワークで構成されているすべてのサービス間で一意である必要があります。 |
properties.serviceQosPolicy |
このサービスに一致するパケットに使用する QoS ポリシー。 これは、PccRuleConfiguration の ruleQosPolicy フィールドを使用して、特定のフローに対してオーバーライドできます。 このフィールドが null の場合、UE の SIM ポリシーによって QoS 設定が定義されます。 |
|
systemData |
createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。 |
|
tags |
object |
リソース タグ。 |
type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
ServiceDataFlowTemplate
データ フロー テンプレート
名前 | 型 | 説明 |
---|---|---|
direction |
このフローの方向。 |
|
ports |
string[] |
このフローに対して UA が接続するポート。 0 個以上のポートまたはポート範囲を指定できます。 1 つ以上のポートまたはポート範囲を指定する場合は、 フィールドに 以外 |
protocol |
string[] |
このフローで許可されるプロトコルの一覧。 このフローでインターネット プロトコル スイート内の任意のプロトコルを使用できるようにする場合は、値 |
remoteIpList |
string[] |
このフローに対して UE が接続するリモート IP アドレス。 任意の IP アドレスで接続を許可する場合は、 の値 |
templateName |
string |
データ フロー テンプレートの名前。 これは、親データ フロー ポリシー ルール内で一意である必要があります。 予約文字列 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |
TrafficControlPermission
トラフィック制御のアクセス許可。
名前 | 型 | 説明 |
---|---|---|
Blocked |
string |
このルールに一致するトラフィックはフローできません。 |
Enabled |
string |
この規則に一致するトラフィックのフローが許可されます。 |