costexplorer: AWS Cost Explorer Service

In paws: Amazon Web Services Software Development Kit

AWS Cost Explorer Service

Description

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.com⁠

For information about the costs that are associated with the Cost Explorer API, see Amazon Web Services Cost Management Pricing.

Usage

costexplorer(
  config = list(),
  credentials = list(),
  endpoint = NULL,
  region = NULL
)

Arguments

config	Optional configuration of credentials, endpoint, and/or region. credentials: creds: access_key_id: AWS access key ID secret_access_key: AWS secret access key session_token: AWS temporary session token 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: access_key_id: AWS access key ID secret_access_key: AWS secret access key session_token: AWS temporary session token 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.

Value

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.

Service syntax

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

Operations

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

Examples

## Not run: 
svc <- costexplorer()
svc$create_anomaly_monitor(
  Foo = 123
)

## End(Not run)

paws documentation built on Sept. 17, 2024, 5:07 p.m.