# AWS Cost and Usage Report Exemplos do usando a AWS CLI
<a name="cli_cost-and-usage-report-service_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 Cost and Usage Report.

*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>

### `delete-report-definition`
<a name="cost-and-usage-report-service_DeleteReportDefinition_cli_topic"></a>

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

**AWS CLI**  
**Para excluir um relatório custos e uso da AWS**  
Este exemplo exclui um relatório de custos e uso da AWS.  
Comando:  

```
aws cur --region us-east-1 delete-report-definition --report-name "ExampleReport"
```
+  Para ver detalhes da API, consulte [DeleteReportDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/delete-report-definition.html) na *Referência de comandos da AWS CLI*. 

### `describe-report-definitions`
<a name="cost-and-usage-report-service_DescribeReportDefinitions_cli_topic"></a>

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

**AWS CLI**  
**Para recuperar uma lista de relatórios de custos e uso da AWS**  
Este exemplo descreve uma lista de relatórios de custos e uso da AWS pertencentes a uma conta.  
Comando:  

```
aws cur --region us-east-1 describe-report-definitions --max-items 5
```
Resultado:  

```
  {
"ReportDefinitions": [
  {
      "ReportName": "ExampleReport",
      "Compression": "ZIP",
      "S3Region": "us-east-1",
      "Format": "textORcsv",
      "S3Prefix": "exampleprefix",
      "S3Bucket": "example-s3-bucket",
      "TimeUnit": "DAILY",
      "AdditionalArtifacts": [
          "REDSHIFT",
          "QUICKSIGHT"
      ],
      "AdditionalSchemaElements": [
          "RESOURCES"
      ]
  }
]
  }
```
+  Para ver detalhes da API, consulte [DescribeReportDefinitions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/describe-report-definitions.html) na *Referência de comandos da AWS CLI*. 

### `put-report-definition`
<a name="cost-and-usage-report-service_PutReportDefinition_cli_topic"></a>

O código de exemplo a seguir mostra como usar `put-report-definition`.

**AWS CLI**  
**Para criar relatórios de custos e uso da AWS**  
O exemplo `put-report-definition` a seguir cria um relatório diário de custos e uso da AWS que você pode carregar no Amazon Redshift ou no Amazon QuickSight.  

```
aws cur put-report-definition --report-definition file://report-definition.json
```
Conteúdo de `report-definition.json`:  

```
{
    "ReportName": "ExampleReport",
    "TimeUnit": "DAILY",
    "Format": "textORcsv",
    "Compression": "ZIP",
    "AdditionalSchemaElements": [
        "RESOURCES"
    ],
    "S3Bucket": "example-s3-bucket",
    "S3Prefix": "exampleprefix",
    "S3Region": "us-east-1",
    "AdditionalArtifacts": [
        "REDSHIFT",
        "QUICKSIGHT"
    ]
}
```
+  Consulte detalhes da API em [PutReportDefinition](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/cur/put-report-definition.html) na *Referência de comandos da AWS CLI*.