# AWS Cloud9 Ejemplos de usando AWS CLI
<a name="cli_cloud9_code_examples"></a>

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.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `create-environment-ec2`
<a name="cloud9_CreateEnvironmentEc2_cli_topic"></a>

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](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment-main.html) en la *Guía del usuario de AWS Cloud9*.  
+  Para obtener información sobre la API, consulte [CreateEnvironmentEc2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-ec2.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-environment-membership`
<a name="cloud9_CreateEnvironmentMembership_cli_topic"></a>

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"
  }
}
```
+  Para obtener información sobre la API, consulte [CreateEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-membership.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-environment-membership`
<a name="cloud9_DeleteEnvironmentMembership_cli_topic"></a>

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.
```
+  Para obtener información sobre la API, consulte [DeleteEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment-membership.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-environment`
<a name="cloud9_DeleteEnvironment_cli_topic"></a>

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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-environment-memberships`
<a name="cloud9_DescribeEnvironmentMemberships_cli_topic"></a>

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"
    }
  ]
}
```
+  Para obtener información sobre la API, consulte [DescribeEnvironmentMemberships](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-memberships.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-environment-status`
<a name="cloud9_DescribeEnvironmentStatus_cli_topic"></a>

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"
}
```
+  Para obtener información sobre la API, consulte [DescribeEnvironmentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-status.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-environments`
<a name="cloud9_DescribeEnvironments_cli_topic"></a>

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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environments.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-environments`
<a name="cloud9_ListEnvironments_cli_topic"></a>

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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/list-environments.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-environment-membership`
<a name="cloud9_UpdateEnvironmentMembership_cli_topic"></a>

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"
  }
}
```
+  Para obtener información sobre la API, consulte [UpdateEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment-membership.html) en la *Referencia de comandos de la AWS CLI*. 

### `update-environment`
<a name="cloud9_UpdateEnvironment_cli_topic"></a>

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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment.html) en la *Referencia de comandos de la AWS CLI*.