Aperçu
Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !
Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.
Cette page fournit une référence complète des actions aws ec2 disponibles dans le catalogue des actions d'automatisation du workflow. Ces actions vous permettent de gérer les instances et les snapshots ec2.
Prérequis
Avant d'utiliser AWS Actions dans l'automatisation workflow, assurez-vous de disposer des éléments suivants :
- Un compte AWS disposant des autorisations appropriées.
- Informations d'identification AWS configurées (informations d'identification de l'utilisateur IAM, ARN du rôle IAM ou informations d'identification de session).
- Les autorisations IAM nécessaires pour les services AWS spécifiques que vous prévoyez d'utiliser.
Consultez la section Configurer les informations d'identification AWS pour savoir comment créer un utilisateur IAM et des rôles IAM, et comment configurer les informations d'identification AWS statiques et de session pour l'intégration avec les actions AWS d'automatisation workflow.
lancer le nombre spécifié d'instances en utilisant une AMI pour laquelle vous disposez des autorisations.
Vous pouvez spécifier un certain nombre d'options, ou conserver les options par défaut. Les règles suivantes s'appliquent :
Si vous ne spécifiez pas d'ID de sous-réseau, nous choisissons un sous-réseau par défaut de votre VPC par défaut pour vous. Si vous n'avez pas de VPC par défaut, vous devez spécifier un ID de sous-réseau dans la requête.
Si l'une des AMI possède un code produit auquel l'utilisateur n'a pas souscrit, la requête échoue.
Champ de saisie
optionnalité
Type
Exemple
awsRoleArn
Facultatif
Chaîne
arn:aws:iam::123456789012:role/my-workflow-roleawsAccessKeyId
Facultatif
Chaîne
${{ :secrets:<awsAccessKeyId> }}awsSecretAccessKey
Facultatif
Chaîne
${{ :secrets:<awsSecretAccessKey> }}awsSessionToken
Facultatif
Chaîne
${{ :secrets:<awsSessionToken> }}région
Requis
Chaîne
region: "us-east-2"imageId
Requis
Chaîne
"ami-0ca4d5db4872d0c28"instanceType
Requis
Chaîne
"t2.micro"minCount
Requis
Int
1maxCount
Requis
Int
10paramètres
Facultatif
Carte
{"EbsOptimized": false,"TagSpecifications": [{"ResourceType": "instance","Tags": [{"Key": "Name","Value": "My-Web-Server"}]}}sélecteurs
Facultatif
List
[{\"name\": \"response\", \"expression\": \".response\"}, {\"name\": \"success\", \"expression\": \".success\"}, {\"name\": \"errorMessage\", \"expression\": \".errorMessage\"}]Important
Pour prendre en charge un large éventail d'entrées, la carte
parametersaccepte tout argument optionnel disponible. Cela vous permet de construire dynamiquement requests en ajoutant plusieurs champs.Champ de sortie
Type
Exemple
response
Objet
La syntaxe de la réponse est consultable dans la documentation de Boto3 1.40.50 (run_instances).
succès
Booléen
success: true | falsemessage d'erreur
Chaîne
errorMessage: ""Exemple de workflow
name: ec2_run_instanceworkflowInputs:arnRole:type: Stringrequired: truesteps:- name: RunInstancetype: actionaction: aws.ec2.runInstancesversion: '1'inputs:awsRoleArn: ${{.workflowInputs.arnRole}}region: us-east-2imageId: ami-0ca4d5db4872d0c28instanceType: t2.microminCount: 1maxCount: 1parameters:EbsOptimized: falseTagSpecifications:- ResourceType: instanceTags:- Key: NameValue: My-Test-Instanceselectors:- name: instanceIdexpression: .response.Instances[0].InstanceId
Décrit les instances spécifiées ou toutes les instances.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
instanceIds | Facultatif | List |
|
filtres | Facultatif | List |
|
nextToken | Facultatif | Chaîne |
|
maxResults | Facultatif | Int | 100 |
sélecteurs | Facultatif | List |
|
Important
Dans l'entrée d'action, au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle étant prioritaire sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | La syntaxe de la réponse peut être consultée describe_instances. |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Important
- Si vous spécifiez des ID d'instance, la sortie inclut des informations uniquement pour les instances spécifiées.
- Si vous spécifiez des filtres, la sortie inclut des informations uniquement pour les instances qui répondent aux critères de filtre.
- Si vous ne spécifiez pas d'ID d'instance ou de filtres, la sortie inclut des informations pour toutes les instances.
- Le paramètre
instanceIdsne peut pas être utilisé avecmaxResults.
Exemple de flux de travail |
|---|
|
Démarre une instance Amazon EBS que vous aviez précédemment arrêtée.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
instanceIds | Requis | List |
|
sélecteurs | Facultatif | List |
|
Conseil
Dans le champ d'entrée de l'action, au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle ayant priorité sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | La syntaxe de réponse est décrite dans la documentation de Boto3 1.40.50 (start_instances). |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de workflow |
|---|
|
Arrête une instance basée sur Amazon EBS
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
instanceIds | Requis | List |
|
hibernation | Facultatif | Booléen | vrai ou faux (Par défaut :
) |
force | Facultatif | Booléen | vrai ou faux (Par défaut :
) |
sélecteurs | Facultatif | List |
|
Important
Dans le champ d'entrée de l'action, au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle ayant priorité sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | La syntaxe de la réponse peut être consultée stop_instances |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de workflow |
|---|
|
Demande un redémarrage de l'instance spécifiée. Cette opération est asynchrone ; elle se contente de mettre en file d'attente une requête de redémarrage de l'instance spécifiée. L'opération réussit si les instances sont valides et vous appartiennent. Les demandes de redémarrage d'une instance arrêtée sont ignorées.
Si une instance ne s'arrête pas correctement en quelques minutes, Amazon EC2 effectue un redémarrage forcé.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
instanceIds | Requis | List |
|
sélecteurs | Facultatif | List |
|
Important
Dans le champ d'entrée de l'action, au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle ayant priorité sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de workflow |
|---|
|
Arrête les instances spécifiées. Cette opération est idempotente; si vous arrêtez une instance plusieurs fois, chaque appel réussit.
Si vous spécifiez plusieurs instances et que la requête échoue (par exemple, à cause d'un seul ID d' instance incorrect), aucune des instances n'est arrêtée.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
instanceIds | Requis | List |
|
sélecteurs | Facultatif | List |
|
Important
Dans le champ d'entrée de l'action, au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle ayant priorité sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | La syntaxe de réponse est décrite dans la documentation de terminate_instances - Boto3 1.40.50. |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de workflow |
|---|
|
Crée un instantané d'un volume EBS et le stocke dans Amazon S3. Vous pouvez utiliser des instantanés pour les sauvegardes, pour faire des copies de volumes EBS et enregistrer des données avant d'arrêter une instance.
L'emplacement du volume EBS source détermine où vous pouvez créer l'instantané.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
description | Facultatif | Chaîne |
|
outpostArn | Facultatif | Chaîne |
|
volumeId | Requis | Chaîne |
|
tagSpecifications | Facultatif | List |
|
emplacement | Facultatif | Chaîne |
|
sélecteurs | Facultatif | List |
|
Important
Au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle étant prioritaire sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | La syntaxe de la réponse peut être consultée create_snapshot. |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Supprime l'instantané spécifié.
Vous ne pouvez pas supprimer un instantané du périphérique racine d'un volume EBS utilisé par une AMI enregistrée. Vous devez d'abord désenregistrer l'AMI avant de pouvoir supprimer l'instantané.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
snapshotId | Requis | Chaîne |
|
sélecteurs | Facultatif | Chaîne |
|
Conseil
Au moins une des informations d'identification AWS (courte, longue, rôle) doit être fournie, le rôle étant prioritaire sur les autres.
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | Aucune réponse en cas de La syntaxe de réponse peut être consultée dans la documentation delete_snapshot - Boto3 1.40.55. |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de flux de travail |
|---|
|
Invoque un agent AWS Bedrock.
Champ de saisie | optionnalité | Type | Exemple |
|---|---|---|---|
awsRoleArn | Facultatif | Chaîne |
|
awsAccessKeyId | Facultatif | Chaîne |
|
awsSecretAccessKey | Facultatif | Chaîne |
|
awsSessionToken | Facultatif | Chaîne |
|
région | Requis | Chaîne |
|
agentId | Requis | Chaîne |
|
agentAliasId | Requis | Chaîne |
|
sessionId | Facultatif | Chaîne |
|
inputText | Requis | Chaîne |
|
paramètres | Facultatif | Carte | |
sélecteurs | Facultatif | List |
|
Champ de sortie | Type | Exemple |
|---|---|---|
response | Objet | |
succès | Booléen |
|
message d'erreur | Chaîne |
|
Exemple de flux de travail |
|---|
|