Struct aws_sdk_billingconductor::Client

pub struct Client { /* private fields */ }

Client for AWSBillingConductor

Client for invoking operations on AWSBillingConductor. Each operation on AWSBillingConductor is a method on this this struct. .send() MUST be invoked on the generated operations to dispatch the request to the service.

Constructing a Client

A Config is required to construct a client. For most use cases, the aws-config crate should be used to automatically resolve this config using aws_config::load_from_env(), since this will resolve an SdkConfig which can be shared across multiple different AWS SDK clients. This config resolution process can be customized by calling aws_config::from_env() instead, which returns a ConfigLoader that uses the builder pattern to customize the default config.

In the simplest case, creating a client looks as follows:

let config = aws_config::load_from_env().await;
let client = aws_sdk_billingconductor::Client::new(&config);

Occasionally, SDKs may have additional service-specific that can be set on the Config that is absent from SdkConfig, or slightly different settings for a specific client may be desired. The Config struct implements From<&SdkConfig>, so setting these specific settings can be done as follows:

let sdk_config = ::aws_config::load_from_env().await;
let config = aws_sdk_billingconductor::config::Builder::from(&sdk_config)
    .some_service_specific_setting("value")
    .build();

See the aws-config docs and Config for more information on customizing configuration.

Note: Client construction is expensive due to connection thread pool initialization, and should be done once at application start-up.

Using the Client

A client has a function for every operation that can be performed by the service. For example, the ListAccountAssociations operation has a Client::list_account_associations, function which returns a builder for that operation. The fluent builder ultimately has a send() function that returns an async future that returns a result, as illustrated below:

let result = client.list_account_associations()
    .billing_period("example")
    .send()
    .await;

The underlying HTTP requests that get made by this can be modified with the customize_operation function on the fluent builder. See the customize module for more information.

Implementations

impl Client

pub fn associate_accounts(&self) -> AssociateAccountsFluentBuilder

Constructs a fluent builder for the AssociateAccounts operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the billing group that associates the array of account IDs.

    
    
  • account_ids(impl Into<String>) / set_account_ids(Option<Vec::<String>>):
    required: true
    

    The associating array of account IDs.

    
    
• On success, responds with AssociateAccountsOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the billing group that associates the array of account IDs.

• On failure, responds with SdkError<AssociateAccountsError>

impl Client

pub fn associate_pricing_rules(&self) -> AssociatePricingRulesFluentBuilder

Constructs a fluent builder for the AssociatePricingRules operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The PricingPlanArn that the PricingRuleArns are associated with.

    
    
  • pricing_rule_arns(impl Into<String>) / set_pricing_rule_arns(Option<Vec::<String>>):
    required: true
    

    The PricingRuleArns that are associated with the Pricing Plan.

    
    
• On success, responds with AssociatePricingRulesOutput with field(s):
  • arn(Option<String>):

    The PricingPlanArn that the PricingRuleArns are associated with.

• On failure, responds with SdkError<AssociatePricingRulesError>

impl Client

pub fn batch_associate_resources_to_custom_line_item( &self ) -> BatchAssociateResourcesToCustomLineItemFluentBuilder

Constructs a fluent builder for the BatchAssociateResourcesToCustomLineItem operation.

• The fluent builder is configurable:
  • target_arn(impl Into<String>) / set_target_arn(Option<String>):
    required: true
    

    A percentage custom line item ARN to associate the resources to.

    
    
  • resource_arns(impl Into<String>) / set_resource_arns(Option<Vec::<String>>):
    required: true
    

    A list containing the ARNs of the resources to be associated.

    
    
  • billing_period_range(CustomLineItemBillingPeriodRange) / set_billing_period_range(Option<CustomLineItemBillingPeriodRange>):
    required: false
    

    The billing period range in which the custom line item request will be applied.

    
    
• On success, responds with BatchAssociateResourcesToCustomLineItemOutput with field(s):
  • successfully_associated_resources(Option<Vec::<AssociateResourceResponseElement>>):

    A list of AssociateResourceResponseElement for each resource that’s been associated to a percentage custom line item successfully.

  • failed_associated_resources(Option<Vec::<AssociateResourceResponseElement>>):

    A list of AssociateResourceResponseElement for each resource that failed association to a percentage custom line item.

• On failure, responds with SdkError<BatchAssociateResourcesToCustomLineItemError>

impl Client

pub fn batch_disassociate_resources_from_custom_line_item( &self ) -> BatchDisassociateResourcesFromCustomLineItemFluentBuilder

Constructs a fluent builder for the BatchDisassociateResourcesFromCustomLineItem operation.

• The fluent builder is configurable:
  • target_arn(impl Into<String>) / set_target_arn(Option<String>):
    required: true
    

    A percentage custom line item ARN to disassociate the resources from.

    
    
  • resource_arns(impl Into<String>) / set_resource_arns(Option<Vec::<String>>):
    required: true
    

    A list containing the ARNs of resources to be disassociated.

    
    
  • billing_period_range(CustomLineItemBillingPeriodRange) / set_billing_period_range(Option<CustomLineItemBillingPeriodRange>):
    required: false
    

    The billing period range in which the custom line item request will be applied.

    
    
• On success, responds with BatchDisassociateResourcesFromCustomLineItemOutput with field(s):
  • successfully_disassociated_resources(Option<Vec::<DisassociateResourceResponseElement>>):

    A list of DisassociateResourceResponseElement for each resource that’s been disassociated from a percentage custom line item successfully.

  • failed_disassociated_resources(Option<Vec::<DisassociateResourceResponseElement>>):

    A list of DisassociateResourceResponseElement for each resource that failed disassociation from a percentage custom line item.

• On failure, responds with SdkError<BatchDisassociateResourcesFromCustomLineItemError>

impl Client

pub fn create_billing_group(&self) -> CreateBillingGroupFluentBuilder

Constructs a fluent builder for the CreateBillingGroup operation.

• The fluent builder is configurable:
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    The token that is needed to support idempotency. Idempotency isn’t currently supported, but will be implemented in a future update.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The billing group name. The names must be unique.

    
    
  • account_grouping(AccountGrouping) / set_account_grouping(Option<AccountGrouping>):
    required: true
    

    The set of accounts that will be under the billing group. The set of accounts resemble the linked accounts in a consolidated billing family.

    
    
  • computation_preference(ComputationPreference) / set_computation_preference(Option<ComputationPreference>):
    required: true
    

    The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.

    
    
  • primary_account_id(impl Into<String>) / set_primary_account_id(Option<String>):
    required: false
    

    The account ID that serves as the main account in a billing group.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The description of the billing group.

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    A map that contains tag keys and tag values that are attached to a billing group. This feature isn’t available during the beta.

    
    
• On success, responds with CreateBillingGroupOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the created billing group.

• On failure, responds with SdkError<CreateBillingGroupError>

impl Client

pub fn create_custom_line_item(&self) -> CreateCustomLineItemFluentBuilder

Constructs a fluent builder for the CreateCustomLineItem operation.

• The fluent builder is configurable:
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    The token that is needed to support idempotency. Idempotency isn’t currently supported, but will be implemented in a future update.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The name of the custom line item.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: true
    

    The description of the custom line item. This is shown on the Bills page in association with the charge value.

    
    
  • billing_group_arn(impl Into<String>) / set_billing_group_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) that references the billing group where the custom line item applies to.

    
    
  • billing_period_range(CustomLineItemBillingPeriodRange) / set_billing_period_range(Option<CustomLineItemBillingPeriodRange>):
    required: false
    

    A time range for which the custom line item is effective.

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    A map that contains tag keys and tag values that are attached to a custom line item.

    
    
  • charge_details(CustomLineItemChargeDetails) / set_charge_details(Option<CustomLineItemChargeDetails>):
    required: true
    

    A CustomLineItemChargeDetails that describes the charge details for a custom line item.

    
    
• On success, responds with CreateCustomLineItemOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the created custom line item.

• On failure, responds with SdkError<CreateCustomLineItemError>

impl Client

pub fn create_pricing_plan(&self) -> CreatePricingPlanFluentBuilder

Constructs a fluent builder for the CreatePricingPlan operation.

• The fluent builder is configurable:
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    The token that is needed to support idempotency. Idempotency isn’t currently supported, but will be implemented in a future update.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The name of the pricing plan. The names must be unique to each pricing plan.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The description of the pricing plan.

    
    
  • pricing_rule_arns(impl Into<String>) / set_pricing_rule_arns(Option<Vec::<String>>):
    required: false
    

    A list of Amazon Resource Names (ARNs) that define the pricing plan parameters.

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    A map that contains tag keys and tag values that are attached to a pricing plan.

    
    
• On success, responds with CreatePricingPlanOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the created pricing plan.

• On failure, responds with SdkError<CreatePricingPlanError>

impl Client

pub fn create_pricing_rule(&self) -> CreatePricingRuleFluentBuilder

Constructs a fluent builder for the CreatePricingRule operation.

• The fluent builder is configurable:
  • client_token(impl Into<String>) / set_client_token(Option<String>):
    required: false
    

    The token that’s needed to support idempotency. Idempotency isn’t currently supported, but will be implemented in a future update.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: true
    

    The pricing rule name. The names must be unique to each pricing rule.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The pricing rule description.

    
    
  • scope(PricingRuleScope) / set_scope(Option<PricingRuleScope>):
    required: true
    

    The scope of pricing rule that indicates if it’s globally applicable, or it’s service-specific.

    
    
  • r#type(PricingRuleType) / set_type(Option<PricingRuleType>):
    required: true
    

    The type of pricing rule.

    
    
  • modifier_percentage(f64) / set_modifier_percentage(Option<f64>):
    required: false
    

    A percentage modifier that’s applied on the public pricing rates.

    
    
  • service(impl Into<String>) / set_service(Option<String>):
    required: false
    

    If the Scope attribute is set to SERVICE or SKU, the attribute indicates which service the PricingRule is applicable for.

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: false
    

    A map that contains tag keys and tag values that are attached to a pricing rule.

    
    
  • billing_entity(impl Into<String>) / set_billing_entity(Option<String>):
    required: false
    

    The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.

    
    
  • tiering(CreateTieringInput) / set_tiering(Option<CreateTieringInput>):
    required: false
    

    The set of tiering configurations for the pricing rule.

    
    
  • usage_type(impl Into<String>) / set_usage_type(Option<String>):
    required: false
    

    Usage type is the unit that each service uses to measure the usage of a specific type of resource.

    If the Scope attribute is set to SKU, this attribute indicates which usage type the PricingRule is modifying. For example, USW2-BoxUsage:m2.2xlarge describes an M2 High Memory Double Extra Large instance in the US West (Oregon) Region.

    
    
  • operation(impl Into<String>) / set_operation(Option<String>):
    required: false
    

    Operation is the specific Amazon Web Services action covered by this line item. This describes the specific usage of the line item.

    If the Scope attribute is set to SKU, this attribute indicates which operation the PricingRule is modifying. For example, a value of RunInstances:0202 indicates the operation of running an Amazon EC2 instance.

    
    
• On success, responds with CreatePricingRuleOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the created pricing rule.

• On failure, responds with SdkError<CreatePricingRuleError>

impl Client

pub fn delete_billing_group(&self) -> DeleteBillingGroupFluentBuilder

Constructs a fluent builder for the DeleteBillingGroup operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the billing group that you’re deleting.

    
    
• On success, responds with DeleteBillingGroupOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the deleted billing group.

• On failure, responds with SdkError<DeleteBillingGroupError>

impl Client

pub fn delete_custom_line_item(&self) -> DeleteCustomLineItemFluentBuilder

Constructs a fluent builder for the DeleteCustomLineItem operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The ARN of the custom line item to be deleted.

    
    
  • billing_period_range(CustomLineItemBillingPeriodRange) / set_billing_period_range(Option<CustomLineItemBillingPeriodRange>):
    required: false
    

    The billing period range in which the custom line item request will be applied.

    
    
• On success, responds with DeleteCustomLineItemOutput with field(s):
  • arn(Option<String>):

    Then ARN of the deleted custom line item.

• On failure, responds with SdkError<DeleteCustomLineItemError>

impl Client

pub fn delete_pricing_plan(&self) -> DeletePricingPlanFluentBuilder

Constructs a fluent builder for the DeletePricingPlan operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the pricing plan that you’re deleting.

    
    
• On success, responds with DeletePricingPlanOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the deleted pricing plan.

• On failure, responds with SdkError<DeletePricingPlanError>

impl Client

pub fn delete_pricing_rule(&self) -> DeletePricingRuleFluentBuilder

Constructs a fluent builder for the DeletePricingRule operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the pricing rule that you are deleting.

    
    
• On success, responds with DeletePricingRuleOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the deleted pricing rule.

• On failure, responds with SdkError<DeletePricingRuleError>

impl Client

pub fn disassociate_accounts(&self) -> DisassociateAccountsFluentBuilder

Constructs a fluent builder for the DisassociateAccounts operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the billing group that the array of account IDs will disassociate from.

    
    
  • account_ids(impl Into<String>) / set_account_ids(Option<Vec::<String>>):
    required: true
    

    The array of account IDs to disassociate.

    
    
• On success, responds with DisassociateAccountsOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the billing group that the array of account IDs is disassociated from.

• On failure, responds with SdkError<DisassociateAccountsError>

impl Client

pub fn disassociate_pricing_rules( &self ) -> DisassociatePricingRulesFluentBuilder

Constructs a fluent builder for the DisassociatePricingRules operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The pricing plan Amazon Resource Name (ARN) to disassociate pricing rules from.

    
    
  • pricing_rule_arns(impl Into<String>) / set_pricing_rule_arns(Option<Vec::<String>>):
    required: true
    

    A list containing the Amazon Resource Name (ARN) of the pricing rules that will be disassociated.

    
    
• On success, responds with DisassociatePricingRulesOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the pricing plan that the pricing rules successfully disassociated from.

• On failure, responds with SdkError<DisassociatePricingRulesError>

impl Client

pub fn list_account_associations(&self) -> ListAccountAssociationsFluentBuilder

Constructs a fluent builder for the ListAccountAssociations operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period to get account associations.

    
    
  • filters(ListAccountAssociationsFilter) / set_filters(Option<ListAccountAssociationsFilter>):
    required: false
    

    The filter on the account ID of the linked account, or any of the following:

    MONITORED: linked accounts that are associated to billing groups.

    UNMONITORED: linked accounts that aren’t associated to billing groups.

    Billing Group Arn: linked accounts that are associated to the provided billing group Arn.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent calls to retrieve accounts.

    
    
• On success, responds with ListAccountAssociationsOutput with field(s):
  • linked_accounts(Option<Vec::<AccountAssociationsListElement>>):

    The list of linked accounts in the payer account.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get accounts.

• On failure, responds with SdkError<ListAccountAssociationsError>

impl Client

pub fn list_billing_group_cost_reports( &self ) -> ListBillingGroupCostReportsFluentBuilder

Constructs a fluent builder for the ListBillingGroupCostReports operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period for your report.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of reports to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent calls to get reports.

    
    
  • filters(ListBillingGroupCostReportsFilter) / set_filters(Option<ListBillingGroupCostReportsFilter>):
    required: false
    

    A ListBillingGroupCostReportsFilter to specify billing groups to retrieve reports from.

    
    
• On success, responds with ListBillingGroupCostReportsOutput with field(s):
  • billing_group_cost_reports(Option<Vec::<BillingGroupCostReportElement>>):

    A list of BillingGroupCostReportElement retrieved.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get reports.

• On failure, responds with SdkError<ListBillingGroupCostReportsError>

impl Client

pub fn list_billing_groups(&self) -> ListBillingGroupsFluentBuilder

Constructs a fluent builder for the ListBillingGroups operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period to get billing groups.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of billing groups to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent calls to get billing groups.

    
    
  • filters(ListBillingGroupsFilter) / set_filters(Option<ListBillingGroupsFilter>):
    required: false
    

    A ListBillingGroupsFilter that specifies the billing group and pricing plan to retrieve billing group information.

    
    
• On success, responds with ListBillingGroupsOutput with field(s):
  • billing_groups(Option<Vec::<BillingGroupListElement>>):

    A list of BillingGroupListElement retrieved.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get billing groups.

• On failure, responds with SdkError<ListBillingGroupsError>

impl Client

pub fn list_custom_line_item_versions( &self ) -> ListCustomLineItemVersionsFluentBuilder

Constructs a fluent builder for the ListCustomLineItemVersions operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) for the custom line item.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of custom line item versions to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent calls to retrieve custom line item versions.

    
    
  • filters(ListCustomLineItemVersionsFilter) / set_filters(Option<ListCustomLineItemVersionsFilter>):
    required: false
    

    A ListCustomLineItemVersionsFilter that specifies the billing period range in which the custom line item versions are applied.

    
    
• On success, responds with ListCustomLineItemVersionsOutput with field(s):
  • custom_line_item_versions(Option<Vec::<CustomLineItemVersionListElement>>):

    A list of CustomLineItemVersionListElements that are received.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to retrieve custom line item versions.

• On failure, responds with SdkError<ListCustomLineItemVersionsError>

impl Client

pub fn list_custom_line_items(&self) -> ListCustomLineItemsFluentBuilder

Constructs a fluent builder for the ListCustomLineItems operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period to get custom line items (FFLIs).

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of billing groups to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent calls to get custom line items (FFLIs).

    
    
  • filters(ListCustomLineItemsFilter) / set_filters(Option<ListCustomLineItemsFilter>):
    required: false
    

    A ListCustomLineItemsFilter that specifies the custom line item names and/or billing group Amazon Resource Names (ARNs) to retrieve FFLI information.

    
    
• On success, responds with ListCustomLineItemsOutput with field(s):
  • custom_line_items(Option<Vec::<CustomLineItemListElement>>):

    A list of FreeFormLineItemListElements received.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get custom line items (FFLIs).

• On failure, responds with SdkError<ListCustomLineItemsError>

impl Client

pub fn list_pricing_plans(&self) -> ListPricingPlansFluentBuilder

Constructs a fluent builder for the ListPricingPlans operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period to get pricing plan.

    
    
  • filters(ListPricingPlansFilter) / set_filters(Option<ListPricingPlansFilter>):
    required: false
    

    A ListPricingPlansFilter that specifies the Amazon Resource Name (ARNs) of pricing plans to retrieve pricing plans information.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of pricing plans to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent call to get pricing plans.

    
    
• On success, responds with ListPricingPlansOutput with field(s):
  • billing_period(Option<String>):

    The billing period for which the described pricing plans are applicable.

  • pricing_plans(Option<Vec::<PricingPlanListElement>>):

    A list of PricingPlanListElement retrieved.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get pricing plans.

• On failure, responds with SdkError<ListPricingPlansError>

impl Client

pub fn list_pricing_plans_associated_with_pricing_rule( &self ) -> ListPricingPlansAssociatedWithPricingRuleFluentBuilder

Constructs a fluent builder for the ListPricingPlansAssociatedWithPricingRule operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The pricing plan billing period for which associations will be listed.

    
    
  • pricing_rule_arn(impl Into<String>) / set_pricing_rule_arn(Option<String>):
    required: true
    

    The pricing rule Amazon Resource Name (ARN) for which associations will be listed.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The optional maximum number of pricing rule associations to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The optional pagination token returned by a previous call.

    
    
• On success, responds with ListPricingPlansAssociatedWithPricingRuleOutput with field(s):
  • billing_period(Option<String>):

    The pricing plan billing period for which associations will be listed.

  • pricing_rule_arn(Option<String>):

    The pricing rule Amazon Resource Name (ARN) for which associations will be listed.

  • pricing_plan_arns(Option<Vec::<String>>):

    The list containing pricing plans that are associated with the requested pricing rule.

  • next_token(Option<String>):

    The pagination token to be used on subsequent calls.

• On failure, responds with SdkError<ListPricingPlansAssociatedWithPricingRuleError>

impl Client

pub fn list_pricing_rules(&self) -> ListPricingRulesFluentBuilder

Constructs a fluent builder for the ListPricingRules operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The preferred billing period to get the pricing plan.

    
    
  • filters(ListPricingRulesFilter) / set_filters(Option<ListPricingRulesFilter>):
    required: false
    

    A DescribePricingRuleFilter that specifies the Amazon Resource Name (ARNs) of pricing rules to retrieve pricing rules information.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The maximum number of pricing rules to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The pagination token that’s used on subsequent call to get pricing rules.

    
    
• On success, responds with ListPricingRulesOutput with field(s):
  • billing_period(Option<String>):

    The billing period for which the described pricing rules are applicable.

  • pricing_rules(Option<Vec::<PricingRuleListElement>>):

    A list containing the described pricing rules.

  • next_token(Option<String>):

    The pagination token that’s used on subsequent calls to get pricing rules.

• On failure, responds with SdkError<ListPricingRulesError>

impl Client

pub fn list_pricing_rules_associated_to_pricing_plan( &self ) -> ListPricingRulesAssociatedToPricingPlanFluentBuilder

Constructs a fluent builder for the ListPricingRulesAssociatedToPricingPlan operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The billing period for which the pricing rule associations are to be listed.

    
    
  • pricing_plan_arn(impl Into<String>) / set_pricing_plan_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the pricing plan for which associations are to be listed.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    The optional maximum number of pricing rule associations to retrieve.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    The optional pagination token returned by a previous call.

    
    
• On success, responds with ListPricingRulesAssociatedToPricingPlanOutput with field(s):
  • billing_period(Option<String>):

    The billing period for which the pricing rule associations are listed.

  • pricing_plan_arn(Option<String>):

    The Amazon Resource Name (ARN) of the pricing plan for which associations are listed.

  • pricing_rule_arns(Option<Vec::<String>>):

    A list containing pricing rules that are associated with the requested pricing plan.

  • next_token(Option<String>):

    The pagination token to be used on subsequent calls.

• On failure, responds with SdkError<ListPricingRulesAssociatedToPricingPlanError>

impl Client

pub fn list_resources_associated_to_custom_line_item( &self ) -> ListResourcesAssociatedToCustomLineItemFluentBuilder

Constructs a fluent builder for the ListResourcesAssociatedToCustomLineItem operation. This operation supports pagination; See into_paginator().

• The fluent builder is configurable:
  • billing_period(impl Into<String>) / set_billing_period(Option<String>):
    required: false
    

    The billing period for which the resource associations will be listed.

    
    
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The ARN of the custom line item for which the resource associations will be listed.

    
    
  • max_results(i32) / set_max_results(Option<i32>):
    required: false
    

    (Optional) The maximum number of resource associations to be retrieved.

    
    
  • next_token(impl Into<String>) / set_next_token(Option<String>):
    required: false
    

    (Optional) The pagination token that’s returned by a previous request.

    
    
  • filters(ListResourcesAssociatedToCustomLineItemFilter) / set_filters(Option<ListResourcesAssociatedToCustomLineItemFilter>):
    required: false
    

    (Optional) A ListResourcesAssociatedToCustomLineItemFilter that can specify the types of resources that should be retrieved.

    
    
• On success, responds with ListResourcesAssociatedToCustomLineItemOutput with field(s):
  • arn(Option<String>):

    The custom line item ARN for which the resource associations are listed.

  • associated_resources(Option<Vec::<ListResourcesAssociatedToCustomLineItemResponseElement>>):

    A list of ListResourcesAssociatedToCustomLineItemResponseElement for each resource association retrieved.

  • next_token(Option<String>):

    The pagination token to be used in subsequent requests to retrieve additional results.

• On failure, responds with SdkError<ListResourcesAssociatedToCustomLineItemError>

impl Client

pub fn list_tags_for_resource(&self) -> ListTagsForResourceFluentBuilder

Constructs a fluent builder for the ListTagsForResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) that identifies the resource to list the tags.

    
    
• On success, responds with ListTagsForResourceOutput with field(s):
  • tags(Option<HashMap::<String, String>>):

    The tags for the resource.

• On failure, responds with SdkError<ListTagsForResourceError>

impl Client

pub fn tag_resource(&self) -> TagResourceFluentBuilder

Constructs a fluent builder for the TagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the resource to which to add tags.

    
    
  • tags(impl Into<String>, impl Into<String>) / set_tags(Option<HashMap::<String, String>>):
    required: true
    

    The tags to add to the resource as a list of key-value pairs.

    
    
• On success, responds with TagResourceOutput
• On failure, responds with SdkError<TagResourceError>

impl Client

pub fn untag_resource(&self) -> UntagResourceFluentBuilder

Constructs a fluent builder for the UntagResource operation.

• The fluent builder is configurable:
  • resource_arn(impl Into<String>) / set_resource_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the resource to which to delete tags.

    
    
  • tag_keys(impl Into<String>) / set_tag_keys(Option<Vec::<String>>):
    required: true
    

    The tags to delete from the resource as a list of key-value pairs.

    
    
• On success, responds with UntagResourceOutput
• On failure, responds with SdkError<UntagResourceError>

impl Client

pub fn update_billing_group(&self) -> UpdateBillingGroupFluentBuilder

Constructs a fluent builder for the UpdateBillingGroup operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the billing group being updated.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The name of the billing group. The names must be unique to each billing group.

    
    
  • status(BillingGroupStatus) / set_status(Option<BillingGroupStatus>):
    required: false
    

    The status of the billing group. Only one of the valid values can be used.

    
    
  • computation_preference(ComputationPreference) / set_computation_preference(Option<ComputationPreference>):
    required: false
    

    The preferences and settings that will be used to compute the Amazon Web Services charges for a billing group.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    A description of the billing group.

    
    
  • account_grouping(UpdateBillingGroupAccountGrouping) / set_account_grouping(Option<UpdateBillingGroupAccountGrouping>):
    required: false
    

    Specifies if the billing group has automatic account association (AutoAssociate) enabled.

    
    
• On success, responds with UpdateBillingGroupOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the billing group that was updated.

  • name(Option<String>):

    The name of the billing group. The names must be unique to each billing group.

  • description(Option<String>):

    A description of the billing group.

  • primary_account_id(Option<String>):

    The account ID that serves as the main account in a billing group.

  • pricing_plan_arn(Option<String>):

    The Amazon Resource Name (ARN) of the pricing plan to compute Amazon Web Services charges for the billing group.

  • size(i64):

    The number of accounts in the particular billing group.

  • last_modified_time(i64):

    The most recent time when the billing group was modified.

  • status(Option<BillingGroupStatus>):

    The status of the billing group. Only one of the valid values can be used.

  • status_reason(Option<String>):

    The reason why the billing group is in its current status.

  • account_grouping(Option<UpdateBillingGroupAccountGrouping>):

    Specifies if the billing group has automatic account association (AutoAssociate) enabled.

• On failure, responds with SdkError<UpdateBillingGroupError>

impl Client

pub fn update_custom_line_item(&self) -> UpdateCustomLineItemFluentBuilder

Constructs a fluent builder for the UpdateCustomLineItem operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The ARN of the custom line item to be updated.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The new name for the custom line item.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The new line item description of the custom line item.

    
    
  • charge_details(UpdateCustomLineItemChargeDetails) / set_charge_details(Option<UpdateCustomLineItemChargeDetails>):
    required: false
    

    A ListCustomLineItemChargeDetails containing the new charge details for the custom line item.

    
    
  • billing_period_range(CustomLineItemBillingPeriodRange) / set_billing_period_range(Option<CustomLineItemBillingPeriodRange>):
    required: false
    

    The billing period range in which the custom line item request will be applied.

    
    
• On success, responds with UpdateCustomLineItemOutput with field(s):
  • arn(Option<String>):

    The ARN of the successfully updated custom line item.

  • billing_group_arn(Option<String>):

    The ARN of the billing group that the custom line item is applied to.

  • name(Option<String>):

    The name of the successfully updated custom line item.

  • description(Option<String>):

    The description of the successfully updated custom line item.

  • charge_details(Option<ListCustomLineItemChargeDetails>):

    A ListCustomLineItemChargeDetails containing the charge details of the successfully updated custom line item.

  • last_modified_time(i64):

    The most recent time when the custom line item was modified.

  • association_size(i64):

    The number of resources that are associated to the custom line item.

• On failure, responds with SdkError<UpdateCustomLineItemError>

impl Client

pub fn update_pricing_plan(&self) -> UpdatePricingPlanFluentBuilder

Constructs a fluent builder for the UpdatePricingPlan operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the pricing plan that you’re updating.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The name of the pricing plan. The name must be unique to each pricing plan.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The description of the pricing plan.

    
    
• On success, responds with UpdatePricingPlanOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the updated pricing plan.

  • name(Option<String>):

    The name of the pricing plan. The name must be unique to each pricing plan.

  • description(Option<String>):

    The new description for the pricing rule.

  • size(i64):

    The pricing rules count that’s currently associated with this pricing plan list.

  • last_modified_time(i64):

    The most recent time when the pricing plan was modified.

• On failure, responds with SdkError<UpdatePricingPlanError>

impl Client

pub fn update_pricing_rule(&self) -> UpdatePricingRuleFluentBuilder

Constructs a fluent builder for the UpdatePricingRule operation.

• The fluent builder is configurable:
  • arn(impl Into<String>) / set_arn(Option<String>):
    required: true
    

    The Amazon Resource Name (ARN) of the pricing rule to update.

    
    
  • name(impl Into<String>) / set_name(Option<String>):
    required: false
    

    The new name of the pricing rule. The name must be unique to each pricing rule.

    
    
  • description(impl Into<String>) / set_description(Option<String>):
    required: false
    

    The new description for the pricing rule.

    
    
  • r#type(PricingRuleType) / set_type(Option<PricingRuleType>):
    required: false
    

    The new pricing rule type.

    
    
  • modifier_percentage(f64) / set_modifier_percentage(Option<f64>):
    required: false
    

    The new modifier to show pricing plan rates as a percentage.

    
    
  • tiering(UpdateTieringInput) / set_tiering(Option<UpdateTieringInput>):
    required: false
    

    The set of tiering configurations for the pricing rule.

    
    
• On success, responds with UpdatePricingRuleOutput with field(s):
  • arn(Option<String>):

    The Amazon Resource Name (ARN) of the successfully updated pricing rule.

  • name(Option<String>):

    The new name of the pricing rule. The name must be unique to each pricing rule.

  • description(Option<String>):

    The new description for the pricing rule.

  • scope(Option<PricingRuleScope>):

    The scope of pricing rule that indicates if it’s globally applicable, or it’s service-specific.

  • r#type(Option<PricingRuleType>):

    The new pricing rule type.

  • modifier_percentage(Option<f64>):

    The new modifier to show pricing plan rates as a percentage.

  • service(Option<String>):

    If the Scope attribute is set to SERVICE, the attribute indicates which service the PricingRule is applicable for.

  • associated_pricing_plan_count(i64):

    The pricing plans count that this pricing rule is associated with.

  • last_modified_time(i64):

    The most recent time the pricing rule was modified.

  • billing_entity(Option<String>):

    The seller of services provided by Amazon Web Services, their affiliates, or third-party providers selling services via Amazon Web Services Marketplace.

  • tiering(Option<UpdateTieringInput>):

    The set of tiering configurations for the pricing rule.

  • usage_type(Option<String>):

    Usage type is the unit that each service uses to measure the usage of a specific type of resource.

    If the Scope attribute is set to SKU, this attribute indicates which usage type the PricingRule is modifying. For example, USW2-BoxUsage:m2.2xlarge describes an M2 High Memory Double Extra Large instance in the US West (Oregon) Region.

  • operation(Option<String>):

    Operation refers to the specific Amazon Web Services covered by this line item. This describes the specific usage of the line item.

    If the Scope attribute is set to SKU, this attribute indicates which operation the PricingRule is modifying. For example, a value of RunInstances:0202 indicates the operation of running an Amazon EC2 instance.

• On failure, responds with SdkError<UpdatePricingRuleError>

impl Client

pub fn from_conf(conf: Config) -> Self

Creates a new client from the service Config.

Panics

This method will panic in the following cases:

• Retries or timeouts are enabled without a sleep_impl configured.
• Identity caching is enabled without a sleep_impl and time_source configured.
• No behavior_version is provided.

The panic message for each of these will have instructions on how to resolve them.

pub fn config(&self) -> &Config

Returns the client’s configuration.

impl Client

pub fn new(sdk_config: &SdkConfig) -> Self

Creates a new client from an SDK Config.

Panics

• This method will panic if the sdk_config is missing an async sleep implementation. If you experience this panic, set the sleep_impl on the Config passed into this function to fix it.
• This method will panic if the sdk_config is missing an HTTP connector. If you experience this panic, set the http_connector on the Config passed into this function to fix it.
• This method will panic if no BehaviorVersion is provided. If you experience this panic, set behavior_version on the Config or enable the behavior-version-latest Cargo feature.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Client

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.