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á.

# Configurar o CORS usando a AWS CLI
<a name="cors-configuration-cli"></a>

Você pode configurar o CORS para o bucket do Lightsail usando a AWS CLI com o parâmetro `--cors`. Esse parâmetro aceita um arquivo JSON que contém sua configuração do CORS. Para obter mais informações sobre os elementos de uma configuração do CORS, consulte [Elementos de uma configuração de CORS](cors-how-evaluation-works.md#cors-configuration-elements).

**Topics**
+ [Aplicar uma configuração do CORS](#cors-configuration-apply)
+ [Exemplo da configuração do CORS](#cors-configuration-examples)
+ [Excluir configurações do CORS](#cors-remove-configuration)

## Aplicar uma configuração do CORS
<a name="cors-configuration-apply"></a>

O procedimento a seguir mostra como uma configuração do CORS pode ser aplicada a um bucket ao especificar um arquivo JSON. Para ver mais exemplos de configurações, consulte [Exemplo da configuração do CORS](#cors-configuration-examples).

**Para configurar o CORS de um bucket usando o AWS CLI**

1. Crie um arquivo JSON contendo a configuração do CORS. Crie um arquivo chamado `cors-config.json` com o seguinte conteúdo:

   ```
   {
     "CORSRules": [
       {
         "AllowedOrigins": ["https://example.com"],
         "AllowedMethods": ["GET", "PUT", "POST"],
         "AllowedHeaders": ["*"],
         "MaxAgeSeconds": 3000
       }
     ]
   }
   ```

1. Use a AWS CLI para aplicar a configuração do CORS ao bucket:

   ```
   aws lightsail update-bucket --bucket-name amzn-s3-demo-bucket --cors file://cors-config.json
   ```

1. Verifique se a configuração do CORS foi aplicada com êxito:

   ```
   aws lightsail get-buckets --bucket-name amzn-s3-demo-bucket --include-cors
   ```

**nota**  
Substitua *amzn-s3-demo-bucket* pelo nome do seu bucket do Lightsail.

## Exemplo da configuração do CORS
<a name="cors-configuration-examples"></a>

Os exemplos a seguir mostram as configurações usuais do CORS para casos de uso diferentes.

**Exemplo 1: permitir todos os métodos e origens**  
Essa configuração permite que todas as origens usem qualquer método HTTP para acessar seu bucket:

```
{
    "CORSRules": [
      {
        "AllowedOrigins": ["*"],
        "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
        "AllowedHeaders": ["*"],
        "MaxAgeSeconds": 3000
      }
    ]
  }
```

**Exemplo 2: restringir a um domínio específico**  
Essa configuração permite apenas solicitações de `https://mywebsite.com`:

```
{
    "CORSRules": [
      {
        "AllowedOrigins": ["https://mywebsite.com"],
        "AllowedMethods": ["GET", "PUT"],
        "AllowedHeaders": ["Authorization", "Content-Type"],
        "ExposeHeaders": ["ETag"],
        "MaxAgeSeconds": 3600
      }
    ]
  }
```

**Exemplo 3: diversas regras para origens diferentes**  
Essa configuração define regras distintas para origens diferentes:

```
{
    "CORSRules": [
      {
        "AllowedOrigins": ["https://mywebsite.com"],
        "AllowedMethods": ["GET", "PUT", "POST"],
        "AllowedHeaders": ["*"],
        "MaxAgeSeconds": 3600
      },
      {
        "AllowedOrigins": ["https://cdn.mywebsite.com"],
        "AllowedMethods": ["GET"],
        "AllowedHeaders": ["Authorization"],
        "MaxAgeSeconds": 86400
      }
    ]
  }
```

## Excluir configurações do CORS
<a name="cors-remove-configuration"></a>

Para excluir a configuração do CORS do seu bucket, use o seguinte comando da AWS CLI:

```
aws lightsail update-bucket --bucket-name amzn-s3-demo-bucket --cors '{"rules":[]}'
```

**nota**  
Substitua *amzn-s3-demo-bucket* pelo nome do seu bucket do Lightsail.

Depois de excluir a configuração do CORS, as solicitações entre origens do bucket serão bloqueadas pelos navegadores.