Packet Core Control Planes - Create Or Update

服务:

Mobile Network

API 版本:

2024-04-01

创建或更新数据包核心控制平面。

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

URI 参数

名称	在	必需	类型	说明
packetCoreControlPlaneName	path	True	string maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9_-]*$	数据包核心控制平面的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。 名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。 该值必须是 UUID。
api-version	query	True	string minLength: 1	用于此作的 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源所在的地理位置
properties.controlPlaneAccessInterface	True	InterfaceProperties	访问网络上的控制平面接口。 对于 5G 网络，这是 N2 接口。 对于 4G 网络，这是 S1-MME 接口。
properties.localDiagnosticsAccess	True	LocalDiagnosticsAccessConfiguration	Kubernetes 入口配置，用于通过本地 API 控制对数据包核心诊断的访问。
properties.platform	True	PlatformConfiguration	部署数据包核心的平台。
properties.sites	True	SiteResourceId[]	应在其中部署此数据包核心控制平面的站点（s）。 站点必须与数据包核心控制平面位于同一位置。
properties.sku	True	BillingSku	定义此数据包核心控制平面部署的吞吐量和 SIM 限额的 SKU。
identity		ManagedServiceIdentity	用于从 Azure 密钥保管库检索入口证书的标识。
properties.controlPlaneAccessVirtualIpv4Addresses		string[] pattern: ^(([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])$	高可用性 （HA） 系统中访问网络上控制平面的虚拟 IP 地址（es）。 在 HA 部署中，应将访问网络路由器配置为此地址的任何广播流量，以连接到活动节点和备用节点上的控制平面访问接口。 在非 HA 系统中，此列表应省略或为空。
properties.coreNetworkTechnology		CoreNetworkType	核心网络技术生成（5G 核心或 EPC /4G 核心）。
properties.diagnosticsUpload		DiagnosticsUploadConfiguration	上传数据包核心诊断的配置
properties.eventHub		EventHubConfiguration	用于将数据包核心事件发送到 Azure 事件中心的配置。
properties.installation		Installation	数据包核心控制平面资源的安装状态。
properties.interopSettings		object	用于允许与第三方组件（例如 RAN 和 UE）的互作性的设置。
properties.signaling		SignalingConfiguration	数据包核心的信号配置。
properties.ueMtu		integer (int32) minimum: 1280 maximum: 1930	向 UE 发出信号的 MTU（以字节为单位）。 针对所有数据网络的用户平面数据链接设置相同的 MTU。 在用户平面访问链接上设置的 MTU 计算为大于此值 60 字节，以允许 GTP 封装。
properties.userConsent		UserConsentConfiguration	数据包核心的用户同意配置。
properties.version		string	数据包核心软件的所需版本。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	PacketCoreControlPlane	更新成功。 该作返回生成的数据包核心控制平面资源。
201 Created	PacketCoreControlPlane	创建成功。 该作返回生成的数据包核心控制平面资源。
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create packet core control plane

示例请求

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP?api-version=2024-04-01

{
  "location": "eastus",
  "properties": {
    "installation": {
      "desiredState": "Installed"
    },
    "sites": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"
      }
    ],
    "platform": {
      "type": "AKS-HCI",
      "azureStackEdgeDevice": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
      },
      "connectedCluster": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"
      },
      "customLocation": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"
      }
    },
    "coreNetworkTechnology": "5GC",
    "version": "0.2.0",
    "controlPlaneAccessInterface": {
      "name": "N2"
    },
    "sku": "G0",
    "ueMtu": 1600,
    "localDiagnosticsAccess": {
      "authenticationType": "AAD",
      "httpsServerCertificate": {
        "certificateUrl": "https://contosovault.vault.azure.net/certificates/ingress"
      }
    },
    "eventHub": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub",
      "reportingInterval": 60
    },
    "signaling": {
      "nasReroute": {
        "macroMmeGroupId": 1024
      },
      "nasEncryption": [
        "NEA2/EEA2",
        "NEA1/EEA1",
        "NEA0/EEA0"
      ]
    }
  }
}

Java

import com.azure.resourcemanager.mobilenetwork.models.AuthenticationType;
import com.azure.resourcemanager.mobilenetwork.models.AzureStackEdgeDeviceResourceId;
import com.azure.resourcemanager.mobilenetwork.models.BillingSku;
import com.azure.resourcemanager.mobilenetwork.models.ConnectedClusterResourceId;
import com.azure.resourcemanager.mobilenetwork.models.CoreNetworkType;
import com.azure.resourcemanager.mobilenetwork.models.CustomLocationResourceId;
import com.azure.resourcemanager.mobilenetwork.models.DesiredInstallationState;
import com.azure.resourcemanager.mobilenetwork.models.EventHubConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.HttpsServerCertificate;
import com.azure.resourcemanager.mobilenetwork.models.Installation;
import com.azure.resourcemanager.mobilenetwork.models.InterfaceProperties;
import com.azure.resourcemanager.mobilenetwork.models.LocalDiagnosticsAccessConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.NasEncryptionType;
import com.azure.resourcemanager.mobilenetwork.models.NasRerouteConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.PlatformConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.PlatformType;
import com.azure.resourcemanager.mobilenetwork.models.SignalingConfiguration;
import com.azure.resourcemanager.mobilenetwork.models.SiteResourceId;
import java.util.Arrays;

/**
 * Samples for PacketCoreControlPlanes CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/
     * PacketCoreControlPlaneCreate.json
     */
    /**
     * Sample code: Create packet core control plane.
     * 
     * @param manager Entry point to MobileNetworkManager.
     */
    public static void
        createPacketCoreControlPlane(com.azure.resourcemanager.mobilenetwork.MobileNetworkManager manager) {
        manager.packetCoreControlPlanes().define("TestPacketCoreCP").withRegion("eastus")
            .withExistingResourceGroup("rg1")
            .withSites(Arrays.asList(new SiteResourceId().withId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite")))
            .withPlatform(new PlatformConfiguration().withType(PlatformType.AKS_HCI)
                .withAzureStackEdgeDevice(new AzureStackEdgeDeviceResourceId().withId(
                    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"))
                .withConnectedCluster(new ConnectedClusterResourceId().withId(
                    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"))
                .withCustomLocation(new CustomLocationResourceId().withId(
                    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation")))
            .withControlPlaneAccessInterface(new InterfaceProperties().withName("N2")).withSku(BillingSku.G0)
            .withLocalDiagnosticsAccess(
                new LocalDiagnosticsAccessConfiguration().withAuthenticationType(AuthenticationType.AAD)
                    .withHttpsServerCertificate(new HttpsServerCertificate()
                        .withCertificateUrl("https://contosovault.vault.azure.net/certificates/ingress")))
            .withInstallation(new Installation().withDesiredState(DesiredInstallationState.INSTALLED))
            .withCoreNetworkTechnology(CoreNetworkType.FIVE_GC).withVersion("0.2.0").withUeMtu(1600)
            .withEventHub(new EventHubConfiguration().withId(
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub")
                .withReportingInterval(60))
            .withSignaling(new SignalingConfiguration()
                .withNasReroute(new NasRerouteConfiguration().withMacroMmeGroupId(1024)).withNasEncryption(Arrays
                    .asList(NasEncryptionType.NEA2_EEA2, NasEncryptionType.NEA1_EEA1, NasEncryptionType.NEA0_EEA0)))
            .create();
    }
}

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

Python

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 packet_core_control_plane_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.packet_core_control_planes.begin_create_or_update(
        resource_group_name="rg1",
        packet_core_control_plane_name="TestPacketCoreCP",
        parameters={
            "location": "eastus",
            "properties": {
                "controlPlaneAccessInterface": {"name": "N2"},
                "coreNetworkTechnology": "5GC",
                "eventHub": {
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub",
                    "reportingInterval": 60,
                },
                "installation": {"desiredState": "Installed"},
                "localDiagnosticsAccess": {
                    "authenticationType": "AAD",
                    "httpsServerCertificate": {
                        "certificateUrl": "https://contosovault.vault.azure.net/certificates/ingress"
                    },
                },
                "platform": {
                    "azureStackEdgeDevice": {
                        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
                    },
                    "connectedCluster": {
                        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"
                    },
                    "customLocation": {
                        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"
                    },
                    "type": "AKS-HCI",
                },
                "signaling": {
                    "nasEncryption": ["NEA2/EEA2", "NEA1/EEA1", "NEA0/EEA0"],
                    "nasReroute": {"macroMmeGroupId": 1024},
                },
                "sites": [
                    {
                        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"
                    }
                ],
                "sku": "G0",
                "ueMtu": 1600,
                "version": "0.2.0",
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/PacketCoreControlPlaneCreate.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

Go

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/PacketCoreControlPlaneCreate.json
func ExamplePacketCoreControlPlanesClient_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.NewPacketCoreControlPlanesClient().BeginCreateOrUpdate(ctx, "rg1", "TestPacketCoreCP", armmobilenetwork.PacketCoreControlPlane{
		Location: to.Ptr("eastus"),
		Properties: &armmobilenetwork.PacketCoreControlPlanePropertiesFormat{
			ControlPlaneAccessInterface: &armmobilenetwork.InterfaceProperties{
				Name: to.Ptr("N2"),
			},
			CoreNetworkTechnology: to.Ptr(armmobilenetwork.CoreNetworkTypeFiveGC),
			EventHub: &armmobilenetwork.EventHubConfiguration{
				ID:                to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub"),
				ReportingInterval: to.Ptr[int32](60),
			},
			Installation: &armmobilenetwork.Installation{
				DesiredState: to.Ptr(armmobilenetwork.DesiredInstallationStateInstalled),
			},
			LocalDiagnosticsAccess: &armmobilenetwork.LocalDiagnosticsAccessConfiguration{
				AuthenticationType: to.Ptr(armmobilenetwork.AuthenticationTypeAAD),
				HTTPSServerCertificate: &armmobilenetwork.HTTPSServerCertificate{
					CertificateURL: to.Ptr("https://contosovault.vault.azure.net/certificates/ingress"),
				},
			},
			Platform: &armmobilenetwork.PlatformConfiguration{
				Type: to.Ptr(armmobilenetwork.PlatformTypeAKSHCI),
				AzureStackEdgeDevice: &armmobilenetwork.AzureStackEdgeDeviceResourceID{
					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"),
				},
				ConnectedCluster: &armmobilenetwork.ConnectedClusterResourceID{
					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"),
				},
				CustomLocation: &armmobilenetwork.CustomLocationResourceID{
					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"),
				},
			},
			Signaling: &armmobilenetwork.SignalingConfiguration{
				NasEncryption: []*armmobilenetwork.NasEncryptionType{
					to.Ptr(armmobilenetwork.NasEncryptionTypeNEA2EEA2),
					to.Ptr(armmobilenetwork.NasEncryptionTypeNEA1EEA1),
					to.Ptr(armmobilenetwork.NasEncryptionTypeNEA0EEA0)},
				NasReroute: &armmobilenetwork.NASRerouteConfiguration{
					MacroMmeGroupID: to.Ptr[int32](1024),
				},
			},
			Sites: []*armmobilenetwork.SiteResourceID{
				{
					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"),
				}},
			SKU:     to.Ptr(armmobilenetwork.BillingSKUG0),
			UeMtu:   to.Ptr[int32](1600),
			Version: to.Ptr("0.2.0"),
		},
	}, 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.PacketCoreControlPlane = armmobilenetwork.PacketCoreControlPlane{
	// 	Name: to.Ptr("TestPacketCoreCP"),
	// 	Type: to.Ptr("Microsoft.MobileNetwork/packetCoreControlPlane"),
	// 	ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP"),
	// 	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.PacketCoreControlPlanePropertiesFormat{
	// 		ControlPlaneAccessInterface: &armmobilenetwork.InterfaceProperties{
	// 			Name: to.Ptr("N2"),
	// 		},
	// 		CoreNetworkTechnology: to.Ptr(armmobilenetwork.CoreNetworkTypeFiveGC),
	// 		EventHub: &armmobilenetwork.EventHubConfiguration{
	// 			ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub"),
	// 			ReportingInterval: to.Ptr[int32](60),
	// 		},
	// 		Installation: &armmobilenetwork.Installation{
	// 			DesiredState: to.Ptr(armmobilenetwork.DesiredInstallationStateInstalled),
	// 			ReinstallRequired: to.Ptr(armmobilenetwork.ReinstallRequiredNotRequired),
	// 			State: to.Ptr(armmobilenetwork.InstallationStateInstalled),
	// 		},
	// 		LocalDiagnosticsAccess: &armmobilenetwork.LocalDiagnosticsAccessConfiguration{
	// 			AuthenticationType: to.Ptr(armmobilenetwork.AuthenticationTypeAAD),
	// 			HTTPSServerCertificate: &armmobilenetwork.HTTPSServerCertificate{
	// 				CertificateURL: to.Ptr("https://contosovault.vault.azure.net/certificates/ingress"),
	// 				Provisioning: &armmobilenetwork.CertificateProvisioning{
	// 					State: to.Ptr(armmobilenetwork.CertificateProvisioningStateNotProvisioned),
	// 				},
	// 			},
	// 		},
	// 		Platform: &armmobilenetwork.PlatformConfiguration{
	// 			Type: to.Ptr(armmobilenetwork.PlatformTypeAKSHCI),
	// 			AzureStackEdgeDevice: &armmobilenetwork.AzureStackEdgeDeviceResourceID{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"),
	// 			},
	// 			AzureStackEdgeDevices: []*armmobilenetwork.AzureStackEdgeDeviceResourceID{
	// 				{
	// 					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"),
	// 				},
	// 				{
	// 					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice2"),
	// 			}},
	// 			ConnectedCluster: &armmobilenetwork.ConnectedClusterResourceID{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"),
	// 			},
	// 			CustomLocation: &armmobilenetwork.CustomLocationResourceID{
	// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr(armmobilenetwork.ProvisioningStateSucceeded),
	// 		Signaling: &armmobilenetwork.SignalingConfiguration{
	// 			NasEncryption: []*armmobilenetwork.NasEncryptionType{
	// 				to.Ptr(armmobilenetwork.NasEncryptionTypeNEA2EEA2),
	// 				to.Ptr(armmobilenetwork.NasEncryptionTypeNEA1EEA1),
	// 				to.Ptr(armmobilenetwork.NasEncryptionTypeNEA0EEA0)},
	// 				NasReroute: &armmobilenetwork.NASRerouteConfiguration{
	// 					MacroMmeGroupID: to.Ptr[int32](1024),
	// 				},
	// 			},
	// 			Sites: []*armmobilenetwork.SiteResourceID{
	// 				{
	// 					ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"),
	// 			}},
	// 			SKU: to.Ptr(armmobilenetwork.BillingSKUG0),
	// 			UeMtu: to.Ptr[int32](1600),
	// 			Version: to.Ptr("0.2.0"),
	// 		},
	// 	}
}

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

JavaScript

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

/**
 * This sample demonstrates how to Creates or updates a packet core control plane.
 *
 * @summary Creates or updates a packet core control plane.
 * x-ms-original-file: specification/mobilenetwork/resource-manager/Microsoft.MobileNetwork/stable/2024-04-01/examples/PacketCoreControlPlaneCreate.json
 */
async function createPacketCoreControlPlane() {
  const subscriptionId =
    process.env["MOBILENETWORK_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const resourceGroupName = process.env["MOBILENETWORK_RESOURCE_GROUP"] || "rg1";
  const packetCoreControlPlaneName = "TestPacketCoreCP";
  const parameters = {
    controlPlaneAccessInterface: { name: "N2" },
    coreNetworkTechnology: "5GC",
    eventHub: {
      id: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub",
      reportingInterval: 60,
    },
    installation: { desiredState: "Installed" },
    localDiagnosticsAccess: {
      authenticationType: "AAD",
      httpsServerCertificate: {
        certificateUrl: "https://contosovault.vault.azure.net/certificates/ingress",
      },
    },
    location: "eastus",
    platform: {
      type: "AKS-HCI",
      azureStackEdgeDevice: {
        id: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice",
      },
      connectedCluster: {
        id: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster",
      },
      customLocation: {
        id: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation",
      },
    },
    signaling: {
      nasEncryption: ["NEA2/EEA2", "NEA1/EEA1", "NEA0/EEA0"],
      nasReroute: { macroMmeGroupId: 1024 },
    },
    sites: [
      {
        id: "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite",
      },
    ],
    sku: "G0",
    ueMtu: 1600,
    version: "0.2.0",
  };
  const credential = new DefaultAzureCredential();
  const client = new MobileNetworkManagementClient(credential, subscriptionId);
  const result = await client.packetCoreControlPlanes.beginCreateOrUpdateAndWait(
    resourceGroupName,
    packetCoreControlPlaneName,
    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": "TestPacketCoreCP",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP",
  "type": "Microsoft.MobileNetwork/packetCoreControlPlane",
  "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",
    "installation": {
      "desiredState": "Installed",
      "state": "Installed",
      "reinstallRequired": "NotRequired"
    },
    "sites": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"
      }
    ],
    "platform": {
      "type": "AKS-HCI",
      "azureStackEdgeDevice": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
      },
      "azureStackEdgeDevices": [
        {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
        },
        {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice2"
        }
      ],
      "connectedCluster": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"
      },
      "customLocation": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"
      }
    },
    "coreNetworkTechnology": "5GC",
    "version": "0.2.0",
    "controlPlaneAccessInterface": {
      "name": "N2"
    },
    "sku": "G0",
    "ueMtu": 1600,
    "localDiagnosticsAccess": {
      "authenticationType": "AAD",
      "httpsServerCertificate": {
        "certificateUrl": "https://contosovault.vault.azure.net/certificates/ingress",
        "provisioning": {
          "state": "NotProvisioned"
        }
      }
    },
    "eventHub": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub",
      "reportingInterval": 60
    },
    "signaling": {
      "nasReroute": {
        "macroMmeGroupId": 1024
      },
      "nasEncryption": [
        "NEA2/EEA2",
        "NEA1/EEA1",
        "NEA0/EEA0"
      ]
    }
  }
}

状态代码:

201

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

{
  "name": "TestPacketCoreCP",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/packetCoreControlPlanes/TestPacketCoreCP",
  "type": "Microsoft.MobileNetwork/packetCoreControlPlane",
  "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",
    "installation": {
      "desiredState": "Installed",
      "state": "Installing",
      "operation": {
        "id": "/providers/Microsoft.MobileNetwork/locations/testLocation/operationStatuses/testOperation"
      }
    },
    "sites": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.MobileNetwork/mobileNetworks/testMobileNetwork/sites/testSite"
      }
    ],
    "platform": {
      "type": "AKS-HCI",
      "azureStackEdgeDevice": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
      },
      "azureStackEdgeDevices": [
        {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice"
        },
        {
          "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/TestAzureStackEdgeDevice2"
        }
      ],
      "connectedCluster": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Kubernetes/connectedClusters/TestConnectedCluster"
      },
      "customLocation": {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ExtendedLocation/customLocations/TestCustomLocation"
      }
    },
    "coreNetworkTechnology": "5GC",
    "version": "0.2.0",
    "controlPlaneAccessInterface": {
      "name": "N2"
    },
    "sku": "G0",
    "ueMtu": 1600,
    "localDiagnosticsAccess": {
      "authenticationType": "AAD",
      "httpsServerCertificate": {
        "certificateUrl": "https://contosovault.vault.azure.net/certificates/ingress",
        "provisioning": {
          "state": "NotProvisioned"
        }
      }
    },
    "eventHub": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.EventHub/namespaces/contosoNamespace/eventHubs/contosoHub",
      "reportingInterval": 60
    },
    "signaling": {
      "nasReroute": {
        "macroMmeGroupId": 1024
      },
      "nasEncryption": [
        "NEA2/EEA2",
        "NEA1/EEA1",
        "NEA0/EEA0"
      ]
    }
  }
}

定义

名称	说明
AsyncOperationId	对 Azure 异步操作 ID 的引用。
AuthenticationType	如何对访问本地诊断 API 的用户进行身份验证。
AzureStackEdgeDeviceResourceId	对 Azure Stack Edge 设备资源的引用。
AzureStackHCIClusterResourceId	对 Azure Stack HCI 群集资源的引用。
BillingSku	数据包核心控制平面资源的 SKU。 当添加新 SKU 或删除退出 SKU 时，SKU 列表可能会随着时间推移而更改。
CertificateProvisioning	证书预配状态
CertificateProvisioningState	证书的预配状态
ConnectedClusterResourceId	对 Azure Arc 自定义位置资源的引用。
CoreNetworkType	核心网络技术生成（5G 核心、EPC/4G 核心或 EPC/4G + 5G 核心）。
createdByType	创建资源的标识的类型。
CustomLocationResourceId	对 Azure Arc 自定义位置资源的引用。
DesiredInstallationState	数据包核心的所需安装状态。
DiagnosticsUploadConfiguration	上传数据包核心诊断的配置。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
EventHubConfiguration	用于将数据包核心事件发送到 Azure 事件中心的配置。
homeNetworkPrivateKeysProvisioning
homeNetworkPrivateKeysProvisioningState	SUPI 隐藏的私钥的预配状态。
HttpsServerCertificate	HTTPS 服务器证书配置。
Installation	数据包核心的安装状态。
InstallationReason	数据包核心尚未安装或需要重新安装的原因或原因列表。
InstallationState	数据包核心的安装状态。
InterfaceProperties	接口属性
LocalDiagnosticsAccessConfiguration	Kubernetes 入口配置，用于通过本地 API 控制对数据包核心诊断的访问。
ManagedServiceIdentity	托管服务标识 （用户分配的标识）
ManagedServiceIdentityType	托管服务标识的类型（目前只允许 UserAssigned）。
nasEncryptionType	NAS 加密算法的有序列表，用于加密 UE 和数据包核心之间的控制平面流量，从最不首选到最不首选。 如果未指定，数据包核心将使用内置的默认排序。
NASRerouteConfiguration	启用 NAS 重新路由的配置。
PacketCoreControlPlane	数据包核心控制平面资源。
PlatformConfiguration	部署数据包核心的平台。
PlatformType	部署数据包核心的平台类型。 此枚举的内容可能会更改。
ProvisioningState	当前预配状态。
ReinstallRequired	是否需要重新安装数据包核心才能选取最新的配置更改。
SignalingConfiguration	数据包核心的信号配置。
SiteResourceId	对站点资源的引用。
systemData	与创建和上次修改资源相关的元数据。
UserAssignedIdentity	用户分配的标识属性
UserConsentConfiguration

AsyncOperationId

Object

对 Azure 异步操作 ID 的引用。

名称	类型	说明
id	string pattern: ^/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[^/?#]+/[lL][oO][cC][aA][tT][iI][oO][nN][sS]/[^/?#]+/[oO][pP][eE][rR][aA][tT][iI][oO][nN][sS][tT][aA][tT][uU][sS][eE][sS]/[^/?#]+$	Azure 异步作 ID。

AuthenticationType

枚举

如何对访问本地诊断 API 的用户进行身份验证。

值	说明
AAD	使用 AAD SSO 对用户进行身份验证（这需要 Internet 访问）。
Password	使用本地存储的密码对用户进行身份验证。

AzureStackEdgeDeviceResourceId

Object

对 Azure Stack Edge 设备资源的引用。

名称	类型	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[dD][aA][tT][aA][bB][oO][xX][eE][dD][gG][eE]/[dD][aA][tT][aA][bB][oO][xX][eE][dD][gG][eE][dD][eE][vV][iI][cC][eE][sS]/[^/?#]+$	Azure Stack Edge 设备资源 ID。

AzureStackHCIClusterResourceId

Object

对 Azure Stack HCI 群集资源的引用。

名称	类型	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[aA][zZ][uU][rR][eE][sS][tT][aA][cC][kK][hH][cC][iI]/[cC][lL][uU][sS][tT][eE][rR][sS]/[^/?#]+$	Azure Stack HCI 群集资源 ID。

BillingSku

枚举

数据包核心控制平面资源的 SKU。 当添加新 SKU 或删除退出 SKU 时，SKU 列表可能会随着时间推移而更改。

值	说明
G0	100 Mbps、20 个活动 SIM 计划、2 个 RAN
G1	1 Gbps、100 个活动 SIM 计划、5 个 RAN
G10	10 Gbps，1000 个活动 SIM 计划
G2	2 Gbps，200 个活动 SIM 计划，10 个 RAN
G5	5 Gbps，500 个活动 SIM 计划

CertificateProvisioning

Object

证书预配状态

名称	类型	说明
reason	string	证书预配失败的原因。
state	CertificateProvisioningState	证书的预配状态

CertificateProvisioningState

枚举

证书的预配状态

值	说明
Failed	无法预配证书。 “reason”属性解释原因。
NotProvisioned	尚未预配证书。
Provisioned	已预配证书。

ConnectedClusterResourceId

Object

对 Azure Arc 自定义位置资源的引用。

名称	类型	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[kK][uU][bB][eE][rR][nN][eE][tT][eE][sS]/[cC][oO][nN][nN][eE][cC][tT][eE][dD][cC][lL][uU][sS][tT][eE][rR][sS]/[^/?#]+$	Azure Arc 连接的群集资源 ID。

CoreNetworkType

枚举

核心网络技术生成（5G 核心、EPC/4G 核心或 EPC/4G + 5G 核心）。

值	说明
5GC	5G 核心
EPC	EPC / 4G 核心
EPC + 5GC	组合 EPC/4G 和 5G 核心

createdByType

枚举

创建资源的标识的类型。

值	说明
Application
Key
ManagedIdentity
User

CustomLocationResourceId

Object

对 Azure Arc 自定义位置资源的引用。

名称	类型	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[eE][xX][tT][eE][nN][dD][eE][dD][lL][oO][cC][aA][tT][iI][oO][nN]/[cC][uU][sS][tT][oO][mM][lL][oO][cC][aA][tT][iI][oO][nN][sS]/[^/?#]+$	Azure Arc 自定义位置资源 ID。

DesiredInstallationState

枚举

数据包核心的所需安装状态。

值	说明
Installed	安装数据包核心。
Uninstalled	不要安装数据包核心。

DiagnosticsUploadConfiguration

Object

上传数据包核心诊断的配置。

名称	类型	说明
storageAccountContainerUrl	string	要将诊断上传到的存储帐户容器 URL。

ErrorAdditionalInfo

Object

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

Object

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

Object

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

EventHubConfiguration

Object

用于将数据包核心事件发送到 Azure 事件中心的配置。

名称	类型	默认值	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[eE][vV][eE][nN][tT][hH][uU][bB]/[nN][aA][mM][eE][sS][pP][aA][cC][eE][sS]/[^/?#]+/[eV][vV][eE][nN][tT][hH][uU][bB][sS]/[^/?#]+$		要向其发送数据包核心事件的 Azure 事件中心的资源 ID。
reportingInterval	integer (int32) minimum: 30 maximum: 3600	1800	UE 使用情况报告之间的持续时间（以秒为单位）。

homeNetworkPrivateKeysProvisioning

Object

名称	类型	说明
state	homeNetworkPrivateKeysProvisioningState	SUPI 隐藏的私钥的预配状态。

homeNetworkPrivateKeysProvisioningState

枚举

SUPI 隐藏的私钥的预配状态。

值	说明
Failed	为 SUPI 隐藏预配私钥失败。
NotProvisioned	尚未尝试为 SUPI 隐藏预配私钥。
Provisioned	成功预配 SUPI 隐藏的私钥。

HttpsServerCertificate

Object

HTTPS 服务器证书配置。

名称	类型	说明
certificateUrl	string	证书 URL 不受版本化。 例如： https://contosovault.vault.azure.net/certificates/ingress。
provisioning	CertificateProvisioning	证书的预配状态。

Installation

Object

数据包核心的安装状态。

名称	类型	默认值	说明
desiredState	DesiredInstallationState	Installed	所需的安装状态
operation	AsyncOperationId		对正在进行的安装作的引用
reasons	InstallationReason[]		数据包核心的当前安装状态的原因（s）。
reinstallRequired	ReinstallRequired		是否需要重新安装数据包核心才能选取最新的配置更改。
state	InstallationState		安装状态

InstallationReason

枚举

数据包核心尚未安装或需要重新安装的原因或原因列表。

值	说明
ControlPlaneAccessInterfaceHasChanged	重新安装是必需的，因为数据包核心正在使用过时的控制平面访问接口信息。
ControlPlaneAccessVirtualIpv4AddressesHasChanged	需要重新安装，因为数据包核心已用完控制平面访问网络虚拟 IP 地址。
NoAttachedDataNetworks	数据包核心尚未安装，因为数据包核心没有附加的数据网络。
NoPacketCoreDataPlane	数据包核心尚未安装，因为此数据包核心没有配置的数据平面。
NoSlices	数据包核心尚未安装，因为移动网络没有任何适用的配置切片。
PublicLandMobileNetworkIdentifierHasChanged	需要重新安装，因为数据包核心已用完 PLMN ID。
UserPlaneAccessInterfaceHasChanged	重新安装是必需的，因为数据包核心正在运行与过时的用户平面核心接口。
UserPlaneAccessVirtualIpv4AddressesHasChanged	需要重新安装，因为数据包核心已用完用户平面访问网络虚拟 IP 地址。
UserPlaneDataInterfaceHasChanged	重新安装是必需的，因为数据包核心正在运行与过时的用户平面访问接口。

InstallationState

枚举

数据包核心的安装状态。

值	说明
Failed	数据包核心处于失败状态。
Installed	数据包核心已安装。
Installing	数据包核心正在安装。
Reinstalling	数据包核心正在重新安装。
RollingBack	数据包核心将回滚到其以前的版本。
Uninstalled	数据包核心已卸载。
Uninstalling	数据包核心正在卸载。
Updating	数据包核心正在更新其配置。
Upgrading	数据包核心正在升级到其他软件版本。

InterfaceProperties

Object

接口属性

名称	类型	说明
bfdIpv4Endpoints	string[] pattern: ^(([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])$	要向其发送 BFD 探测的终结点的 IPv4 地址。
ipv4Address	string pattern: ^(([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])$	IPv4 地址。
ipv4AddressList	string[] pattern: ^(([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])$	多节点系统的 IPv4 地址列表。
ipv4Gateway	string pattern: ^(([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])$	默认 IPv4 网关（路由器）。
ipv4Subnet	string pattern: ^(([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]))$	IPv4 子网。
name	string	此接口的逻辑名称。 这应与 Azure Stack Edge 设备上配置的接口之一匹配。
vlanId	integer (int32) minimum: 1 maximum: 4094	网络接口的 VLAN 标识符。 示例：501。

LocalDiagnosticsAccessConfiguration

Object

Kubernetes 入口配置，用于通过本地 API 控制对数据包核心诊断的访问。

名称	类型	说明
authenticationType	AuthenticationType	如何对访问本地诊断 API 的用户进行身份验证。
httpsServerCertificate	HttpsServerCertificate	用于保护对诊断的本地访问的 HTTPS 服务器 TLS 证书。

ManagedServiceIdentity

Object

托管服务标识 （用户分配的标识）

名称	类型	说明
type	ManagedServiceIdentityType	托管服务标识的类型（目前只允许 UserAssigned）。
userAssignedIdentities	<string,  UserAssignedIdentity>	User-Assigned 标识 与资源关联的用户分配标识集。 userAssignedIdentities 字典密钥将为 ARM 资源 ID，格式为“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}”。 字典值可以是请求中的空对象（{}）。

ManagedServiceIdentityType

枚举

托管服务标识的类型（目前只允许 UserAssigned）。

值	说明
None
UserAssigned

nasEncryptionType

枚举

NAS 加密算法的有序列表，用于加密 UE 和数据包核心之间的控制平面流量，从最不首选到最不首选。 如果未指定，数据包核心将使用内置的默认排序。

值	说明
NEA0/EEA0	NAS 信号未加密。
NEA1/EEA1	NAS 信号使用 SNOW 3G 密码进行加密。
NEA2/EEA2	NAS 信号使用 AES 密码进行加密。

NASRerouteConfiguration

Object

启用 NAS 重新路由的配置。

名称	类型	说明
macroMmeGroupId	integer (int32) minimum: 0 maximum: 65535	宏网络的 MME 组 ID。 这是通过 NAS 重新路由发送到未知的 UE 的位置。

PacketCoreControlPlane

Object

数据包核心控制平面资源。

名称	类型	默认值	说明
id	string (arm-id)		资源的完全限定资源 ID。 例如“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
identity	ManagedServiceIdentity		用于从 Azure 密钥保管库检索入口证书的标识。
location	string		资源所在的地理位置
name	string		资源的名称
properties.controlPlaneAccessInterface	InterfaceProperties		访问网络上的控制平面接口。 对于 5G 网络，这是 N2 接口。 对于 4G 网络，这是 S1-MME 接口。
properties.controlPlaneAccessVirtualIpv4Addresses	string[] pattern: ^(([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])$		高可用性 （HA） 系统中访问网络上控制平面的虚拟 IP 地址（es）。 在 HA 部署中，应将访问网络路由器配置为此地址的任何广播流量，以连接到活动节点和备用节点上的控制平面访问接口。 在非 HA 系统中，此列表应省略或为空。
properties.coreNetworkTechnology	CoreNetworkType	5GC	核心网络技术生成（5G 核心或 EPC /4G 核心）。
properties.diagnosticsUpload	DiagnosticsUploadConfiguration		上传数据包核心诊断的配置
properties.eventHub	EventHubConfiguration		用于将数据包核心事件发送到 Azure 事件中心的配置。
properties.homeNetworkPrivateKeysProvisioning	homeNetworkPrivateKeysProvisioning		包含用于 SUPI 隐藏的私钥和 keyId 的机密的预配状态。
properties.installation	Installation		数据包核心控制平面资源的安装状态。
properties.installedVersion	string		当前安装的数据包核心软件版本。
properties.interopSettings	object		用于允许与第三方组件（例如 RAN 和 UE）的互作性的设置。
properties.localDiagnosticsAccess	LocalDiagnosticsAccessConfiguration		Kubernetes 入口配置，用于通过本地 API 控制对数据包核心诊断的访问。
properties.platform	PlatformConfiguration		部署数据包核心的平台。
properties.provisioningState	ProvisioningState		数据包核心控制平面资源的预配状态。
properties.rollbackVersion	string		已部署的数据包核心软件的早期版本。 执行回滚操作时使用。
properties.signaling	SignalingConfiguration		数据包核心的信号配置。
properties.sites	SiteResourceId[]		应在其中部署此数据包核心控制平面的站点（s）。 站点必须与数据包核心控制平面位于同一位置。
properties.sku	BillingSku		定义此数据包核心控制平面部署的吞吐量和 SIM 限额的 SKU。
properties.ueMtu	integer (int32) minimum: 1280 maximum: 1930	1440	向 UE 发出信号的 MTU（以字节为单位）。 针对所有数据网络的用户平面数据链接设置相同的 MTU。 在用户平面访问链接上设置的 MTU 计算为大于此值 60 字节，以允许 GTP 封装。
properties.userConsent	UserConsentConfiguration		数据包核心的用户同意配置。
properties.version	string		数据包核心软件的所需版本。
systemData	systemData		包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object		资源标记。
type	string		资源的类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”

PlatformConfiguration

Object

部署数据包核心的平台。

名称	类型	说明
azureStackEdgeDevice	AzureStackEdgeDeviceResourceId	在其中部署数据包核心的 Azure Stack Edge 设备。 如果设备是容错对的一部分，则可以指定对中的任一设备。
azureStackEdgeDevices	AzureStackEdgeDeviceResourceId[]	部署数据包核心的 Azure Stack Edge 设备。 如果数据包核心跨多个设备部署，则所有设备都将显示在此列表中。
azureStackHciCluster	AzureStackHCIClusterResourceId	在其中部署数据包核心的 Azure Stack HCI 群集。
connectedCluster	ConnectedClusterResourceId	部署数据包核心的 Azure Arc 连接的群集。
customLocation	CustomLocationResourceId	部署数据包核心的 Azure Arc 自定义位置。
type	PlatformType	部署数据包核心的平台类型。

PlatformType

枚举

部署数据包核心的平台类型。 此枚举的内容可能会更改。

值	说明
3P-AZURE-STACK-HCI	如果选择此选项，则必须设置“azureStackHciCluster”、“connectedCluster”或“customLocation”之一。 如果设置了多个，则它们必须彼此一致。
AKS-HCI	如果选择此选项，则必须设置“azureStackEdgeDevice”、“connectedCluster”或“customLocation”之一。 如果设置了多个，则它们必须彼此一致。

ProvisioningState

枚举

当前预配状态。

值	说明
Accepted
Canceled
Deleted
Deleting
Failed
Succeeded
Unknown

ReinstallRequired

枚举

是否需要重新安装数据包核心才能选取最新的配置更改。

值	说明
NotRequired	不需要重新安装数据包核心。
Required	需要重新安装数据包核心。

SignalingConfiguration

Object

数据包核心的信号配置。

名称	类型	说明
nasEncryption	nasEncryptionType[]	NAS 加密算法的有序列表，用于加密 UE 和数据包核心之间的控制平面流量，从最不首选到最不首选。 如果未指定，数据包核心将使用内置的默认排序。
nasReroute	NASRerouteConfiguration	启用 4G NAS 重新路由的配置。

SiteResourceId

Object

对站点资源的引用。

名称	类型	说明
id	string pattern: ^/[sS][uU][bB][sS][cC][rR][iI][pP][tT][iI][oO][nN][sS]/[^/?#]+/[rR][eE][sS][oO][uU][rR][cC][eE][gG][rR][oO][uU][pP][sS]/[^/?#]+/[pP][rR][oO][vV][iI][dD][eE][rR][sS]/[mM][iI][cC][rR][oO][sS][oO][fF][tT]\.[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK]/[mM][oO][bB][iI][lL][eE][nN][eE][tT][wW][oO][rR][kK][sS]/[^/?#]+/[sS][iI][tT][eE][sS]/[^/?#]+$	站点资源 ID。

systemData

Object

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	上次修改的资源时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

UserAssignedIdentity

Object

用户分配的标识属性

名称	类型	说明
clientId	string (uuid)	分配的标识的客户端 ID。
principalId	string (uuid)	已分配标识的主体 ID。

UserConsentConfiguration

Object

名称	类型	说明
allowSupportTelemetryAccess	boolean	允许Microsoft从数据包核心访问非 PII 遥测信息。