Trunked Networks - Get

서비스:

Operator Nexus - Network Cloud

API 버전:

2025-09-01

제공된 트렁크 네트워크의 속성을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetworkCloud/trunkedNetworks/{trunkedNetworkName}?api-version=2025-09-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
trunkedNetworkName	path	True	string pattern: ^([a-zA-Z0-9][a-zA-Z0-9-_]{0,28}[a-zA-Z0-9])$	트렁크된 네트워크의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	TrunkedNetwork	Azure 운영이 성공적으로 완료되었습니다.
Other Status Codes	ErrorResponse	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

Get Trunked network

샘플 요청

HTTP

GET https://management.azure.com/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName?api-version=2025-09-01

Java

/**
 * Samples for TrunkedNetworks GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/TrunkedNetworks_Get
     * .json
     */
    /**
     * Sample code: Get Trunked network.
     * 
     * @param manager Entry point to NetworkCloudManager.
     */
    public static void getTrunkedNetwork(com.azure.resourcemanager.networkcloud.NetworkCloudManager manager) {
        manager.trunkedNetworks().getByResourceGroupWithResponse("resourceGroupName", "trunkedNetworkName",
            com.azure.core.util.Context.NONE);
    }
}

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 azure.identity import DefaultAzureCredential

from azure.mgmt.networkcloud import NetworkCloudMgmtClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-networkcloud
# USAGE
    python trunked_networks_get.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 = NetworkCloudMgmtClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.trunked_networks.get(
        resource_group_name="resourceGroupName",
        trunked_network_name="trunkedNetworkName",
    )
    print(response)


# x-ms-original-file: 2025-09-01/TrunkedNetworks_Get.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 armnetworkcloud_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/networkcloud/armnetworkcloud"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/46c51b03d99b113ecc3b38883e3cb2d395fe94a4/specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/TrunkedNetworks_Get.json
func ExampleTrunkedNetworksClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetworkcloud.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewTrunkedNetworksClient().Get(ctx, "resourceGroupName", "trunkedNetworkName", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.TrunkedNetwork = armnetworkcloud.TrunkedNetwork{
	// 	Name: to.Ptr("trunkedNetworkName"),
	// 	Type: to.Ptr("Microsoft.NetworkCloud/trunkedNetworks"),
	// 	ID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName"),
	// 	SystemData: &armnetworkcloud.SystemData{
	// 		CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:27:03.008Z"); return t}()),
	// 		CreatedBy: to.Ptr("identityA"),
	// 		CreatedByType: to.Ptr(armnetworkcloud.CreatedByTypeApplication),
	// 		LastModifiedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-01-22T13:29:03.001Z"); return t}()),
	// 		LastModifiedBy: to.Ptr("identityB"),
	// 		LastModifiedByType: to.Ptr(armnetworkcloud.CreatedByTypeUser),
	// 	},
	// 	Location: to.Ptr("location"),
	// 	Tags: map[string]*string{
	// 		"key1": to.Ptr("myvalue1"),
	// 		"key2": to.Ptr("myvalue2"),
	// 	},
	// 	ExtendedLocation: &armnetworkcloud.ExtendedLocation{
	// 		Name: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName"),
	// 		Type: to.Ptr("CustomLocation"),
	// 	},
	// 	Properties: &armnetworkcloud.TrunkedNetworkProperties{
	// 		AssociatedResourceIDs: []*string{
	// 			to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName")},
	// 			ClusterID: to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName"),
	// 			DetailedStatus: to.Ptr(armnetworkcloud.TrunkedNetworkDetailedStatusAvailable),
	// 			DetailedStatusMessage: to.Ptr("Trunked network is up"),
	// 			InterfaceName: to.Ptr("eth0"),
	// 			IsolationDomainIDs: []*string{
	// 				to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/l2IsolationDomains/l2IsolationDomainName"),
	// 				to.Ptr("/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName")},
	// 				ProvisioningState: to.Ptr(armnetworkcloud.TrunkedNetworkProvisioningStateSucceeded),
	// 				Vlans: []*int64{
	// 					to.Ptr[int64](12),
	// 					to.Ptr[int64](14)},
	// 				},
	// 			}
}

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 { NetworkCloud } = require("@azure/arm-networkcloud");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Get properties of the provided trunked network.
 *
 * @summary Get properties of the provided trunked network.
 * x-ms-original-file: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/TrunkedNetworks_Get.json
 */
async function getTrunkedNetwork() {
  const subscriptionId =
    process.env["NETWORKCLOUD_SUBSCRIPTION_ID"] || "123e4567-e89b-12d3-a456-426655440000";
  const resourceGroupName = process.env["NETWORKCLOUD_RESOURCE_GROUP"] || "resourceGroupName";
  const trunkedNetworkName = "trunkedNetworkName";
  const credential = new DefaultAzureCredential();
  const client = new NetworkCloud(credential, subscriptionId);
  const result = await client.trunkedNetworks.get(resourceGroupName, trunkedNetworkName);
  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

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.NetworkCloud.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.NetworkCloud;

// Generated from example definition: specification/networkcloud/resource-manager/Microsoft.NetworkCloud/stable/2025-09-01/examples/TrunkedNetworks_Get.json
// this example is just showing the usage of "TrunkedNetworks_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "123e4567-e89b-12d3-a456-426655440000";
string resourceGroupName = "resourceGroupName";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this NetworkCloudTrunkedNetworkResource
NetworkCloudTrunkedNetworkCollection collection = resourceGroupResource.GetNetworkCloudTrunkedNetworks();

// invoke the operation
string trunkedNetworkName = "trunkedNetworkName";
NullableResponse<NetworkCloudTrunkedNetworkResource> response = await collection.GetIfExistsAsync(trunkedNetworkName);
NetworkCloudTrunkedNetworkResource result = response.HasValue ? response.Value : null;

if (result == null)
{
    Console.WriteLine("Succeeded with null as result");
}
else
{
    // the variable result is a resource, you could call other operations on this instance as well
    // but just for demo, we get its data from this resource instance
    NetworkCloudTrunkedNetworkData resourceData = result.Data;
    // for demo we just print out the id
    Console.WriteLine($"Succeeded on id: {resourceData.Id}");
}

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

샘플 응답

상태 코드:

200

{
  "extendedLocation": {
    "name": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ExtendedLocation/customLocations/clusterExtendedLocationName",
    "type": "CustomLocation"
  },
  "id": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/trunkedNetworks/trunkedNetworkName",
  "location": "location",
  "name": "trunkedNetworkName",
  "properties": {
    "associatedResourceIds": [
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/virtualMachines/virtualMachineName"
    ],
    "clusterId": "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.NetworkCloud/clusters/clusterName",
    "detailedStatus": "Available",
    "detailedStatusMessage": "Trunked network is up",
    "interfaceName": "eth0",
    "isolationDomainIds": [
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/l2IsolationDomains/l2IsolationDomainName",
      "/subscriptions/123e4567-e89b-12d3-a456-426655440000/resourceGroups/resourceGroupName/providers/Microsoft.ManagedNetworkFabric/l3IsolationDomains/l3IsolationDomainName"
    ],
    "provisioningState": "Succeeded",
    "vlans": [
      12,
      14
    ]
  },
  "systemData": {
    "createdAt": "2021-01-22T13:27:03.008Z",
    "createdBy": "identityA",
    "createdByType": "Application",
    "lastModifiedAt": "2021-01-22T13:29:03.001Z",
    "lastModifiedBy": "identityB",
    "lastModifiedByType": "User"
  },
  "tags": {
    "key1": "myvalue1",
    "key2": "myvalue2"
  },
  "type": "Microsoft.NetworkCloud/trunkedNetworks"
}

정의

Name	Description
Azure.ResourceManager.CommonTypes.ExtendedLocation	확장된 위치의 복합 형식입니다.
createdByType	리소스를 만든 ID의 형식입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ExtendedLocationType	확장된 위치의 형식입니다.
HybridAksPluginType	더 이상 사용되지 않는 필드입니다. 이 필드는 이전에 선택 사항이었습니다. 이제 정의된 동작이 없으며 무시됩니다. 하이브리드 AKS의 네트워크 플러그 인 유형입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
TrunkedNetwork	TrunkedNetwork는 여러 격리 도메인과 지정된 VLAN을 활용하여 트렁크 네트워크를 생성하는 네트워크를 나타냅니다.
TrunkedNetworkDetailedStatus	트렁크 네트워크의 자세한 상태입니다.
TrunkedNetworkProvisioningState	트렁크 네트워크의 프로비저닝 상태입니다.

Azure.ResourceManager.CommonTypes.ExtendedLocation

Object

확장된 위치의 복합 형식입니다.

Name	형식	Description
name	string	확장된 위치의 이름입니다.
type	ExtendedLocationType	확장된 위치의 형식입니다.

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

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	오류 개체입니다.

ExtendedLocationType

열거형

확장된 위치의 형식입니다.

값	Description
EdgeZone	Azure Edge Zones 위치 유형
CustomLocation	Azure 사용자 지정 위치 유형

HybridAksPluginType

열거형

더 이상 사용되지 않는 필드입니다. 이 필드는 이전에 선택 사항이었습니다. 이제 정의된 동작이 없으며 무시됩니다. 하이브리드 AKS의 네트워크 플러그 인 유형입니다.

값	Description
DPDK	DPDK 플러그인 타입입니다.
SRIOV	SRIOV 플러그인 타입입니다.
OSDevice	OSDevice 플러그인 유형입니다.

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의 형식입니다.

TrunkedNetwork

Object

TrunkedNetwork는 여러 격리 도메인과 지정된 VLAN을 활용하여 트렁크 네트워크를 생성하는 네트워크를 나타냅니다.

Name	형식	Default value	Description
etag	string		"etag가 응답 본문에 제공되면 일반 etag 규칙에 따라 헤더로 제공될 수도 있습니다. 엔터티 태그는 동일한 요청된 리소스에서 둘 이상의 엔터티를 비교하는 데 사용됩니다. HTTP/1.1은 etag(섹션 14.19), If-Match(섹션 14.24), If-None-Match(섹션 14.26) 및 If-Range(섹션 14.27) 헤더 필드에서 엔터티 태그를 사용합니다.")
extendedLocation	Azure.ResourceManager.CommonTypes.ExtendedLocation		자원의 확장된 위치. 이 속성은 자원을 생성할 때 필요합니다.
id	string (arm-id)		리소스에 대한 정규화된 리소스 ID입니다. 예: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		리소스가 있는 지리적 위치
name	string		리소스의 이름
properties.associatedResourceIds	string[]		이 네트워크를 연결한 다른 Microsoft.NetworkCloud 리소스에 대한 리소스 ID 목록입니다.
properties.clusterId	string (arm-id)		이 트렁크 네트워크가 연결된 Network Cloud 클러스터의 리소스 ID입니다.
properties.detailedStatus	TrunkedNetworkDetailedStatus		트렁크 네트워크의 자세한 상태입니다.
properties.detailedStatusMessage	string		현재 세부 상태에 대한 설명 메시지입니다.
properties.hybridAksClustersAssociatedIds	string[]		더 이상 사용되지 않는 필드입니다. 이러한 필드는 비어 있거나 생략됩니다. 이 트렁크 네트워크와 연결된 하이브리드 AKS 클러스터 리소스 ID 목록입니다.
properties.hybridAksPluginType	HybridAksPluginType	SRIOV	더 이상 사용되지 않는 필드입니다. 이 필드는 이전에 선택 사항이었습니다. 이제 정의된 동작이 없으며 무시됩니다. 하이브리드 AKS의 네트워크 플러그 인 유형입니다.
properties.interfaceName	string maxLength: 12 pattern: ^[a-zA-Z0-9@._-]*$		가상 머신에서 이 트렁크된 네트워크의 기본 인터페이스 이름입니다. 이 이름은 해당 가상 머신의 네트워크 첨부 파일 구성에 제공된 이름으로 재정의할 수 있습니다.
properties.isolationDomainIds	string[]		Network Fabric 격리 도메인을 나타내는 리소스 ID 목록입니다. l2IsolationDomain 및 l3IsolationDomain 리소스의 조합일 수 있습니다.
properties.provisioningState	TrunkedNetworkProvisioningState		트렁크 네트워크의 프로비저닝 상태입니다.
properties.virtualMachinesAssociatedIds	string[]		더 이상 사용되지 않는 필드입니다. 이러한 필드는 비어 있거나 생략됩니다. 현재 이 트렁크 네트워크를 사용하는 하이브리드 AKS 가상 머신을 제외한 가상 머신 리소스 ID 목록입니다.
properties.vlans	integer[] (int64)		트렁크에 대한 격리 도메인에서 선택한 vlan 목록입니다.
systemData	systemData		createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.
tags	object		리소스 태그.
type	string		리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

TrunkedNetworkDetailedStatus

열거형

트렁크 네트워크의 자세한 상태입니다.

값	Description
Error	오류 상태.
Available	이용 가능 상태.
Provisioning	프로비저닝 상태.

TrunkedNetworkProvisioningState

열거형

트렁크 네트워크의 프로비저닝 상태입니다.

값	Description
Succeeded	성공 상태.
Failed	실패 상태.
Canceled	취소된 상태.
Provisioning	프로비저닝 상태.
Accepted	수락 상태.