Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Quels sont les types de modifications ?
Le type de modification fait référence à l'action exécutée par une demande de modification (RFC) AWS Managed Services (AMS) et englobe l'action de modification elle-même, ainsi que le type de modification (manuel ou automatique). AMS possède une vaste collection de types de modifications qui ne sont pas utilisés par les autres services Web Amazon. Vous utilisez ces types de modification lorsque vous soumettez une demande de modification (RFC) pour déployer, gérer ou accéder à des ressources.
**Topics**
+ [Automatisé et manuel CTs](ug-automated-or-manual.md)
+ [Exigences d'approbation CT](constrained-unconstrained-ctis.md)
+ [Modifier les versions de type](ct-versions.md)
+ [Création de types de modifications](ct-creates.md)
+ [Mettre à jour les types de modifications](ct-updates.md)
+ [Types de modifications internes uniquement](ct-internals.md)
+ [Schémas de type de changement](ct-schemas.md)
+ [Gestion des autorisations pour les types de modifications](ct-permissions.md)
+ [Supprimer les informations sensibles des types de modifications](ct-redaction.md)
+ [Recherche d'un type de modification à l'aide de l'option de requête](ug-find-ct-ex-section.md)
# Automatisé et manuel CTs
Une contrainte sur les types de modification est de savoir s'ils sont automatisés ou manuels. Il s'agit de l'`AutomationStatusId`attribut de type de modification, appelé **mode d'exécution** dans la console AMS.
Les types de modifications automatisées ont des résultats et des délais d'exécution attendus et sont exécutés par le système automatisé AMS, généralement en une heure ou moins (cela dépend largement des ressources que le CT fournit). Les types de modifications manuelles sont rares, mais ils sont traités différemment car ils nécessitent qu'un opérateur AMS agisse sur le RFC avant de pouvoir l'exécuter. Cela implique parfois de communiquer avec l'émetteur de la RFC, de sorte que les types de modifications manuelles nécessitent des durées variables.
Pour toutes les modifications planifiées RFCs, une heure de fin non spécifiée est écrite comme étant l'heure de la date spécifiée `RequestedStartTime` plus l'`ExpectedExecutionDurationInMinutes`attribut du type de modification soumis. Par exemple, si la valeur `ExpectedExecutionDurationInMinutes` est « 60 » (minutes) et que la valeur spécifiée `RequestedStartTime` est `2016-12-05T14:20:00Z` (5 décembre 2016 à 4 h 20), l'heure de fin réelle sera fixée au 5 décembre 2016 à 5 h 20. Pour trouver le `ExpectedExecutionDurationInMinutes` type de modification correspondant à un type de modification spécifique, exécutez cette commande :
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
```
**Note**
RFCs Planifié avec **mode d'exécution** = Manuel, dans la console, doit être configuré pour fonctionner au moins 24 heures dans le futur.
**Note**
Lorsque vous utilisez le mode manuel CTs, AMS vous recommande d'utiliser l'option ASAP **Scheduling** (choisissez **ASAP** dans la console, laissez les heures de début et de fin vides dans l'API/CLI) car elles CTs nécessitent qu'un opérateur AMS examine la RFC et communique éventuellement avec vous avant qu'elle ne puisse être approuvée et exécutée. Si vous les planifiez RFCs, veillez à prévoir au moins 24 heures. Si l'approbation n'intervient pas avant l'heure de début prévue, le RFC est automatiquement rejeté.
AMS a pour objectif de répondre à un scanner manuel dans les quatre heures et vous répondra dès que possible, mais l'exécution du RFC peut prendre beaucoup plus de temps.
Pour une liste de ceux CTs qui sont manuels et qui nécessitent une révision par AMS, consultez le fichier CSV Change Type, disponible sur la page **Ressources pour développeurs de** la console.
**YouTube Vidéo** : [Comment puis-je trouver les types de modifications automatisés pour AMS RFCs ?](https://www.youtube.com/watch?v=sOzDuCCOduI&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=2&t=1s)
Pour trouver le **mode d'exécution** d'un CT dans la console AMS, vous devez utiliser l'option de recherche **Parcourir les types de modification**. Les résultats indiquent le mode d'exécution du ou des types de modification correspondants.
Pour rechercher le `AutomationStatus` type de modification correspondant à un type de modification spécifique à l'aide de la CLI AMS, exécutez cette commande :
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
```
Vous pouvez également rechercher les types de modifications dans le manuel [AMS Change Type Reference](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html), qui fournit des informations sur tous les types de modifications AMS.
**Note**
API/CLI Les AMS ne font pas actuellement partie d'AWSAPI/CLI. To access the AMS API/CLI. Vous pouvez télécharger le SDK AMS via la console AMS.
# Exigences d'approbation CT
AMS CTs a toujours deux conditions d'approbation, **AwsApprovalId**CustomerApprovalId****qui indiquent si la RFC exige qu'AMS, vous ou quelqu'un d'autre approuve l'exécution.
La condition d'approbation est quelque peu liée au mode d'exécution ; pour plus de détails, voir[Automatisé et manuel CTs](ug-automated-or-manual.md).
Pour connaître les conditions d'approbation d'un CT, vous pouvez consulter le manuel [AMS Change Type Reference](https://docs.aws.amazon.com/managedservices/latest/ctref/index.html) ou exécuter [GetChangeTypeVersion](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_GetChangeTypeVersion.html). Les deux vous donneront également le **mode CT `AutomationStatusId` ou Exécution**.
Vous pouvez approuver à RFCs l'aide de la console AMS ou à l'aide de la commande suivante :
```
aws amscm approve-rfc --rfc-id RFC_ID
```
**Condition d'approbation CT**
| Si la condition d'approbation du CT est | Il nécessite l'approbation de | And |
| --- | --- | --- |
| `AwsApprovalId: Required` | Le système de changement de type AMS, | Aucune action n’est requise. Cette condition est typique de l'automatisation CTs. |
| `AwsApprovalId: NotRequiredIfSubmitter` | Le système de changement de type AMS et personne d'autre, si la RFC soumise concerne le compte pour lequel elle a été soumise, | Aucune action n’est requise. Cette condition est typique des manuels CTs car ils seront toujours revus par les opérateurs AMS. |
| `CustomerApprovalId: NotRequired` | Le système de changement de type AMS, | Si la RFC passe les vérifications de syntaxe et de paramètres, elle est approuvée automatiquement. |
| `CustomerApprovalId: Required` | Le système AMS change de type et vous, | Une notification vous est envoyée et vous devez approuver explicitement la RFC, soit en répondant à la notification, soit en exécutant l'[ApproveRfc](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ApproveRfc.html)opération. |
| `CustomerApprovalId: NotRequiredIfSubmitter` | L'AMS change de type de système et personne d'autre, si vous avez soumis la RFC. | Si la RFC passe les vérifications de syntaxe et de paramètres, elle est approuvée automatiquement. |
| Incident de sécurité urgent ou correctif | AMS | Est approuvé et mis en œuvre automatiquement. |
# Modifier les versions de type
Les types de modifications sont versionnés et la version change lorsqu'une mise à jour majeure est apportée au type de modification.
Après avoir sélectionné un type de modification à l'aide de la console AMS, vous avez la possibilité d'ouvrir la zone de **configuration supplémentaire** et de sélectionner une version du type de modification. Vous pouvez également spécifier une version du type de modification sur la ligne de API/CLI commande. Vous souhaiterez peut-être le faire pour diverses raisons, notamment :
+ **Vous savez que la version du type de modification de **mise à jour** que vous souhaitez doit correspondre à la version du type de modification que vous avez utilisée pour créer la ressource que vous souhaitez maintenant mettre à jour.** Par exemple, vous pouvez avoir une instance Elastic Load Balancer (ELB) que vous avez créée avec le type de modification ELB Create version 1. Pour le mettre à jour, choisissez ELB Update version 1.
+ Vous souhaitez utiliser une version de type de modification comportant des options différentes de celles du type de modification le plus récent. Nous ne le recommandons pas car les mises à jour AMS changent de type principalement pour des raisons de sécurité et nous vous recommandons de toujours choisir la version la plus récente.
# Création de types de modifications
Les types de création de modification sont mis en correspondance version-to-version avec les types de modification de mise à jour. En d'autres termes, la version du type de modification que vous utilisez pour provisionner une ressource doit correspondre à la version du type de modification Mettre à jour que vous utiliserez ultérieurement pour modifier cette ressource. Par exemple, si vous créez un compartiment S3 avec le type de modification Create S3 Bucket version 2.0, et que vous souhaitez ultérieurement soumettre une RFC pour modifier ce compartiment S3, vous devez également utiliser le type de changement de compartiment Update S3 version 2.0, même s'il existe un type de changement de compartiment Update S3 avec la version 3.0.
Nous vous recommandons de conserver une trace de l'ID et de la version du type de modification que vous utilisez lorsque vous approvisionnez une ressource avec le type Créer une modification au cas où vous souhaiteriez ultérieurement utiliser un type de modification Mettre à jour pour la modifier.
# Mettre à jour les types de modifications
AMS fournit des types de modification de mise à jour pour mettre à jour les ressources créées avec Create change types. Les types de modification de mise à jour doivent correspondre version-to-version au type de création de modification utilisé à l'origine pour provisionner la ressource.
Nous vous recommandons de conserver une trace de l'ID et de la version du type de modification que vous utilisez lors du provisionnement d'une ressource afin de faciliter sa mise à jour.
**YouTube Vidéo** : [Comment utiliser la mise à jour CTs pour modifier les ressources d'un compte AWS Managed Services (AMS) ?](https://www.youtube.com/watch?v=dqb31yaAXhc&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=8&t=30s)
# Types de modifications internes uniquement
Vous pouvez voir les types de modifications destinés à un usage interne uniquement. Cela vous permet de savoir quelles actions AMS peut ou doit entreprendre. S'il existe un type de modification interne que vous souhaiteriez mettre à votre disposition, soumettez une demande de service.
Par exemple, il existe un CT de gestion \$1 Surveillance et notification \$1 Suppression des CloudWatch alarmes \$1 Mise à jour CT qui est uniquement interne. AMS l'utilise pour déployer des mises à jour de l'infrastructure (telles que des correctifs) afin de désactiver les notifications d'alarme susceptibles de déclencher par erreur les mises à jour. Lorsque ce CT est soumis, vous remarquerez le RFC correspondant au CT dans votre liste de RFC. Tout CT interne déployé dans un RFC apparaît dans votre liste RFC.
# Schémas de type de changement
Tous les types de modifications fournissent un schéma JSON pour votre contribution à la création, à la modification ou à l'accès aux ressources. Le schéma fournit les paramètres, ainsi que leurs descriptions, pour que vous puissiez créer une demande de modification (RFC).
L'exécution réussie d'une RFC entraîne une sortie d'exécution. Pour le provisionnement RFCs, le résultat de l'exécution inclut un « stack\$1id » qui représente le stack in CloudFormation et qui peut être recherché dans la console. CloudFormation La sortie d'exécution inclut parfois la sortie de l'ID de l'instance créée et cet ID peut être utilisé pour rechercher l'instance dans la console AWS correspondante. Par exemple, le résultat d'exécution de Create ELB CT inclut un « stack\$1id » dans lequel il est possible de faire des recherches CloudFormation et génère une valeur KEY=ELB value= consultable dans la console Amazon pour Elastic Load Balancing. EC2
Examinons un schéma de tomodensitométrie. Il s'agit du schéma d' CodeDeploy Application Create, un schéma assez petit. Certains schémas comportent de très grandes `Parameter` surfaces.
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/managedservices/latest/onboardingguide/ct-schemas.html)
**Note**
Ce schéma autorise jusqu'à sept balises ; toutefois EC2, les schémas EFS, RDS et de création à plusieurs niveaux autorisent jusqu'à 50 balises.
# Gestion des autorisations pour les types de modifications
Vous pouvez utiliser une politique personnalisée pour limiter les types de modifications (CTs) disponibles pour les différents groupes ou utilisateurs.
Pour en savoir plus sur cette procédure, consultez la section [Configuration des autorisations](https://docs.aws.amazon.com/managedservices/latest/userguide/setting-permissions.html) du guide de l'utilisateur AMS.
# Supprimer les informations sensibles des types de modifications
Les schémas de type de modification AMS proposent un attribut de paramètre, `"metadata":"ams:sensitive":"true"` qui est utilisé pour les paramètres susceptibles de contenir des informations sensibles, telles qu'un mot de passe. Lorsque cet attribut est défini, l'entrée fournie est masquée. Notez que vous ne pouvez pas définir cet attribut de paramètre. Toutefois, si vous travaillez avec AMS pour créer un type de modification et que vous souhaitez masquer un paramètre en entrée, vous pouvez le demander.
# Recherche d'un type de modification à l'aide de l'option de requête
Cet exemple montre comment utiliser la console AMS pour trouver le type de modification approprié pour la RFC que vous souhaitez soumettre.
Vous pouvez utiliser la console ou le API/CLI pour rechercher un ID de type de modification (CT) ou une version. Il existe deux méthodes, soit la recherche, soit le choix de la classification. Pour les deux types de sélection, vous pouvez trier la recherche en choisissant le **plus fréquemment utilisé**, **le plus récemment utilisé** ou **Alphabétique**.
**YouTube Vidéo** : [Comment créer une RFC à l'aide de l'AWS Managed Services CLI et où puis-je trouver le schéma CT](https://www.youtube.com/watch?v=IluDFwnJJFU&list=PLhr1KZpdzukc_VXASRqOUSM5AJgtHat6-&index=3&t=150s) ?
Dans la console AMS, sur la page **RFCs**-> **Créer une RFC** :
+ Lorsque l'option **Parcourir par type de modification** est sélectionnée (valeur par défaut), vous pouvez soit :
+ Utilisez la zone de **création rapide** pour sélectionner l'une des solutions les plus populaires d'AMS CTs. Cliquez sur une étiquette et la page **Run RFC** s'ouvre avec l'option **Objet** remplie automatiquement pour vous. Complétez les options restantes selon vos besoins et cliquez sur **Exécuter** pour soumettre la RFC.
+ Vous pouvez également faire défiler l'écran jusqu'à la zone **Tous les types de modification** et commencer à taper un nom CT dans la case d'option. Vous n'avez pas besoin du nom exact ou complet du type de modification. Vous pouvez également rechercher un CT par identifiant de type de modification, classification ou mode d'exécution (automatique ou manuel) en saisissant les mots pertinents.
Lorsque la vue **Cartes** par défaut est sélectionnée, les cartes CT correspondantes apparaissent au fur et à mesure que vous tapez, sélectionnez une carte et cliquez sur **Créer une RFC**. Une fois la vue **sous forme de tableau** sélectionnée, choisissez le CT approprié et cliquez sur **Créer une RFC**. Les deux méthodes ouvrent la page **Run RFC**.
+ Sinon, pour explorer les choix de type de modification, cliquez sur **Choisir par catégorie** en haut de la page pour ouvrir une série de boîtes d'options déroulantes.
+ Choisissez une **catégorie**, une **sous-catégorie**, un **article** et une **opération**. La zone d'information correspondant à ce type de modification apparaît et un panneau apparaît en bas de page.
+ Lorsque vous êtes prêt, appuyez sur **Entrée** pour afficher la liste des types de modifications correspondants.
+ Choisissez un type de modification dans la liste. La zone d'information correspondant à ce type de modification apparaît au bas de la page.
+ Une fois que vous avez sélectionné le type de modification correct, choisissez **Create RFC**.
**Note**
L'AMS CLI doit être installée pour que ces commandes fonctionnent. Pour installer l'API ou la CLI AMS, rendez-vous sur la page **Ressources pour développeurs** de la console AMS. Pour des informations de référence sur l'API AMS CM ou l'API AMS SKMS, consultez la section Ressources d'information AMS du guide de l'utilisateur. Vous devrez peut-être ajouter une `--profile` option d'authentification ; par exemple,`aws amsskms ams-cli-command --profile SAML`. Vous devrez peut-être également ajouter `--region` cette option car toutes les commandes AMS sont exécutées à partir de us-east-1, par exemple. `aws amscm ams-cli-command --region=us-east-1`
**Note**
Les points de terminaison AMS API/CLI (amscm et amsskms) se trouvent dans la région AWS de Virginie du Nord,. `us-east-1` En fonction de la configuration de votre authentification et de la région AWS dans laquelle se trouvent votre compte et vos ressources, vous devrez peut-être en ajouter `--region us-east-1` lors de l'émission de commandes. Vous devrez peut-être également ajouter`--profile saml`, s'il s'agit de votre méthode d'authentification.
Pour rechercher un type de modification à l'aide de l'API AMS CM (voir [ListChangeTypeClassificationSummaries](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html)) ou de la CLI :
Vous pouvez utiliser un filtre ou une requête pour effectuer une recherche. L' ListChangeTypeClassificationSummaries opération comporte des options de [filtres](https://docs.aws.amazon.com/managedservices/latest/ApiReference-cm/API_ListChangeTypeClassificationSummaries.html#amscm-ListChangeTypeClassificationSummaries-request-Filters) pour `Category` `Subcategory``Item`,, et`Operation`, mais les valeurs doivent correspondre exactement aux valeurs existantes. Pour des résultats plus flexibles lors de l'utilisation de la CLI, vous pouvez utiliser l'`--query`option.
**Changer le type de filtrage avec l'API/CLI AMS CM**
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/managedservices/latest/onboardingguide/ug-find-ct-ex-section.html)
1. Voici quelques exemples de classification des types de modification de liste :
La commande suivante répertorie toutes les catégories de types de modifications.
```
aws amscm list-change-type-categories
```
La commande suivante répertorie les sous-catégories appartenant à une catégorie spécifiée.
```
aws amscm list-change-type-subcategories --category CATEGORY
```
La commande suivante répertorie les éléments appartenant à une catégorie et à une sous-catégorie spécifiées.
```
aws amscm list-change-type-items --category CATEGORY --subcategory SUBCATEGORY
```
1. Voici quelques exemples de recherche de types de modifications à l'aide de requêtes CLI :
La commande suivante recherche dans les résumés de classification CT ceux qui contiennent « S3 » dans le nom de l'élément et crée une sortie de la catégorie, de la sous-catégorie, de l'élément, de l'opération et de l'ID de type de modification sous forme de tableau.
```
aws amscm list-change-type-classification-summaries --query "ChangeTypeClassificationSummaries [?contains(Item, 'S3')].[Category,Subcategory,Item,Operation,ChangeTypeId]" --output table
```
```
+---------------------------------------------------------------+
| ListChangeTypeClassificationSummaries |
+----------+-------------------------+--+------+----------------+
|Deployment|Advanced Stack Components|S3|Create|ct-1a68ck03fn98r|
+----------+-------------------------+--+------+----------------+
```
1. Vous pouvez ensuite utiliser l'ID du type de modification pour obtenir le schéma CT et examiner les paramètres. La commande suivante génère le schéma dans un fichier JSON nommé Creates3Params.Schema.json.
```
aws amscm get-change-type-version --change-type-id "ct-1a68ck03fn98r" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > CreateS3Params.schema.json
```
Pour plus d'informations sur l'utilisation des requêtes CLI, consultez [Comment filtrer la sortie avec l'option --query](https://docs.aws.amazon.com/cli/latest/userguide/controlling-output.html#controlling-output-filter) et la référence du langage de requête, [JMESPath Spécification](http://jmespath.org/specification.html).
1. Une fois que vous avez obtenu l'identifiant du type de modification, nous vous recommandons de vérifier la version du type de modification afin de vous assurer qu'il s'agit de la dernière version. Utilisez cette commande pour trouver la version correspondant à un type de modification spécifié :
```
aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CHANGE_TYPE_ID
```
Pour trouver le `AutomationStatus` type de modification correspondant à un type de modification spécifique, exécutez cette commande :
```
aws amscm --profile saml get-change-type-version --change-type-id CHANGE_TYPE_ID --query "ChangeTypeVersion.{AutomationStatus:AutomationStatus.Name}"
```
Pour trouver le `ExpectedExecutionDurationInMinutes` type de modification correspondant à un type de modification spécifique, exécutez cette commande :
```
aws amscm --profile saml get-change-type-version --change-type-id ct-14027q0sjyt1h --query "ChangeTypeVersion.{ExpectedDuration:ExpectedExecutionDurationInMinutes}"
```