AWS Cost Explorer Service
You can use the Cost Explorer API to programmatically query your cost and usage data. You can query for aggregated data such as total monthly costs or total daily usage. You can also query for granular data. This might include the number of daily write operations for Amazon DynamoDB database tables in your production environment.
Service Endpoint
The Cost Explorer API provides the following endpoint:
https://ce.us-east-1.amazonaws.comFor information about the costs that are associated with the Cost Explorer API, see Amazon Web Services Cost Management Pricing.
costexplorer( config = list(), credentials = list(), endpoint = NULL, region = NULL )
config: Optional configuration of credentials, endpoint, and/or region.
credentials :
creds :
profile : The name of a profile to use. If not given, then the default profile is used.
anonymous : Set anonymous credentials.
endpoint : The complete URL to use for the constructed client.
region : The AWS Region used in instantiating the client.
close_connection : Immediately close all HTTP connections.
timeout : The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
s3_force_path_style : Set this to true to force the request to use path-style addressing, i.e. http://s3.amazonaws.com/BUCKET/KEY.
sts_regional_endpoint : Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials: Optional credentials shorthand for the config parameter
creds :
profile : The name of a profile to use. If not given, then the default profile is used.
anonymous : Set anonymous credentials.
endpoint: Optional shorthand for complete URL to use for the constructed client.
region: Optional shorthand for AWS Region used in instantiating the client.
A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.
svc <- costexplorer(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical",
sts_regional_endpoint = "string"
),
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string"
)
| create_anomaly_monitor | Creates a new cost anomaly detection monitor with the requested type and monitor specification |
| create_anomaly_subscription | Adds an alert subscription to a cost anomaly detection monitor |
| create_cost_category_definition | Creates a new Cost Category with the requested name and rules |
| delete_anomaly_monitor | Deletes a cost anomaly monitor |
| delete_anomaly_subscription | Deletes a cost anomaly subscription |
| delete_cost_category_definition | Deletes a Cost Category |
| describe_cost_category_definition | Returns the name, Amazon Resource Name (ARN), rules, definition, and effective dates of a Cost Category that's defined in the account |
| get_anomalies | Retrieves all of the cost anomalies detected on your account during the time period that's specified by the DateInterval object |
| get_anomaly_monitors | Retrieves the cost anomaly monitor definitions for your account |
| get_anomaly_subscriptions | Retrieves the cost anomaly subscription objects for your account |
| get_approximate_usage_records | Retrieves estimated usage records for hourly granularity or resource-level data at daily granularity |
| get_commitment_purchase_analysis | Retrieves a commitment purchase analysis result based on the AnalysisId |
| get_cost_and_usage | Retrieves cost and usage metrics for your account |
| get_cost_and_usage_with_resources | Retrieves cost and usage metrics with resources for your account |
| get_cost_categories | Retrieves an array of Cost Category names and values incurred cost |
| get_cost_forecast | Retrieves a forecast for how much Amazon Web Services predicts that you will spend over the forecast time period that you select, based on your past costs |
| get_dimension_values | Retrieves all available filter values for a specified filter over a period of time |
| get_reservation_coverage | Retrieves the reservation coverage for your account, which you can use to see how much of your Amazon Elastic Compute Cloud, Amazon ElastiCache, Amazon Relational Database Service, or Amazon Redshift usage is covered by a reservation |
| get_reservation_purchase_recommendation | Gets recommendations for reservation purchases |
| get_reservation_utilization | Retrieves the reservation utilization for your account |
| get_rightsizing_recommendation | Creates recommendations that help you save cost by identifying idle and underutilized Amazon EC2 instances |
| get_savings_plan_purchase_recommendation_details | Retrieves the details for a Savings Plan recommendation |
| get_savings_plans_coverage | Retrieves the Savings Plans covered for your account |
| get_savings_plans_purchase_recommendation | Retrieves the Savings Plans recommendations for your account |
| get_savings_plans_utilization | Retrieves the Savings Plans utilization for your account across date ranges with daily or monthly granularity |
| get_savings_plans_utilization_details | Retrieves attribute data along with aggregate utilization and savings data for a given time period |
| get_tags | Queries for available tag keys and tag values for a specified period |
| get_usage_forecast | Retrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage |
| list_commitment_purchase_analyses | Lists the commitment purchase analyses for your account |
| list_cost_allocation_tag_backfill_history | Retrieves a list of your historical cost allocation tag backfill requests |
| list_cost_allocation_tags | Get a list of cost allocation tags |
| list_cost_category_definitions | Returns the name, Amazon Resource Name (ARN), NumberOfRules and effective dates of all Cost Categories defined in the account |
| list_savings_plans_purchase_recommendation_generation | Retrieves a list of your historical recommendation generations within the past 30 days |
| list_tags_for_resource | Returns a list of resource tags associated with the resource specified by the Amazon Resource Name (ARN) |
| provide_anomaly_feedback | Modifies the feedback property of a given cost anomaly |
| start_commitment_purchase_analysis | Specifies the parameters of a planned commitment purchase and starts the generation of the analysis |
| start_cost_allocation_tag_backfill | Request a cost allocation tag backfill |
| start_savings_plans_purchase_recommendation_generation | Requests a Savings Plans recommendation generation |
| tag_resource | An API operation for adding one or more tags (key-value pairs) to a resource |
| untag_resource | Removes one or more tags from a resource |
| update_anomaly_monitor | Updates an existing cost anomaly monitor |
| update_anomaly_subscription | Updates an existing cost anomaly subscription |
| update_cost_allocation_tags_status | Updates status for cost allocation tags in bulk, with maximum batch size of 20 |
| update_cost_category_definition | Updates an existing Cost Category |
## Not run: svc <- costexplorer() svc$create_anomaly_monitor( Foo = 123 ) ## End(Not run)
Useful links