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

# Iniciar o AWS Config com um gravador de configuração gerenciado pelo cliente usando a AWS CLI
<a name="gs-cli-subscribe"></a>

Você pode iniciar o AWS Config criando um gravador de configuração gerenciado pelo cliente. Para criar um gravador de configuração gerenciado pelo cliente com aAWS CLI, use os seguintes comandos: [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html), [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html) e [https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html).
+ O comando `put-configuration-recorder` cria um gravador de configuração gerenciado pelo cliente.
+ O comando `put-delivery-channel` cria um objeto de canal de entrega para fornecer informações de configuração a um bucket do S3 e a um tópico do SNS.
+ Em seguida, `start-configuration-recorder` inicia o gravador de configuração gerenciado pelo cliente. O gravador de configuração gerenciado pelo cliente começará a registrar alterações de configuração para os tipos de recurso que você especificar.

**Topics**
+ [Considerações](#gs-cli-subscribe-considerations)
+ [Etapa 1: executar o comando put-configuration-recorder](#gs-cli-subscribe-put-configuration-recorder)
+ [Etapa 2: executar o comando put-delivery-channel](#gs-cli-subscribe-put-delivery-channel)
+ [Etapa 3: executar o comando start-configuration-recorder](#gs-cli-subscribe-start-configuration-recorder)

## Considerações
<a name="gs-cli-subscribe-considerations"></a>

**O bucket do S3, o tópico do SNS e o perfil do IAM são obrigatórios**

Para criar um gravador de configuração gerenciado pelo cliente, você precisa criar um bucket do S3, um tópico do SNS e um perfil do IAM com políticas anexadas como pré-requisitos. Para configurar seus pré-requisitos para o AWS Config, consulte [Pré-requisitos](https://docs.aws.amazon.com/config/latest/developerguide/gs-cli-prereq.html).

**Um gravador de configuração gerenciado pelo cliente por conta por região**

Só e possível ter um gravador de configuração gerenciado pelo cliente por Conta da AWS e por Região da AWS.

**Um canal de entrega por conta por região**

É possível ter somente uma região de canal de entrega por Conta da AWS para cada Região da AWS.

**Políticas e resultados de conformidade**

As [políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) e [outras políticas gerenciadas no AWS Organizations](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies.html) podem determinar se o AWS Config tem permissões para registrar alterações na configuração de seus recursos. Além disso, as regras avaliam diretamente a configuração de um recurso e não levam em conta essas políticas ao executar avaliações. As políticas em vigor devem estar alinhadas com a forma como você pretende usar o AWS Config.

## Etapa 1: executar o comando put-configuration-recorder
<a name="gs-cli-subscribe-put-configuration-recorder"></a>

Use o comando [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html) para criar um gravador de configuração gerenciado pelo cliente:

Esse comando usa os campos `--configuration-recorder` e `---recording-group`.

```
$ aws configservice put-configuration-recorder \
--configuration-recorder file://configurationRecorder.json \
--recording-group file://recordingGroup.json
```

**O campo `configuration-recorder`**

O arquivo `configurationRecorder.json` especifica `name` e `roleArn`, bem como a frequência de gravação padrão para o gravador de configuração (`recordingMode`). Também é possível usar esse campo para substituir a frequência de gravação de tipos de recurso específicos.

```
{
  "name": "default",
  "roleARN": "arn:aws:iam::123456789012:role/config-role",
  "recordingMode": {
    "recordingFrequency": CONTINUOUS or DAILY,
    "recordingModeOverrides": [ 
        { 
            "description": "Description you provide for the override",
            "recordingFrequency": CONTINUOUS or DAILY,
            "resourceTypes": [ Comma-separated list of resource types to include in the override ]
        }
    ]
  }
}
```

**O campo `recording-group`**

O arquivo `recordingGroup.json` especifica quais tipos de recurso são gravados.

```
{ 
    "allSupported": boolean,
    "exclusionByResourceTypes": { 
        "resourceTypes": [ Comma-separated list of resource types to exclude ]
    },
    "includeGlobalResourceTypes": boolean,
    "recordingStrategy": { 
        "useOnly": "Recording strategy for the configuration recorder"
    },
    "resourceTypes": [ Comma-separated list of resource types to include]
}
```

Para ter mais informações sobre esses campos, consulte [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-configuration-recorder.html) na *Referência de comandos da AWS CLI*.

## Etapa 2: executar o comando put-delivery-channel
<a name="gs-cli-subscribe-put-delivery-channel"></a>

Use o comando [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html) para criar um canal de entrega:

Esse comando usa o campo `--delivery-channel`.

```
$ aws configservice put-delivery-channel --delivery-channel file://deliveryChannel.json
```

**O campo `delivery-channel`**

O arquivo `deliveryChannel.json` especifica o seguinte:
+ O `name` do canal de entrega.
+ O `s3BucketName` no qual o AWS Config envia snapshots de configuração.
+ O `snsTopicARN` no qual o AWS Config envia notificações.
+ O `configSnapshotDeliveryProperties` que define com que frequência o AWS Config fornece snapshots de configuração e com que frequência invoca avaliações de regras periódicas.

```
{
    "name": "default",
    "s3BucketName": "config-bucket-123456789012",
    "snsTopicARN": "arn:aws:sns:us-east-1:123456789012:config-topic",
    "configSnapshotDeliveryProperties": {
        "deliveryFrequency": "Twelve_Hours"
    }
}
```

Para ter mais informações sobre esses campos, consulte [https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/put-delivery-channel.html) na *Referência de comandos da AWS CLI*.

## Etapa 3: executar o comando start-configuration-recorder
<a name="gs-cli-subscribe-start-configuration-recorder"></a>

Use o comando [https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html) para iniciar o AWS Config:

```
$ aws configservice start-configuration-recorder --configuration-recorder-name configRecorderName
```

Para ter mais informações sobre esses campos, consulte [https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html](https://docs.aws.amazon.com/cli/latest/reference/configservice/start-configuration-recorder.html) na *Referência de comandos da AWS CLI*.