Request Syntax Request Parameters Response Syntax Response Elements Errors See Also

ListBillingViews

Lists the billing views available for a given time period.

Every AWS account has a unique PRIMARY billing view that represents the billing data available by default. Accounts that use AWS Billing Conductor also have BILLING_GROUP billing views representing pro forma costs associated with each created billing group.

Request Syntax


{
   "activeTimeRange": { 
      "activeAfterInclusive": number,
      "activeBeforeInclusive": number
   },
   "maxResults": number,
   "nextToken": "string"
}

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

activeTimeRange

The time range for the billing views listed. PRIMARY billing view is always listed. BILLING_GROUP billing views are listed for time ranges when the associated billing group resource in AWS Billing Conductor is active. The time range must be within one calendar month.

Type: ActiveTimeRange object

Required: Yes

maxResults

The maximum number of billing views to retrieve. Default is 100.

Type: Integer

Valid Range: Minimum value of 1. Maximum value of 100.

Required: No

nextToken

The pagination token that is used on subsequent calls to list billing views.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2047.

Required: No

Response Syntax


{
   "billingViews": [ 
      { 
         "arn": "string",
         "billingViewType": "string",
         "name": "string",
         "ownerAccountId": "string"
      }
   ],
   "nextToken": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

billingViews

A list of BillingViewListElement retrieved.

Type: Array of BillingViewListElement objects

nextToken

The pagination token to use on subsequent calls to list billing views.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2047.

Errors

For information about the errors that are common to all actions, see Common Errors.

AccessDeniedException

You don't have sufficient access to perform this action.

HTTP Status Code: 400

InternalServerException

The request processing failed because of an unknown error, exception, or failure.

HTTP Status Code: 500

ThrottlingException

The request was denied due to request throttling.

HTTP Status Code: 400

ValidationException

The input fails to satisfy the constraints specified by an AWS service.

HTTP Status Code: 400