Hay más ejemplos de AWS SDK disponibles en el GitHub repositorio de [ejemplos de AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples).
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# AWS Budgets ejemplos que utilizan AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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.
**Topics**
+ [Acciones](#actions)
## Acciones
### `create-budget`
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-id 111122223333 \
--budget file://budget.json \
--notifications-with-subscribers file://notifications-with-subscribers.json
```
Contenido 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 más información sobre la API, consulte [CreateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-budget.html)la *Referencia de AWS CLI comandos*.
### `create-notification`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com
```
+ Para obtener más información sobre la API, consulte [CreateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-notification.html)la *Referencia de AWS CLI comandos*.
### `create-subscriber`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com
```
+ Para obtener más información sobre la API, consulte [CreateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-subscriber.html)la *Referencia de AWS CLI comandos*.
### `delete-budget`
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-id 111122223333 --budget-name "Example Budget"
```
+ Para obtener más información sobre la API, consulte [DeleteBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-budget.html)la *Referencia de AWS CLI comandos*.
### `delete-notification`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE
```
+ Para obtener más información sobre la API, consulte [DeleteNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-notification.html)la *Referencia de AWS CLI comandos*.
### `delete-subscriber`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --subscriber SubscriptionType=EMAIL,Address=example@example.com
```
+ Para obtener más información sobre la API, consulte [DeleteSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-subscriber.html)la *Referencia de AWS CLI comandos*.
### `describe-budget`
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-id 111122223333 --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 más información sobre la API, consulte [DescribeBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budget.html)la *Referencia de AWS CLI comandos*.
### `describe-budgets`
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-id 111122223333 --max-results 20
```
Salida:
```
{
"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 más información sobre la API, consulte [DescribeBudgets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budgets.html)la *Referencia de AWS CLI comandos*.
### `describe-notifications-for-budget`
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-id 111122223333 --budget-name "Example Budget" --max-results 5
```
Salida:
```
{
"Notifications": [
{
"Threshold": 80.0,
"ComparisonOperator": "GREATER_THAN",
"NotificationType": "ACTUAL"
}
]
}
```
+ Para obtener más información sobre la API, consulte [DescribeNotificationsForBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-notifications-for-budget.html)la *Referencia de AWS CLI comandos*.
### `describe-subscribers-for-notification`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --max-results 5
```
Salida:
```
{
"Subscribers": [
{
"SubscriptionType": "EMAIL",
"Address": "example2@example.com"
},
{
"SubscriptionType": "EMAIL",
"Address": "example@example.com"
}
]
}
```
+ Para obtener más información sobre la API, consulte [DescribeSubscribersForNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-subscribers-for-notification.html)la *Referencia de AWS CLI comandos*.
### `update-budget`
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-id 111122223333 --new-budget file://new-budget.json
```
new-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 más información sobre la API, consulte [UpdateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-budget.html)la *Referencia de AWS CLI comandos*.
### `update-notification`
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-id 111122223333 --budget-name "Example Budget" --old-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --new-notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=90,ThresholdType=PERCENTAGE
```
+ Para obtener más información sobre la API, consulte [UpdateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-notification.html)la *Referencia de AWS CLI comandos*.
### `update-subscriber`
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-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE --old-subscriber SubscriptionType=EMAIL,Address=example@example.com --new-subscriber SubscriptionType=EMAIL,Address=example2@example.com
```
+ Para obtener más información sobre la API, consulte [UpdateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-subscriber.html)la *Referencia de AWS CLI comandos*.