Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# AWS Cloud9 exemplos usando AWS CLI
<a name="cli_2_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 with 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_2_topic"></a>

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

**AWS CLI**  
**Para criar um ambiente de AWS desenvolvimento Cloud9 EC2**  
O `create-environment-ec2` exemplo a seguir cria um AWS ambiente de desenvolvimento Cloud9 com as configurações especificadas, inicia uma instância do Amazon Elastic Compute Cloud (Amazon EC2) e, em seguida, se conecta 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
```
Saída:  

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

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

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

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

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

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

### `delete-environment-membership`
<a name="cloud9_DeleteEnvironmentMembership_cli_2_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 do ambiente especificado do ambiente de desenvolvimento do AWS Cloud9 especificado.  
Comando:  

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

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

### `delete-environment`
<a name="cloud9_DeleteEnvironment_cli_2_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
```
Saída:  

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

### `describe-environment-memberships`
<a name="cloud9_DescribeEnvironmentMemberships_cli_2_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 AWS Cloud9**  
Este exemplo obtém informações sobre os membros do ambiente do ambiente de desenvolvimento AWS Cloud9 especificado.  
Comando:  

```
aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX
```
Saída:  

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

```
aws cloud9 describe-environment-memberships --environment-id 8a34f51ce1e04a08882f1e811bd706EX --permissions owner
```
Saída:  

```
{
  "memberships": [
    {
      "environmentId": "8a34f51ce1e04a08882f1e811bd706EX",
      "userId": "AIDAJNUEDQAQWFELJDLEX",
      "userArn": "arn:aws:iam::123456789012:user/MyDemoUser",
      "permissions": "owner"
    }
  ]
}
```
**Para obter informações sobre um membro do ambiente para 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
```
Saída:  

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

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

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

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

```
aws cloud9 describe-environment-status --environment-id 685f892f431b45c2b28cb69eadcdb0EX
```
Saída:  

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

### `describe-environments`
<a name="cloud9_DescribeEnvironments_cli_2_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 os ambientes de desenvolvimento AWS Cloud9 especificados.  
Comando:  

```
aws cloud9 describe-environments --environment-ids 685f892f431b45c2b28cb69eadcdb0EX 349c86d4579e4e7298d500ff57a6b2EX
```
Saída:  

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

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

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

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

```
aws cloud9 list-environments
```
Saída:  

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

### `update-environment-membership`
<a name="cloud9_UpdateEnvironmentMembership_cli_2_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 de ambiente existente para um ambiente de desenvolvimento AWS Cloud9**  
Este exemplo altera as configurações do membro do ambiente existente especificado para o ambiente de desenvolvimento AWS Cloud9 especificado.  
Comando:  

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

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

### `update-environment`
<a name="cloud9_UpdateEnvironment_cli_2_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 AWS Cloud9 existente**  
Este exemplo altera as configurações especificadas do ambiente de desenvolvimento AWS Cloud9 existente especificado.  
Comando:  

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

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