Managed Cluster Snapshots - List

Служба:

AKS

Версия API:

2026-04-02-preview

Получает список снимков управляемого кластера в указанной подписке.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/managedclustersnapshots?api-version=2026-04-02-preview

Параметры URI

Имя	В	Обязательно	Тип	Описание
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	ManagedClusterSnapshotListResult	Операция Azure успешно завершена.
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
user_impersonation	выдать себя за учетную запись пользователя

Примеры

List Managed Cluster Snapshots

Образец запроса

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/managedclustersnapshots?api-version=2026-04-02-preview

Java

/**
 * Samples for ManagedClusterSnapshots List.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-04-02-preview/ManagedClusterSnapshotsList.json
     */
    /**
     * Sample code: List Managed Cluster Snapshots.
     * 
     * @param manager Entry point to ContainerServiceManager.
     */
    public static void
        listManagedClusterSnapshots(com.azure.resourcemanager.containerservice.ContainerServiceManager manager) {
        manager.serviceClient().getManagedClusterSnapshots().list(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.containerservice import ContainerServiceClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-containerservice
# USAGE
    python managed_cluster_snapshots_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_cluster_snapshots.list()
    for item in response:
        print(item)


# x-ms-original-file: 2026-04-02-preview/ManagedClusterSnapshotsList.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 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-04-02-preview/ManagedClusterSnapshotsList.json
func ExampleManagedClusterSnapshotsClient_NewListPager() {
	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.NewManagedClusterSnapshotsClient().NewListPager(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.ManagedClusterSnapshotsClientListResponse{
		// 	ManagedClusterSnapshotListResult: armcontainerservice.ManagedClusterSnapshotListResult{
		// 		Value: []*armcontainerservice.ManagedClusterSnapshot{
		// 			{
		// 				Name: to.Ptr("snapshot1"),
		// 				Type: to.Ptr("Microsoft.ContainerService/managedClusterSnapshots"),
		// 				ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedclustersnapshots/snapshot1"),
		// 				Location: to.Ptr("westus"),
		// 				Properties: &armcontainerservice.ManagedClusterSnapshotProperties{
		// 					CreationData: &armcontainerservice.CreationData{
		// 						SourceResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster1"),
		// 					},
		// 					ManagedClusterPropertiesReadOnly: &armcontainerservice.ManagedClusterPropertiesForSnapshot{
		// 						EnableRbac: to.Ptr(true),
		// 						KubernetesVersion: to.Ptr("1.20.5"),
		// 						NetworkProfile: &armcontainerservice.NetworkProfileForSnapshot{
		// 							LoadBalancerSKU: to.Ptr(armcontainerservice.LoadBalancerSKUStandard),
		// 							NetworkMode: to.Ptr(armcontainerservice.NetworkModeBridge),
		// 							NetworkPlugin: to.Ptr(armcontainerservice.NetworkPluginKubenet),
		// 							NetworkPolicy: to.Ptr(armcontainerservice.NetworkPolicyCalico),
		// 						},
		// 						SKU: &armcontainerservice.ManagedClusterSKU{
		// 							Name: to.Ptr(armcontainerservice.ManagedClusterSKUName("Basic")),
		// 							Tier: to.Ptr(armcontainerservice.ManagedClusterSKUTierFree),
		// 						},
		// 					},
		// 					SnapshotType: to.Ptr(armcontainerservice.SnapshotTypeManagedCluster),
		// 				},
		// 				SystemData: &armcontainerservice.SystemData{
		// 					CreatedAt: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-08-09T20:13:23.298420761Z"); return t}()),
		// 					CreatedBy: to.Ptr("user1"),
		// 					CreatedByType: to.Ptr(armcontainerservice.CreatedByTypeUser),
		// 				},
		// 				Tags: map[string]*string{
		// 					"key1": to.Ptr("val1"),
		// 					"key2": to.Ptr("val2"),
		// 				},
		// 			},
		// 		},
		// 	},
		// }
	}
}

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 { ContainerServiceClient } = require("@azure/arm-containerservice");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to gets a list of managed cluster snapshots in the specified subscription.
 *
 * @summary gets a list of managed cluster snapshots in the specified subscription.
 * x-ms-original-file: 2026-04-02-preview/ManagedClusterSnapshotsList.json
 */
async function listManagedClusterSnapshots() {
  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.managedClusterSnapshots.list()) {
    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": "snapshot1",
      "type": "Microsoft.ContainerService/managedClusterSnapshots",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedclustersnapshots/snapshot1",
      "location": "westus",
      "properties": {
        "creationData": {
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster1"
        },
        "managedClusterPropertiesReadOnly": {
          "enableRbac": true,
          "kubernetesVersion": "1.20.5",
          "networkProfile": {
            "loadBalancerSku": "standard",
            "networkMode": "bridge",
            "networkPlugin": "kubenet",
            "networkPolicy": "calico"
          },
          "sku": {
            "name": "Basic",
            "tier": "Free"
          }
        },
        "snapshotType": "ManagedCluster"
      },
      "systemData": {
        "createdAt": "2021-08-09T20:13:23.298420761Z",
        "createdBy": "user1",
        "createdByType": "User"
      },
      "tags": {
        "key1": "val1",
        "key2": "val2"
      }
    }
  ]
}

Определения

Имя	Описание
createdByType	Тип учётной записи, создавшей ресурс.
CreationData	Данные, используемые при создании целевого ресурса из исходного ресурса.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Подробности ошибки.
ErrorResponse	Ответ на ошибку
LoadBalancerSku	SKU подсистемы балансировки нагрузки для управляемого кластера. Значение по умолчанию — "стандартный". Дополнительные сведения о различиях между номерами SKU подсистемы балансировки нагрузки см. в S KU Azure Load Balancer.
ManagedClusterPropertiesForSnapshot	Свойства управляемого кластера для моментального снимка доступны только для чтения.
ManagedClusterSKU	Номер SKU управляемого кластера.
ManagedClusterSKUName	Имя SKU управляемого кластера.
ManagedClusterSKUTier	Уровень SKU управляемого кластера. Если значение не указано, значение по умолчанию — "Бесплатный". См. AKS Pricing Tier для подробностей.
ManagedClusterSnapshot	Ресурс моментального снимка управляемого кластера.
ManagedClusterSnapshotListResult	Ответ операции списка ManagedClusterSnapshot.
NetworkMode	Сетевой режим, с которым настроен Azure CNI. Это невозможно указать, если networkPlugin является что-либо другое, чем azure.
NetworkPlugin	Подключаемый модуль сети, используемый для создания сети Kubernetes.
NetworkPluginMode	Режим, который должен использовать подключаемый модуль сети.
NetworkPolicy	Политика сети, используемая для создания сети Kubernetes.
NetworkProfileForSnapshot	сетевой профиль для моментального снимка управляемого кластера эти свойства доступны только для чтения.
SnapshotType	Тип моментального снимка. Значение по умолчанию — NodePool.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.

createdByType

Перечисление

Тип учётной записи, создавшей ресурс.

Значение	Описание
User
Application
ManagedIdentity
Key

CreationData

Объект

Данные, используемые при создании целевого ресурса из исходного ресурса.

Имя	Тип	Описание
sourceResourceId	string (arm-id)	Это идентификатор ARM исходного объекта, который будет использоваться для создания целевого объекта.

ErrorAdditionalInfo

Объект

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Объект

Подробности ошибки.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Объект

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

LoadBalancerSku

Перечисление

SKU подсистемы балансировки нагрузки для управляемого кластера. Значение по умолчанию — "стандартный". Дополнительные сведения о различиях между номерами SKU подсистемы балансировки нагрузки см. в S KU Azure Load Balancer.

Значение	Описание
standard	Используйте стандартную подсистему балансировки нагрузки. Это рекомендованный SKU Load Balancer. Для получения дополнительной информации о работе с load balancer в управляемом кластере см. статью standard Load Balancer.
basic	Используйте базовую подсистему балансировки нагрузки с ограниченными возможностями.

ManagedClusterPropertiesForSnapshot

Объект

Свойства управляемого кластера для моментального снимка доступны только для чтения.

Имя	Тип	Описание
enableRbac	boolean	Включил кластер Kubernetes Role-Based контроль доступа или нет.
kubernetesVersion	string	Текущая версия kubernetes.
networkProfile	NetworkProfileForSnapshot	Текущий сетевой профиль.
sku	ManagedClusterSKU	Текущий номер SKU управляемого кластера.

ManagedClusterSKU

Объект

Номер SKU управляемого кластера.

Имя	Тип	Описание
name	ManagedClusterSKUName	Имя SKU управляемого кластера.
tier	ManagedClusterSKUTier	Уровень SKU управляемого кластера. Если значение не указано, значение по умолчанию — "Бесплатный". См. AKS Pricing Tier для подробностей.

ManagedClusterSKUName

Перечисление

Имя SKU управляемого кластера.

Значение	Описание
Base	Базовый параметр для плоскости управления AKS.
Automatic	Автоматические кластеры оптимизированы для выполнения большинства производственных рабочих нагрузок с конфигурацией, которая соответствует передовым методикам и рекомендациям AKS по настройке, масштабируемости и безопасности кластеров и рабочих нагрузок. Дополнительные сведения о автоматических кластерах см. в aka.ms/aks/automatic.

ManagedClusterSKUTier

Перечисление

Уровень SKU управляемого кластера. Если значение не указано, значение по умолчанию — "Бесплатный". См. AKS Pricing Tier для подробностей.

Значение	Описание
Premium	Кластер имеет возможности уровня "Премиум" помимо всех возможностей, включенных в "Стандартный". Premium позволяет выбрать LongTermSupport (aka.ms/aks/lts) для определенных версий Kubernetes.
Standard	Рекомендуется для критически важных рабочих нагрузок и рабочих нагрузок. Включает автомасштабирование плоскости управления Kubernetes, интенсивное тестирование рабочей нагрузки и до 5000 узлов на кластер. Гарантирует доступность 99.95% конечной точки сервера Kubernetes API для кластеров, использующих Зоны доступности, и 99.9% доступности для кластеров, не использующих Зоны доступности.
Free	Управление кластерами бесплатно, но взимается плата за использование виртуальных машин, хранилища и сети. Лучше всего экспериментировать, учиться, простое тестирование или рабочие нагрузки с менее чем 10 узлами. Не рекомендуется для рабочих вариантов использования.

ManagedClusterSnapshot

Объект

Ресурс моментального снимка управляемого кластера.

Имя	Тип	Значение по умолчанию	Описание
id	string (arm-id)		Полный идентификатор ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		Географическое расположение, в котором находится ресурс
name	string		Имя ресурса.
properties.creationData	CreationData		CreateData, используемый для указания исходного идентификатора ресурса для создания этого моментального снимка.
properties.managedClusterPropertiesReadOnly	ManagedClusterPropertiesForSnapshot		Какие свойства будут отображаться при получении моментального снимка управляемого кластера. Эти свойства доступны только для чтения.
properties.snapshotType	SnapshotType	NodePool	Тип моментального снимка. Значение по умолчанию — NodePool.
systemData	systemData		Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object		Теги ресурсов.
type	string		Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ManagedClusterSnapshotListResult

Объект

Ответ операции списка ManagedClusterSnapshot.

Имя	Тип	Описание
nextLink	string (uri)	Ссылка на следующую страницу элементов
value	ManagedClusterSnapshot[]	Элементы ManagedClusterSnapshot на этой странице

NetworkMode

Перечисление

Сетевой режим, с которым настроен Azure CNI. Это невозможно указать, если networkPlugin является что-либо другое, чем azure.

Значение	Описание
transparent	Мост не создается. Intra-VM Связь Pod to Pod осуществляется через IP-маршруты, созданные Azure CNI. Дополнительные сведения см. в прозрачном режиме.
bridge	Это больше не поддерживается

NetworkPlugin

Перечисление

Подключаемый модуль сети, используемый для создания сети Kubernetes.

Значение	Описание
azure	Используйте подключаемый модуль сети Azure CNI. См. Azure CNI (продвинутые сети для получения дополнительной информации.
kubenet	Используйте подключаемый модуль сети Kubenet. Дополнительные сведения см. в сети Kubenet (базовый).
none	Подключаемый модуль CNI не установлен. Дополнительные сведения см. в CNI BYO.

NetworkPluginMode

Перечисление

Режим, который должен использовать подключаемый модуль сети.

Значение	Описание
overlay	Используется с networkPlugin=azure, модули pod получают IP-адреса из адресного пространства PodCIDR, но используют домены маршрутизации Azure, а не методы таблиц маршрутов Kubenet. Дополнительные сведения см. в статье https://aka.ms/aks/azure-cni-overlay.

NetworkPolicy

Перечисление

Политика сети, используемая для создания сети Kubernetes.

Значение	Описание
none	Политики сети не будут применяться. Это значение по умолчанию, если NetworkPolicy не указан.
calico	Используйте политики сети Calico. См. различия между политиками Azure и Calico для получения дополнительной информации.
azure	Используйте политики сети Azure. См. различия между политиками Azure и Calico для получения дополнительной информации.
cilium	Используйте Cilium для применения политик сети. Для этого требуется, чтобы networkDataplane был "cilium".

NetworkProfileForSnapshot

Объект

сетевой профиль для моментального снимка управляемого кластера эти свойства доступны только для чтения.

Имя	Тип	Описание
loadBalancerSku	LoadBalancerSku	loadBalancerSku для снимка управляемого кластера.
networkMode	NetworkMode	networkMode для снимка управляемого кластера.
networkPlugin	NetworkPlugin	networkPlugin для снимка управляемого кластера.
networkPluginMode	NetworkPluginMode	NetworkPluginMode для снимка управляемого кластера.
networkPolicy	NetworkPolicy	networkPolicy для снимка управляемого кластера.

SnapshotType

Перечисление

Тип моментального снимка. Значение по умолчанию — NodePool.

Значение	Описание
NodePool	Моментальный снимок — это моментальный снимок пула узлов.
ManagedCluster	Моментальный снимок — это моментальный снимок управляемого кластера.

systemData

Объект

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string (date-time)	Метка времени создания ресурса (UTC).
createdBy	string	Идентификатор, создавший ресурс.
createdByType	createdByType	Тип учётной записи, создавшей ресурс.
lastModifiedAt	string (date-time)	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.