共用方式為

Services - Create Or Update

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

建立或更新服務。 必須與父行動網路位於相同的位置。

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

URI 參數

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

string

行動網路的名稱。

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

string

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

string

服務的名稱。 您不得使用下列任何保留字串 - default、 requested 或 service

Regex 模式: ^(?!(default|requested|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$
subscriptionId
 path True

string

uuid

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

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
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

資源標籤。

回應

名稱 類型 Description
200 OK

Service

更新成功。 作業會傳回產生的服務資源。
201 Created

Service

Create 成功。 作業會傳回產生的服務資源。
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 模擬您的用戶帳戶

範例

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": []
          }
        ]
      }
    ]
  }
}

範例回覆

狀態碼:
200 
{
  "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": []
          }
        ]
      }
    ]
  }
}
狀態碼:
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/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": []
          }
        ]
      }
    ]
  }
}

定義

名稱 Description
Ambr

匯總最大比特率。
createdByType

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

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

錯誤詳細數據。
ErrorResponse

錯誤回應
PccRuleConfiguration

數據流原則規則設定
PccRuleQosPolicy

數據流原則規則 QoS 原則
PreemptionCapability

先占功能。
PreemptionVulnerability

先占弱點。
ProvisioningState

目前的布建狀態。
QosPolicy

QoS 原則
SdfDirection

服務數據流方向。
Service

服務資源。 必須與父行動網路位於相同的位置。
ServiceDataFlowTemplate

數據流範本
systemData

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

流量控制許可權。

Ambr

匯總最大比特率。

名稱 類型 Description
downlink

string

下行連結比特率。
uplink

string

上行連結比特率。

createdByType

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

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。
type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
code

string

錯誤碼。
details

ErrorDetail[]

錯誤詳細資料。
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

PccRuleConfiguration

數據流原則規則設定

名稱 類型 預設值 Description
ruleName

string

規則的名稱。 這在父服務內必須是唯一的。 您不得使用下列任何保留字串 - default或 requestedservice。
rulePrecedence

integer

識別要用於特定 SIM 卡的 QoS 值時，用來決定數據流原則規則之間的優先順序值。 較低的值表示較高的優先順序。 在行動網路中設定的所有數據流原則規則中，此值應該是唯一的。
ruleQosPolicy

PccRuleQosPolicy

要用於符合此規則之封包的 QoS 原則。 如果此欄位為 Null，則父服務會定義 QoS 設定。
serviceDataFlowTemplates

ServiceDataFlowTemplate[]

要用於此數據流原則規則的數據流範本集。
trafficControl

TrafficControlPermission

Enabled

判斷是否允許符合此數據流原則規則的流程。

PccRuleQosPolicy

數據流原則規則 QoS 原則

名稱 類型 預設值 Description
5qi

integer

9

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

integer

9

ARP) 層級 (QoS 流量配置和保留優先順序。 優先順序較高的流程會優先佔用優先順序較低的流程，如果的 preemptionCapability 設定允許 preemptionVulnerability ，則為 。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 流程。 如需 ARP 參數的完整描述，請參閱 3GPP TS23.501 第 5.7.2.2 節。
preemptionVulnerability

PreemptionVulnerability

Preemptable

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

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

QosPolicy

QoS 原則

名稱 類型 預設值 Description
5qi

integer

9

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

integer

9

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

Ambr

使用此數據流原則規則或服務之所有服務數據流的最大比特率 (MBR) 。
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 節。

SdfDirection

服務數據流方向。

名稱 類型 Description
Bidirectional

string

流向和流出 UE 的流量。
Downlink

string

從數據網路流向 UE 的流量。
Uplink

string

從 UE 流向數據網路的流量。

Service

服務資源。 必須與父行動網路位於相同的位置。

名稱 類型 Description
id

string

資源的完整資源識別碼。 例如“/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

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

object

資源標籤。
type

string

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

ServiceDataFlowTemplate

數據流範本

名稱 類型 Description
direction

SdfDirection

此流程的方向。
ports

string[]

埠 (要連線到此流程的 UE) 。 您可以指定零個或多個埠或埠範圍。 如果您指定一或多個埠或埠範圍，則必須在欄位中指定以外的ipprotocol值。 這是選擇性的設定。 如果您未指定，則會在所有埠上允許連線。 埠範圍必須指定為 -。 例如： [8080， 8082-8085]。
protocol

string[]

此流程的允許通訊協定 () 清單。 如果您想要此流程能夠在因特網通訊協定套件內使用任何通訊協定，請使用 值 ip。 如果您只想允許選取通訊協定，則必須針對每個通訊協定使用對應的 IANA 指派因特網通訊協議號碼，如 中所述 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml。 例如，針對 UDP，您必須使用 17。 如果您使用 此值 ip ，則必須將字段 port 保留為未指定。
remoteIpList

string[]

UE 將為此流程連接到其中的遠端 IP 位址。 如果您要允許任何 IP 位址上的連線，請使用 值 any。 否則，您必須提供封包核心實例將為此流程連線的每個遠端IP位址。 您必須以 CIDR 表示法提供每個 IP 位址，包括 netmask (，例如 192.0.2.54/24) 。
templateName

string

資料流程工作的名稱。 這在父數據流原則規則內必須是唯一的。 您不得使用下列任何保留字串 - default或 requestedservice。

systemData

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

名稱 類型 Description
createdAt

string

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

string

建立資源的身分識別。
createdByType

createdByType

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

string

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

lastModifiedBy

string

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

createdByType

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

TrafficControlPermission

流量控制許可權。

名稱 類型 Description
Blocked

string

不允許符合此規則的流量流動。
Enabled

string

允許符合此規則的流量流動。