Comprendre les versions de vos rapports

AWS met à jour votre rapport sur les coûts et l'utilisation au moins une fois par jour jusqu'à ce que vos frais soient finalisés. Lorsque vous créez un rapport, vous pouvez choisir de créer de nouvelles versions de rapport ou de remplacer la version du rapport existante à chaque mise à jour.

Vos fichiers de rapport incluent un fichier .csv ou une collection de fichiers .csv et le fichier manifeste. Votre rapport peut également inclure tout fichier supplémentaire permettant l'intégration de vos données avec Amazon Athena, Amazon Redshift ou Amazon. QuickSight

Les sections suivantes décrivent l'organisation des fichiers et les conventions de dénomination en fonction du versionnement du rapport que vous choisissez.

Calendrier de livraison des rapports sur les coûts et l'utilisation

Au cours de la période couverte par le rapport, AWS fournit un nouveau rapport et un nouveau fichier manifeste chaque fois que le rapport est AWS mis à jour. AWS s'appuie sur les rapports précédents jusqu'à la fin de la période de facturation. Après la fin de la période de facturation du rapport, AWS génère un nouveau rapport sans aucune des informations du rapport précédent.

Création de nouvelles versions du rapport sur les coûts et l'utilisation

Lorsque vous choisissez de conserver vos anciens rapports sur les coûts et l'utilisation, votre AWS CUR utilise les conventions d'organisation et de dénomination Amazon S3 suivantes.

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

• report-prefix = Le préfixe que vous attribuez au rapport.

• report-name = Le nom que vous attribuez au rapport.

• yyyymmdd-yyyymmdd = Plage de dates couverte par le rapport. Les rapports sont finalisés à la fin de cette plage de dates.

• assemblyId= Un identifiant AWS créé chaque fois que le rapport est mis à jour.

• file-number= Si la mise à jour inclut un fichier volumineux, il est AWS possible de le diviser en plusieurs fichiers. Le file-number suit les différents fichiers d'une mise à jour.

• csv = Format des fichiers du rapport.

• zip ou gz = Type de compression appliqué aux fichiers du rapport.

Par exemple, votre rapport peut être fourni sous la forme d'un ensemble des fichiers suivants.

<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 fournit tous les rapports d'une plage de dates de rapport dans le même report-prefix/report-name/yyyymmdd-yyyymmdd dossier. AWS attribue à chaque rapport un identifiant unique et le transmet au assemblyId sous-dossier du dossier de plage de dates. Si le rapport est trop volumineux pour être contenu dans un seul fichier, il est fractionné en plusieurs fichiers et transmis au même dossier assemblyId.

Pour de plus amples informations sur les fichiers manifeste lorsque vous conservez un rapport précédent, veuillez consulter Fichiers manifestes des rapports sur les coûts et l'utilisation

Remplacer les rapports de coûts et d'utilisation précédents

Lorsque vous choisissez de remplacer vos rapports de coûts et d'utilisation précédents, votre AWS CUR utilise les conventions d'organisation et de dénomination Amazon S3 suivantes.

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

• report-prefix = Le préfixe que vous attribuez au rapport.

• report-name = Le nom que vous attribuez au rapport.

• yyyymmdd-yyyymmdd= La plage de dates couverte par le rapport. AWS finalise les rapports à la fin de la plage de dates.

• file-number= Si la mise à jour inclut un fichier volumineux, il est AWS possible de le diviser en plusieurs fichiers. Le file-number suit les différents fichiers d'une mise à jour.

• csv = Format des fichiers du rapport.

• zip ou gz = Type de compression appliqué aux fichiers du rapport.

Par exemple, votre rapport peut être fourni sous la forme d'un ensemble des fichiers suivants.

<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

Spécifications Athena

Si vous avez choisi le support Athena lors de la création de votre AWS CUR, les conventions de dénomination des fichiers sont les mêmes que lorsque vous choisissez de remplacer votre AWS CUR, à l'exception du format et de la compression. Les fichiers Athena AWS CUR sont utilisés .parquet à la place. Par exemple, votre rapport peut être fourni sous la forme d'un ensemble des fichiers suivants.

<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 spécifications

Outre les fichiers AWS CUR, fournit AWS également un AWS CloudFormation modèle que vous pouvez utiliser pour configurer une AWS CloudFormation pile qui vous permet d'interroger les données Amazon S3 à l'aide d'Athena. Si vous ne souhaitez pas utiliser le AWS CloudFormation modèle, vous pouvez utiliser le code SQL fourni pour créer vos propres tables Athena. Pour plus d’informations, consultez Consultation des rapports de coûts et d'utilisation à l'aide d'Amazon Athena.

Fichiers manifestes des rapports sur les coûts et l'utilisation

Lorsque le AWS CUR est AWS mis à jour, il crée et fournit AWS également des fichiers manifestes que vous pouvez utiliser pour Amazon Athena, Amazon Redshift ou Amazon. QuickSight

Les fichiers manifeste utilisent les conventions de dénomination et répertorient les éléments suivants :

• Toutes les colonnes détaillées incluses dans le rapport à ce jour

• Une liste des fichiers de rapport si le rapport a été divisé en plusieurs fichiers

• La période couverte par le rapport et d'autres informations.

<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

Création de nouvelles versions du rapport sur les coûts et l'utilisation

Lorsque vous conservez les rapports de coûts et d'utilisation précédents, le fichier manifeste est envoyé à la fois dans le dossier de plage de dates et assemblyId dans le dossier. Chaque fois qu'un nouveau AWS CUR est AWS créé pour une plage de dates, il remplace le fichier manifeste stocké dans le dossier de plage de dates par un fichier manifeste mis à jour. AWS fournit le même fichier manifeste mis à jour assemblyId dans le dossier avec les fichiers de cette mise à jour. Les fichiers manifestes du dossier assemblyId ne sont pas remplacés.

Remplacer les rapports de coûts et d'utilisation précédents

Lorsque vous remplacez le AWS CUR précédent, le fichier manifeste est envoyé month=mm dans le dossier. Le fichier manifeste est écrasé avec les fichiers de rapport.

Caractéristiques d'Amazon Redshift

Si vous avez choisi l'option de prise en charge d'Amazon Redshift dans votre AWS CUR, vous créez et distribuez AWS également un fichier contenant les commandes SQL dont vous avez besoin pour télécharger votre rapport dans Amazon Redshift. Vous pouvez ouvrir le fichier SQL dans un éditeur de texte standard. Le fichier SQL utilise la convention de dénomination suivante.

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

Si vous utilisez les commandes du fichier RedshiftCommands, vous n'avez pas besoin d'ouvrir le fichier RedshiftManifest.

Important

Le fichier manifest détermine les fichiers du rapport chargés par la commande copy du fichier RedshiftCommands. La suppression du fichier manifest détériore la commande copy du fichier RedshiftCommands.

Caractéristiques techniques d'Amazon Athena

Si vous avez choisi l'option d'assistance Amazon Athena dans votre AWS CUR, vous pouvez AWS également créer et diffuser plusieurs fichiers pour vous aider à configurer toutes les ressources dont vous avez besoin. AWS fournit un AWS CloudFormation modèle, un fichier SQL contenant le code SQL pour créer manuellement votre table Athena et un fichier contenant le code SQL pour vérifier l'état d'actualisation de votre AWS CUR. Ces fichiers utilisent les conventions de dénomination suivantes.

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