Skip to content

BudgetsClient#

Index > Budgets > BudgetsClient

Auto-generated documentation for Budgets type annotations stubs module mypy-boto3-budgets.

BudgetsClient#

Type annotations and code completion for boto3.client("budgets"). boto3 documentation

# BudgetsClient usage example

from boto3.session import Session
from mypy_boto3_budgets.client import BudgetsClient

def get_budgets_client() -> BudgetsClient:
    return Session().client("budgets")

Exceptions#

boto3 client exceptions are generated in runtime. This class provides code completion for boto3.client("budgets").exceptions structure.

# Exceptions.exceptions usage example

client = boto3.client("budgets")

try:
    do_something(client)
except (
    client.exceptions.AccessDeniedException,
    client.exceptions.ClientError,
    client.exceptions.CreationLimitExceededException,
    client.exceptions.DuplicateRecordException,
    client.exceptions.ExpiredNextTokenException,
    client.exceptions.InternalErrorException,
    client.exceptions.InvalidNextTokenException,
    client.exceptions.InvalidParameterException,
    client.exceptions.NotFoundException,
    client.exceptions.ResourceLockedException,
    client.exceptions.ServiceQuotaExceededException,
    client.exceptions.ThrottlingException,
) as e:
    print(e)
# Exceptions.exceptions type checking example

from mypy_boto3_budgets.client import Exceptions

def handle_error(exc: Exceptions.AccessDeniedException) -> None:
    ...

Methods#

can_paginate#

Check if an operation can be paginated.

Type annotations and code completion for boto3.client("budgets").can_paginate method. boto3 documentation

# can_paginate method definition

def can_paginate(
    self,
    operation_name: str,
) -> bool:
    ...

close#

Closes underlying endpoint connections.

Type annotations and code completion for boto3.client("budgets").close method. boto3 documentation

# close method definition

def close(
    self,
) -> None:
    ...

create_budget#

Creates a budget and, if included, notifications and subscribers.

Type annotations and code completion for boto3.client("budgets").create_budget method. boto3 documentation

# create_budget method definition

def create_budget(
    self,
    *,
    AccountId: str,
    Budget: BudgetTypeDef,  # (1)
    NotificationsWithSubscribers: Sequence[NotificationWithSubscribersTypeDef] = ...,  # (2)
    ResourceTags: Sequence[ResourceTagTypeDef] = ...,  # (3)
) -> Dict[str, Any]:
    ...
  1. See BudgetTypeDef
  2. See NotificationWithSubscribersTypeDef
  3. See ResourceTagTypeDef 
# create_budget method usage example with argument unpacking

kwargs: CreateBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "Budget": ...,
}

parent.create_budget(**kwargs)
  1. See CreateBudgetRequestRequestTypeDef

create_budget_action#

Creates a budget action.

Type annotations and code completion for boto3.client("budgets").create_budget_action method. boto3 documentation

# create_budget_action method definition

def create_budget_action(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    NotificationType: NotificationTypeType,  # (1)
    ActionType: ActionTypeType,  # (2)
    ActionThreshold: ActionThresholdTypeDef,  # (3)
    Definition: DefinitionTypeDef,  # (4)
    ExecutionRoleArn: str,
    ApprovalModel: ApprovalModelType,  # (5)
    Subscribers: Sequence[SubscriberTypeDef],  # (6)
    ResourceTags: Sequence[ResourceTagTypeDef] = ...,  # (7)
) -> CreateBudgetActionResponseTypeDef:  # (8)
    ...
  1. See NotificationTypeType
  2. See ActionTypeType
  3. See ActionThresholdTypeDef
  4. See DefinitionTypeDef
  5. See ApprovalModelType
  6. See SubscriberTypeDef
  7. See ResourceTagTypeDef
  8. See CreateBudgetActionResponseTypeDef 
# create_budget_action method usage example with argument unpacking

kwargs: CreateBudgetActionRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "NotificationType": ...,
    "ActionType": ...,
    "ActionThreshold": ...,
    "Definition": ...,
    "ExecutionRoleArn": ...,
    "ApprovalModel": ...,
    "Subscribers": ...,
}

parent.create_budget_action(**kwargs)
  1. See CreateBudgetActionRequestRequestTypeDef

create_notification#

Creates a notification.

Type annotations and code completion for boto3.client("budgets").create_notification method. boto3 documentation

# create_notification method definition

def create_notification(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
    Subscribers: Sequence[SubscriberTypeDef],  # (2)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef
  2. See SubscriberTypeDef 
# create_notification method usage example with argument unpacking

kwargs: CreateNotificationRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
    "Subscribers": ...,
}

parent.create_notification(**kwargs)
  1. See CreateNotificationRequestRequestTypeDef

create_subscriber#

Creates a subscriber.

Type annotations and code completion for boto3.client("budgets").create_subscriber method. boto3 documentation

# create_subscriber method definition

def create_subscriber(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
    Subscriber: SubscriberTypeDef,  # (2)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef
  2. See SubscriberTypeDef 
# create_subscriber method usage example with argument unpacking

kwargs: CreateSubscriberRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
    "Subscriber": ...,
}

parent.create_subscriber(**kwargs)
  1. See CreateSubscriberRequestRequestTypeDef

delete_budget#

Deletes a budget.

Type annotations and code completion for boto3.client("budgets").delete_budget method. boto3 documentation

# delete_budget method definition

def delete_budget(
    self,
    *,
    AccountId: str,
    BudgetName: str,
) -> Dict[str, Any]:
    ...
# delete_budget method usage example with argument unpacking

kwargs: DeleteBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
}

parent.delete_budget(**kwargs)
  1. See DeleteBudgetRequestRequestTypeDef

delete_budget_action#

Deletes a budget action.

Type annotations and code completion for boto3.client("budgets").delete_budget_action method. boto3 documentation

# delete_budget_action method definition

def delete_budget_action(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    ActionId: str,
) -> DeleteBudgetActionResponseTypeDef:  # (1)
    ...
  1. See DeleteBudgetActionResponseTypeDef 
# delete_budget_action method usage example with argument unpacking

kwargs: DeleteBudgetActionRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "ActionId": ...,
}

parent.delete_budget_action(**kwargs)
  1. See DeleteBudgetActionRequestRequestTypeDef

delete_notification#

Deletes a notification.

Type annotations and code completion for boto3.client("budgets").delete_notification method. boto3 documentation

# delete_notification method definition

def delete_notification(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef 
# delete_notification method usage example with argument unpacking

kwargs: DeleteNotificationRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
}

parent.delete_notification(**kwargs)
  1. See DeleteNotificationRequestRequestTypeDef

delete_subscriber#

Deletes a subscriber.

Type annotations and code completion for boto3.client("budgets").delete_subscriber method. boto3 documentation

# delete_subscriber method definition

def delete_subscriber(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
    Subscriber: SubscriberTypeDef,  # (2)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef
  2. See SubscriberTypeDef 
# delete_subscriber method usage example with argument unpacking

kwargs: DeleteSubscriberRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
    "Subscriber": ...,
}

parent.delete_subscriber(**kwargs)
  1. See DeleteSubscriberRequestRequestTypeDef

describe_budget#

Describes a budget.

Type annotations and code completion for boto3.client("budgets").describe_budget method. boto3 documentation

# describe_budget method definition

def describe_budget(
    self,
    *,
    AccountId: str,
    BudgetName: str,
) -> DescribeBudgetResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetResponseTypeDef 
# describe_budget method usage example with argument unpacking

kwargs: DescribeBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
}

parent.describe_budget(**kwargs)
  1. See DescribeBudgetRequestRequestTypeDef

describe_budget_action#

Describes a budget action detail.

Type annotations and code completion for boto3.client("budgets").describe_budget_action method. boto3 documentation

# describe_budget_action method definition

def describe_budget_action(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    ActionId: str,
) -> DescribeBudgetActionResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetActionResponseTypeDef 
# describe_budget_action method usage example with argument unpacking

kwargs: DescribeBudgetActionRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "ActionId": ...,
}

parent.describe_budget_action(**kwargs)
  1. See DescribeBudgetActionRequestRequestTypeDef

describe_budget_action_histories#

Describes a budget action history detail.

Type annotations and code completion for boto3.client("budgets").describe_budget_action_histories method. boto3 documentation

# describe_budget_action_histories method definition

def describe_budget_action_histories(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    ActionId: str,
    TimePeriod: TimePeriodTypeDef = ...,  # (1)
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetActionHistoriesResponseTypeDef:  # (2)
    ...
  1. See TimePeriodTypeDef
  2. See DescribeBudgetActionHistoriesResponseTypeDef 
# describe_budget_action_histories method usage example with argument unpacking

kwargs: DescribeBudgetActionHistoriesRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "ActionId": ...,
}

parent.describe_budget_action_histories(**kwargs)
  1. See DescribeBudgetActionHistoriesRequestRequestTypeDef

describe_budget_actions_for_account#

Describes all of the budget actions for an account.

Type annotations and code completion for boto3.client("budgets").describe_budget_actions_for_account method. boto3 documentation

# describe_budget_actions_for_account method definition

def describe_budget_actions_for_account(
    self,
    *,
    AccountId: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetActionsForAccountResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetActionsForAccountResponseTypeDef 
# describe_budget_actions_for_account method usage example with argument unpacking

kwargs: DescribeBudgetActionsForAccountRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
}

parent.describe_budget_actions_for_account(**kwargs)
  1. See DescribeBudgetActionsForAccountRequestRequestTypeDef

describe_budget_actions_for_budget#

Describes all of the budget actions for a budget.

Type annotations and code completion for boto3.client("budgets").describe_budget_actions_for_budget method. boto3 documentation

# describe_budget_actions_for_budget method definition

def describe_budget_actions_for_budget(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetActionsForBudgetResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetActionsForBudgetResponseTypeDef 
# describe_budget_actions_for_budget method usage example with argument unpacking

kwargs: DescribeBudgetActionsForBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
}

parent.describe_budget_actions_for_budget(**kwargs)
  1. See DescribeBudgetActionsForBudgetRequestRequestTypeDef

describe_budget_notifications_for_account#

Lists the budget names and notifications that are associated with an account.

Type annotations and code completion for boto3.client("budgets").describe_budget_notifications_for_account method. boto3 documentation

# describe_budget_notifications_for_account method definition

def describe_budget_notifications_for_account(
    self,
    *,
    AccountId: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetNotificationsForAccountResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetNotificationsForAccountResponseTypeDef 
# describe_budget_notifications_for_account method usage example with argument unpacking

kwargs: DescribeBudgetNotificationsForAccountRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
}

parent.describe_budget_notifications_for_account(**kwargs)
  1. See DescribeBudgetNotificationsForAccountRequestRequestTypeDef

describe_budget_performance_history#

Describes the history for DAILY, MONTHLY, and QUARTERLY budgets.

Type annotations and code completion for boto3.client("budgets").describe_budget_performance_history method. boto3 documentation

# describe_budget_performance_history method definition

def describe_budget_performance_history(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    TimePeriod: TimePeriodTypeDef = ...,  # (1)
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetPerformanceHistoryResponseTypeDef:  # (2)
    ...
  1. See TimePeriodTypeDef
  2. See DescribeBudgetPerformanceHistoryResponseTypeDef 
# describe_budget_performance_history method usage example with argument unpacking

kwargs: DescribeBudgetPerformanceHistoryRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
}

parent.describe_budget_performance_history(**kwargs)
  1. See DescribeBudgetPerformanceHistoryRequestRequestTypeDef

describe_budgets#

Lists the budgets that are associated with an account.

Type annotations and code completion for boto3.client("budgets").describe_budgets method. boto3 documentation

# describe_budgets method definition

def describe_budgets(
    self,
    *,
    AccountId: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeBudgetsResponseTypeDef:  # (1)
    ...
  1. See DescribeBudgetsResponseTypeDef 
# describe_budgets method usage example with argument unpacking

kwargs: DescribeBudgetsRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
}

parent.describe_budgets(**kwargs)
  1. See DescribeBudgetsRequestRequestTypeDef

describe_notifications_for_budget#

Lists the notifications that are associated with a budget.

Type annotations and code completion for boto3.client("budgets").describe_notifications_for_budget method. boto3 documentation

# describe_notifications_for_budget method definition

def describe_notifications_for_budget(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeNotificationsForBudgetResponseTypeDef:  # (1)
    ...
  1. See DescribeNotificationsForBudgetResponseTypeDef 
# describe_notifications_for_budget method usage example with argument unpacking

kwargs: DescribeNotificationsForBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
}

parent.describe_notifications_for_budget(**kwargs)
  1. See DescribeNotificationsForBudgetRequestRequestTypeDef

describe_subscribers_for_notification#

Lists the subscribers that are associated with a notification.

Type annotations and code completion for boto3.client("budgets").describe_subscribers_for_notification method. boto3 documentation

# describe_subscribers_for_notification method definition

def describe_subscribers_for_notification(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
    MaxResults: int = ...,
    NextToken: str = ...,
) -> DescribeSubscribersForNotificationResponseTypeDef:  # (2)
    ...
  1. See NotificationTypeDef
  2. See DescribeSubscribersForNotificationResponseTypeDef 
# describe_subscribers_for_notification method usage example with argument unpacking

kwargs: DescribeSubscribersForNotificationRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
}

parent.describe_subscribers_for_notification(**kwargs)
  1. See DescribeSubscribersForNotificationRequestRequestTypeDef

execute_budget_action#

Executes a budget action.

Type annotations and code completion for boto3.client("budgets").execute_budget_action method. boto3 documentation

# execute_budget_action method definition

def execute_budget_action(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    ActionId: str,
    ExecutionType: ExecutionTypeType,  # (1)
) -> ExecuteBudgetActionResponseTypeDef:  # (2)
    ...
  1. See ExecutionTypeType
  2. See ExecuteBudgetActionResponseTypeDef 
# execute_budget_action method usage example with argument unpacking

kwargs: ExecuteBudgetActionRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "ActionId": ...,
    "ExecutionType": ...,
}

parent.execute_budget_action(**kwargs)
  1. See ExecuteBudgetActionRequestRequestTypeDef

generate_presigned_url#

Generate a presigned url given a client, its method, and arguments.

Type annotations and code completion for boto3.client("budgets").generate_presigned_url method. boto3 documentation

# generate_presigned_url method definition

def generate_presigned_url(
    self,
    ClientMethod: str,
    Params: Mapping[str, Any] = ...,
    ExpiresIn: int = 3600,
    HttpMethod: str = ...,
) -> str:
    ...

list_tags_for_resource#

Lists tags associated with a budget or budget action resource.

Type annotations and code completion for boto3.client("budgets").list_tags_for_resource method. boto3 documentation

# list_tags_for_resource method definition

def list_tags_for_resource(
    self,
    *,
    ResourceARN: str,
) -> ListTagsForResourceResponseTypeDef:  # (1)
    ...
  1. See ListTagsForResourceResponseTypeDef 
# list_tags_for_resource method usage example with argument unpacking

kwargs: ListTagsForResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
}

parent.list_tags_for_resource(**kwargs)
  1. See ListTagsForResourceRequestRequestTypeDef

tag_resource#

Creates tags for a budget or budget action resource.

Type annotations and code completion for boto3.client("budgets").tag_resource method. boto3 documentation

# tag_resource method definition

def tag_resource(
    self,
    *,
    ResourceARN: str,
    ResourceTags: Sequence[ResourceTagTypeDef],  # (1)
) -> Dict[str, Any]:
    ...
  1. See ResourceTagTypeDef 
# tag_resource method usage example with argument unpacking

kwargs: TagResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "ResourceTags": ...,
}

parent.tag_resource(**kwargs)
  1. See TagResourceRequestRequestTypeDef

untag_resource#

Deletes tags associated with a budget or budget action resource.

Type annotations and code completion for boto3.client("budgets").untag_resource method. boto3 documentation

# untag_resource method definition

def untag_resource(
    self,
    *,
    ResourceARN: str,
    ResourceTagKeys: Sequence[str],
) -> Dict[str, Any]:
    ...
# untag_resource method usage example with argument unpacking

kwargs: UntagResourceRequestRequestTypeDef = {  # (1)
    "ResourceARN": ...,
    "ResourceTagKeys": ...,
}

parent.untag_resource(**kwargs)
  1. See UntagResourceRequestRequestTypeDef

update_budget#

Updates a budget.

Type annotations and code completion for boto3.client("budgets").update_budget method. boto3 documentation

# update_budget method definition

def update_budget(
    self,
    *,
    AccountId: str,
    NewBudget: BudgetTypeDef,  # (1)
) -> Dict[str, Any]:
    ...
  1. See BudgetTypeDef 
# update_budget method usage example with argument unpacking

kwargs: UpdateBudgetRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "NewBudget": ...,
}

parent.update_budget(**kwargs)
  1. See UpdateBudgetRequestRequestTypeDef

update_budget_action#

Updates a budget action.

Type annotations and code completion for boto3.client("budgets").update_budget_action method. boto3 documentation

# update_budget_action method definition

def update_budget_action(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    ActionId: str,
    NotificationType: NotificationTypeType = ...,  # (1)
    ActionThreshold: ActionThresholdTypeDef = ...,  # (2)
    Definition: DefinitionTypeDef = ...,  # (3)
    ExecutionRoleArn: str = ...,
    ApprovalModel: ApprovalModelType = ...,  # (4)
    Subscribers: Sequence[SubscriberTypeDef] = ...,  # (5)
) -> UpdateBudgetActionResponseTypeDef:  # (6)
    ...
  1. See NotificationTypeType
  2. See ActionThresholdTypeDef
  3. See DefinitionTypeDef
  4. See ApprovalModelType
  5. See SubscriberTypeDef
  6. See UpdateBudgetActionResponseTypeDef 
# update_budget_action method usage example with argument unpacking

kwargs: UpdateBudgetActionRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "ActionId": ...,
}

parent.update_budget_action(**kwargs)
  1. See UpdateBudgetActionRequestRequestTypeDef

update_notification#

Updates a notification.

Type annotations and code completion for boto3.client("budgets").update_notification method. boto3 documentation

# update_notification method definition

def update_notification(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    OldNotification: NotificationTypeDef,  # (1)
    NewNotification: NotificationTypeDef,  # (1)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef
  2. See NotificationTypeDef 
# update_notification method usage example with argument unpacking

kwargs: UpdateNotificationRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "OldNotification": ...,
    "NewNotification": ...,
}

parent.update_notification(**kwargs)
  1. See UpdateNotificationRequestRequestTypeDef

update_subscriber#

Updates a subscriber.

Type annotations and code completion for boto3.client("budgets").update_subscriber method. boto3 documentation

# update_subscriber method definition

def update_subscriber(
    self,
    *,
    AccountId: str,
    BudgetName: str,
    Notification: NotificationTypeDef,  # (1)
    OldSubscriber: SubscriberTypeDef,  # (2)
    NewSubscriber: SubscriberTypeDef,  # (2)
) -> Dict[str, Any]:
    ...
  1. See NotificationTypeDef
  2. See SubscriberTypeDef
  3. See SubscriberTypeDef 
# update_subscriber method usage example with argument unpacking

kwargs: UpdateSubscriberRequestRequestTypeDef = {  # (1)
    "AccountId": ...,
    "BudgetName": ...,
    "Notification": ...,
    "OldSubscriber": ...,
    "NewSubscriber": ...,
}

parent.update_subscriber(**kwargs)
  1. See UpdateSubscriberRequestRequestTypeDef

get_paginator#

Type annotations and code completion for boto3.client("budgets").get_paginator method with overloads.