Managed Cluster Snapshots - List

Service:

AKS

API-versie:

2026-04-02-preview

Hiermee haalt u een lijst op met momentopnamen van beheerde clusters in het opgegeven abonnement.

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

URI-parameters

Name	In	Vereist	Type	Description
subscriptionId	path	True	string (uuid)	De ID van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	ManagedClusterSnapshotListResult	Azure-operatie succesvol voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List Managed Cluster Snapshots

Voorbeeldaanvraag

HTTP

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

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

Voorbeeldrespons

Statuscode:

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

Definities

Name	Description
createdByType	Het identiteitstype dat de resource heeft gemaakt.
CreationData	Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	Het foutdetail.
ErrorResponse	Foutreactie
LoadBalancerSku	De SKU van de load balancer voor het beheerde cluster. De standaardwaarde is 'standaard'. Zie Azure Load Balancer-SKU's voor meer informatie over de verschillen tussen load balancer-SKU's.
ManagedClusterPropertiesForSnapshot	beheerde clustereigenschappen voor momentopname. Deze eigenschappen zijn alleen-lezen.
ManagedClusterSKU	De SKU van een beheerd cluster.
ManagedClusterSKUName	De naam van een beheerde cluster-SKU.
ManagedClusterSKUTier	De laag van een beheerde cluster-SKU. Als dit niet is opgegeven, is de standaardwaarde 'Gratis'. Zie de AKS-prijscategorie voor meer informatie.
ManagedClusterSnapshot	Een resource voor een beheerde clustermomentopname.
ManagedClusterSnapshotListResult	De reactie van een ManagedClusterSnapshot-lijstoperatie.
NetworkMode	De netwerkmodus waarmee Azure CNI is geconfigureerd. Dit kan niet worden opgegeven als networkPlugin iets anders is dan 'azure'.
NetworkPlugin	De netwerkinvoegtoepassing die wordt gebruikt voor het bouwen van het Kubernetes-netwerk.
NetworkPluginMode	De modus die de netwerkinvoegtoepassing moet gebruiken.
NetworkPolicy	Netwerkbeleid dat wordt gebruikt voor het bouwen van het Kubernetes-netwerk.
NetworkProfileForSnapshot	netwerkprofiel voor momentopname van beheerde clusters. Deze eigenschappen zijn alleen-lezen.
SnapshotType	Het type momentopname. De standaardwaarde is NodePool.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

createdByType

Opsomming

Het identiteitstype dat de resource heeft gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

CreationData

Object

Gegevens die worden gebruikt bij het maken van een doelresource op basis van een bronresource.

Name	Type	Description
sourceResourceId	string (arm-id)	Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

Het foutdetail.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Aanvullende informatie over de fout.
code	string	De foutcode.
details	ErrorDetail[]	De foutgegevens.
message	string	Het foutbericht.
target	string	Het foutdoelwit.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

LoadBalancerSku

Opsomming

De SKU van de load balancer voor het beheerde cluster. De standaardwaarde is 'standaard'. Zie Azure Load Balancer-SKU's voor meer informatie over de verschillen tussen load balancer-SKU's.

Waarde	Description
standard	Gebruik een standaard load balancer. Dit is de aanbevolen Load Balancer SKU. Voor meer informatie over het werken met de load balancer in de beheerde cluster, zie het artikel standard Load Balancer.
basic	Gebruik een eenvoudige Load Balancer met beperkte functionaliteit.

ManagedClusterPropertiesForSnapshot

Object

beheerde clustereigenschappen voor momentopname. Deze eigenschappen zijn alleen-lezen.

Name	Type	Description
enableRbac	boolean	Of de cluster Kubernetes Role-Based Access Control heeft ingeschakeld of niet.
kubernetesVersion	string	De huidige kubernetes-versie.
networkProfile	NetworkProfileForSnapshot	Het huidige netwerkprofiel.
sku	ManagedClusterSKU	De huidige beheerde cluster-SKU.

ManagedClusterSKU

Object

De SKU van een beheerd cluster.

Name	Type	Description
name	ManagedClusterSKUName	De naam van een beheerde cluster-SKU.
tier	ManagedClusterSKUTier	De laag van een beheerde cluster-SKU. Als dit niet is opgegeven, is de standaardwaarde 'Gratis'. Zie de AKS-prijscategorie voor meer informatie.

ManagedClusterSKUName

Opsomming

De naam van een beheerde cluster-SKU.

Waarde	Description
Base	Basisoptie voor het AKS-besturingsvlak.
Automatic	Automatische clusters zijn geoptimaliseerd om de meeste productieworkloads uit te voeren met een configuratie die voldoet aan AKS-best practices en aanbevelingen voor cluster- en workloadconfiguratie, schaalbaarheid en beveiliging. Zie aka.ms/aks/automatic voor meer informatie over automatische clusters.

ManagedClusterSKUTier

Opsomming

De laag van een beheerde cluster-SKU. Als dit niet is opgegeven, is de standaardwaarde 'Gratis'. Zie de AKS-prijscategorie voor meer informatie.

Waarde	Description
Premium	Cluster heeft premium-mogelijkheden naast alle mogelijkheden die zijn opgenomen in Standard. Premium maakt selectie van LongTermSupport (aka.ms/aks/lts) mogelijk voor bepaalde Kubernetes-versies.
Standard	Aanbevolen voor bedrijfskritieke en productieworkloads. Omvat automatische schaalaanpassing van kubernetes-besturingsvlak, workloadintensieve tests en maximaal 5000 knooppunten per cluster. Waarborgt 99,95% beschikbaarheid van het Kubernetes API-servereindpunt voor clusters die Beschikbaarheidszones gebruiken en 99,9% beschikbaarheid voor clusters die Beschikbaarheidszones niet gebruiken.
Free	Het clusterbeheer is gratis, maar er worden kosten in rekening gebracht voor vm-, opslag- en netwerkgebruik. Het meest geschikt voor experimenteren, leren, eenvoudig testen of workloads met minder dan 10 knooppunten. Niet aanbevolen voor productiegebruiksscenario's.

ManagedClusterSnapshot

Object

Een resource voor een beheerde clustermomentopname.

Name	Type	Default value	Description
id	string (arm-id)		Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
location	string		De geografische locatie waar de resource zich bevindt
name	string		De naam van de resource
properties.creationData	CreationData		CreationData die moet worden gebruikt om de bronresource-id op te geven om deze momentopname te maken.
properties.managedClusterPropertiesReadOnly	ManagedClusterPropertiesForSnapshot		Wat de eigenschappen worden weergegeven bij het ophalen van een momentopname van een beheerd cluster. Deze eigenschappen zijn alleen-lezen.
properties.snapshotType	SnapshotType	NodePool	Het type momentopname. De standaardwaarde is NodePool.
systemData	systemData		Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object		Resourcetags.
type	string		Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ManagedClusterSnapshotListResult

Object

De reactie van een ManagedClusterSnapshot-lijstoperatie.

Name	Type	Description
nextLink	string (uri)	De koppeling naar de volgende pagina met items
value	ManagedClusterSnapshot[]	De ManagedClusterSnapshot-items op deze pagina

NetworkMode

Opsomming

De netwerkmodus waarmee Azure CNI is geconfigureerd. Dit kan niet worden opgegeven als networkPlugin iets anders is dan 'azure'.

Waarde	Description
transparent	Er wordt geen brug gemaakt. Intra-VM Pod-tot-Pod-communicatie verloopt via IP-routes die door Azure CNI zijn aangemaakt. Zie Transparante modus voor meer informatie.
bridge	Dit wordt niet meer ondersteund

NetworkPlugin

Opsomming

De netwerkinvoegtoepassing die wordt gebruikt voor het bouwen van het Kubernetes-netwerk.

Waarde	Description
azure	Gebruik de Azure CNI-netwerkinvoegtoepassing. Zie Azure CNI (geavanceerd) netwerken voor meer informatie.
kubenet	Gebruik de Kubenet-netwerkinvoegtoepassing. Zie Kubenet-netwerk (basic) voor meer informatie.
none	Er is geen CNI-invoegtoepassing vooraf geïnstalleerd. Zie BYO CNI- voor meer informatie.

NetworkPluginMode

Opsomming

De modus die de netwerkinvoegtoepassing moet gebruiken.

Waarde	Description
overlay	Wordt gebruikt met networkPlugin=azure, pods krijgen IP-adressen van de PodCIDR-adresruimte, maar gebruiken Azure Routing Domains in plaats van de methode van Kubenet van routetabellen. Ga voor meer informatie naar https://aka.ms/aks/azure-cni-overlay.

NetworkPolicy

Opsomming

Netwerkbeleid dat wordt gebruikt voor het bouwen van het Kubernetes-netwerk.

Waarde	Description
none	Netwerkbeleid wordt niet afgedwongen. Dit is de standaardwaarde wanneer NetworkPolicy niet is opgegeven.
calico	Gebruik Calico-netwerkbeleid. Zie verschillen tussen Azure- en Calico-beleid voor meer informatie.
azure	Gebruik Azure-netwerkbeleid. Zie verschillen tussen Azure- en Calico-beleid voor meer informatie.
cilium	Gebruik Cilium om netwerkbeleid af te dwingen. Hiervoor moet networkDataplane 'cilium' zijn.

NetworkProfileForSnapshot

Object

netwerkprofiel voor momentopname van beheerde clusters. Deze eigenschappen zijn alleen-lezen.

Name	Type	Description
loadBalancerSku	LoadBalancerSku	loadBalancerSku voor momentopname van beheerde clusters.
networkMode	NetworkMode	networkMode voor momentopname van beheerde clusters.
networkPlugin	NetworkPlugin	networkPlugin voor managed cluster snapshot.
networkPluginMode	NetworkPluginMode	NetworkPluginMode voor momentopname van beheerde clusters.
networkPolicy	NetworkPolicy	networkPolicy voor momentopname van beheerde clusters.

SnapshotType

Opsomming

Het type momentopname. De standaardwaarde is NodePool.

Waarde	Description
NodePool	De momentopname is een momentopname van een knooppuntgroep.
ManagedCluster	De momentopname is een momentopname van een beheerd cluster.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het aanmaken van resources (UTC).
createdBy	string	De identiteit die de resource heeft gemaakt.
createdByType	createdByType	Het identiteitstype dat de resource heeft gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.