Noções básicas sobre as versões dos relatórios

AWS atualiza seu Relatório de Custo e Uso pelo menos uma vez por dia até que suas cobranças sejam finalizadas. Ao criar um relatório, você pode optar por criar novas versões do relatório ou substituir a versão existente do relatório a cada atualização.

Seus arquivos de relatório incluem um arquivo.csv ou uma coleção de arquivos.csv e o arquivo de manifesto. Seu relatório também pode incluir qualquer arquivo adicional que suporte a integração de seus dados com o Amazon Athena, o Amazon Redshift ou a Amazon. QuickSight

As seções a seguir descrevem a organização do arquivo e as convenções de nomenclatura com base no versionamento de relatórios que você escolher.

Cronograma de entrega dos relatórios de custos e uso

Durante o período do relatório, AWS entrega um novo relatório e um novo arquivo de manifesto sempre que AWS atualiza o relatório. AWS baseia-se em relatórios anteriores até o final do período de cobrança. Após o final do período de cobrança do relatório, AWS gera um novo relatório sem nenhuma das informações do relatório anterior.

Criar versões de relatório de custos e uso

Quando você opta por manter seus relatórios de custo e uso anteriores, seu AWS CUR usa as seguintes convenções de organização e nomenclatura do Amazon S3.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-<file-number>.csv.<zip|gz>

• report-prefix = o prefixo que você atribui ao relatório.

• report-name = o nome que você atribui ao relatório.

• yyyymmdd-yyyymmdd = O intervalo de datas coberto pelo relatório. Os relatórios são finalizadas no fim do intervalo de datas.

• assemblyId= Um ID que é AWS criado sempre que o relatório é atualizado.

• file-number= Se a atualização incluir um arquivo grande, AWS poderá dividi-lo em vários arquivos. O file-number controla os diferentes arquivos de uma atualização.

• csv = formato dos arquivos de relatório.

• zip ou gz = tipo de compactação aplicada nos arquivos de relatório.

Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<1>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<2>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-<3>.csv.<zip>
<example-report-prefix>/<example-report-name>/20160101-20160131/<123456789>/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/20160101-20160131/<example-report-name>-Manifest.json

AWS entrega todos os relatórios em um intervalo de datas do relatório na mesma report-prefix/report-name/yyyymmdd-yyyymmdd pasta. AWS dá a cada relatório uma ID exclusiva e o entrega na assemblyId subpasta na pasta do intervalo de datas. Se for muito grande para um único arquivo, o relatório será dividido em vários arquivos e entregue na mesma pasta assemblyId.

Para obter mais informações sobre como manifestar arquivos ao manter um relatório anterior, consulte Arquivos de manifesto dos relatórios de custos e uso

Substituir relatórios de custos e uso anteriores

Quando você opta por sobrescrever seus relatórios de custo e uso anteriores, seu AWS CUR usa as seguintes convenções de organização e nomenclatura do Amazon S3.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<file-number>.csv.<zip|gz>

• report-prefix = o prefixo que você atribui ao relatório.

• report-name = o nome que você atribui ao relatório.

• yyyymmdd-yyyymmdd= O intervalo de datas que o relatório cobre. AWS finaliza os relatórios no final do intervalo de datas.

• file-number= Se a atualização incluir um arquivo grande, AWS poderá dividi-lo em vários arquivos. O file-number controla os diferentes arquivos de uma atualização.

• csv = formato dos arquivos de relatório.

• zip ou gz = tipo de compactação aplicada nos arquivos de relatório.

Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<1>.csv.<zip>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<2>.csv.<zip><example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-<3>.csv.<zip>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json

Especificações do Athena

Se você escolheu o suporte ao Athena ao criar seu AWS CUR, as convenções de nomenclatura de arquivo são as mesmas de quando você escolhe sobrescrever seu AWS CUR, exceto pelo formato e pela compactação. Em vez disso, os arquivos AWS CUR do Athena são usados. .parquet Por exemplo, seu relatório pode ser entregue como um conjunto dos seguintes arquivos.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>.parquet
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status>
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml

AWS CloudFormation especificações

Além dos arquivos AWS CUR, AWS também fornece um AWS CloudFormation modelo que você pode usar para configurar uma AWS CloudFormation pilha que permite consultar dados do Amazon S3 usando o Athena. Se você não quiser usar o AWS CloudFormation modelo, poderá usar o SQL fornecido para criar suas próprias tabelas do Athena. Para ter mais informações, consulte Consultar relatórios de custos e uso com o Amazon Athena.

Arquivos de manifesto dos relatórios de custos e uso

Quando AWS atualiza o AWS CUR, AWS também cria e entrega arquivos de manifesto que você pode usar para Amazon Athena, Amazon Redshift ou Amazon. QuickSight

Os arquivos manifesto usam as convenções de nomenclatura e listam o seguinte:

• Todas as colunas de detalhes incluídas no relatório até o momento

• Uma lista dos arquivos do relatório, se o relatório foi dividido em vários arquivos

• O período abrangido pelo relatório e outras informações.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-Manifest.json
<example-report-prefix>/<example-report-name>/<example-report-name>/year=2018/month=12/<example-report-name>-Manifest.json

Criar versões de relatório de custos e uso

Quando você mantém os relatórios de custos e uso anteriores, o arquivo de manifesto é entregue na pasta do intervalo de datas e na pasta assemblyId. Cada vez que AWS cria um novo AWS CUR para um intervalo de datas, ele substitui o arquivo de manifesto armazenado na pasta do intervalo de datas por um arquivo de manifesto atualizado. AWS entrega o mesmo arquivo de manifesto atualizado para a assemblyId pasta junto com os arquivos dessa atualização. Os arquivos manifesto na pasta assemblyId não são substituídos.

Substituir relatórios de custos e uso anteriores

Quando você sobrescreve o AWS CUR anterior, o arquivo de manifesto é entregue à month=mm pasta. O arquivo manifesto é substituído junto com os arquivos de relatório.

Especificações do Amazon Redshift

Se você escolheu a opção de suporte ao Amazon Redshift em seu AWS CUR, AWS também cria e entrega um arquivo com os comandos SQL necessários para carregar seu relatório no Amazon Redshift. É possível abrir o arquivo SQL com um editor de texto normal. O arquivo SQL usa a seguinte convenção de nomenclatura.

<example-report-prefix>/<example-report-name>/yyyymmdd-yyyymmdd/<assemblyId>/<example-report-name>-RedshiftCommands.sql

Se você usar os comandos do arquivo RedshiftCommands, não será necessário abrir o arquivo RedshiftManifest.

Importante

O arquivo manifest determina quais arquivos de relatório o comando copy no arquivo RedshiftCommands carrega. A exclusão ou a remoção do arquivo manifest quebra o comando de cópia do arquivo RedshiftCommands.

Especificações do Amazon Athena

Se você escolheu a opção de suporte ao Amazon Athena em seu AWS CUR, AWS também cria e entrega vários arquivos para ajudar a configurar todos os recursos necessários. AWS fornece um AWS CloudFormation modelo, um arquivo SQL com o SQL para criar sua tabela Athena manualmente e um arquivo com o SQL para verificar o status de atualização do AWS CUR. Esses arquivos usam as seguintes convenções de nomenclatura.

<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/crawler-cfn.yml
<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<example-report-name>-create-table.sql
<example-report-prefix>/<example-report-name>/<example-report-name>/yyyymmdd-yyyymmdd/<cost_and_usage_data_status>