2025/07/09 - AWS Free Tier - 4 new api methods
Changes This release introduces four new APIs: GetAccountPlanState and UpgradeAccountPlan for AWS account plan management; ListAccountActivities and GetAccountActivity that provide activity tracking capabilities.
Returns a specific activity record that is available to the customer.
See also: AWS API Documentation
Request Syntax
client.get_account_activity(
activityId='string',
languageCode='en-US'|'en-GB'|'id-ID'|'de-DE'|'es-ES'|'fr-FR'|'ja-JP'|'it-IT'|'pt-PT'|'ko-KR'|'zh-CN'|'zh-TW'|'tr-TR'
)
string
[REQUIRED]
A unique identifier that identifies the activity.
string
The language code used to return translated title and description fields.
dict
Response Syntax
{
'activityId': 'string',
'title': 'string',
'description': 'string',
'status': 'NOT_STARTED'|'IN_PROGRESS'|'COMPLETED'|'EXPIRING',
'instructionsUrl': 'string',
'reward': {
'credit': {
'amount': 123.0,
'unit': 'USD'
}
},
'estimatedTimeToCompleteInMinutes': 123,
'expiresAt': datetime(2015, 1, 1),
'startedAt': datetime(2015, 1, 1),
'completedAt': datetime(2015, 1, 1)
}
Response Structure
(dict) --
activityId (string) --
A unique identifier that identifies the activity.
title (string) --
A short activity title.
description (string) --
Provides detailed information about the activity and its expected outcomes.
status (string) --
The current activity status.
instructionsUrl (string) --
The URL resource that provides guidance on activity requirements and completion.
reward (dict) --
A reward granted upon activity completion.
credit (dict) --
The credits gained by activity rewards.
amount (float) --
The aggregated monetary amount of credits earned.
unit (string) --
The unit that the monetary amount is given in.
estimatedTimeToCompleteInMinutes (integer) --
The estimated time to complete the activity. This is the duration in minutes.
expiresAt (datetime) --
The time by which the activity must be completed to receive a reward.
startedAt (datetime) --
The timestamp when the activity started. This field appears only for activities in the IN_PROGRESS or COMPLETED states.
completedAt (datetime) --
The timestamp when the activity is completed. This field appears only for activities in the COMPLETED state.
Returns a list of activities that are available. This operation supports pagination and filtering by status.
See also: AWS API Documentation
Request Syntax
client.list_account_activities(
filterActivityStatuses=[
'NOT_STARTED'|'IN_PROGRESS'|'COMPLETED'|'EXPIRING',
],
nextToken='string',
maxResults=123,
languageCode='en-US'|'en-GB'|'id-ID'|'de-DE'|'es-ES'|'fr-FR'|'ja-JP'|'it-IT'|'pt-PT'|'ko-KR'|'zh-CN'|'zh-TW'|'tr-TR'
)
list
The activity status filter. This field can be used to filter the response by activities status.
(string) --
string
A token from a previous paginated response. If this is specified, the response includes records beginning from this token (inclusive), up to the number specified by maxResults.
integer
The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output.
string
The language code used to return translated titles.
dict
Response Syntax
{
'activities': [
{
'activityId': 'string',
'title': 'string',
'reward': {
'credit': {
'amount': 123.0,
'unit': 'USD'
}
},
'status': 'NOT_STARTED'|'IN_PROGRESS'|'COMPLETED'|'EXPIRING'
},
],
'nextToken': 'string'
}
Response Structure
(dict) --
activities (list) --
A brief information about the activities.
(dict) --
The summary of activities.
activityId (string) --
A unique identifier that identifies the activity.
title (string) --
The title of the activity.
reward (dict) --
The reward for the activity.
credit (dict) --
The credits gained by activity rewards.
amount (float) --
The aggregated monetary amount of credits earned.
unit (string) --
The unit that the monetary amount is given in.
status (string) --
The current status of the activity.
nextToken (string) --
The token to include in another request to get the next page of items. This value is null when there are no more items to return.
This returns all of the information related to the state of the account plan related to Free Tier.
See also: AWS API Documentation
Request Syntax
client.get_account_plan_state()
dict
Response Syntax
{
'accountId': 'string',
'accountPlanType': 'FREE'|'PAID',
'accountPlanStatus': 'NOT_STARTED'|'ACTIVE'|'EXPIRED',
'accountPlanRemainingCredits': {
'amount': 123.0,
'unit': 'USD'
},
'accountPlanExpirationDate': datetime(2015, 1, 1)
}
Response Structure
(dict) --
accountId (string) --
A unique identifier that identifies the account.
accountPlanType (string) --
The plan type for the account.
accountPlanStatus (string) --
The current status for the account plan.
accountPlanRemainingCredits (dict) --
The amount of credits remaining for the account.
amount (float) --
The aggregated monetary amount of credits earned.
unit (string) --
The unit that the monetary amount is given in.
accountPlanExpirationDate (datetime) --
The timestamp for when the current account plan expires.
The account plan type for the Amazon Web Services account.
See also: AWS API Documentation
Request Syntax
client.upgrade_account_plan(
accountPlanType='FREE'|'PAID'
)
string
[REQUIRED]
The target account plan type. This makes it explicit about the change and latest value of the accountPlanType.
dict
Response Syntax
{
'accountId': 'string',
'accountPlanType': 'FREE'|'PAID',
'accountPlanStatus': 'NOT_STARTED'|'ACTIVE'|'EXPIRED'
}
Response Structure
(dict) --
accountId (string) --
A unique identifier that identifies the account.
accountPlanType (string) --
The type of plan for the account.
accountPlanStatus (string) --
This indicates the latest state of the account plan within its lifecycle.