{ "version": "2.0", "metadata": { "apiVersion": "2020-09-10", "endpointPrefix": "application-cost-profiler", "jsonVersion": "1.1", "protocol": "rest-json", "serviceFullName": "AWS Application Cost Profiler", "serviceId": "ApplicationCostProfiler", "signatureVersion": "v4", "signingName": "application-cost-profiler", "uid": "AWSApplicationCostProfiler-2020-09-10" }, "operations": { "DeleteReportDefinition": { "name": "DeleteReportDefinition", "http": { "method": "DELETE", "requestUri": "/reportDefinition/{reportId}" }, "input": { "shape": "DeleteReportDefinitionRequest" }, "output": { "shape": "DeleteReportDefinitionResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" } ], "documentation": "

Deletes the specified report definition in AWS Application Cost Profiler. This stops the report from being generated.

" }, "GetReportDefinition": { "name": "GetReportDefinition", "http": { "method": "GET", "requestUri": "/reportDefinition/{reportId}" }, "input": { "shape": "GetReportDefinitionRequest" }, "output": { "shape": "GetReportDefinitionResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" } ], "documentation": "

Retrieves the definition of a report already configured in AWS Application Cost Profiler.

" }, "ImportApplicationUsage": { "name": "ImportApplicationUsage", "http": { "method": "POST", "requestUri": "/importApplicationUsage" }, "input": { "shape": "ImportApplicationUsageRequest" }, "output": { "shape": "ImportApplicationUsageResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" } ], "documentation": "

Ingests application usage data from Amazon Simple Storage Service (Amazon S3).

The data must already exist in the S3 location. As part of the action, AWS Application Cost Profiler copies the object from your S3 bucket to an S3 bucket owned by Amazon for processing asynchronously.

" }, "ListReportDefinitions": { "name": "ListReportDefinitions", "http": { "method": "GET", "requestUri": "/reportDefinition" }, "input": { "shape": "ListReportDefinitionsRequest" }, "output": { "shape": "ListReportDefinitionsResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" } ], "documentation": "

Retrieves a list of all reports and their configurations for your AWS account.

The maximum number of reports is one.

" }, "PutReportDefinition": { "name": "PutReportDefinition", "http": { "method": "POST", "requestUri": "/reportDefinition" }, "input": { "shape": "PutReportDefinitionRequest" }, "output": { "shape": "PutReportDefinitionResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" }, { "shape": "ServiceQuotaExceededException" } ], "documentation": "

Creates the report definition for a report in Application Cost Profiler.

" }, "UpdateReportDefinition": { "name": "UpdateReportDefinition", "http": { "method": "PUT", "requestUri": "/reportDefinition/{reportId}" }, "input": { "shape": "UpdateReportDefinitionRequest" }, "output": { "shape": "UpdateReportDefinitionResult" }, "errors": [ { "shape": "InternalServerException" }, { "shape": "ThrottlingException" }, { "shape": "ValidationException" }, { "shape": "AccessDeniedException" } ], "documentation": "

Updates existing report in AWS Application Cost Profiler.

" } }, "shapes": { "DeleteReportDefinitionRequest": { "type": "structure", "required": [ "reportId" ], "members": { "reportId": { "shape": "ReportId", "documentation": "

Required. ID of the report to delete.

", "location": "uri", "locationName": "reportId" } } }, "DeleteReportDefinitionResult": { "type": "structure", "members": { "reportId": { "shape": "ReportId", "documentation": "

ID of the report that was deleted.

" } } }, "Format": { "type": "string", "enum": [ "CSV", "PARQUET" ] }, "GetReportDefinitionRequest": { "type": "structure", "required": [ "reportId" ], "members": { "reportId": { "shape": "ReportId", "documentation": "

ID of the report to retrieve.

", "location": "uri", "locationName": "reportId" } } }, "GetReportDefinitionResult": { "type": "structure", "required": [ "reportId", "reportDescription", "reportFrequency", "format", "destinationS3Location", "createdAt", "lastUpdated" ], "members": { "reportId": { "shape": "ReportId", "documentation": "

ID of the report retrieved.

" }, "reportDescription": { "shape": "ReportDescription", "documentation": "

Description of the report.

" }, "reportFrequency": { "shape": "ReportFrequency", "documentation": "

Cadence used to generate the report.

" }, "format": { "shape": "Format", "documentation": "

Format of the generated report.

" }, "destinationS3Location": { "shape": "S3Location", "documentation": "

Amazon Simple Storage Service (Amazon S3) location where the report is uploaded.

" }, "createdAt": { "shape": "Timestamp", "documentation": "

Timestamp (milliseconds) when this report definition was created.

" }, "lastUpdated": { "shape": "Timestamp", "documentation": "

Timestamp (milliseconds) when this report definition was last updated.

" } } }, "ImportApplicationUsageRequest": { "type": "structure", "required": [ "sourceS3Location" ], "members": { "sourceS3Location": { "shape": "SourceS3Location", "documentation": "

Amazon S3 location to import application usage data from.

" } } }, "ImportApplicationUsageResult": { "type": "structure", "required": [ "importId" ], "members": { "importId": { "shape": "ImportId", "documentation": "

ID of the import request.

" } } }, "ImportId": { "type": "string", "max": 255, "min": 1, "pattern": "[0-9A-Za-z\\.\\-_]*" }, "Integer": { "type": "integer", "max": 100, "min": 1 }, "ListReportDefinitionsRequest": { "type": "structure", "members": { "nextToken": { "shape": "Token", "documentation": "

The token value from a previous call to access the next page of results.

", "location": "querystring", "locationName": "nextToken" }, "maxResults": { "shape": "Integer", "documentation": "

The maximum number of results to return.

", "location": "querystring", "locationName": "maxResults" } } }, "ListReportDefinitionsResult": { "type": "structure", "members": { "reportDefinitions": { "shape": "ReportDefinitionList", "documentation": "

The retrieved reports.

" }, "nextToken": { "shape": "Token", "documentation": "

The value of the next token, if it exists. Null if there are no more results.

" } } }, "PutReportDefinitionRequest": { "type": "structure", "required": [ "reportId", "reportDescription", "reportFrequency", "format", "destinationS3Location" ], "members": { "reportId": { "shape": "ReportId", "documentation": "

Required. ID of the report. You can choose any valid string matching the pattern for the ID.

" }, "reportDescription": { "shape": "ReportDescription", "documentation": "

Required. Description of the report.

" }, "reportFrequency": { "shape": "ReportFrequency", "documentation": "

Required. The cadence to generate the report.

" }, "format": { "shape": "Format", "documentation": "

Required. The format to use for the generated report.

" }, "destinationS3Location": { "shape": "S3Location", "documentation": "

Required. Amazon Simple Storage Service (Amazon S3) location where Application Cost Profiler uploads the report.

" } } }, "PutReportDefinitionResult": { "type": "structure", "members": { "reportId": { "shape": "ReportId", "documentation": "

ID of the report.

" } } }, "ReportDefinition": { "type": "structure", "members": { "reportId": { "shape": "ReportId", "documentation": "

The ID of the report.

" }, "reportDescription": { "shape": "ReportDescription", "documentation": "

Description of the report

" }, "reportFrequency": { "shape": "ReportFrequency", "documentation": "

The cadence at which the report is generated.

" }, "format": { "shape": "Format", "documentation": "

The format used for the generated reports.

" }, "destinationS3Location": { "shape": "S3Location", "documentation": "

The location in Amazon Simple Storage Service (Amazon S3) the reports should be saved to.

" }, "createdAt": { "shape": "Timestamp", "documentation": "

Timestamp (milliseconds) when this report definition was created.

" }, "lastUpdatedAt": { "shape": "Timestamp", "documentation": "

Timestamp (milliseconds) when this report definition was last updated.

" } }, "documentation": "

The configuration of a report in AWS Application Cost Profiler.

" }, "ReportDefinitionList": { "type": "list", "member": { "shape": "ReportDefinition" } }, "ReportDescription": { "type": "string", "max": 1024, "min": 1, "pattern": ".*\\S.*" }, "ReportFrequency": { "type": "string", "enum": [ "MONTHLY", "DAILY", "ALL" ] }, "ReportId": { "type": "string", "max": 255, "min": 1, "pattern": "^[0-9A-Za-z\\.\\-_]+$" }, "S3Bucket": { "type": "string", "max": 63, "min": 3, "pattern": "(?=^.{3,63}$)(?!^(\\d+\\.)+\\d+$)(^(([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])\\.)*([a-z0-9]|[a-z0-9][a-z0-9\\-]*[a-z0-9])$)" }, "S3BucketRegion": { "type": "string", "enum": [ "ap-east-1", "me-south-1", "eu-south-1", "af-south-1" ] }, "S3Key": { "type": "string", "max": 512, "min": 1, "pattern": ".*\\S.*" }, "S3Location": { "type": "structure", "required": [ "bucket", "prefix" ], "members": { "bucket": { "shape": "S3Bucket", "documentation": "

Name of the S3 bucket.

" }, "prefix": { "shape": "S3Prefix", "documentation": "

Prefix for the location to write to.

" } }, "documentation": "

Represents the Amazon Simple Storage Service (Amazon S3) location where AWS Application Cost Profiler reports are generated and then written to.

" }, "S3Prefix": { "type": "string", "max": 512, "min": 1, "pattern": ".*\\S.*" }, "SourceS3Location": { "type": "structure", "required": [ "bucket", "key" ], "members": { "bucket": { "shape": "S3Bucket", "documentation": "

Name of the bucket.

" }, "key": { "shape": "S3Key", "documentation": "

Key of the object.

" }, "region": { "shape": "S3BucketRegion", "documentation": "

Region of the bucket. Only required for Regions that are disabled by default. For more infomration about Regions that are disabled by default, see Enabling a Region in the AWS General Reference guide.

" } }, "documentation": "

Represents the Amazon Simple Storage Service (Amazon S3) location where usage data is read from.

" }, "Timestamp": { "type": "timestamp" }, "Token": { "type": "string", "max": 102400, "min": 1, "pattern": "^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$" }, "UpdateReportDefinitionRequest": { "type": "structure", "required": [ "reportId", "reportDescription", "reportFrequency", "format", "destinationS3Location" ], "members": { "reportId": { "shape": "ReportId", "documentation": "

Required. ID of the report to update.

", "location": "uri", "locationName": "reportId" }, "reportDescription": { "shape": "ReportDescription", "documentation": "

Required. Description of the report.

" }, "reportFrequency": { "shape": "ReportFrequency", "documentation": "

Required. The cadence to generate the report.

" }, "format": { "shape": "Format", "documentation": "

Required. The format to use for the generated report.

" }, "destinationS3Location": { "shape": "S3Location", "documentation": "

Required. Amazon Simple Storage Service (Amazon S3) location where Application Cost Profiler uploads the report.

" } } }, "UpdateReportDefinitionResult": { "type": "structure", "members": { "reportId": { "shape": "ReportId", "documentation": "

ID of the report.

" } } } }, "documentation": "

This reference provides descriptions of the AWS Application Cost Profiler API.

The AWS Application Cost Profiler API provides programmatic access to view, create, update, and delete application cost report definitions, as well as to import your usage data into the Application Cost Profiler service.

For more information about using this service, see the AWS Application Cost Profiler User Guide.

" }