Route53Domains / Client / view_billing

view_billing#

Route53Domains.Client.view_billing(**kwargs)#

Returns all the domain-related billing records for the current Amazon Web Services account for a specified period

See also: AWS API Documentation

Request Syntax

response = client.view_billing(
    Start=datetime(2015, 1, 1),
    End=datetime(2015, 1, 1),
    Marker='string',
    MaxItems=123
)
Parameters:

  • Start (datetime) – The beginning date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

  • End (datetime) – The end date and time for the time period for which you want a list of billing records. Specify the date and time in Unix time format and Coordinated Universal time (UTC).

  • Marker (string) –

    For an initial request for a list of billing records, omit this element. If the number of billing records that are associated with the current Amazon Web Services account during the specified period is greater than the value that you specified for MaxItems, you can use Marker to return additional billing records. Get the value of NextPageMarker from the previous response, and submit another request that includes the value of NextPageMarker in the Marker element.

    Constraints: The marker must match the value of NextPageMarker that was returned in the previous response.

  • MaxItems (integer) –

    The number of billing records to be returned.

    Default: 20

Return type:

dict

Returns:

Response Syntax

{
    'NextPageMarker': 'string',
    'BillingRecords': [
        {
            'DomainName': 'string',
            'Operation': 'REGISTER_DOMAIN'|'DELETE_DOMAIN'|'TRANSFER_IN_DOMAIN'|'UPDATE_DOMAIN_CONTACT'|'UPDATE_NAMESERVER'|'CHANGE_PRIVACY_PROTECTION'|'DOMAIN_LOCK'|'ENABLE_AUTORENEW'|'DISABLE_AUTORENEW'|'ADD_DNSSEC'|'REMOVE_DNSSEC'|'EXPIRE_DOMAIN'|'TRANSFER_OUT_DOMAIN'|'CHANGE_DOMAIN_OWNER'|'RENEW_DOMAIN'|'PUSH_DOMAIN'|'INTERNAL_TRANSFER_OUT_DOMAIN'|'INTERNAL_TRANSFER_IN_DOMAIN'|'RELEASE_TO_GANDI'|'TRANSFER_ON_RENEW'|'RESTORE_DOMAIN',
            'InvoiceId': 'string',
            'BillDate': datetime(2015, 1, 1),
            'Price': 123.0
        },
    ]
}

Response Structure

  • (dict) –

    The ViewBilling response includes the following elements.

    • NextPageMarker (string) –

      If there are more billing records than you specified for MaxItems in the request, submit another request and include the value of NextPageMarker in the value of Marker.

    • BillingRecords (list) –

      A summary of billing records.

      • (dict) –

        Information for one billing record.

        • DomainName (string) –

          The name of the domain that the billing record applies to. If the domain name contains characters other than a-z, 0-9, and - (hyphen), such as an internationalized domain name, then this value is in Punycode. For more information, see DNS Domain Name Format in the Amazon Route 53 Developer Guide.

        • Operation (string) –

          The operation that you were charged for.

        • InvoiceId (string) –

          The ID of the invoice that is associated with the billing record.

        • BillDate (datetime) –

          The date that the operation was billed, in Unix format.

        • Price (float) –

          The price that you were charged for the operation, in US dollars.

          Example value: 12.0

Exceptions