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

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

요청 본문

Name	필수	형식	Description
location	True	string	리소스가 있는 지리적 위치
properties.pccRules	True	PccRuleConfiguration[]	이 서비스를 구성하는 데이터 흐름 정책 규칙 집합입니다.
properties.servicePrecedence	True	integer (int32) minimum: 0 maximum: 255	특정 SIM에 사용할 QoS 값을 식별할 때 서비스 간에 결정하는 데 사용되는 우선 순위 값입니다. 값이 낮을수록 우선 순위가 높아질 수 있습니다. 이 값은 모바일 네트워크에 구성된 모든 서비스 중에서 고유해야 합니다.
properties.serviceQosPolicy		QosPolicy	이 서비스와 일치하는 패킷에 사용할 QoS 정책입니다. PccRuleConfiguration에서 ruleQosPolicy 필드를 사용하여 특정 흐름에 대해 재정의할 수 있습니다. 이 필드가 null이면 UE의 SIM 정책이 QoS 설정을 정의합니다.
tags		object	리소스 태그.

응답

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

보안

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


import com.azure.resourcemanager.mobilenetwork.models.Ambr;
import com.azure.resourcemanager.mobilenetwork.models.PccRuleConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.PccRuleQosPolicy;
import com.azure.resourcemanager.mobilenetwork.models.PreemptionCapability;
import com.azure.resourcemanager.mobilenetwork.models.PreemptionVulnerability;
import com.azure.resourcemanager.mobilenetwork.models.QosPolicy;
import com.azure.resourcemanager.mobilenetwork.models.SdfDirection;
import com.azure.resourcemanager.mobilenetwork.models.ServiceDataFlowTemplate;
import com.azure.resourcemanager.mobilenetwork.models.TrafficControlPermission;
import java.util.Arrays;

/**
 * Samples for Services CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.
     * json
     */
    /**
     * Sample code: Create service.
     * 
     * @param manager Entry point to MobileNetworkManager.
     */
    public static void createService(com.azure.resourcemanager.mobilenetwork.MobileNetworkManager manager) {
        manager.services().define("TestService").withRegion("eastus")
            .withExistingMobileNetwork("rg1", "testMobileNetwork").withServicePrecedence(255)
            .withPccRules(Arrays.asList(new PccRuleConfiguration().withRuleName("default-rule").withRulePrecedence(255)
                .withRuleQosPolicy(new PccRuleQosPolicy().withFiveQi(9).withAllocationAndRetentionPriorityLevel(9)
                    .withPreemptionCapability(PreemptionCapability.NOT_PREEMPT)
                    .withPreemptionVulnerability(PreemptionVulnerability.PREEMPTABLE)
                    .withMaximumBitRate(new Ambr().withUplink("500 Mbps").withDownlink("1 Gbps")))
                .withTrafficControl(TrafficControlPermission.ENABLED).withServiceDataFlowTemplates(
                    Arrays.asList(new ServiceDataFlowTemplate().withTemplateName("IP-to-server")
                        .withDirection(SdfDirection.UPLINK).withProtocol(Arrays.asList("ip"))
                        .withRemoteIpList(Arrays.asList("10.3.4.0/24")).withPorts(Arrays.asList())))))
            .withServiceQosPolicy(new QosPolicy().withFiveQi(9).withAllocationAndRetentionPriorityLevel(9)
                .withPreemptionCapability(PreemptionCapability.NOT_PREEMPT)
                .withPreemptionVulnerability(PreemptionVulnerability.PREEMPTABLE)
                .withMaximumBitRate(new Ambr().withUplink("500 Mbps").withDownlink("1 Gbps")))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.mobilenetwork import MobileNetworkManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-mobilenetwork
# USAGE
    python service_create.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = MobileNetworkManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="00000000-0000-0000-0000-000000000000",
    )

    response = client.services.begin_create_or_update(
        resource_group_name="rg1",
        mobile_network_name="testMobileNetwork",
        service_name="TestService",
        parameters={
            "location": "eastus",
            "properties": {
                "pccRules": [
                    {
                        "ruleName": "default-rule",
                        "rulePrecedence": 255,
                        "ruleQosPolicy": {
                            "5qi": 9,
                            "allocationAndRetentionPriorityLevel": 9,
                            "maximumBitRate": {"downlink": "1 Gbps", "uplink": "500 Mbps"},
                            "preemptionCapability": "NotPreempt",
                            "preemptionVulnerability": "Preemptable",
                        },
                        "serviceDataFlowTemplates": [
                            {
                                "direction": "Uplink",
                                "ports": [],
                                "protocol": ["ip"],
                                "remoteIpList": ["10.3.4.0/24"],
                                "templateName": "IP-to-server",
                            }
                        ],
                        "trafficControl": "Enabled",
                    }
                ],
                "servicePrecedence": 255,
                "serviceQosPolicy": {
                    "5qi": 9,
                    "allocationAndRetentionPriorityLevel": 9,
                    "maximumBitRate": {"downlink": "1 Gbps", "uplink": "500 Mbps"},
                    "preemptionCapability": "NotPreempt",
                    "preemptionVulnerability": "Preemptable",
                },
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armmobilenetwork_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/mobilenetwork/armmobilenetwork/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d88c94b22a8efdd47c0cadfe6d8d489107db2b23/specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.json
func ExampleServicesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armmobilenetwork.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewServicesClient().BeginCreateOrUpdate(ctx, "rg1", "testMobileNetwork", "TestService", armmobilenetwork.Service{
		Location: to.Ptr("eastus"),
		Properties: &armmobilenetwork.ServicePropertiesFormat{
			PccRules: []*armmobilenetwork.PccRuleConfiguration{
				{
					RuleName:       to.Ptr("default-rule"),
					RulePrecedence: to.Ptr[int32](255),
					RuleQosPolicy: &armmobilenetwork.PccRuleQosPolicy{
						FiveQi:                              to.Ptr[int32](9),
						AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
						MaximumBitRate: &armmobilenetwork.Ambr{
							Downlink: to.Ptr("1 Gbps"),
							Uplink:   to.Ptr("500 Mbps"),
						},
						PreemptionCapability:    to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
						PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
					},
					ServiceDataFlowTemplates: []*armmobilenetwork.ServiceDataFlowTemplate{
						{
							Direction: to.Ptr(armmobilenetwork.SdfDirectionUplink),
							Ports:     []*string{},
							RemoteIPList: []*string{
								to.Ptr("10.3.4.0/24")},
							TemplateName: to.Ptr("IP-to-server"),
							Protocol: []*string{
								to.Ptr("ip")},
						}},
					TrafficControl: to.Ptr(armmobilenetwork.TrafficControlPermissionEnabled),
				}},
			ServicePrecedence: to.Ptr[int32](255),
			ServiceQosPolicy: &armmobilenetwork.QosPolicy{
				FiveQi:                              to.Ptr[int32](9),
				AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
				MaximumBitRate: &armmobilenetwork.Ambr{
					Downlink: to.Ptr("1 Gbps"),
					Uplink:   to.Ptr("500 Mbps"),
				},
				PreemptionCapability:    to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
				PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Service = armmobilenetwork.Service{
	// 	Name: to.Ptr("testPolicy"),
	// 	Type: to.Ptr("Microsoft.MobileNetwork/service"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/services/TestService"),
	// 	SystemData: &armmobilenetwork.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-01T17:18:19.123Z"); return t}()),
	// 		CreatedBy: to.Ptr("user1"),
	// 		CreatedByType: to.Ptr(armmobilenetwork.CreatedByTypeUser),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-01-02T17:18:19.123Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("user2"),
	// 		LastModifiedByType: to.Ptr(armmobilenetwork.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("eastus"),
	// 	Tags: map[string]*string{
	// 	},
	// 	Properties: &armmobilenetwork.ServicePropertiesFormat{
	// 		PccRules: []*armmobilenetwork.PccRuleConfiguration{
	// 			{
	// 				RuleName: to.Ptr("default-rule"),
	// 				RulePrecedence: to.Ptr[int32](255),
	// 				RuleQosPolicy: &armmobilenetwork.PccRuleQosPolicy{
	// 					FiveQi: to.Ptr[int32](9),
	// 					AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
	// 					MaximumBitRate: &armmobilenetwork.Ambr{
	// 						Downlink: to.Ptr("1 Gbps"),
	// 						Uplink: to.Ptr("500 Mbps"),
	// 					},
	// 					PreemptionCapability: to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
	// 					PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
	// 				},
	// 				ServiceDataFlowTemplates: []*armmobilenetwork.ServiceDataFlowTemplate{
	// 					{
	// 						Direction: to.Ptr(armmobilenetwork.SdfDirectionUplink),
	// 						Ports: []*string{
	// 						},
	// 						RemoteIPList: []*string{
	// 							to.Ptr("10.3.4.0/24")},
	// 							TemplateName: to.Ptr("IP-to-server"),
	// 							Protocol: []*string{
	// 								to.Ptr("ip")},
	// 						}},
	// 						TrafficControl: to.Ptr(armmobilenetwork.TrafficControlPermissionEnabled),
	// 				}},
	// 				ProvisioningState: to.Ptr(armmobilenetwork.ProvisioningStateSucceeded),
	// 				ServicePrecedence: to.Ptr[int32](255),
	// 				ServiceQosPolicy: &armmobilenetwork.QosPolicy{
	// 					FiveQi: to.Ptr[int32](9),
	// 					AllocationAndRetentionPriorityLevel: to.Ptr[int32](9),
	// 					MaximumBitRate: &armmobilenetwork.Ambr{
	// 						Downlink: to.Ptr("1 Gbps"),
	// 						Uplink: to.Ptr("500 Mbps"),
	// 					},
	// 					PreemptionCapability: to.Ptr(armmobilenetwork.PreemptionCapabilityNotPreempt),
	// 					PreemptionVulnerability: to.Ptr(armmobilenetwork.PreemptionVulnerabilityPreemptable),
	// 				},
	// 			},
	// 		}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { MobileNetworkManagementClient } = require("@azure/arm-mobilenetwork");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Creates or updates a service. Must be created in the same location as its parent mobile network.
 *
 * @summary Creates or updates a service. Must be created in the same location as its parent mobile network.
 * x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/ServiceCreate.json
 */
async function createService() {
  const subscriptionId =
    process.env["MOBILENETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MOBILENETWORK_RESOURCE_GROUP"] || "rg1";
  const mobileNetworkName = "testMobileNetwork";
  const serviceName = "TestService";
  const parameters = {
    location: "eastus",
    pccRules: [
      {
        ruleName: "default-rule",
        rulePrecedence: 255,
        ruleQosPolicy: {
          fiveQi: 9,
          allocationAndRetentionPriorityLevel: 9,
          maximumBitRate: { downlink: "1 Gbps", uplink: "500 Mbps" },
          preemptionCapability: "NotPreempt",
          preemptionVulnerability: "Preemptable",
        },
        serviceDataFlowTemplates: [
          {
            direction: "Uplink",
            ports: [],
            remoteIpList: ["10.3.4.0/24"],
            templateName: "IP-to-server",
            protocol: ["ip"],
          },
        ],
        trafficControl: "Enabled",
      },
    ],
    servicePrecedence: 255,
    serviceQosPolicy: {
      fiveQi: 9,
      allocationAndRetentionPriorityLevel: 9,
      maximumBitRate: { downlink: "1 Gbps", uplink: "500 Mbps" },
      preemptionCapability: "NotPreempt",
      preemptionVulnerability: "Preemptable",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new MobileNetworkManagementClient(credential, subscriptionId);
  const result = await client.services.beginCreateOrUpdateAndWait(
    resourceGroupName,
    mobileNetworkName,
    serviceName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 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": []
          }
        ]
      }
    ]
  }
}

정의

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

Ambr

Object

최대 비트 속도를 집계합니다.

Name	형식	Description
downlink	string pattern: ^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$	다운링크 비트 속도입니다.
uplink	string pattern: ^\d+(\.\d+)? (bps\|Kbps\|Mbps\|Gbps\|Tbps)$	업링크 비트 속도입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

PccRuleConfiguration

Object

데이터 흐름 정책 규칙 구성

Name	형식	Default value	Description
ruleName	string maxLength: 64 pattern: ^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$		규칙의 이름입니다. 부모 서비스 내에서 고유해야 합니다. `default`, `requested` 또는 `service`예약된 문자열을 사용하면 안 됩니다.
rulePrecedence	integer (int32) minimum: 0 maximum: 255		특정 SIM에 사용할 QoS 값을 식별할 때 데이터 흐름 정책 규칙 중에서 결정하는 데 사용되는 우선 순위 값입니다. 값이 낮을수록 우선 순위가 높아질 수 있습니다. 이 값은 모바일 네트워크에 구성된 모든 데이터 흐름 정책 규칙 중에서 고유해야 합니다.
ruleQosPolicy	PccRuleQosPolicy		이 규칙과 일치하는 패킷에 사용할 QoS 정책입니다. 이 필드가 null이면 부모 서비스에서 QoS 설정을 정의합니다.
serviceDataFlowTemplates	ServiceDataFlowTemplate[]		이 데이터 흐름 정책 규칙에 사용할 데이터 흐름 템플릿 집합입니다.
trafficControl	TrafficControlPermission	Enabled	이 데이터 흐름 정책 규칙과 일치하는 흐름이 허용되는지 여부를 결정합니다.

PccRuleQosPolicy

Object

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

Name	형식	Default value	Description
5qi	integer (int32) minimum: 1 maximum: 127	9	5G QoS 흐름 표시기 값입니다. 5QI는 흐름에 제공할 특정 QoS 전달 처리를 식별합니다. 5QI 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.1을 참조하고, 5QI 값 정의에 대한 표 5.7.4-1을 참조하세요.
allocationAndRetentionPriorityLevel	integer (int32) minimum: 1 maximum: 15	9	QoS 흐름 할당 및 보존 우선 순위(ARP) 수준입니다. `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 Flow 선점 기능. QoS Flow의 선점 기능은 우선 순위 수준이 낮은 다른 QoS Flow를 선점할 수 있는지 여부를 제어합니다. 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

열거형

선점 기능.

값	Description
MayPreempt	5월 선점
NotPreempt	선점할 수 없음

PreemptionVulnerability

열거형

선점 취약성.

값	Description
NotPreemptable	선점할 수 없음
Preemptable	선점될 수 있음

ProvisioningState

열거형

현재 프로비저닝 상태입니다.

값	Description
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

QosPolicy

Object

QoS 정책

Name	형식	Default value	Description
5qi	integer (int32) minimum: 1 maximum: 127	9	5G QoS 흐름 표시기 값입니다. 5QI는 흐름에 제공할 특정 QoS 전달 처리를 식별합니다. 5QI 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.1을 참조하고, 5QI 값 정의에 대한 표 5.7.4-1을 참조하세요.
allocationAndRetentionPriorityLevel	integer (int32) minimum: 1 maximum: 15	9	QoS 흐름 할당 및 보존 우선 순위(ARP) 수준입니다. `preemptionCapability` 및 `preemptionVulnerability` 설정에서 허용하는 경우 우선 순위가 높은 흐름은 우선 순위가 낮은 흐름을 선점합니다. 1은 가장 높은 수준의 우선 순위입니다. 이 필드를 지정하지 않으면 `5qi` ARP 값을 파생하는 데 사용됩니다. ARP 매개 변수에 대한 전체 설명은 3GPP TS23.501 섹션 5.7.2.2를 참조하세요.
maximumBitRate	Ambr		이 데이터 흐름 정책 규칙 또는 서비스를 사용하는 모든 서비스 데이터 흐름의 최대 비트 전송률(MBR)입니다.
preemptionCapability	PreemptionCapability	NotPreempt	QoS Flow 선점 기능. QoS Flow의 선점 기능은 우선 순위 수준이 낮은 다른 QoS Flow를 선점할 수 있는지 여부를 제어합니다. 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

열거형

서비스 데이터 흐름 방향입니다.

값	Description
Bidirectional	UE를 오가는 트래픽입니다.
Downlink	데이터 네트워크에서 UE로 흐르는 트래픽입니다.
Uplink	UE에서 데이터 네트워크로 흐르는 트래픽입니다.

Service

Object

서비스 리소스입니다. 부모 모바일 네트워크와 동일한 위치에 만들어야 합니다.

Name	형식	Description
id	string (arm-id)	리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	리소스가 있는 지리적 위치
name	string	리소스의 이름
properties.pccRules	PccRuleConfiguration[]	이 서비스를 구성하는 데이터 흐름 정책 규칙 집합입니다.
properties.provisioningState	ProvisioningState	서비스 리소스의 프로비전 상태입니다.
properties.servicePrecedence	integer (int32) minimum: 0 maximum: 255	특정 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

Object

데이터 흐름 템플릿

Name	형식	Description
direction	SdfDirection	이 흐름의 방향입니다.
ports	string[] pattern: ^([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5])(-([1-9]\|[1-9][0-9]{1,3}\|[1-5][0-9]{4}\|6[0-4][0-9]{3}\|65[0-4][0-9]{2}\|655[0-2][0-9]\|6553[0-5]))?$	이 흐름에 대해 ES가 연결할 포트입니다. 0개 이상의 포트 또는 포트 범위를 지정할 수 있습니다. 하나 이상의 포트 또는 포트 범위를 지정하는 경우 `ip` 필드에 `protocol` 이외의 값을 지정해야 합니다. 선택적 설정입니다. 지정하지 않으면 모든 포트에서 연결이 허용됩니다. 포트 범위는 -로 지정해야 합니다. 예: [`8080`, `8082-8085`].
protocol	string[] pattern: ^(ip\|[0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])$	이 흐름에 허용되는 프로토콜 목록입니다. 이 흐름이 인터넷 프로토콜 제품군 내에서 모든 프로토콜을 사용할 수 있도록 하려면 `ip`값을 사용합니다. 프로토콜 선택만 허용하려면 https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml설명된 대로 각 프로토콜에 해당하는 IANA 할당 인터넷 프로토콜 번호를 사용해야 합니다. 예를 들어 UDP의 경우 17을 사용해야 합니다. 값 `ip` 사용하는 경우 필드를 지정되지 `port` 유지해야 합니다.
remoteIpList	string[] pattern: ^(any\|(([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])\.){3}([0-9]\|[1-9][0-9]\|1[0-9][0-9]\|2[0-4][0-9]\|25[0-5])(\/([0-9]\|[1-2][0-9]\|3[0-2])))$	이 흐름에 대해 UI가 연결할 원격 IP 주소입니다. IP 주소에서 연결을 허용하려면 `any`값을 사용합니다. 그렇지 않으면 패킷 코어 인스턴스가 이 흐름에 연결할 각 원격 IP 주소를 제공해야 합니다. netmask(예: 192.0.2.54/24)를 포함하여 CIDR 표기법으로 각 IP 주소를 제공해야 합니다.
templateName	string maxLength: 64 pattern: ^(?!(default\|requested\|service)$)[a-zA-Z0-9][a-zA-Z0-9_-]*$	데이터 흐름 템플릿의 이름입니다. 부모 데이터 흐름 정책 규칙 내에서 고유해야 합니다. `default`, `requested` 또는 `service`예약된 문자열을 사용하면 안 됩니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

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

TrafficControlPermission

열거형

트래픽 제어 권한입니다.

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

다음을 통해 공유

Services - Create Or Update

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

Create service

샘플 요청

샘플 응답

정의

Ambr

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

PccRuleConfiguration

PccRuleQosPolicy

PreemptionCapability

PreemptionVulnerability

ProvisioningState

QosPolicy

SdfDirection

Service

ServiceDataFlowTemplate

systemData

TrafficControlPermission

추가 리소스