Services - Create Or Update

참조

Service:: Mobile Network

API Version:: 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 매개 변수

Name	In(다음 안에)	필수	형식	Description
mobileNetworkName	path	True	string	모바일 네트워크의 이름입니다. Regex pattern: `^[a-zA-Z0-9][a-zA-Z0-9_-]*$`
resourceGroupName	path	True	string	리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.
serviceName	path	True	string	서비스의 이름입니다. 다음 예약 문자열(, `requested` 또는)을 사용하지 않아야 합니다. `defaultservice` Regex pattern: `^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$`
subscriptionId	path	True	string uuid	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string	이 작업에 사용할 API 버전입니다.

요청 본문

Name	필수	형식	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	리소스 태그.

응답

Name	형식	Description
200 OK	Service	업데이트에 성공했습니다. 작업은 결과 서비스 리소스를 반환합니다.
201 Created	Service	Create 성공했습니다. 작업은 결과 서비스 리소스를 반환합니다.
Other Status Codes	ErrorResponse	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	사용자 계정 가장

예제

Create service

Sample Request

HTTP

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

Sample Response

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

Status code:: 201

Azure-AsyncOperation: https://management.azure.com/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation?api-version=2024-04-01

Response Body

{
  "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	최대 비트 속도를 집계합니다.
createdByType	리소스를 만든 ID 유형입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
PccRuleConfiguration	데이터 흐름 정책 규칙 구성
PccRuleQosPolicy	데이터 흐름 정책 규칙 QoS 정책
PreemptionCapability	선점 기능.
PreemptionVulnerability	선점 취약성.
ProvisioningState	현재 프로비저닝 상태입니다.
QosPolicy	QoS 정책
SdfDirection	서비스 데이터 흐름 방향.
Service	서비스 리소스. 부모 모바일 네트워크와 동일한 위치에 만들어져야 합니다.
ServiceDataFlowTemplate	데이터 흐름 템플릿
systemData	리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
TrafficControlPermission	트래픽 제어 권한.

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	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

PccRuleConfiguration

데이터 흐름 정책 규칙 구성

Name	형식	기본값	Description
ruleName	string		규칙의 이름입니다. 부모 서비스 내에서 고유해야 합니다. 다음 예약된 문자열( 또는 `requestedservice`)을 `default`사용하면 안 됩니다.
rulePrecedence	integer		특정 SIM에 사용할 QoS 값을 식별할 때 데이터 흐름 정책 규칙 중에서 결정하는 데 사용되는 우선 순위 값입니다. 값이 낮을수록 우선 순위가 높습니다. 이 값은 모바일 네트워크에 구성된 모든 데이터 흐름 정책 규칙 중에서 고유해야 합니다.
ruleQosPolicy	PccRuleQosPolicy		이 규칙과 일치하는 패킷에 사용할 QoS 정책입니다. 이 필드가 null이면 부모 서비스에서 QoS 설정을 정의합니다.
serviceDataFlowTemplates	ServiceDataFlowTemplate[]		이 데이터 흐름 정책 규칙에 사용할 데이터 흐름 템플릿 집합입니다.
trafficControl	TrafficControlPermission	Enabled	이 데이터 흐름 정책 규칙과 일치하는 흐름이 허용되는지 여부를 결정합니다.

PccRuleQosPolicy

데이터 흐름 정책 규칙 QoS 정책

Name	형식	기본값	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) 수준입니다. 우선 순위가 높은 흐름은 및 의 설정 `preemptionCapabilitypreemptionVulnerability` 에서 허용하는 경우 우선 순위가 낮은 흐름을 선점합니다. 1이 가장 높은 우선 순위 수준입니다. 이 필드를 지정 `5qi` 하지 않으면 는 ARP 값을 파생하는 데 사용됩니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
guaranteedBitRate	Ambr		이 데이터 흐름 정책 규칙을 사용하는 모든 서비스 데이터 흐름에 대해 보장된 GBR(비트 전송률)입니다. 이는 선택적 설정입니다. 값을 제공하지 않으면 이 QoS 정의를 사용하는 데이터 흐름 정책 규칙에 대한 GBR 집합이 없습니다.
maximumBitRate	Ambr		이 데이터 흐름 정책 규칙 또는 서비스를 사용하는 모든 서비스 데이터 흐름의 최대 비트 전송률(MBR)입니다.
preemptionCapability	PreemptionCapability	NotPreempt	QoS Flow 선점 기능. QoS 흐름 제어의 선점 기능은 우선 순위 수준이 낮은 다른 QoS 흐름을 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
preemptionVulnerability	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	형식	기본값	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) 수준입니다. 우선 순위가 높은 흐름은 및 의 설정 `preemptionCapabilitypreemptionVulnerability` 에서 허용하는 경우 우선 순위가 낮은 흐름을 선점합니다. 1이 가장 높은 우선 순위 수준입니다. 이 필드를 지정 `5qi` 하지 않으면 는 ARP 값을 파생하는 데 사용됩니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
maximumBitRate	Ambr		이 데이터 흐름 정책 규칙 또는 서비스를 사용하는 모든 서비스 데이터 흐름의 최대 비트 전송률(MBR)입니다.
preemptionCapability	PreemptionCapability	NotPreempt	QoS Flow 선점 기능. QoS 흐름 제어의 선점 기능은 우선 순위 수준이 낮은 다른 QoS 흐름을 선점할 수 있는지 여부를 제어합니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
preemptionVulnerability	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	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

데이터 흐름 템플릿

Name	형식	Description
direction	SdfDirection	이 흐름의 방향입니다.
ports	string[]	이 흐름에 대해 ES가 연결할 포트입니다. 포트 또는 포트 범위를 0개 이상 지정할 수 있습니다. 하나 이상의 포트 또는 포트 범위를 지정하는 경우 필드 이외의 값을 `ipprotocol` 지정해야 합니다. 이는 선택적 설정입니다. 지정하지 않으면 모든 포트에서 연결이 허용됩니다. 포트 범위는 -로 지정해야 합니다. 예: [`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`사용합니다. 그렇지 않으면 패킷 코어 instance 이 흐름에 연결할 각 원격 IP 주소를 제공해야 합니다. netmask를 포함하여 CIDR 표기법으로 각 IP 주소를 제공해야 합니다(예: 192.0.2.54/24).
templateName	string	데이터 흐름 템플릿의 이름입니다. 부모 데이터 흐름 정책 규칙 내에서 고유해야 합니다. 다음 예약된 문자열( 또는 `requestedservice`)을 `default`사용하면 안 됩니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name	형식	Description
createdAt	string	UTC(리소스 만들기)의 타임스탬프입니다.
createdBy	string	리소스를 만든 ID입니다.
createdByType	createdByType	리소스를 만든 ID의 형식입니다.
lastModifiedAt	string	리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy	string	리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType	createdByType	리소스를 마지막으로 수정한 ID 유형입니다.

TrafficControlPermission

트래픽 제어 권한.

Name	형식	Description
Blocked	string	이 규칙과 일치하는 트래픽은 흐를 수 없습니다.
Enabled	string	이 규칙과 일치하는 트래픽은 흐를 수 있습니다.

다음을 통해 공유