Managed Cluster Snapshots - List

Serviço:: AKS

Versão da API:: 2025-04-02-preview

Obtém uma lista de instantâneos de cluster gerenciado na assinatura especificada.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	ManagedClusterSnapshotListResult	OKEY
Other Status Codes	CloudError	Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

List Managed Cluster Snapshots

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 200

{
  "value": [
    {
      "name": "snapshot1",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedclustersnapshots/snapshot1",
      "type": "Microsoft.ContainerService/ManagedClusterSnapshots",
      "location": "westus",
      "tags": {
        "key1": "val1",
        "key2": "val2"
      },
      "systemData": {
        "createdBy": "user1",
        "createdByType": "User",
        "createdAt": "2021-08-09T20:13:23.298420761Z"
      },
      "properties": {
        "creationData": {
          "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster1"
        },
        "snapshotType": "ManagedCluster",
        "managedClusterPropertiesReadOnly": {
          "kubernetesVersion": "1.20.5",
          "sku": {
            "name": "Basic",
            "tier": "Free"
          },
          "enableRbac": true,
          "networkProfile": {
            "networkPlugin": "kubenet",
            "networkPolicy": "calico",
            "networkMode": "bridge",
            "loadBalancerSku": "standard"
          }
        }
      }
    }
  ]
}

Definições

Nome	Description
CloudError	Uma resposta de erro do serviço contêiner.
CloudErrorBody	Uma resposta de erro do serviço contêiner.
createdByType	O tipo de identidade que criou o recurso.
CreationData	Dados usados ao criar um recurso de destino de um recurso de origem.
loadBalancerSku	O sku do balanceador de carga para o cluster gerenciado.
ManagedClusterPropertiesForSnapshot	propriedades do cluster gerenciado para instantâneo, essas propriedades são somente leitura.
ManagedClusterSKU	A SKU de um cluster gerenciado.
ManagedClusterSKUName	O nome de um SKU de cluster gerenciado.
ManagedClusterSKUTier	A camada de um SKU de cluster gerenciado.
ManagedClusterSnapshot	Um recurso de instantâneo de cluster gerenciado.
ManagedClusterSnapshotListResult	A resposta da operação List Managed Cluster Snapshots.
networkMode	O modo de rede com o qual o CNI do Azure está configurado.
NetworkPlugin	Plug-in de rede usado para criar a rede do Kubernetes.
NetworkPluginMode	O modo que o plug-in de rede deve usar.
NetworkPolicy	Política de rede usada para criar a rede do Kubernetes.
NetworkProfileForSnapshot	perfil de rede para instantâneo de cluster gerenciado, essas propriedades são somente leitura.
SnapshotType	O tipo de instantâneo. O padrão é NodePool.
systemData	Metadados relativos à criação e última modificação do recurso.

CloudError

Objeto

Uma resposta de erro do serviço contêiner.

Nome	Tipo	Description
error	CloudErrorBody	Detalhes sobre o erro.

CloudErrorBody

Objeto

Uma resposta de erro do serviço contêiner.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CreationData

Objeto

Dados usados ao criar um recurso de destino de um recurso de origem.

Nome	Tipo	Description
sourceResourceId	string (arm-id)	Esta é a ID do ARM do objeto de origem a ser usado para criar o objeto de destino.

loadBalancerSku

Enumeração

O sku do balanceador de carga para o cluster gerenciado.

Valor	Description
basic	Use um Load Balancer básico com funcionalidade limitada.
standard	Use um Load Balancer padrão. Essa é a SKU do Load Balancer recomendada. Para obter mais informações sobre como trabalhar com o balanceador de carga no cluster gerenciado, consulte o artigo do Load Balancer padrão .

ManagedClusterPropertiesForSnapshot

Objeto

propriedades do cluster gerenciado para instantâneo, essas propriedades são somente leitura.

Nome	Tipo	Description
enableRbac	boolean	Se o cluster habilitou o Kubernetes Role-Based Controle de Acesso ou não.
kubernetesVersion	string	A versão atual do kubernetes.
networkProfile	NetworkProfileForSnapshot	O perfil de rede atual.
sku	ManagedClusterSKU	O sku do cluster gerenciado atual.

ManagedClusterSKU

Objeto

A SKU de um cluster gerenciado.

Nome	Tipo	Description
name	ManagedClusterSKUName	O nome de um SKU de cluster gerenciado.
tier	ManagedClusterSKUTier	A camada de um SKU de cluster gerenciado. Se não for especificado, o padrão será "Gratuito". Consulte o tipo de preço do AKS para obter mais detalhes.

ManagedClusterSKUName

Enumeração

O nome de um SKU de cluster gerenciado.

Valor	Description
Automatic	Os clusters automáticos são otimizados para executar a maioria das cargas de trabalho de produção com configuração que segue as melhores práticas e recomendações do AKS para configuração de cluster e carga de trabalho, escalabilidade e segurança. Para obter mais detalhes sobre clusters automáticos, consulte aka.ms/aks/automatic.
Base	Opção base para o plano de controle do AKS.

ManagedClusterSKUTier

Enumeração

A camada de um SKU de cluster gerenciado.

Valor	Description
Free	O gerenciamento de cluster é gratuito, mas cobrado pelo uso de VM, armazenamento e rede. Melhor para experimentar, aprender, testar simples ou cargas de trabalho com menos de 10 nós. Não recomendado para casos de uso de produção.
Premium	O cluster tem funcionalidades premium, além de todos os recursos incluídos no 'Standard'. O Premium habilita a seleção de LongTermSupport (aka.ms/aks/lts) para determinadas versões do Kubernetes.
Standard	Recomendado para cargas de trabalho críticas e de produção. Inclui dimensionamento automático do plano de controle do Kubernetes, teste intensivo de carga de trabalho e até 5.000 nós por cluster. Garante 99,95% disponibilidade do ponto de extremidade do servidor de API do Kubernetes para clusters que usam Zonas de Disponibilidade e 99,9% de disponibilidade para clusters que não usam Zonas de Disponibilidade.