Managed Cluster Snapshots - List

Service:

AKS

Version d’API:

2026-04-02-preview

Obtient une liste d’instantanés de cluster managés dans l’abonnement spécifié.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	ManagedClusterSnapshotListResult	Opération Azure terminée avec succès.
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Flux OAuth2 d’Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	Usurper l’identité de votre compte utilisateur

Exemples

List Managed Cluster Snapshots

Exemple de requête

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
createdByType	Type d’identité qui a créé la ressource.
CreationData	Données utilisées lors de la création d’une ressource cible à partir d’une ressource source.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
LoadBalancerSku	Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez références SKU Azure Load Balancer pour plus d’informations sur les différences entre les références SKU de l’équilibreur de charge.
ManagedClusterPropertiesForSnapshot	propriétés de cluster managé pour l’instantané, ces propriétés sont en lecture seule.
ManagedClusterSKU	Référence SKU d’un cluster managé.
ManagedClusterSKUName	Nom d’une référence SKU de cluster managé.
ManagedClusterSKUTier	Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Voir AKS Pricing Tier pour plus de détails.
ManagedClusterSnapshot	Ressource d’instantané de cluster managé.
ManagedClusterSnapshotListResult	La réponse d’une opération de liste ManagedClusterSnapshot.
NetworkMode	Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être précisé si networkPlugin est autre chose que « azure ».
NetworkPlugin	Plug-in réseau utilisé pour créer le réseau Kubernetes.
NetworkPluginMode	Mode que le plug-in réseau doit utiliser.
NetworkPolicy	Stratégie réseau utilisée pour créer le réseau Kubernetes.
NetworkProfileForSnapshot	profil réseau pour l’instantané de cluster managé, ces propriétés sont en lecture seule.
SnapshotType	Type d’instantané. La valeur par défaut est NodePool.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

CreationData

Objet

Données utilisées lors de la création d’une ressource cible à partir d’une ressource source.

Nom	Type	Description
sourceResourceId	string (arm-id)	Il s’agit de l’ID ARM de l’objet source à utiliser pour créer l’objet cible.

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires
type	string	Le type d’informations supplémentaires.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations complémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

LoadBalancerSku

Énumération

Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez références SKU Azure Load Balancer pour plus d’informations sur les différences entre les références SKU de l’équilibreur de charge.

Valeur	Description
standard	Utilisez un équilibreur de charge standard. C’est le SKU Load Balancer recommandé. Pour plus d’informations sur la collaboration avec les load balancer dans le cluster géré, voir l’article standard Load Balancer.
basic	Utilisez un équilibreur de charge de base avec des fonctionnalités limitées.

ManagedClusterPropertiesForSnapshot

Objet

propriétés de cluster managé pour l’instantané, ces propriétés sont en lecture seule.

Nom	Type	Description
enableRbac	boolean	Que le cluster ait activé Kubernetes Role-Based Access Control ou non.
kubernetesVersion	string	Version actuelle de Kubernetes.
networkProfile	NetworkProfileForSnapshot	Profil réseau actuel.
sku	ManagedClusterSKU	Référence SKU du cluster managé actuel.

ManagedClusterSKU

Objet

Référence SKU d’un cluster managé.

Nom	Type	Description
name	ManagedClusterSKUName	Nom d’une référence SKU de cluster managé.
tier	ManagedClusterSKUTier	Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Voir AKS Pricing Tier pour plus de détails.

ManagedClusterSKUName

Énumération

Nom d’une référence SKU de cluster managé.

Valeur	Description
Base	Option de base pour le plan de contrôle AKS.
Automatic	Les clusters automatiques sont optimisés pour exécuter la plupart des charges de travail de production avec une configuration qui suit les meilleures pratiques AKS et les recommandations pour la configuration, l’évolutivité et la sécurité des clusters et des charges de travail. Pour plus d’informations sur les clusters automatiques, consultez aka.ms/aks/automatic.

ManagedClusterSKUTier

Énumération

Niveau d’une référence SKU de cluster managé. S’il n’est pas spécifié, la valeur par défaut est « Free ». Voir AKS Pricing Tier pour plus de détails.

Valeur	Description
Premium	Le cluster dispose de fonctionnalités Premium en plus de toutes les fonctionnalités incluses dans « Standard ». Premium active la sélection de LongTermSupport (aka.ms/aks/lts) pour certaines versions de Kubernetes.
Standard	Recommandé pour les charges de travail stratégiques et de production. Inclut la mise à l’échelle automatique du plan de contrôle Kubernetes, les tests gourmands en charge de travail et jusqu’à 5 000 nœuds par cluster. Garantit une disponibilité de 99,95% du point de terminaison serveur API Kubernetes pour les clusters utilisant Zones de disponibilité et une% de disponibilité de 99,9 pour les clusters qui n'utilisent pas Zones de disponibilité.
Free	La gestion du cluster est gratuite, mais facturée pour l’utilisation des machines virtuelles, du stockage et de la mise en réseau. Il est préférable d’expérimenter, d’apprendre, de tester facilement ou de charges de travail avec moins de 10 nœuds. Non recommandé pour les cas d’usage de production.

ManagedClusterSnapshot

Objet

Ressource d’instantané de cluster managé.

Nom	Type	Valeur par défaut	Description
id	string (arm-id)		Identifiant de ressource entièrement qualifié pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
location	string		Emplacement géographique où réside la ressource
name	string		nom de la ressource.
properties.creationData	CreationData		CreationData à utiliser pour spécifier l’ID de ressource source pour créer cet instantané.
properties.managedClusterPropertiesReadOnly	ManagedClusterPropertiesForSnapshot		Ce que les propriétés seront montrées lors de l’obtention d’un instantané de cluster managé. Ces propriétés sont en lecture seule.
properties.snapshotType	SnapshotType	NodePool	Type d’instantané. La valeur par défaut est NodePool.
systemData	systemData		Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object		Balises de ressources.
type	string		Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ManagedClusterSnapshotListResult

Objet

La réponse d’une opération de liste ManagedClusterSnapshot.

Nom	Type	Description
nextLink	string (uri)	Lien vers la page suivante des éléments
value	ManagedClusterSnapshot[]	Les éléments ManagedClusterSnapshot sur cette page

NetworkMode

Énumération

Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être précisé si networkPlugin est autre chose que « azure ».

Valeur	Description
transparent	Aucun pont n’est créé. Intra-VM communication Pod à Pod se fait via des routes IP créées par Azure CNI. Pour plus d’informations, consultez en mode transparent.
bridge	Cela n’est plus pris en charge

NetworkPlugin

Énumération

Plug-in réseau utilisé pour créer le réseau Kubernetes.

Valeur	Description
azure	Utilisez le plug-in réseau Azure CNI. Voir Azure CNI (avancé) réseau pour plus d’informations.
kubenet	Utilisez le plug-in réseau Kubenet. Pour plus d’informations, consultez de mise en réseau Kubenet (de base).
none	Aucun plug-in CNI n’est préinstallé. Pour plus d’informations, consultez BYO CNI.

NetworkPluginMode

Énumération

Mode que le plug-in réseau doit utiliser.

Valeur	Description
overlay	Utilisés avec networkPlugin=azure, les pods reçoivent des adresses IP à partir de l’espace d’adressage PodCIDR, mais utilisent les domaines de routage Azure plutôt que la méthode de tables de routage kubenet. Pour plus d’informations, visitez https://aka.ms/aks/azure-cni-overlay.

NetworkPolicy

Énumération

Stratégie réseau utilisée pour créer le réseau Kubernetes.

Valeur	Description
none	Les stratégies réseau ne seront pas appliquées. Il s’agit de la valeur par défaut lorsque NetworkPolicy n’est pas spécifié.
calico	Utilisez des stratégies réseau Calico. Voir différences entre les polices Azure et Calico pour plus d’informations.
azure	Utilisez des stratégies réseau Azure. Voir différences entre les polices Azure et Calico pour plus d’informations.
cilium	Utilisez Cilium pour appliquer des stratégies réseau. Cela nécessite que networkDataplane soit « cilium ».

NetworkProfileForSnapshot

Objet

profil réseau pour l’instantané de cluster managé, ces propriétés sont en lecture seule.

Nom	Type	Description
loadBalancerSku	LoadBalancerSku	loadBalancerSku pour l’instantané de cluster géré.
networkMode	NetworkMode	networkMode pour l’instantané de cluster géré.
networkPlugin	NetworkPlugin	networkPlugin pour l’instantané de cluster géré.
networkPluginMode	NetworkPluginMode	NetworkPluginMode pour l’instantané de cluster géré.
networkPolicy	NetworkPolicy	networkPolicy pour l’instantané de cluster géré.

SnapshotType

Énumération

Type d’instantané. La valeur par défaut est NodePool.

Valeur	Description
NodePool	L’instantané est un instantané d’un pool de nœuds.
ManagedCluster	L’instantané est un instantané d’un cluster managé.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.