什么是 S3 Storage Lens 存储统计管理工具导出清单？ - Amazon Simple Storage Service

什么是 S3 Storage Lens 存储统计管理工具导出清单？

鉴于聚合的数据量大，在通用存储桶中，S3 Storage Lens 存储统计管理工具每日指标导出可以拆分为多个文件。清单文件 manifest.json 描述了当天的指标导出文件的位置。无论何时，只要传输了新的导出，就会附有新清单。manifest.json 文件中包含的每个清单均提供了有关导出的元数据和其他基本信息。

清单信息包括以下属性：

  • sourceAccountId – 配置拥有者的账户 ID。

  • configId – 控制面板的唯一标识符。

  • destinationBucket – 放置指标导出的目标桶 Amazon Resource Name（ARN）。

  • reportVersion – 导出的版本。

  • reportDate – 报告的日期。

  • reportFormat – 报告的格式。

  • reportSchema – 报告的架构。

  • reportFiles – 目标桶中的导出报告文件的实际列表。

清单目标路径示例：

user-defined-prefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/manifests/dt=2025-03-18/manifest.json

以下示例说明 CSV 格式的 Storage Lens 存储统计管理工具默认指标报告的 manifest.json 文件：

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-07-15",  
   "reportFormat": "CSV",  
   "reportSchema": "version_number,configuration_id,report_date,aws_account_number,aws_region,storage_class,record_type,record_value,bucket_name,metric_name,metric_value",  
   "reportFiles": [  
        {  
            "key": "DestinationPrefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-07-15/12345678-1234-1234-1234-123456789012.csv",  
            "size": 1603959,  
            "md5Checksum": "2177e775870def72b8d84febe1ad3574"  
        }  
   ]  
}

以下示例说明 CSV 格式的 Storage Lens 存储统计管理工具扩展前缀指标报告的 manifest.json 文件：

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",   
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "CSV",  
   "reportSchema": "version_number,configuration_id,report_date,aws_account_number,aws_region,storage_class,record_type,record_value,bucket_name,metric_name,metric_value",  
   "reportFiles": [  
        {  
            "key": "DestinationPrefix/StorageLensExpandedPrefixes/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/EXAMPLE1234-56ab-78cd-90ef-EXAMPLE11111.csv",  
            "size": 1603959,  
            "md5Checksum": "2177e775870def72b8d84febe1ad3574"  
        }  
      ]  
}

以下示例说明 Parquet 格式的 Storage Lens 存储统计管理工具默认指标报告的 manifest.json 文件：

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "Parquet",  
   "reportSchema": "message s3.storage.lens { required string version_number; required string configuration_id; required string report_date; required string aws_account_number; required string aws_region; required string storage_class; required string record_type; required string record_value; required string bucket_name; required string metric_name; required long metric_value; }",  
   "reportFiles": [  
      {  
         "key": "DestinationPrefix/StorageLens/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/bd23de7c-b46a-4cf4-bcc5-b21aac5be0f5.par",  
         "size": 14714,  
         "md5Checksum": "b5c741ee0251cd99b90b3e8eff50b944"  
      }  
   ]  
}

以下示例说明 Parquet 格式的 Storage Lens 存储统计管理工具扩展前缀指标报告的 manifest.json 文件：

{  
   "sourceAccountId": "111122223333",  
   "configId": "example-dashboard-configuration-id",  
   "destinationBucket": "arn:aws:s3:::amzn-s3-demo-destination-bucket",  
   "reportVersion": "V_1",  
   "reportDate": "2025-11-03",  
   "reportFormat": "Parquet",  
   "reportSchema": "message s3.storage.lens { required string version_number; required string configuration_id; required string report_date; required string aws_account_number; required string aws_region; required string storage_class; required string record_type; required string record_value; required string bucket_name; required string metric_name; required long metric_value; }",  
   "reportFiles": [  
      {  
         "key": "DestinationPrefix/StorageLensExpandedPrefixes/111122223333/example-dashboard-configuration-id/V_1/reports/dt=2025-11-03/bd23de7c-b46a-4cf4-bcc5-b21aac5be0f5.par",  
         "size": 14714,  
         "md5Checksum": "b5c741ee0251cd99b90b3e8eff50b944"  
      }  
   ]  
}

您可以将指标导出配置为作为控制面板配置的一部分在 Amazon S3 控制台中生成，也可以使用 Amazon S3 REST API、AWS CLI 和开发工具包进行生成。