Exemples d’utilisation de l’AWS CLI avec AWS Cloud9

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec AWS Cloud9.

Les actions sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

Rubriques

Actions

Actions

L’exemple de code suivant montre comment utiliser create-environment-ec2.

AWS CLI

Pour créer un environnement de développement AWS Cloud9 EC2

L’exemple create-environment-ec2 suivant crée un environnement de développement AWS Cloud9 avec les paramètres spécifiés, lance une instance Amazon Elastic Compute Cloud (Amazon EC2), héberge l’environnement sur l’instance, puis connecte l’instance à l’environnement.


aws cloud9 create-environment-ec2 \
    --name my-demo-env \
    --description "My demonstration development environment." \
    --instance-type t2.micro --image-id amazonlinux-2023-x86_64 \
    --subnet-id subnet-1fab8aEX \
    --automatic-stop-time-minutes 60 \
    --owner-arn arn:aws:iam::123456789012:user/MyDemoUser

Sortie :


{
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX"
}

Pour plus d’informations, consultez Créer un environnement EC2 dans le Guide de l’utilisateur AWS Cloud9.

Pour plus de détails sur l’API, consultez CreateEnvironmentEc2 dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser create-environment-membership.

AWS CLI

Pour ajouter un membre d’un environnement à un environnement de développement AWS Cloud9

Cet exemple ajoute le membre de l’environnement spécifié à l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 create-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser --permissions read-write

Sortie :


{
  "membership": {
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
    "userId": "AIDAJ3LOROMOUXTBSU6EX",
    "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser",
    "permissions": "read-write"
  }
}

Pour plus de détails sur l’API, consultez CreateEnvironmentMembership dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-environment-membership.

AWS CLI

Pour supprimer un membre d’un environnement de développement AWS Cloud9

Cet exemple supprime le membre spécifié de l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 delete-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser

Sortie :


None.

Pour plus de détails sur l’API, consultez DeleteEnvironmentMembership dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser delete-environment.

AWS CLI

Pour supprimer un environnement de développement AWS Cloud9

Cet exemple supprime l’environnement de développement AWS Cloud9 spécifié. Si une instance Amazon EC2 est connectée à l’environnement, l’instance est également résiliée.

Commande :


aws cloud9 delete-environment --environment-id 8a34f51ce1e04a08882f1e811bd706EX

Sortie :


None.

Pour plus de détails sur l’API, consultez DeleteEnvironment dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-environment-memberships.

AWS CLI

Pour obtenir les informations sur les membres d’un environnement de développement AWS Cloud9

Cet exemple obtient les informations sur les membres de l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX

Sortie :


{
  "memberships": [
    {
      "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
      "userId": "AIDAJ3LOROMOUXTBSU6EX",
      "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser",
      "permissions": "read-write"
    },
    {
      "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    }
  ]
}

Pour obtenir les informations sur le propriétaire d’un environnement de développement AWS Cloud9

Cet exemple obtient les informations sur le propriétaire de l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX --permissions owner

Sortie :


{
  "memberships": [
    {
      "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    }
  ]
}

Pour obtenir les informations sur un membre de plusieurs environnements de développement AWS Cloud9

Cet exemple obtient les informations sur le membre spécifié de plusieurs environnements de développement AWS Cloud9.

Commande :


aws cloud9 describe-environment-memberships --user-arn arn:aws:iam::123456789012:user/MyDemoUser

Sortie :


{
  "memberships": [
    {
      "environmentId": "10a75714bd494714929e7f5ec4125aEX",
      "lastAccess": 1516213427.0,
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    },
    {
      "environmentId": "1980b80e5f584920801c09086667f0EX",
      "lastAccess": 1516144884.0,
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    }
  ]
}

Pour plus de détails sur l’API, consultez DescribeEnvironmentMemberships dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-environment-status.

AWS CLI

Pour obtenir les informations de statut pour un environnement de développement AWS Cloud9

Cet exemple obtient les informations de statut pour l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 describe-environment-status --environment-id 685f892f431b45c2b28cb69eadcdb0EX

Sortie :


{
  "status": "ready",
  "message": "Environment is ready to use"
}

Pour plus de détails sur l’API, consultez DescribeEnvironmentStatus dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser describe-environments.

AWS CLI

Pour obtenir les informations sur les environnements de développement AWS Cloud9

Cet exemple obtient les informations sur les environnements de développement AWS Cloud9 spécifiés.

Commande :


aws cloud9 describe-environments --environment-ids 685f892f431b45c2b28cb69eadcdb0EX 349c86d4579e4e7298d500ff57a6b2EX

Sortie :


{
  "environments": [
    {
      "id": "685f892f431b45c2b28cb69eadcdb0EX",
      "name": "my-demo-ec2-env",
      "description": "Created from CodeStar.",
      "type": "ec2",
      "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:685f892f431b45c2b28cb69eadcdb0EX",
      "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "lifecycle": {
        "status": "CREATED"
      }
    },
    {
      "id": "349c86d4579e4e7298d500ff57a6b2EX",
      "name": my-demo-ssh-env",
      "description": "",
      "type": "ssh",
      "arn": "arn:aws:cloud9:us-east-1:123456789012:environment:349c86d4579e4e7298d500ff57a6b2EX",
      "ownerArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "lifecycle": {
        "status": "CREATED"
      }
    }
  ]
}

Pour plus de détails sur l’API, consultez DescribeEnvironments dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser list-environments.

AWS CLI

Pour obtenir une liste des identifiants de l’environnement de développement AWS Cloud9

Cet exemple obtient une liste des identifiants de l’environnement de développement AWS Cloud9.

Commande :


aws cloud9 list-environments

Sortie :


{
  "environmentIds": [
    "685f892f431b45c2b28cb69eadcdb0EX",
    "1980b80e5f584920801c09086667f0EX"
  ]
}

Pour plus de détails sur l’API, consultez ListEnvironments dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-environment-membership.

AWS CLI

Pour modifier les paramètres d’un membre existant pour un environnement de développement AWS Cloud9

Cet exemple modifie les paramètres du membre existant spécifié pour l’environnement de développement AWS Cloud9 spécifié.

Commande :


aws cloud9 update-environment-membership --environment-id 8a34f51ce1e04a08882f1e811bd706EX --user-arn arn:aws:iam::123456789012:user/AnotherDemoUser --permissions read-only

Sortie :


{
  "membership": {
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
    "userId": "AIDAJ3LOROMOUXTBSU6EX",
    "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser",
    "permissions": "read-only"
  }
}

Pour plus de détails sur l’API, consultez UpdateEnvironmentMembership dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser update-environment.

AWS CLI

Pour modifier les paramètres d’un environnement de développement AWS Cloud9 existant

Cet exemple modifie les paramètres spécifiés de l’environnement de développement AWS Cloud9 existant spécifié.

Commande :


aws cloud9 update-environment --environment-id 8a34f51ce1e04a08882f1e811bd706EX --name my-changed-demo-env --description "My changed demonstration development environment."

Sortie :


None.

Pour plus de détails sur l’API, consultez UpdateEnvironment dans la Référence des commandes de l’AWS CLI.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

AWS Cloud Map

CloudFormation