# AWS Cloud9 Exemplos do usando a AWS CLI
<a name="cli_cloud9_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS Cloud9.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

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

O código de exemplo a seguir mostra como usar `create-environment-ec2`.

**AWS CLI**  
**Para criar um ambiente de desenvolvimento do EC2 no AWS Cloud9**  
O exemplo `create-environment-ec2` a seguir cria um ambiente de desenvolvimento para o AWS Cloud9 com as configurações específicas, inicia uma instância do Amazon Elastic Compute Cloud (Amazon EC2) e, em seguida, conecta-se da instância ao ambiente.  

```
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
```
Resultado:  

```
{
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX"
}
```
Para obter mais informações, consulte [Criação de um ambiente do EC2](https://docs.aws.amazon.com/cloud9/latest/user-guide/create-environment-main.html) no *Guia do usuário do AWS Cloud9*.  
+  Para ver detalhes da API, consulte [CreateEnvironmentEc2](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-ec2.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `create-environment-membership`.

**AWS CLI**  
**Para adicionar um membro de ambiente a um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo adiciona o membro de ambiente de desenvolvimento especificado ao ambiente de desenvolvimento do AWS Cloud9.  
Comando:  

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

```
{
  "membership": {
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
    "userId": "AIDAJ3LOROMOUXTBSU6EX",
    "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser",
    "permissions": "read-write"
  }
}
```
+  Para ver detalhes da API, consulte [CreateEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/create-environment-membership.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `delete-environment-membership`.

**AWS CLI**  
**Para excluir um membro do ambiente de um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo exclui o membro de ambiente de desenvolvimento especificado do ambiente de desenvolvimento do AWS Cloud9.  
Comando:  

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

```
None.
```
+  Para ver detalhes da API, consulte [DeleteEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment-membership.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `delete-environment`.

**AWS CLI**  
**Para excluir um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo exclui o ambiente de desenvolvimento do AWS Cloud9 especificado. Se uma instância do Amazon EC2 estiver conectada ao ambiente, também encerrará a instância.  
Comando:  

```
aws cloud9 delete-environment --environment-id 8a34f51ce1e04a08882f1e811bd706EX
```
Resultado:  

```
None.
```
+  Para ver detalhes da API, consulte [DeleteEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/delete-environment.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `describe-environment-memberships`.

**AWS CLI**  
**Para obter informações sobre os membros do ambiente de um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo obtém informações sobre os membros do ambiente de desenvolvimento do AWS Cloud9 especificado.  
Comando:  

```
aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX
```
Resultado:  

```
{
  "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 obter informações sobre o proprietário de um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo obtém informações sobre o proprietário do ambiente de desenvolvimento do AWS Cloud9 especificado.  
Comando:  

```
aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX --permissions owner
```
Resultado:  

```
{
  "memberships": [
    {
      "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    }
  ]
}
```
**Para obter informações sobre os membros do ambiente de vários ambientes de desenvolvimento do AWS Cloud9**  
Este exemplo obtém informações sobre o membro do ambiente especificado para vários ambientes de desenvolvimento do AWS Cloud9.  
Comando:  

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

```
{
  "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 ver detalhes da API, consulte [DescribeEnvironmentMemberships](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-memberships.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `describe-environment-status`.

**AWS CLI**  
**Para obter informações sobre o status de um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo obtém informações sobre o status do ambiente de desenvolvimento do AWS Cloud9.  
Comando:  

```
aws cloud9 describe-environment-status --environment-id 685f892f431b45c2b28cb69eadcdb0EX
```
Resultado:  

```
{
  "status": "ready",
  "message": "Environment is ready to use"
}
```
+  Para ver detalhes da API, consulte [DescribeEnvironmentStatus](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environment-status.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `describe-environments`.

**AWS CLI**  
**Para obter informações sobre os ambientes de desenvolvimento do AWS Cloud9**  
Este exemplo obtém informações sobre ambientes de desenvolvimento do AWS Cloud9.  
Comando:  

```
aws cloud9 describe-environments --environment-ids 685f892f431b45c2b28cb69eadcdb0EX 349c86d4579e4e7298d500ff57a6b2EX
```
Resultado:  

```
{
  "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 ver detalhes da API, consulte [DescribeEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/describe-environments.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `list-environments`.

**AWS CLI**  
**Para obter uma lista de identificadores de ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo obtém uma lista de identificadores de ambientes de desenvolvimento do AWS Cloud9.  
Comando:  

```
aws cloud9 list-environments
```
Resultado:  

```
{
  "environmentIds": [
    "685f892f431b45c2b28cb69eadcdb0EX",
    "1980b80e5f584920801c09086667f0EX"
  ]
}
```
+  Para ver detalhes da API, consulte [ListEnvironments](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/list-environments.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `update-environment-membership`.

**AWS CLI**  
**Para alterar as configurações de um membro do ambiente de desenvolvimento existente para um ambiente de desenvolvimento do AWS Cloud9**  
Este exemplo altera as configurações do membro de um ambiente de desenvolvimento existente especificado do AWS Cloud9.  
Comando:  

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

```
{
  "membership": {
    "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
    "userId": "AIDAJ3LOROMOUXTBSU6EX",
    "userArn": "arn:aws:iam::123456789012:user/AnotherDemoUser",
    "permissions": "read-only"
  }
}
```
+  Para ver detalhes da API, consulte [UpdateEnvironmentMembership](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment-membership.html) na *Referência de comandos da AWS CLI*. 

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

O código de exemplo a seguir mostra como usar `update-environment`.

**AWS CLI**  
**Para alterar as configurações de um ambiente de desenvolvimento existente do AWS Cloud9**  
Este exemplo altera as configurações especificadas do ambiente de desenvolvimento do AWS Cloud9 existente especificado.  
Comando:  

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

```
None.
```
+  Para ver detalhes da API, consulte [UpdateEnvironment](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cloud9/update-environment.html) na *Referência de comandos da AWS CLI*.