Deprecated Admin API Calls

Below is the list of Admin-Level API calls in CloudCheckr that have been deprecated and replaced with a newer version. These calls continued to be accessible so that any current user functionality is not interrupted. However, CloudCheckr encourages the use of the most current API calls here: Admin API Reference guide.

ADD ACCOUNT

This API is deprecated and is maintained for historical reasons only. Please use add_accountv3 instead. The API method "add_account" is used to register an AWS account with CloudCheckr. IMPORTANT: This call can only be made using Admin-Level Access Keys. The preferred HTTP method for this call is POST. XML call:

https://api.cloudcheckr.com/api/account.xml/add_account?access_key=[access_key]&account_name=MyAccountName

JSON call:

https://api.cloudcheckr.com/api/account.json/add_account?access_key=[access_key]&account_name=MyAccountName

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - standard Access Key required for all API calls.
  • account_name (required) - the name of the AWS account to register with CloudCheckr.
  • aws_access_key (optional) - the access key of the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • aws_secret_key (optional) - the secret key of the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • aws_role_arn (optional) - the cross account role for the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • account_tag (optional) - the tag for the account to be used within a Multi-Account View.
  • user_name (optional) - the name of the user that will have access to this account. If no user is specified, the first Administrator of the account will be applied.
  • emails (optional) - the email address(es) that will populate the account's Email Settings, determining who receives the automated reports. If this parameter is not used, the email address used when registering the CloudCheckr account will be populated in this field.

NOTE: AWS secret keys typically contain special characters. In order to submit as a parameter on the URL, you must URL encode it. See http://www.w3schools.com/tags/ref_urlencode.asp for more details or to URL encode a AWS secret key.

OUTPUT

XML & JSON Example:

{"Code":200,"Message":"OK"}

ADD ACCOUNT v2

This API is deprecated and is maintained for historical reasons only. Please use add_accountv3 instead. The API method "add_accountv2" is used to register an AWS account with CloudCheckr. This method will return an ID for the newly created account that can be used for the parameter 'use_cc_account_id' when making calls to the Admin-Level API.

IMPORTANT: This call can only be made using Admin-Level Access Keys. The preferred HTTP method for this call is POST. XML call:

https://api.cloudcheckr.com/api/account.xml/add_accountv2?access_key=[access_key]&account_name=MyAccountName

JSON call:

https://api.cloudcheckr.com/api/account.json/add_accountv2?access_key=[access_key]&account_name=MyAccountName

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - standard Access Key required for all API calls.
  • account_name (required) - the name of the AWS account to register with CloudCheckr.
  • aws_access_key (optional) - the access key of the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • aws_secret_key (optional) - the secret key of the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • aws_role_arn (optional) - the cross account role for the IAM user whose credentials will be used to connect CloudCheckr to your AWS account.
  • account_tag (optional) - the tag for the account to be used within a Multi-Account View.
  • user_name (optional) - the name of the user that will have access to this account. If no user is specified, the first Administrator of the account will be applied.
  • emails (optional) - the email address(es) that will populate the account's Email Settings, determining who receives the automated reports. If this parameter is not used, the email address used when registering the CloudCheckr account will be populated in this field.

NOTE: AWS secret keys typically contain special characters. In order to submit as a parameter on the URL, you must URL encode it. See http://www.w3schools.com/tags/ref_urlencode.asp for more details or to URL encode a AWS secret key.

OUTPUT

XML Example:

<AddAccountResponseV2 xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance>
<cc_account_id>336</cc_account_id>
</AddAccountResponseV2>

JSON Example:

{"cc_account_id":340}

GET ACCOUNT LEVEL TAGS

This API is deprecated and is maintained for historical reasons only. Please use get_account_level_tags_v2 instead. The API method "get_account_level_tags", when called from a general account, retrieves all of the account-level tags created within that account. When called from a Multi-Account View, it returns a list of accounts associated with the Multi-Account View and a list of their account-level tags.

Using call against general accounts: The preferred HTTP method for this call is GET.

XML call:

https://api.cloudcheckr.com/api/account.xml/get_account_level_tags?access_key=[access_key]

JSON call:

https://api.cloudcheckr.com/api/account.json/get_account_level_tags?access_key=[access_key]

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - Admin-Level Access Key is required for this call.

OUTPUT

XML Example:

<AccountLevelTag
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Accounts>
<Account>
<Name>MY AWS ACCOUNT</Name>
<Tags>
<Tag>Account Tag 1</Tag>
<Tag>Account Tag 2</Tag>
</Tags>
</Account>
</Accounts>
</AccountLevelTag>

JSON Example:

{
"Accounts": [
{
"Name": "MY AWS ACCOUNT",
"Tags": [
"Account Tag 1",
"Account Tag 2"
]
}
]
}

  Using the call against Multi-Account Views:

XML call:

https://api.cloudcheckr.com/api/account.xml/get_account_level_tags?access_key=[access_key]

JSON call:

https://api.cloudcheckr.com/api/account.json/get_account_level_tags?access_key=[access_key]

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - Admin-Level Access Key is required for this call.
  • use_account (optional; multi-account view only) - return account-level tags from these accounts.

OUTPUT

XML Example:

<AccountLevelTag
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Accounts>
<Account>
<Name>AWS AccountA</Name>
<Tags>
<Tag>Account Tag 1</Tag>
<Tag>Account Tag 2</Tag>
</Tags>
</Account>
<Account>
<Name>AWS AccountB</Name>
<Tags>
<Tag>Account Tag 1</Tag>
<Tag>Account Tag 2</Tag>
<Tag>Account Tag 3</Tag>
</Tags>
</Account>
</Accounts>
</AccountLevelTag>

JSON Example:

{
"Accounts": [
{
"Name": "AWS AccountA",
"Tags": [
"Account Tag 1",
"Account Tag 2"
]
},
{
"Name": "AWS AccountB",
"Tags": [
"Account Tag 1",
"Account Tag 2",
"Account Tag 3"
]
}
]
}

 


GET ACCOUNTS

This API is deprecated and is maintained for historical reasons only. Please use get_accounts_v4 instead. The API method "get_accounts" is used to return a complete list of all AWS accounts registered in CloudCheckr. This call will return an ID for each account that can be used for the parameter ‘use_cc_account_id’ when making calls to the Admin-Level API. IMPORTANT: This call can only be made using Admin-Level Access Keys. The preferred HTTP method for this call is GET.

XML call:

https://api.cloudcheckr.com/api/account.xml/get_accounts?access_key=[access_key]

JSON call:

https://api.cloudcheckr.com/api/account.json/get_accounts?access_key=[access_key]

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - Admin-Level Access Key is required for this call.

OUTPUT

XML Example:

<GetAccountsResponse 
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<accounts_and_users>
<AccountAndUsernames>
<account_name>CloudCheckr Account Name 1 </account_name>
<cc_account_id>1</cc_account_id>
<user_names>
<string>user@domain.com</string>
</user_names>
</AccountAndUsernames>
</accounts_and_users>
</GetAccountsResponse>

JSON Example:

{
"accounts_and_users": [
{
"account_name": "CloudCheckr Account Name 1",
"cc_account_id": "1",
"user_names": [
"user@domain.com"
]
},
{
"account_name": "CloudCheckr Account Name 2",
"cc_account_id": "2",
"user_names":[
"user@domain.com"
]
},
{
"account_name": "CloudCheckr Account Name 3",
"cc_account_id": "3",
"user_names": [
"user@domain.com"
]
}
]
}

GET USERS

This API is deprecated and is maintained for historical reasons only. Please use get_users_v2 instead. The API method "get_users" is used to return a complete list of all CloudCheckr users and the AWS accounts registered in CloudCheckr they can access. IMPORTANT: This call can only be made using Admin-Level Access Keys. The preferred HTTP method for this call is GET.

XML call:

https://api.cloudcheckr.com/api/account.xml/get_users?access_key=[access_key]

JSON call:

https://api.cloudcheckr.com/api/account.json/get_users?access_key=[access_key]

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - Admin-Level Access Key is required for this call.
  • use_account (required -- either this field or 'use_cc_account_id') - The name of the AWS account within CloudCheckr.
  • use_cc_account_id (required -- either this field or 'use_account') - The CloudCheckr ID number for the AWS account within the application.

OUTPUT

XML Example:

<GetUsersResponse
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<users_and_accounts>
<UsernameAndAccountNames>
<username>user@domain.com</username>
<account_names>
<string>AWS Account1</string>
<string>AWS Account2</string>
<string>AWS Account3</string>
</account_names>
</UsernameAndAccountNames>
</users_and_accounts>
</GetUsersResponse>

JSON Example:

{
"users_and_accounts": [
{
"username": "user@domain.com",
"account_names": [
"AWS Account1",
"AWS Account2",
"AWS Account3"
]
}
]
}

GET ACCOUNT FAMILY

This API is deprecated and is maintained for historical reasons only. Please use get_account_family_v2 instead. The API method "get_account_family" is used to return a complete list of all account families in a CloudCheckr payer account.

Sample XML call:

https://api.cloudcheckr.com/api/billing.xml/get_account_family?access_key=[access_key]&use_account=[use_account]&name=[name]

Sample JSON call:

https://api.cloudcheckr.com/api/billing.json/get_account_family?access_key=[access_key]&use_account=[use_account]&name=[name]

INPUT PARAMETERS This call accepts these parameters:

  • access_key (required) - Admin Level Access Key required for all API calls.
  • use_account (required) – The name of the account you are making the call for, where the name is the name of the account added in CloudCheckr.
  • use_cc_account_id (required -- either use this or ‘use_account’) – The CloudCheckr ID of the account you are making the call for.
  • name (optional) - The name for the Account Family in question.

OUTPUT

XML Example:

<GetAccountFamilyResponse 
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Code>0</Code>
<AccountFamilies>
<AccountFamily>
<Name>123456789 (AccountFamilyExample)</Name>
<Accounts>
<string>123456789 (AccountFamilyExample)</string>
</Accounts>
</AccountFamily>
</AccountFamilies>
<UnmappedAccounts>
<string>9876543210 (UnmappedAccountExample)</string>
</UnmappedAccounts>
</GetAccountFamilyResponse>

JSON Example:

{
"GetAccountFamilyResponse": {
"Code": "0",
"AccountFamilies": {
"AccountFamily": {
"Name": "123456789 (AccountFamilyExample)",
"Accounts": {
"string": "123456789 (AccountFamilyExample)"
}
}
},
"UnmappedAccounts": {
"string": "9876543210 (UnmappedAccountExample)"
},
"_xmlns:xsd": "http://www.w3.org/2001/XMLSchema",
"_xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance"
}
}

GET CUSTOM BILLING CHARGES

This API is deprecated and is maintained for historical reasons only. Please use get_custom_billing_charges_v3 instead. The API method, "get_custom_billing_charges", is used to return any custom billing charges from the Cost > AWS Partner Tools > Configure > Custom Billing Charges page. INPUT PARAMETERS:

Parameter

Type

Description

access_key

string

required, admin-level API key

accounts

string

optional; comma-separated list of AWS account IDs; only returns custom charges that contain one of the accounts from the list

ENDPOINT URL:

https://api.cloudcheckr.com/api/billing.[json|xml]/get_custom_billing_charges&accounts=111111111111

JSON/XML CALL EXAMPLE:

curl --request GET \
--'https://api.cloudcheckr.com/api/billing.[json|xml]/get_custom_billing_charges?access_key=your_admin_access_key' \
--header 'cache-control: no-cache' \
--header 'content-type: application/[json|xml]' \
--data '{
"accounts": 1111111111111,
}

SUCCESSFUL JSON/XML RESPONSE:

{ 
"CustomBillingCharges":
[
{
"StartDate":"1/1/2018",
"EndDate":"N/A",
"Type":"Monthly Tier",
"ChargeValue":"Tiers",
"Description":"A Sample Tiered Charge for EC2",
"ResourceId":"",
"Stack":true,
"StackOrder":1,
"Account":"111111111111,222222222222,333333333333",
"Region":"All Regions"
}
]
}


How did we do?