Managed Namespaces - List By Managed Cluster

서비스:: AKS

API 버전:: 2026-03-01

지정된 관리형 클러스터의 관리형 네임스페이스 목록을 가져옵니다.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedClusters/{resourceName}/managedNamespaces?api-version=2026-03-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	관리되는 클러스터 리소스의 이름입니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ManagedNamespaceListResult	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	사용자 계정 가장

예제

List namespaces by Managed Cluster

샘플 요청

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces?api-version=2026-03-01


/**
 * Samples for ManagedNamespaces ListByManagedCluster.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-03-01/ManagedNamespacesList.json
     */
    /**
     * Sample code: List namespaces by Managed Cluster.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        listNamespacesByManagedCluster(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getManagedNamespaces().listByManagedCluster("rg1", "clustername1",
            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

from azure.identity import DefaultAzureCredential

from azure.mgmt.containerservice import ContainerServiceClient

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

    response = client.managed_namespaces.list_by_managed_cluster(
        resource_group_name="rg1",
        resource_name="clustername1",
    )
    for item in response:
        print(item)


# x-ms-original-file: 2026-03-01/ManagedNamespacesList.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 armcontainerservice_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/containerservice/armcontainerservice/v9"
)

// Generated from example definition: 2026-03-01/ManagedNamespacesList.json
func ExampleManagedNamespacesClient_NewListByManagedClusterPager() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcontainerservice.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	pager := clientFactory.NewManagedNamespacesClient().NewListByManagedClusterPager("rg1", "clustername1", nil)
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page = armcontainerservice.ManagedNamespacesClientListByManagedClusterResponse{
		// 	ManagedNamespaceListResult: armcontainerservice.ManagedNamespaceListResult{
		// 		Value: []*armcontainerservice.ManagedNamespace{
		// 			{
		// 				Name: to.Ptr("namespace1"),
		// 				Type: to.Ptr("Microsoft.ContainerService/managedClusters/managedNamespaces"),
		// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1"),
		// 				Location: to.Ptr("eastus2"),
		// 				Properties: &armcontainerservice.NamespaceProperties{
		// 					AdoptionPolicy: to.Ptr(armcontainerservice.AdoptionPolicyIfIdentical),
		// 					Annotations: map[string]*string{
		// 						"annatationKey": to.Ptr("annatationValue"),
		// 					},
		// 					DefaultNetworkPolicy: &armcontainerservice.NetworkPolicies{
		// 						Egress: to.Ptr(armcontainerservice.PolicyRuleAllowAll),
		// 						Ingress: to.Ptr(armcontainerservice.PolicyRuleAllowSameNamespace),
		// 					},
		// 					DefaultResourceQuota: &armcontainerservice.ResourceQuota{
		// 						CPULimit: to.Ptr("3m"),
		// 						CPURequest: to.Ptr("3m"),
		// 						MemoryLimit: to.Ptr("5Gi"),
		// 						MemoryRequest: to.Ptr("5Gi"),
		// 					},
		// 					DeletePolicy: to.Ptr(armcontainerservice.DeletePolicyKeep),
		// 					Labels: map[string]*string{
		// 						"kubernetes.azure.com/managedByArm": to.Ptr("true"),
		// 					},
		// 					ProvisioningState: to.Ptr(armcontainerservice.NamespaceProvisioningStateSucceeded),
		// 				},
		// 				Tags: map[string]*string{
		// 					"tagKey1": to.Ptr("tagValue1"),
		// 				},
		// 			},
		// 		},
		// 	},
		// }
	}
}

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

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

/**
 * This sample demonstrates how to gets a list of managed namespaces in the specified managed cluster.
 *
 * @summary gets a list of managed namespaces in the specified managed cluster.
 * x-ms-original-file: 2026-03-01/ManagedNamespacesList.json
 */
async function listNamespacesByManagedCluster() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new ContainerServiceClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.managedNamespaces.listByManagedCluster("rg1", "clustername1")) {
    resArray.push(item);
  }

  console.log(resArray);
}

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

샘플 응답

상태 코드:: 200

{
  "value": [
    {
      "name": "namespace1",
      "type": "Microsoft.ContainerService/managedClusters/managedNamespaces",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/clustername1/managedNamespaces/namespace1",
      "location": "eastus2",
      "properties": {
        "adoptionPolicy": "IfIdentical",
        "annotations": {
          "annatationKey": "annatationValue"
        },
        "defaultNetworkPolicy": {
          "egress": "AllowAll",
          "ingress": "AllowSameNamespace"
        },
        "defaultResourceQuota": {
          "cpuLimit": "3m",
          "cpuRequest": "3m",
          "memoryLimit": "5Gi",
          "memoryRequest": "5Gi"
        },
        "deletePolicy": "Keep",
        "labels": {
          "kubernetes.azure.com/managedByArm": "true"
        },
        "provisioningState": "Succeeded"
      },
      "tags": {
        "tagKey1": "tagValue1"
      }
    }
  ]
}

정의

Name	Description
AdoptionPolicy	이름이 같은 Kubernetes 네임스페이스가 이미 있는 경우의 작업입니다.
createdByType	리소스를 만든 ID 유형입니다.
DeletePolicy	네임스페이스의 옵션을 삭제합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ManagedNamespace	ARM에서 관리하는 네임스페이스입니다.
ManagedNamespaceListResult	ManagedNamespace 리스트 작업의 응답.
NamespaceProperties	ARM에서 관리하는 네임스페이스의 속성
NamespaceProvisioningState	네임스페이스의 현재 프로비저닝 상태입니다.
NetworkPolicies	수신 및 송신 규칙을 지정하는 네임스페이스의 기본 네트워크 정책입니다.
PolicyRule	다른 네트워크 정책 규칙을 나타내는 열거형입니다.
ResourceQuota	네임스페이스에 대한 리소스 할당량입니다.
systemData	리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

AdoptionPolicy

열거형

이름이 같은 Kubernetes 네임스페이스가 이미 있는 경우의 작업입니다.

값	Description
Never	네임스페이스가 Kubernetes에 이미 있는 경우 ARM에서 동일한 네임스페이스를 만들려는 시도는 실패합니다.
IfIdentical	차이가 없는 경우 ARM에서 관리할 기존 네임스페이스를 인수합니다.
Always	항상 ARM에서 관리할 기존 네임스페이스를 인수하면 일부 필드를 덮어쓸 수 있습니다.

createdByType

열거형

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

값	Description
User
Application
ManagedIdentity
Key

DeletePolicy

열거형

네임스페이스의 옵션을 삭제합니다.

값	Description
Keep	ARM 리소스만 삭제하고 Kubernetes 네임스페이스를 유지합니다. ManagedByARM 레이블도 삭제합니다.
Delete	ARM 리소스와 Kubernetes 네임스페이스를 함께 삭제합니다.

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