DescribeBudgetActionsForAccountCommand

Suggest an Edit

Describes all of the budget actions for an account.

Example Syntax

Use a bare-bones client and the command you need to make an API call.

import { BudgetsClient, DescribeBudgetActionsForAccountCommand } from "@aws-sdk/client-budgets"; // ES Modules import
// const { BudgetsClient, DescribeBudgetActionsForAccountCommand } = require("@aws-sdk/client-budgets"); // CommonJS import
const client = new BudgetsClient(config);
const input = { // DescribeBudgetActionsForAccountRequest
  AccountId: "STRING_VALUE", // required
  MaxResults: Number("int"),
  NextToken: "STRING_VALUE",
};
const command = new DescribeBudgetActionsForAccountCommand(input);
const response = await client.send(command);
// { // DescribeBudgetActionsForAccountResponse
//   Actions: [ // Actions // required
//     { // Action
//       ActionId: "STRING_VALUE", // required
//       BudgetName: "STRING_VALUE", // required
//       NotificationType: "ACTUAL" || "FORECASTED", // required
//       ActionType: "APPLY_IAM_POLICY" || "APPLY_SCP_POLICY" || "RUN_SSM_DOCUMENTS", // required
//       ActionThreshold: { // ActionThreshold
//         ActionThresholdValue: Number("double"), // required
//         ActionThresholdType: "PERCENTAGE" || "ABSOLUTE_VALUE", // required
//       },
//       Definition: { // Definition
//         IamActionDefinition: { // IamActionDefinition
//           PolicyArn: "STRING_VALUE", // required
//           Roles: [ // Roles
//             "STRING_VALUE",
//           ],
//           Groups: [ // Groups
//             "STRING_VALUE",
//           ],
//           Users: [ // Users
//             "STRING_VALUE",
//           ],
//         },
//         ScpActionDefinition: { // ScpActionDefinition
//           PolicyId: "STRING_VALUE", // required
//           TargetIds: [ // TargetIds // required
//             "STRING_VALUE",
//           ],
//         },
//         SsmActionDefinition: { // SsmActionDefinition
//           ActionSubType: "STOP_EC2_INSTANCES" || "STOP_RDS_INSTANCES", // required
//           Region: "STRING_VALUE", // required
//           InstanceIds: [ // InstanceIds // required
//             "STRING_VALUE",
//           ],
//         },
//       },
//       ExecutionRoleArn: "STRING_VALUE", // required
//       ApprovalModel: "AUTOMATIC" || "MANUAL", // required
//       Status: "STANDBY" || "PENDING" || "EXECUTION_IN_PROGRESS" || "EXECUTION_SUCCESS" || "EXECUTION_FAILURE" || "REVERSE_IN_PROGRESS" || "REVERSE_SUCCESS" || "REVERSE_FAILURE" || "RESET_IN_PROGRESS" || "RESET_FAILURE", // required
//       Subscribers: [ // Subscribers // required
//         { // Subscriber
//           SubscriptionType: "SNS" || "EMAIL", // required
//           Address: "STRING_VALUE", // required
//         },
//       ],
//     },
//   ],
//   NextToken: "STRING_VALUE",
// };

DescribeBudgetActionsForAccountCommand Input

See DescribeBudgetActionsForAccountCommandInput for more details

Parameter
Type
Description
AccountId
Required
string | undefined

The account ID of the user. It's a 12-digit number.

MaxResults
number | undefined

An integer that represents how many entries a paginated response contains. The maximum is 100.

NextToken
string | undefined

A generic string.

DescribeBudgetActionsForAccountCommand Output

See DescribeBudgetActionsForAccountCommandOutput for details

Parameter
Type
Description
$metadata
Required
ResponseMetadata
Metadata pertaining to this request.
Actions
Required
Action[] | undefined

A list of the budget action resources information.

NextToken
string | undefined

A generic string.

Throws

Name
Fault
Details
AccessDeniedException
client

You are not authorized to use this operation with the given parameters.

InternalErrorException
server

An error on the server occurred during the processing of your request. Try again later.

InvalidNextTokenException
client

The pagination token is invalid.

InvalidParameterException
client

An error on the client occurred. Typically, the cause is an invalid input value.

ThrottlingException
client

The number of API requests has exceeded the maximum allowed API request throttling limit for the account.

BudgetsServiceException
Base exception class for all service exceptions from Budgets service.