Managed Cluster Snapshots - Create Or Update

Service:: AKS

Version d'API:: 2025-05-02-preview

Crée ou met à jour un instantané de cluster managé.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/managedclustersnapshots/{resourceName}?api-version=2025-05-02-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
resourceName	path	True	string minLength: 1 maxLength: 63 pattern: ^[a-zA-Z0-9]$\|^[a-zA-Z0-9][-_a-zA-Z0-9]{0,61}[a-zA-Z0-9]$	Nom de la ressource de cluster managé.
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.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
properties.creationData		CreationData	CreationData à utiliser pour spécifier l’ID de ressource source pour créer cet instantané.
properties.snapshotType		SnapshotType	Type d’instantané. La valeur par défaut est NodePool.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	ManagedClusterSnapshot	L’instantané de cluster managé existant a été correctement mis à jour.
201 Created	ManagedClusterSnapshot	La nouvelle capture instantanée de cluster managé a été créée avec succès.
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Create/Update Managed Cluster Snapshot

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ContainerService/managedclustersnapshots/snapshot1?api-version=2025-05-02-preview

{
  "location": "westus",
  "tags": {
    "key1": "val1",
    "key2": "val2"
  },
  "properties": {
    "creationData": {
      "sourceResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg1/providers/Microsoft.ContainerService/managedClusters/cluster1"
    }
  }
}

Exemple de réponse

Code d’état:: 200

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

Code d’état:: 201

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

Définitions

Nom	Description
CloudError	Réponse d’erreur du service Conteneur.
CloudErrorBody	Réponse d’erreur du service Conteneur.
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.
loadBalancerSku	Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez les 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 ». Pour plus d’informations, consultez le niveau tarifaire AKS .
ManagedClusterSnapshot	Ressource d’instantané de cluster managé.
networkMode	Le mode réseau avec lequel Azure CNI est configuré. Cela ne peut pas être spécifié si networkPlugin est autre 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.

CloudError

Object

Réponse d’erreur du service Conteneur.

Nom	Type	Description
error	CloudErrorBody	Détails sur l’erreur.

CloudErrorBody

Object

Réponse d’erreur du service Conteneur.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

createdByType

Énumération

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

Valeur	Description
User
Application
ManagedIdentity
Key

CreationData

Object

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.

loadBalancerSku

Énumération

Référence sKU de l’équilibreur de charge pour le cluster managé. La valeur par défaut est « standard ». Consultez les 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. Il s’agit de la référence SKU Load Balancer recommandée. Pour plus d’informations sur l’utilisation de l’équilibreur de charge dans le cluster managé, consultez l’article standard Load Balancer.
basic	Utilisez un équilibreur de charge de base avec des fonctionnalités limitées.

ManagedClusterPropertiesForSnapshot

Object

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

Nom	Type	Description
enableRbac	boolean	Indique si le cluster a activé Kubernetes Role-Based Contrôle d’accès 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

Object

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 ». Pour plus d’informations, consultez le niveau tarifaire AKS .

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 la configuration qui suit les meilleures pratiques et recommandations AKS pour la configuration, la scalabilité 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 ». Pour plus d’informations, consultez le niveau tarifaire AKS .

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 la disponibilité de 99,95% du point de terminaison du serveur d’API Kubernetes pour les clusters qui utilisent des zones de disponibilité et 99,9% de disponibilité pour les clusters qui n’utilisent pas de 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.