Ejemplos de AWS Cloud9 usando AWS CLI - AWS Command Line Interface
Acciones

Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.

Ejemplos de AWS Cloud9 usando AWS CLI

En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS Cloud9.

Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo utilizar create-environment-ec2.

AWS CLI

Creación de un entorno de desarrollo de AWS Cloud9 EC2

En el siguiente ejemplo de create-environment-ec2, se crea un entorno de desarrollo de AWS Cloud9 con la configuración especificada, se lanza una instancia de Amazon Elastic Compute Cloud (Amazon EC2) y, después, se realiza la conexión al entorno desde la instancia.

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

Salida:

{
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX"
}

Para obtener más información, consulte Creating an EC2 Environment en la Guía del usuario de AWS Cloud9.

  • Para obtener información sobre la API, consulte CreateEnvironmentEc2 en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar create-environment-membership.

AWS CLI

Adición de un miembro del entorno a un entorno de desarrollo de AWS Cloud9

En este ejemplo, se agrega el miembro de entorno especificado al entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

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

En el siguiente ejemplo de código, se muestra cómo utilizar delete-environment-membership.

AWS CLI

Eliminación de un miembro de entorno de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se elimina el miembro de entorno especificado del entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

None.

En el siguiente ejemplo de código, se muestra cómo utilizar delete-environment.

AWS CLI

Eliminación de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se elimina el entorno de desarrollo de AWS Cloud9 especificado. Si hay una instancia de Amazon EC2 conectada al entorno, se termina también la instancia.

Comando:

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

Salida:

None.

  • Para obtener información sobre la API, consulte DeleteEnvironment en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar describe-environment-memberships.

AWS CLI

Para obtener información sobre los miembros de entorno de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se obtiene información sobre los miembros de entorno de un entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

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

Para obtener información sobre el propietario de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se obtiene información sobre el propietario del entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

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

Para obtener información sobre un miembro de entorno de varios entornos de desarrollo de AWS Cloud9

En este ejemplo, se obtiene información sobre el miembro de entorno especificado de varios entornos de desarrollo de AWS Cloud9.

Comando:

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

Salida:

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

En el siguiente ejemplo de código, se muestra cómo utilizar describe-environment-status.

AWS CLI

Para obtener información de estado de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se obtiene información sobre el entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

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

En el siguiente ejemplo de código, se muestra cómo utilizar describe-environments.

AWS CLI

Para obtener información sobre los entornos de desarrollo de AWS Cloud9

En este ejemplo, se obtiene información sobre los entornos de desarrollo de AWS Cloud9 especificados.

Comando:

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

Salida:

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

  • Para obtener información sobre la API, consulte DescribeEnvironments en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar list-environments.

AWS CLI

Para obtener una lista de los identificadores de entorno de desarrollo de AWS Cloud9 disponibles

En este ejemplo, se obtiene una lista de los identificadores de entorno de desarrollo de AWS Cloud9 disponibles.

Comando:

aws cloud9 list-environments

Salida:

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

  • Para obtener información sobre la API, consulte ListEnvironments en la Referencia de comandos de la AWS CLI.

En el siguiente ejemplo de código, se muestra cómo utilizar update-environment-membership.

AWS CLI

Cambio de la configuración de un miembro de entorno existente de un entorno de desarrollo de AWS Cloud9

En este ejemplo, se cambia la configuración del miembro de entorno existente especificado del entorno de desarrollo de AWS Cloud9 especificado.

Comando:

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

Salida:

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

En el siguiente ejemplo de código, se muestra cómo utilizar update-environment.

AWS CLI

Cambio de la configuración de un entorno de desarrollo de AWS Cloud9 existente

En este ejemplo, se cambia la configuración especificada del entorno de desarrollo de AWS Cloud9 existente especificado.

Comando:

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

Salida:

None.

  • Para obtener información sobre la API, consulte UpdateEnvironment en la Referencia de comandos de la AWS CLI.