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 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
mobile
|
path | True |
string |
모바일 네트워크의 이름입니다. regex 패턴: |
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. |
service
|
path | True |
string |
서비스의 이름입니다. 다음 예약 문자열(, regex 패턴: |
subscription
|
path | True |
string uuid |
대상 구독의 ID입니다. 값은 UUID여야 합니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
properties.pccRules | True |
이 서비스를 구성하는 데이터 흐름 정책 규칙 집합입니다. |
|
properties.servicePrecedence | True |
integer |
특정 SIM에 사용할 QoS 값을 식별할 때 서비스 간에 결정하는 데 사용되는 우선 순위 값입니다. 값이 낮을수록 우선 순위가 높습니다. 이 값은 모바일 네트워크에 구성된 모든 서비스 중에서 고유해야 합니다. |
properties.serviceQosPolicy |
이 서비스와 일치하는 패킷에 사용할 QoS 정책입니다. 이는 PccRuleConfiguration의 ruleQosPolicy 필드를 사용하여 특정 흐름에 대해 재정의할 수 있습니다. 이 필드가 null이면 UE의 SIM 정책이 QoS 설정을 정의합니다. |
||
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
업데이트에 성공했습니다. 작업은 결과 서비스 리소스를 반환합니다. |
|
201 Created |
Create 성공했습니다. 작업은 결과 서비스 리소스를 반환합니다. |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
보안
azure_auth
Azure Active Directory OAuth2 Flow.
형식:
oauth2
Flow:
implicit
권한 부여 URL:
https://login.microsoftonline.com/common/oauth2/authorize
범위
Name | 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": []
}
]
}
]
}
}
샘플 응답
{
"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": []
}
]
}
]
}
}
정의
Name | Description |
---|---|
Ambr |
최대 비트 속도를 집계합니다. |
created |
리소스를 만든 ID 유형입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Pcc |
데이터 흐름 정책 규칙 구성 |
Pcc |
데이터 흐름 정책 규칙 QoS 정책 |
Preemption |
선점 기능. |
Preemption |
선점 취약성. |
Provisioning |
현재 프로비저닝 상태입니다. |
Qos |
QoS 정책 |
Sdf |
서비스 데이터 흐름 방향. |
Service |
서비스 리소스. 부모 모바일 네트워크와 동일한 위치에 만들어져야 합니다. |
Service |
데이터 흐름 템플릿 |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
Traffic |
트래픽 제어 권한. |
Ambr
최대 비트 속도를 집계합니다.
Name | 형식 | Description |
---|---|---|
downlink |
string |
다운링크 비트 속도입니다. |
uplink |
string |
업링크 비트 속도. |
createdByType
리소스를 만든 ID 유형입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
PccRuleConfiguration
데이터 흐름 정책 규칙 구성
Name | 형식 | Default value | Description |
---|---|---|---|
ruleName |
string |
규칙의 이름입니다. 부모 서비스 내에서 고유해야 합니다. 다음 예약된 문자열( 또는 |
|
rulePrecedence |
integer |
특정 SIM에 사용할 QoS 값을 식별할 때 데이터 흐름 정책 규칙 중에서 결정하는 데 사용되는 우선 순위 값입니다. 값이 낮을수록 우선 순위가 높습니다. 이 값은 모바일 네트워크에 구성된 모든 데이터 흐름 정책 규칙 중에서 고유해야 합니다. |
|
ruleQosPolicy |
이 규칙과 일치하는 패킷에 사용할 QoS 정책입니다. 이 필드가 null이면 부모 서비스에서 QoS 설정을 정의합니다. |
||
serviceDataFlowTemplates |
이 데이터 흐름 정책 규칙에 사용할 데이터 흐름 템플릿 집합입니다. |
||
trafficControl | Enabled |
이 데이터 흐름 정책 규칙과 일치하는 흐름이 허용되는지 여부를 결정합니다. |
PccRuleQosPolicy
데이터 흐름 정책 규칙 QoS 정책
Name | 형식 | Default value | Description |
---|---|---|---|
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 Flow 선점 기능. QoS 흐름 제어의 선점 기능은 우선 순위 수준이 낮은 다른 QoS 흐름을 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요. |
|
preemptionVulnerability | Preemptable |
QoS Flow 선점 취약성. QoS 흐름의 선점 취약성은 우선 순위 수준이 높은 QoS Flow에서 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요. |
PreemptionCapability
선점 기능.
Name | 형식 | Description |
---|---|---|
MayPreempt |
string |
5월 선점 |
NotPreempt |
string |
선점할 수 없음 |
PreemptionVulnerability
선점 취약성.
Name | 형식 | Description |
---|---|---|
NotPreemptable |
string |
선점할 수 없음 |
Preemptable |
string |
선점될 수 있음 |
ProvisioningState
현재 프로비저닝 상태입니다.
Name | 형식 | Description |
---|---|---|
Accepted |
string |
|
Canceled |
string |
|
Deleted |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Unknown |
string |
QosPolicy
QoS 정책
Name | 형식 | Default value | Description |
---|---|---|---|
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 Flow 선점 기능. QoS 흐름 제어의 선점 기능은 우선 순위 수준이 낮은 다른 QoS 흐름을 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요. |
|
preemptionVulnerability | Preemptable |
QoS Flow 선점 취약성. QoS 흐름의 선점 취약성은 우선 순위 수준이 높은 QoS Flow에서 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요. |
SdfDirection
서비스 데이터 흐름 방향.
Name | 형식 | Description |
---|---|---|
Bidirectional |
string |
UE를 오가는 트래픽입니다. |
Downlink |
string |
데이터 네트워크에서 UE로 흐르는 트래픽입니다. |
Uplink |
string |
UE에서 데이터 네트워크로 흐르는 트래픽입니다. |
Service
서비스 리소스. 부모 모바일 네트워크와 동일한 위치에 만들어져야 합니다.
Name | 형식 | Description |
---|---|---|
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
데이터 흐름 템플릿
Name | 형식 | Description |
---|---|---|
direction |
이 흐름의 방향입니다. |
|
ports |
string[] |
이 흐름에 대해 ES가 연결할 포트입니다. 포트 또는 포트 범위를 0개 이상 지정할 수 있습니다. 하나 이상의 포트 또는 포트 범위를 지정하는 경우 필드 이외의 값을 |
protocol |
string[] |
이 흐름에 허용되는 프로토콜 목록입니다. 이 흐름이 인터넷 프로토콜 제품군 내의 모든 프로토콜을 사용할 수 있도록 하려면 값을 |
remoteIpList |
string[] |
이 흐름에서 UE가 연결할 원격 IP 주소입니다. 모든 IP 주소에서 연결을 허용하려면 값을 |
templateName |
string |
데이터 흐름 템플릿의 이름입니다. 부모 데이터 흐름 정책 규칙 내에서 고유해야 합니다. 다음 예약된 문자열( 또는 |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
TrafficControlPermission
트래픽 제어 권한.
Name | 형식 | Description |
---|---|---|
Blocked |
string |
이 규칙과 일치하는 트래픽은 흐를 수 없습니다. |
Enabled |
string |
이 규칙과 일치하는 트래픽은 흐를 수 있습니다. |