Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
En los siguientes ejemplos de código se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con AWS Budgets.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar create-budget.
- AWS CLI
-
Creación de un presupuesto de costos y uso
En el siguiente comando de
create-budget, se crea un presupuesto de costos y uso.aws budgets create-budget \ --account-id111122223333\ --budgetfile://budget.json\ --notifications-with-subscribersfile://notifications-with-subscribers.jsonContenido de
budget.json:{ "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Tag Budget", "BudgetType": "COST", "CostFilters": { "TagKeyValue": [ "user:Key$value1", "user:Key$value2" ] }, "CostTypes": { "IncludeCredit": true, "IncludeDiscount": true, "IncludeOtherSubscription": true, "IncludeRecurring": true, "IncludeRefund": true, "IncludeSubscription": true, "IncludeSupport": true, "IncludeTax": true, "IncludeUpfront": true, "UseBlended": false }, "TimePeriod": { "Start": 1477958399, "End": 3706473600 }, "TimeUnit": "MONTHLY" }Contenido de
notifications-with-subscribers.json:[ { "Notification": { "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL", "Threshold": 80, "ThresholdType": "PERCENTAGE" }, "Subscribers": [ { "Address": "example@example.com", "SubscriptionType": "EMAIL" } ] } ]-
Para obtener información sobre la API, consulte CreateBudget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-notification.
- AWS CLI
-
Creación de una notificación para el presupuesto de costos y uso especificado
En este ejemplo, se crea una notificación para el presupuesto de costos y uso especificado.
Comando:
aws budgets create-notification --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--subscriberSubscriptionType=EMAIL,Address=example@example.com-
Para obtener información sobre la API, consulte CreateNotification
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar create-subscriber.
- AWS CLI
-
Creación de un suscriptor para una notificación asociada a un presupuesto de costos y uso
En este ejemplo, se crea un suscriptor para la notificación especificada.
Comando:
aws budgets create-subscriber --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--subscriberSubscriptionType=EMAIL,Address=example@example.com-
Para obtener información sobre la API, consulte CreateSubscriber
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-budget.
- AWS CLI
-
Eliminación de un presupuesto de costos y uso
En este ejemplo, se elimina el presupuesto de costos y uso especificado.
Comando:
aws budgets delete-budget --account-id111122223333--budget-name"Example Budget"-
Para obtener información sobre la API, consulte DeleteBudget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-notification.
- AWS CLI
-
Eliminación de una notificación de un presupuesto
En este ejemplo, se elimina la notificación especificada del presupuesto especificado.
Comando:
aws budgets delete-notification --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE-
Para obtener información sobre la API, consulte DeleteNotification
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar delete-subscriber.
- AWS CLI
-
Eliminación de un suscriptor de una notificación
En este ejemplo, se elimina el suscriptor especificado de la notificación especificada.
Comando:
aws budgets delete-subscriber --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--subscriberSubscriptionType=EMAIL,Address=example@example.com-
Para obtener información sobre la API, consulte DeleteSubscriber
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-budget.
- AWS CLI
-
Recuperación de un presupuesto asociado a una cuenta
En este ejemplo, se recupera el presupuesto de costos y uso especificado.
Comando:
aws budgets describe-budget --account-id111122223333--budget-name"Example Budget"Salida:
{ "Budget": { "CalculatedSpend": { "ForecastedSpend": { "Amount": "2641.54800000000022919266484677791595458984375", "Unit": "USD" }, "ActualSpend": { "Amount": "604.4560000000000172803993336856365203857421875", "Unit": "USD" } }, "BudgetType": "COST", "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "CostTypes": { "IncludeOtherSubscription": true, "IncludeUpfront": true, "IncludeRefund": true, "UseBlended": false, "IncludeDiscount": true, "UseAmortized": false, "IncludeTax": true, "IncludeCredit": true, "IncludeSupport": true, "IncludeRecurring": true, "IncludeSubscription": true }, "TimeUnit": "MONTHLY", "TimePeriod": { "Start": 1477958399.0, "End": 3706473600.0 }, "CostFilters": { "AZ": [ "us-east-1" ] } } }-
Para obtener información sobre la API, consulte DescribeBudget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-budgets.
- AWS CLI
-
Recuperación de los presupuestos asociados a una cuenta
En este ejemplo, se recuperan los presupuestos de costos y uso de una cuenta.
Comando:
aws budgets describe-budgets --account-id111122223333--max-results20Salida:
{ "Budgets": [ { "CalculatedSpend": { "ForecastedSpend": { "Amount": "2641.54800000000022919266484677791595458984375", "Unit": "USD" }, "ActualSpend": { "Amount": "604.4560000000000172803993336856365203857421875", "Unit": "USD" } }, "BudgetType": "COST", "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "CostTypes": { "IncludeOtherSubscription": true, "IncludeUpfront": true, "IncludeRefund": true, "UseBlended": false, "IncludeDiscount": true, "UseAmortized": false, "IncludeTax": true, "IncludeCredit": true, "IncludeSupport": true, "IncludeRecurring": true, "IncludeSubscription": true }, "TimeUnit": "MONTHLY", "TimePeriod": { "Start": 1477958399.0, "End": 3706473600.0 }, "CostFilters": { "AZ": [ "us-east-1" ] } } ] }-
Para obtener información sobre la API, consulte DescribeBudgets
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-notifications-for-budget.
- AWS CLI
-
Recuperación de las notificaciones de un presupuesto
En este ejemplo, se recuperan las notificaciones de un presupuesto de costos y uso.
Comando:
aws budgets describe-notifications-for-budget --account-id111122223333--budget-name"Example Budget"--max-results5Salida:
{ "Notifications": [ { "Threshold": 80.0, "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL" } ] }-
Para obtener información sobre la API, consulte DescribeNotificationsForBudget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar describe-subscribers-for-notification.
- AWS CLI
-
Recuperación de los suscriptores de una notificación de presupuesto
En este ejemplo, se recuperan los suscriptores de una notificación de presupuesto de costos y uso.
Comando:
aws budgets describe-subscribers-for-notification --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--max-results5Salida:
{ "Subscribers": [ { "SubscriptionType": "EMAIL", "Address": "example2@example.com" }, { "SubscriptionType": "EMAIL", "Address": "example@example.com" } ] }-
Para obtener información sobre la API, consulte DescribeSubscribersForNotification
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-budget.
- AWS CLI
-
Sustitución de un presupuesto por un presupuesto de costos y uso
En este ejemplo, se sustituye un presupuesto de costos y uso por otro nuevo.
Comando:
aws budgets update-budget --account-id111122223333--new-budgetfile://new-budget.jsonnew-budget.json:
{ "BudgetLimit": { "Amount": "100", "Unit": "USD" }, "BudgetName": "Example Budget", "BudgetType": "COST", "CostFilters": { "AZ" : [ "us-east-1" ] }, "CostTypes": { "IncludeCredit": false, "IncludeDiscount": true, "IncludeOtherSubscription": true, "IncludeRecurring": true, "IncludeRefund": true, "IncludeSubscription": true, "IncludeSupport": true, "IncludeTax": true, "IncludeUpfront": true, "UseBlended": false, "UseAmortized": true }, "TimePeriod": { "Start": 1477958399, "End": 3706473600 }, "TimeUnit": "MONTHLY" }-
Para obtener información sobre la API, consulte UpdateBudget
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-notification.
- AWS CLI
-
Creación de una notificación para un presupuesto de costos y uso
En este ejemplo, se sustituye una notificación del 80 % de un presupuesto de costos y uso por una notificación del 90 %.
Comando:
aws budgets update-notification --account-id111122223333--budget-name"Example Budget"--old-notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--new-notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE-
Para obtener información acerca de la API, consulte UpdateNotification
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar update-subscriber.
- AWS CLI
-
Sustitución de un suscriptor de un presupuesto de costos y uso
En este ejemplo, se sustituye un suscriptor de un presupuesto de costos y uso.
Comando:
aws budgets update-subscriber --account-id111122223333--budget-name"Example Budget"--notificationNotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE--old-subscriberSubscriptionType=EMAIL,Address=example@example.com--new-subscriberSubscriptionType=EMAIL,Address=example2@example.com-
Para obtener información sobre la API, consulte UpdateSubscriber
en la Referencia de comandos de la AWS CLI.
-
