Snapshots - List

Servicio:: AKS

Versión de la API:: 2025-05-01

Obtiene una lista de instantáneas de la suscripción especificada.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/snapshots?api-version=2025-05-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
subscriptionId	path	True	string (uuid)	Identificador de la suscripción de destino. El valor debe ser un UUID.
api-version	query	True	string minLength: 1	Versión de API que se usará para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	SnapshotListResult	De acuerdo
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

List Snapshots

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/snapshots?api-version=2025-05-01

Respuesta de muestra

status code:: 200

{
  "value": [
    {
      "name": "snapshot1",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/snapshots/snapshot1",
      "type": "Microsoft.ContainerService/Snapshots",
      "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/agentPools/pool0"
        },
        "snapshotType": "NodePool",
        "nodeImageVersion": "AKSUbuntu-1804gen2containerd-2021.09.11",
        "kubernetesVersion": "1.20.5",
        "osType": "Linux",
        "osSku": "Ubuntu",
        "vmSize": "Standard_D2s_v3",
        "enableFIPS": false
      }
    }
  ]
}

Definiciones

Nombre	Description
CloudError	Respuesta de error del servicio contenedor.
CloudErrorBody	Respuesta de error del servicio contenedor.
createdByType	Tipo de identidad que creó el recurso.
CreationData	Datos usados al crear un recurso de destino a partir de un recurso de origen.
OSSKU	Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.
OSType	Tipo de sistema operativo. El valor predeterminado es Linux.
Snapshot	Un recurso de instantánea del grupo de nodos.
SnapshotListResult	Respuesta de la operación Enumerar instantáneas.
SnapshotType	Tipo de una instantánea. El valor predeterminado es NodePool.
systemData	Metadatos relativos a la creación y última modificación del recurso.

CloudError

Object

Respuesta de error del servicio contenedor.

Nombre	Tipo	Description
error	CloudErrorBody	Detalles sobre el error.

CloudErrorBody

Object

Respuesta de error del servicio contenedor.

Nombre	Tipo	Description
code	string	Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
details	CloudErrorBody[]	Lista de detalles adicionales sobre el error.
message	string	Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
target	string	Destino del error concreto. Por ejemplo, el nombre de la propiedad en error.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

CreationData

Object

Datos usados al crear un recurso de destino a partir de un recurso de origen.

Nombre	Tipo	Description
sourceResourceId	string (arm-id)	Este es el identificador de ARM del objeto de origen que se va a usar para crear el objeto de destino.

OSSKU

Enumeración

Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.

Valor	Description
AzureLinux	Use AzureLinux como sistema operativo para imágenes de nodo. Azure Linux es una distribución linux optimizada para contenedores creada por Microsoft, visite https://aka.ms/azurelinux para obtener más información.
CBLMariner	OSSKU en desuso. Microsoft recomienda que las nuevas implementaciones elijan "AzureLinux" en su lugar.
Ubuntu	Use Ubuntu como sistema operativo para imágenes de nodo.
Ubuntu2204	Utilice Ubuntu2204 como sistema operativo para las imágenes de nodo, sin embargo, es posible que Ubuntu 22.04 no sea compatible con todos los grupos de nodos. Para conocer las limitaciones y las versiones de Kubernetes compatibles, consulte https://aka.ms/aks/supported-ubuntu-versions
Windows2019	Use Windows2019 como sistema operativo para imágenes de nodo. No se admite para los grupos de nodos del sistema. Windows2019 solo admite contenedores de Windows2019; no puede ejecutar contenedores de Windows2022 y viceversa.
Windows2022	Use Windows2022 como sistema operativo para imágenes de nodo. No se admite para los grupos de nodos del sistema. Windows2022 solo admite contenedores de Windows2022; no puede ejecutar contenedores de Windows2019 y viceversa.

OSType

Enumeración

Tipo de sistema operativo. El valor predeterminado es Linux.

Valor	Description
Linux	Usa Linux.
Windows	Utilice Windows.

Snapshot

Object

Un recurso de instantánea del grupo de nodos.

Nombre	Tipo	Valor predeterminado	Description
id	string (arm-id)		Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string		Ubicación geográfica donde reside el recurso
name	string		Nombre del recurso
properties.creationData	CreationData		CreationData que se usará para especificar el identificador de recurso del grupo de agentes de origen para crear esta instantánea.
properties.enableFIPS	boolean		Si se usa un sistema operativo habilitado para FIPS.
properties.kubernetesVersion	string		Versión de Kubernetes.
properties.nodeImageVersion	string		Versión de la imagen de nodo.
properties.osSku	OSSKU		Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es Ubuntu si OSType es Linux. El valor predeterminado es Windows2019 cuando Kubernetes <= 1.24 o Windows2022 cuando Kubernetes >= 1.25 si OSType es Windows.
properties.osType	OSType	Linux	Tipo de sistema operativo. El valor predeterminado es Linux.
properties.snapshotType	SnapshotType	NodePool	Tipo de una instantánea. El valor predeterminado es NodePool.
properties.vmSize	string		Tamaño de la máquina virtual.
systemData	systemData		Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object		Etiquetas de recursos.
type	string		Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

SnapshotListResult

Object

Respuesta de la operación Enumerar instantáneas.

Nombre	Tipo	Description
nextLink	string	Dirección URL para obtener el siguiente conjunto de resultados de instantáneas.
value	Snapshot[]	Lista de instantáneas.

SnapshotType

Enumeración

Tipo de una instantánea. El valor predeterminado es NodePool.

Valor	Description
NodePool	La instantánea es una instantánea de un grupo de nodos.

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

Snapshots - List

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

List Snapshots

Solicitud de ejemplo

Respuesta de muestra

Definiciones

CloudError

CloudErrorBody

createdByType

CreationData

OSSKU

OSType

Snapshot

SnapshotListResult

SnapshotType

systemData