Managed Cluster Snapshots - List

Tjänst:: AKS

API-version:: 2026-04-02-preview

Hämtar en lista över ögonblicksbilder av hanterade kluster i den angivna prenumerationen.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	ManagedClusterSnapshotListResult	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

List Managed Cluster Snapshots

Exempelbegäran

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


/**
 * 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

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

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

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

Exempelsvar

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

Definitioner

Name	Description
createdByType	Den typ av identitet som skapade resursen.
CreationData	Data som används när du skapar en målresurs från en källresurs.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
LoadBalancerSku	Lastbalanserarens SKU för det hanterade klustret. Standardvärdet är "standard". Mer information om skillnaderna mellan SKU:er för lastbalanserare finns i SKU:er för Azure Load Balancer.
ManagedClusterPropertiesForSnapshot	hanterade klusteregenskaper för ögonblicksbilder är dessa egenskaper skrivskyddade.
ManagedClusterSKU	SKU:n för ett hanterat kluster.
ManagedClusterSKUName	Namnet på en SKU för ett hanterat kluster.
ManagedClusterSKUTier	Nivån för en SKU för ett hanterat kluster. Om det inte anges är standardvärdet "Kostnadsfri". Se AKS prisnivå för mer information.
ManagedClusterSnapshot	En ögonblicksbildsresurs för ett hanterat kluster.
ManagedClusterSnapshotListResult	Svaret på en ManagedClusterSnapshot-listoperation.
NetworkMode	Nätverksläget som Azure CNI är konfigurerat med. Detta kan inte specificeras om networkPlugin är något annat än 'azure'.
NetworkPlugin	Nätverksinsticksprogram som används för att skapa Kubernetes-nätverket.
NetworkPluginMode	Läget som nätverkets plugin-program ska använda.
NetworkPolicy	Nätverksprincip som används för att skapa Kubernetes-nätverket.
NetworkProfileForSnapshot	nätverksprofil för ögonblicksbild av hanterat kluster är dessa egenskaper skrivskyddade.
SnapshotType	Typen av ögonblicksbild. Standardvärdet är NodePool.
systemData	Metadata som rör skapande och senaste ändring av resursen.

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
User
Application
ManagedIdentity
Key

CreationData

Objekt

Data som används när du skapar en målresurs från en källresurs.

Name	Typ	Description
sourceResourceId	string (arm-id)	Det här är ARM-ID:t för källobjektet som ska användas för att skapa målobjektet.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

LoadBalancerSku

Uppräkning

Lastbalanserarens SKU för det hanterade klustret. Standardvärdet är "standard". Mer information om skillnaderna mellan SKU:er för lastbalanserare finns i SKU:er för Azure Load Balancer.

Värde	Description
standard	Använd en standardlastbalanserare. Detta är den rekommenderade Load Balancer SKU. För mer information om hur man arbetar med load balancer i det hanterade klustret, se artikeln om standard Load Balancer.
basic	Använd en grundläggande lastbalanserare med begränsad funktionalitet.

ManagedClusterPropertiesForSnapshot

Objekt

hanterade klusteregenskaper för ögonblicksbilder är dessa egenskaper skrivskyddade.

Name	Typ	Description
enableRbac	boolean	Oavsett om klustret har aktiverat Kubernetes Role-Based Access Control eller inte.
kubernetesVersion	string	Den aktuella kubernetes-versionen.
networkProfile	NetworkProfileForSnapshot	Den aktuella nätverksprofilen.
sku	ManagedClusterSKU	Den aktuella SKU:n för det hanterade klustret.

ManagedClusterSKU

Objekt

SKU:n för ett hanterat kluster.

Name	Typ	Description
name	ManagedClusterSKUName	Namnet på en SKU för ett hanterat kluster.
tier	ManagedClusterSKUTier	Nivån för en SKU för ett hanterat kluster. Om det inte anges är standardvärdet "Kostnadsfri". Se AKS prisnivå för mer information.

ManagedClusterSKUName

Uppräkning

Namnet på en SKU för ett hanterat kluster.

Värde	Description
Base	Basalternativ för AKS-kontrollplanet.
Automatic	Automatiska kluster är optimerade för att köra de flesta produktionsarbetsbelastningar med en konfiguration som följer AKS-metodtips och rekommendationer för kluster- och arbetsbelastningskonfiguration, skalbarhet och säkerhet. Mer information om automatiska kluster finns i aka.ms/aks/automatic.

ManagedClusterSKUTier

Uppräkning

Nivån för en SKU för ett hanterat kluster. Om det inte anges är standardvärdet "Kostnadsfri". Se AKS prisnivå för mer information.

Värde	Description
Premium	Klustret har premiumfunktioner utöver alla funktioner som ingår i Standard. Premium möjliggör val av LongTermSupport (aka.ms/aks/lts) för vissa Kubernetes-versioner.
Standard	Rekommenderas för verksamhetskritiska arbetsbelastningar och produktionsarbetsbelastningar. Innehåller Autoskalning av Kubernetes-kontrollplan, arbetsbelastningsintensiv testning och upp till 5 000 noder per kluster. Garanterar 99,95% tillgänglighet av Kubernetes API:s serverendpoint för kluster som använder Availability Zones och 99,9% tillgänglighet för kluster som inte använder Availability Zones.
Free	Klusterhanteringen är kostnadsfri men debiteras för användning av virtuella datorer, lagring och nätverk. Bäst för experimentering, inlärning, enkel testning eller arbetsbelastningar med färre än 10 noder. Rekommenderas inte för produktionsanvändningsfall.