{ "smithy": "2.0", "shapes": { "com.amazonaws.freetier#AWSFreeTierService": { "type": "service", "version": "2023-09-07", "operations": [ { "target": "com.amazonaws.freetier#GetAccountActivity" }, { "target": "com.amazonaws.freetier#GetAccountPlanState" }, { "target": "com.amazonaws.freetier#GetFreeTierUsage" }, { "target": "com.amazonaws.freetier#ListAccountActivities" }, { "target": "com.amazonaws.freetier#UpgradeAccountPlan" } ], "traits": { "aws.api#service": { "sdkId": "FreeTier", "endpointPrefix": "freetier" }, "aws.auth#sigv4": { "name": "freetier" }, "aws.protocols#awsJson1_0": {}, "smithy.api#documentation": "
You can use the Amazon Web Services Free Tier API to query programmatically your Free Tier usage data.
Free Tier tracks your monthly usage data for all free tier offers that are associated with your Amazon Web Services account. You can use the Free Tier API to filter and show only the data that you want.
Service endpoint
The Free Tier API provides the following endpoint:
For more information, see Using the Amazon Web Services Free Tier in the Billing User Guide.
", "smithy.api#title": "AWS Free Tier", "smithy.rules#endpointBdd": { "version": "1.1", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] }, { "fn": "isSet", "argv": [ { "ref": "Region" } ] }, { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" }, { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] }, { "fn": "stringEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "name" ] }, "aws" ] }, { "fn": "stringEquals", "argv": [ { "ref": "Region" }, "aws-cn-global" ] }, { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] }, true ] } ], "results": [ { "conditions": [], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.api.aws", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" }, { "conditions": [], "endpoint": { "url": "https://freetier.us-east-1.api.aws", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "us-east-1" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier.cn-northwest-1.api.amazonwebservices.com.cn", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "cn-northwest-1" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ], "root": 2, "nodeCount": 12, "nodes": "/////wAAAAH/////AAAAAAAAAAwAAAADAAAAAQAAAAQF9eELAAAAAgAAAAUF9eELAAAAAwAAAAkAAAAGAAAABQX14QUAAAAHAAAABgX14QcAAAAIAAAABwX14QgF9eEKAAAABAAAAAoF9eEEAAAABQX14QMAAAALAAAABwX14QYF9eEJAAAAAwX14QEF9eEC" }, "smithy.rules#endpointRuleSet": { "version": "1.0", "parameters": { "Region": { "builtIn": "AWS::Region", "required": false, "documentation": "The AWS region used to dispatch the request.", "type": "string" }, "UseFIPS": { "builtIn": "AWS::UseFIPS", "required": true, "default": false, "documentation": "When true, send this request to the FIPS-compliant regional endpoint. If the configured endpoint does not have a FIPS compliant endpoint, dispatching the request will return an error.", "type": "boolean" }, "Endpoint": { "builtIn": "SDK::Endpoint", "required": false, "documentation": "Override the endpoint used to send this request", "type": "string" } }, "rules": [ { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Endpoint" } ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "error": "Invalid Configuration: FIPS and custom endpoint are not supported", "type": "error" }, { "conditions": [], "endpoint": { "url": { "ref": "Endpoint" }, "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [ { "fn": "isSet", "argv": [ { "ref": "Region" } ] } ], "rules": [ { "conditions": [ { "fn": "aws.partition", "argv": [ { "ref": "Region" } ], "assign": "PartitionResult" } ], "rules": [ { "conditions": [ { "fn": "stringEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "name" ] }, "aws" ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "rules": [ { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.api.aws", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } ], "type": "tree" }, { "conditions": [], "endpoint": { "url": "https://freetier.us-east-1.api.aws", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "us-east-1" } ] }, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ true, { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsDualStack" ] } ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "rules": [ { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "stringEquals", "argv": [ { "ref": "Region" }, "aws-cn-global" ] } ], "endpoint": { "url": "https://freetier.cn-northwest-1.api.amazonwebservices.com.cn", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "cn-northwest-1" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier.{Region}.{PartitionResult#dualStackDnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [ { "fn": "booleanEquals", "argv": [ { "ref": "UseFIPS" }, true ] } ], "rules": [ { "conditions": [ { "fn": "booleanEquals", "argv": [ { "fn": "getAttr", "argv": [ { "ref": "PartitionResult" }, "supportsFIPS" ] }, true ] } ], "rules": [ { "conditions": [], "endpoint": { "url": "https://freetier-fips.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" }, { "conditions": [], "error": "FIPS is enabled but this partition does not support FIPS", "type": "error" } ], "type": "tree" }, { "conditions": [ { "fn": "stringEquals", "argv": [ { "ref": "Region" }, "aws-cn-global" ] } ], "endpoint": { "url": "https://freetier.cn-northwest-1.api.amazonwebservices.com.cn", "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "cn-northwest-1" } ] }, "headers": {} }, "type": "endpoint" }, { "conditions": [], "endpoint": { "url": "https://freetier.{Region}.{PartitionResult#dnsSuffix}", "properties": {}, "headers": {} }, "type": "endpoint" } ], "type": "tree" } ], "type": "tree" }, { "conditions": [], "error": "Invalid Configuration: Missing Region", "type": "error" } ] }, "smithy.rules#endpointTests": { "testCases": [ { "documentation": "For region aws-global with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "us-east-1" } ] }, "url": "https://freetier.us-east-1.api.aws" } }, "params": { "Region": "aws-global", "UseFIPS": false } }, { "documentation": "For region us-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://freetier-fips.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": true } }, { "documentation": "For region us-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "us-east-1" } ] }, "url": "https://freetier.us-east-1.api.aws" } }, "params": { "Region": "us-east-1", "UseFIPS": false } }, { "documentation": "For region aws-cn-global with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "properties": { "authSchemes": [ { "name": "sigv4", "signingName": "freetier", "signingRegion": "cn-northwest-1" } ] }, "url": "https://freetier.cn-northwest-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "aws-cn-global", "UseFIPS": false } }, { "documentation": "For region cn-north-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://freetier-fips.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": true } }, { "documentation": "For region cn-north-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://freetier.cn-north-1.api.amazonwebservices.com.cn" } }, "params": { "Region": "cn-north-1", "UseFIPS": false } }, { "documentation": "For region us-gov-east-1 with FIPS enabled and DualStack enabled", "expect": { "endpoint": { "url": "https://freetier-fips.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": true } }, { "documentation": "For region us-gov-east-1 with FIPS disabled and DualStack enabled", "expect": { "endpoint": { "url": "https://freetier.us-gov-east-1.api.aws" } }, "params": { "Region": "us-gov-east-1", "UseFIPS": false } }, { "documentation": "For custom endpoint with region set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "Region": "us-east-1", "UseFIPS": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with region not set and fips disabled and dualstack disabled", "expect": { "endpoint": { "url": "https://example.com" } }, "params": { "UseFIPS": false, "Endpoint": "https://example.com" } }, { "documentation": "For custom endpoint with fips enabled and dualstack disabled", "expect": { "error": "Invalid Configuration: FIPS and custom endpoint are not supported" }, "params": { "Region": "us-east-1", "UseFIPS": true, "Endpoint": "https://example.com" } }, { "documentation": "Missing region", "expect": { "error": "Invalid Configuration: Missing Region" } } ], "version": "1.0" } } }, "com.amazonaws.freetier#AccessDeniedException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "You don't have sufficient access to perform this action.
", "smithy.api#error": "client", "smithy.api#httpError": 403 } }, "com.amazonaws.freetier#AccountId": { "type": "string", "traits": { "smithy.api#pattern": "^[0-9]{12}$" } }, "com.amazonaws.freetier#AccountPlanStatus": { "type": "enum", "members": { "NOT_STARTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NOT_STARTED" } }, "ACTIVE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ACTIVE" } }, "EXPIRED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EXPIRED" } } } }, "com.amazonaws.freetier#AccountPlanType": { "type": "enum", "members": { "FREE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "FREE" } }, "PAID": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "PAID" } } } }, "com.amazonaws.freetier#Activities": { "type": "list", "member": { "target": "com.amazonaws.freetier#ActivitySummary" } }, "com.amazonaws.freetier#ActivityId": { "type": "string", "traits": { "smithy.api#length": { "min": 32, "max": 32 }, "smithy.api#pattern": "^[a-zA-Z0-9]+$" } }, "com.amazonaws.freetier#ActivityReward": { "type": "union", "members": { "credit": { "target": "com.amazonaws.freetier#MonetaryAmount", "traits": { "smithy.api#documentation": "The credits gained by activity rewards.
" } } }, "traits": { "smithy.api#documentation": "The summary of the rewards granted as a result of activities completed.
" } }, "com.amazonaws.freetier#ActivityStatus": { "type": "enum", "members": { "NOT_STARTED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "NOT_STARTED" } }, "IN_PROGRESS": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "IN_PROGRESS" } }, "COMPLETED": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "COMPLETED" } }, "EXPIRING": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "EXPIRING" } } } }, "com.amazonaws.freetier#ActivitySummary": { "type": "structure", "members": { "activityId": { "target": "com.amazonaws.freetier#ActivityId", "traits": { "smithy.api#documentation": "A unique identifier that identifies the activity.
", "smithy.api#required": {} } }, "title": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "The title of the activity.
", "smithy.api#required": {} } }, "reward": { "target": "com.amazonaws.freetier#ActivityReward", "traits": { "smithy.api#documentation": "The reward for the activity.
", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.freetier#ActivityStatus", "traits": { "smithy.api#documentation": "The current status of the activity.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The summary of activities.
" } }, "com.amazonaws.freetier#CurrencyCode": { "type": "enum", "members": { "USD": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "USD" } } } }, "com.amazonaws.freetier#Dimension": { "type": "enum", "members": { "SERVICE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "SERVICE" } }, "OPERATION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "OPERATION" } }, "USAGE_TYPE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "USAGE_TYPE" } }, "REGION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "REGION" } }, "FREE_TIER_TYPE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "FREE_TIER_TYPE" } }, "DESCRIPTION": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "DESCRIPTION" } }, "USAGE_PERCENTAGE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "USAGE_PERCENTAGE" } } } }, "com.amazonaws.freetier#DimensionValues": { "type": "structure", "members": { "Key": { "target": "com.amazonaws.freetier#Dimension", "traits": { "smithy.api#documentation": "The name of the dimension that you want to filter on.
", "smithy.api#required": {} } }, "Values": { "target": "com.amazonaws.freetier#Values", "traits": { "smithy.api#documentation": "The metadata values you can specify to filter upon, so that the results all match at least one of the specified values.
", "smithy.api#required": {} } }, "MatchOptions": { "target": "com.amazonaws.freetier#MatchOptions", "traits": { "smithy.api#documentation": "The match options that you can use to filter your results. You can specify only one of these values in the array.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "Contains the specifications for the filters to use for your request.
" } }, "com.amazonaws.freetier#Expression": { "type": "structure", "members": { "Or": { "target": "com.amazonaws.freetier#Expressions", "traits": { "smithy.api#documentation": "Return results that match any of the Expressions that you specified. in the array.
Return results that match all Expressions that you specified in the array.
Return results that don\u2019t match the Expression that you specified.
The specific dimension, values, and match type to filter objects with.
" } } }, "traits": { "smithy.api#documentation": "Use Expression to filter in the GetFreeTierUsage API operation.
You can use the following patterns:
Simple dimension values (Dimensions root operator)
Complex expressions with logical operators (AND, NOT, and OR root operators).
For simple dimension values, you can set the dimension name, values, and match type for the filters that you plan to use.
Example for simple dimension values
You can filter to match exactly for REGION==us-east-1 OR REGION==us-west-1.
The corresponding Expression appears like the following: { \"Dimensions\": { \"Key\": \"REGION\", \"Values\": [ \"us-east-1\", \"us-west-1\" ], \"MatchOptions\": [\"EQUALS\"] } }
As shown in the previous example, lists of dimension values are combined with OR when you apply the filter.
For complex expressions with logical operators, you can have nested expressions to use the logical operators and specify advanced filtering.
Example for complex expressions with logical operators
You can filter by ((REGION == us-east-1 OR REGION == us-west-1) OR (SERVICE CONTAINS AWSLambda)) AND (USAGE_TYPE !CONTAINS DataTransfer).
The corresponding Expression appears like the following: { \"And\": [ {\"Or\": [ {\"Dimensions\": { \"Key\": \"REGION\", \"Values\": [ \"us-east-1\", \"us-west-1\" ], \"MatchOptions\": [\"EQUALS\"] }}, {\"Dimensions\": { \"Key\": \"SERVICE\", \"Values\": [\"AWSLambda\"], \"MatchOptions\": [\"CONTAINS\"] } } ]}, {\"Not\": {\"Dimensions\": { \"Key\": \"USAGE_TYPE\", \"Values\": [\"DataTransfer\"], \"MatchOptions\": [\"CONTAINS\"] }}} ] }
In the following Contents, you must specify exactly one of the following root operators.
" } }, "com.amazonaws.freetier#Expressions": { "type": "list", "member": { "target": "com.amazonaws.freetier#Expression" } }, "com.amazonaws.freetier#FilterActivityStatuses": { "type": "list", "member": { "target": "com.amazonaws.freetier#ActivityStatus" } }, "com.amazonaws.freetier#FreeTierUsage": { "type": "structure", "members": { "service": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "The name of the Amazon Web Services service providing the Free Tier offer. For example, this can be Amazon Elastic Compute Cloud.
" } }, "operation": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "Describes usageType more granularly with the specific Amazon Web Services service API operation. For example, this can be the RunInstances API operation for Amazon Elastic Compute Cloud.
Describes the usage details of the offer. For example, this might be Global-BoxUsage:freetrial.
Describes the Amazon Web Services Region for which this offer is applicable
" } }, "actualUsageAmount": { "target": "com.amazonaws.freetier#GenericDouble", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "Describes the actual usage accrued month-to-day (MTD) that you've used so far.
" } }, "forecastedUsageAmount": { "target": "com.amazonaws.freetier#GenericDouble", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "Describes the forecasted usage by the month that you're expected to use.
" } }, "limit": { "target": "com.amazonaws.freetier#GenericDouble", "traits": { "smithy.api#default": 0, "smithy.api#documentation": "Describes the maximum usage allowed in Free Tier.
" } }, "unit": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "Describes the unit of the usageType, such as Hrs.
The description of the Free Tier offer.
" } }, "freeTierType": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "Describes the type of the Free Tier offer. For example, the offer can be \"12 Months Free\", \"Always Free\", and \"Free Trial\".
Consists of a Amazon Web Services Free Tier offer\u2019s metadata and your data usage for the offer.
" } }, "com.amazonaws.freetier#FreeTierUsages": { "type": "list", "member": { "target": "com.amazonaws.freetier#FreeTierUsage" } }, "com.amazonaws.freetier#GenericDouble": { "type": "double", "traits": { "smithy.api#default": 0 } }, "com.amazonaws.freetier#GenericString": { "type": "string", "traits": { "smithy.api#length": { "min": 0, "max": 1024 }, "smithy.api#pattern": "^[\\S\\s]*$" } }, "com.amazonaws.freetier#GetAccountActivity": { "type": "operation", "input": { "target": "com.amazonaws.freetier#GetAccountActivityRequest" }, "output": { "target": "com.amazonaws.freetier#GetAccountActivityResponse" }, "errors": [ { "target": "com.amazonaws.freetier#InternalServerException" }, { "target": "com.amazonaws.freetier#ResourceNotFoundException" }, { "target": "com.amazonaws.freetier#ThrottlingException" }, { "target": "com.amazonaws.freetier#ValidationException" } ], "traits": { "smithy.api#documentation": "Returns a specific activity record that is available to the customer.
", "smithy.api#examples": [ { "title": "Fetching an Account activity by id", "input": { "activityId": "d622f48bf4014286a2686ab10cacfb2e", "languageCode": "en-US" }, "output": { "activityId": "d622f48bf4014286a2686ab10cacfb2e", "title": "Configure Your Access in the AWS Identity and Access Management (IAM) center", "description": "Set up three notifications: one for your costs reach ...", "status": "COMPLETED", "instructionsUrl": "https://catalog.us-east-1.prod.workshops.aws/workshops/2a5fc82d-2b5f-4105-83c2-91a1b4d7abfe/en-US/2-foundation/lab1-create", "reward": { "credit": { "amount": 20.0, "unit": "USD" } }, "estimatedTimeToCompleteInMinutes": 15, "expiresAt": "1985-10-12T23:20:50.520Z", "startedAt": "1985-04-12T23:20:50.520Z", "completedAt": "1985-06-12T23:20:50.520Z" } } ], "smithy.api#readonly": {}, "smithy.test#smokeTests": [ { "id": "GetAccountActivitySuccess", "params": { "activityId": "d622f48bf4014286a2686ab10cacfb2e", "languageCode": "en-US" }, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.freetier#GetAccountActivityRequest": { "type": "structure", "members": { "activityId": { "target": "com.amazonaws.freetier#ActivityId", "traits": { "smithy.api#documentation": "A unique identifier that identifies the activity.
", "smithy.api#required": {} } }, "languageCode": { "target": "com.amazonaws.freetier#LanguageCode", "traits": { "smithy.api#documentation": "The language code used to return translated title and description fields.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.freetier#GetAccountActivityResponse": { "type": "structure", "members": { "activityId": { "target": "com.amazonaws.freetier#ActivityId", "traits": { "smithy.api#documentation": "A unique identifier that identifies the activity.
", "smithy.api#required": {} } }, "title": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "A short activity title.
", "smithy.api#required": {} } }, "description": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "Provides detailed information about the activity and its expected outcomes.
", "smithy.api#required": {} } }, "status": { "target": "com.amazonaws.freetier#ActivityStatus", "traits": { "smithy.api#documentation": "The current activity status.
", "smithy.api#required": {} } }, "instructionsUrl": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#documentation": "The URL resource that provides guidance on activity requirements and completion.
", "smithy.api#required": {} } }, "reward": { "target": "com.amazonaws.freetier#ActivityReward", "traits": { "smithy.api#documentation": "A reward granted upon activity completion.
", "smithy.api#required": {} } }, "estimatedTimeToCompleteInMinutes": { "target": "smithy.api#Integer", "traits": { "smithy.api#documentation": "The estimated time to complete the activity. This is the duration in minutes.
" } }, "expiresAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The time by which the activity must be completed to receive a reward.
", "smithy.api#timestampFormat": "date-time" } }, "startedAt": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": " The timestamp when the activity started. This field appears only for activities in the IN_PROGRESS or COMPLETED states.
The timestamp when the activity is completed. This field appears only for activities in the COMPLETED state.
This returns all of the information related to the state of the account plan related to Free Tier.
", "smithy.api#examples": [ { "title": "Fetching account plan state by id", "input": {}, "output": { "accountId": "111122223333", "accountPlanType": "FREE", "accountPlanStatus": "ACTIVE", "accountPlanExpirationDate": "2025-06-30T23:59:59Z", "accountPlanRemainingCredits": { "amount": 25.0, "unit": "USD" } } }, { "title": "Attempt to fetch account plan state by id with insufficient permissions", "input": {}, "error": { "shapeId": "com.amazonaws.freetier#AccessDeniedException", "content": { "message": "Access denied" } } }, { "title": "Internal service error", "input": {}, "error": { "shapeId": "com.amazonaws.freetier#InternalServerException", "content": { "message": "An internal error occurred while processing your request" } } }, { "title": "Attempt to fetch plan state by id for an account without account plan", "input": {}, "error": { "shapeId": "com.amazonaws.freetier#ResourceNotFoundException", "content": { "message": "Account plan state could not be found" } } }, { "title": "Request rate exceeds limits", "input": {}, "error": { "shapeId": "com.amazonaws.freetier#ThrottlingException", "content": { "message": "Request rate limit exceeded" } } } ], "smithy.api#readonly": {} } }, "com.amazonaws.freetier#GetAccountPlanStateRequest": { "type": "structure", "members": {}, "traits": { "smithy.api#input": {} } }, "com.amazonaws.freetier#GetAccountPlanStateResponse": { "type": "structure", "members": { "accountId": { "target": "com.amazonaws.freetier#AccountId", "traits": { "smithy.api#documentation": "A unique identifier that identifies the account.
", "smithy.api#required": {} } }, "accountPlanType": { "target": "com.amazonaws.freetier#AccountPlanType", "traits": { "smithy.api#documentation": "The plan type for the account.
", "smithy.api#required": {} } }, "accountPlanStatus": { "target": "com.amazonaws.freetier#AccountPlanStatus", "traits": { "smithy.api#documentation": "The current status for the account plan.
", "smithy.api#required": {} } }, "accountPlanRemainingCredits": { "target": "com.amazonaws.freetier#MonetaryAmount", "traits": { "smithy.api#documentation": "The amount of credits remaining for the account.
" } }, "accountPlanExpirationDate": { "target": "smithy.api#Timestamp", "traits": { "smithy.api#documentation": "The timestamp for when the current account plan expires.
", "smithy.api#timestampFormat": "date-time" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.freetier#GetFreeTierUsage": { "type": "operation", "input": { "target": "com.amazonaws.freetier#GetFreeTierUsageRequest" }, "output": { "target": "com.amazonaws.freetier#GetFreeTierUsageResponse" }, "errors": [ { "target": "com.amazonaws.freetier#InternalServerException" }, { "target": "com.amazonaws.freetier#ThrottlingException" }, { "target": "com.amazonaws.freetier#ValidationException" } ], "traits": { "smithy.api#documentation": "Returns a list of all Free Tier usage objects that match your filters.
", "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "freeTierUsages" } } }, "com.amazonaws.freetier#GetFreeTierUsageRequest": { "type": "structure", "members": { "filter": { "target": "com.amazonaws.freetier#Expression", "traits": { "smithy.api#documentation": "An expression that specifies the conditions that you want each FreeTierUsage object to meet.
The maximum number of results to return in the response. MaxResults means that there can be up to the specified number of values, but there might be fewer results based on your filters.
The pagination token that indicates the next set of results to retrieve.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.freetier#GetFreeTierUsageResponse": { "type": "structure", "members": { "freeTierUsages": { "target": "com.amazonaws.freetier#FreeTierUsages", "traits": { "smithy.api#documentation": "The list of Free Tier usage objects that meet your filter expression.
", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.freetier#NextPageToken", "traits": { "smithy.api#documentation": "The pagination token that indicates the next set of results to retrieve.
" } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.freetier#InternalServerException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "An unexpected error occurred during the processing of your request.
", "smithy.api#error": "server", "smithy.api#httpError": 500 } }, "com.amazonaws.freetier#LanguageCode": { "type": "enum", "members": { "EN_US": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "en-US" } }, "EN_GB": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "en-GB" } }, "ID_ID": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "id-ID" } }, "DE_DE": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "de-DE" } }, "ES_ES": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "es-ES" } }, "FR_FR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "fr-FR" } }, "JA_JP": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ja-JP" } }, "IT_IT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "it-IT" } }, "PT_PT": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "pt-PT" } }, "KO_KR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "ko-KR" } }, "ZH_CN": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "zh-CN" } }, "ZH_TW": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "zh-TW" } }, "TR_TR": { "target": "smithy.api#Unit", "traits": { "smithy.api#enumValue": "tr-TR" } } } }, "com.amazonaws.freetier#ListAccountActivities": { "type": "operation", "input": { "target": "com.amazonaws.freetier#ListAccountActivitiesRequest" }, "output": { "target": "com.amazonaws.freetier#ListAccountActivitiesResponse" }, "errors": [ { "target": "com.amazonaws.freetier#InternalServerException" }, { "target": "com.amazonaws.freetier#ThrottlingException" }, { "target": "com.amazonaws.freetier#ValidationException" } ], "traits": { "smithy.api#documentation": "Returns a list of activities that are available. This operation supports pagination and filtering by status.
", "smithy.api#examples": [ { "title": "Fetching a page of completed activities", "input": { "filterActivityStatuses": [ "COMPLETED" ], "maxResults": 1, "languageCode": "en-US" }, "output": { "activities": [ { "activityId": "d622f48bf4014286a2686ab10cacfb2e", "title": "Configure Your Access in the AWS Identity and Access Management (IAM) center", "status": "COMPLETED", "reward": { "credit": { "amount": 20.0, "unit": "USD" } } } ], "nextToken": "a95f3d9e7710c6ca8ba4f640b40bbc40" } } ], "smithy.api#paginated": { "inputToken": "nextToken", "outputToken": "nextToken", "pageSize": "maxResults", "items": "activities" }, "smithy.api#readonly": {}, "smithy.test#smokeTests": [ { "id": "ListAccountActivitiesSuccess", "params": { "languageCode": "en-US" }, "expect": { "success": {} }, "vendorParamsShape": "aws.test#AwsVendorParams", "vendorParams": { "region": "us-east-1" } } ] } }, "com.amazonaws.freetier#ListAccountActivitiesRequest": { "type": "structure", "members": { "filterActivityStatuses": { "target": "com.amazonaws.freetier#FilterActivityStatuses", "traits": { "smithy.api#documentation": "The activity status filter. This field can be used to filter the response by activities status.
" } }, "nextToken": { "target": "com.amazonaws.freetier#NextPageToken", "traits": { "smithy.api#documentation": " 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.
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.
" } }, "languageCode": { "target": "com.amazonaws.freetier#LanguageCode", "traits": { "smithy.api#documentation": "The language code used to return translated titles.
" } } }, "traits": { "smithy.api#input": {} } }, "com.amazonaws.freetier#ListAccountActivitiesResponse": { "type": "structure", "members": { "activities": { "target": "com.amazonaws.freetier#Activities", "traits": { "smithy.api#documentation": "A brief information about the activities.
", "smithy.api#required": {} } }, "nextToken": { "target": "com.amazonaws.freetier#NextPageToken", "traits": { "smithy.api#documentation": " 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.
The aggregated monetary amount of credits earned.
", "smithy.api#required": {} } }, "unit": { "target": "com.amazonaws.freetier#CurrencyCode", "traits": { "smithy.api#documentation": "The unit that the monetary amount is given in.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The monetary amount of the credit.
" } }, "com.amazonaws.freetier#NextPageToken": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 8192 }, "smithy.api#pattern": "^[\\S\\s]*$" } }, "com.amazonaws.freetier#ResourceNotFoundException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "This exception is thrown when the requested resource cannot be found.
", "smithy.api#error": "client", "smithy.api#httpError": 404 } }, "com.amazonaws.freetier#ThrottlingException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The request was denied due to request throttling.
", "smithy.api#error": "client", "smithy.api#httpError": 429 } }, "com.amazonaws.freetier#UpgradeAccountPlan": { "type": "operation", "input": { "target": "com.amazonaws.freetier#UpgradeAccountPlanRequest" }, "output": { "target": "com.amazonaws.freetier#UpgradeAccountPlanResponse" }, "errors": [ { "target": "com.amazonaws.freetier#AccessDeniedException" }, { "target": "com.amazonaws.freetier#InternalServerException" }, { "target": "com.amazonaws.freetier#ResourceNotFoundException" }, { "target": "com.amazonaws.freetier#ThrottlingException" }, { "target": "com.amazonaws.freetier#ValidationException" } ], "traits": { "smithy.api#documentation": "The account plan type for the Amazon Web Services account.
", "smithy.api#examples": [ { "title": "Upgrading an account plan to PAID", "input": { "accountPlanType": "PAID" }, "output": { "accountId": "111122223333", "accountPlanType": "PAID", "accountPlanStatus": "NOT_STARTED" } }, { "title": "Attempt to upgrade an account with insufficient permissions", "input": { "accountPlanType": "PAID" }, "error": { "shapeId": "com.amazonaws.freetier#AccessDeniedException", "content": { "message": "Access denied" } } }, { "title": "Attempt to downgrade an account from PAID to FREE", "input": { "accountPlanType": "FREE" }, "error": { "shapeId": "com.amazonaws.freetier#ValidationException", "content": { "message": "The Account Plan can not be updated from to PAID to FREE" } } }, { "title": "Internal service error", "input": { "accountPlanType": "PAID" }, "error": { "shapeId": "com.amazonaws.freetier#InternalServerException", "content": { "message": "An internal error occurred while processing your request" } } }, { "title": "Attempt to upgrade a non-existent account plan", "input": { "accountPlanType": "PAID" }, "error": { "shapeId": "com.amazonaws.freetier#ResourceNotFoundException", "content": { "message": "Unable to upgrade account plan: account plan state could not be found" } } }, { "title": "Request rate exceeds limits", "input": { "accountPlanType": "PAID" }, "error": { "shapeId": "com.amazonaws.freetier#ThrottlingException", "content": { "message": "Request rate limit exceeded" } } } ] } }, "com.amazonaws.freetier#UpgradeAccountPlanRequest": { "type": "structure", "members": { "accountPlanType": { "target": "com.amazonaws.freetier#AccountPlanType", "traits": { "smithy.api#documentation": " The target account plan type. This makes it explicit about the change and latest value of the accountPlanType.
A unique identifier that identifies the account.
", "smithy.api#required": {} } }, "accountPlanType": { "target": "com.amazonaws.freetier#AccountPlanType", "traits": { "smithy.api#documentation": "The type of plan for the account.
", "smithy.api#required": {} } }, "accountPlanStatus": { "target": "com.amazonaws.freetier#AccountPlanStatus", "traits": { "smithy.api#documentation": "This indicates the latest state of the account plan within its lifecycle.
", "smithy.api#required": {} } } }, "traits": { "smithy.api#output": {} } }, "com.amazonaws.freetier#ValidationException": { "type": "structure", "members": { "message": { "target": "com.amazonaws.freetier#GenericString", "traits": { "smithy.api#required": {} } } }, "traits": { "smithy.api#documentation": "The input fails to satisfy the constraints specified by an Amazon Web Services service.
", "smithy.api#error": "client", "smithy.api#httpError": 400 } }, "com.amazonaws.freetier#Value": { "type": "string", "traits": { "smithy.api#length": { "min": 1, "max": 20 }, "smithy.api#pattern": "^[ a-zA-Z0-9\\-\\:\\.\\_\\/\\,\\$\\(\\)]*$" } }, "com.amazonaws.freetier#Values": { "type": "list", "member": { "target": "com.amazonaws.freetier#Value" }, "traits": { "smithy.api#length": { "min": 1 } } } } }