AWS Budgets ejemplos que utilizan AWS CLI - AWS SDKEjemplos de código
Acciones

Hay más AWS SDK ejemplos disponibles en el GitHub repositorio de 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código se muestra cómo usar create-budget.

AWS CLI

Para crear un presupuesto de costos y uso

El siguiente create-budget comando crea un presupuesto de costo y uso.

aws budgets create-budget \
    --account-id 111122223333 \
    --budget file://budget.json \
    --notifications-with-subscribers file://notifications-with-subscribers.json

Contenidos 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"
}

Contenidos de notifications-with-subscribers.json:

[
    {
        "Notification": {
            "ComparisonOperator": "GREATER_THAN",
            "NotificationType": "ACTUAL",
            "Threshold": 80,
            "ThresholdType": "PERCENTAGE"
        },
        "Subscribers": [
            {
                "Address": "example@example.com",
                "SubscriptionType": "EMAIL"
            }
        ]
    }
]

  • Para API obtener más información, consulte CreateBudgetla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-notification.

AWS CLI

Para crear una notificación para el presupuesto de costes y uso especificado

En este ejemplo, se crea una notificación para el presupuesto de coste 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 API obtener más información, consulte CreateNotificationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar create-subscriber.

AWS CLI

Para crear un suscriptor para una notificación asociada a un presupuesto de costo 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 API obtener más información, consulte CreateSubscriberla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-budget.

AWS CLI

Para eliminar un presupuesto de costo y uso

En este ejemplo se elimina el presupuesto de coste y uso especificado.

Comando:

aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget"

  • Para API obtener más información, consulte DeleteBudgetla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-notification.

AWS CLI

Para eliminar 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 API obtener más información, consulte DeleteNotificationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar delete-subscriber.

AWS CLI

Para eliminar 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 API obtener más información, consulte DeleteSubscriberla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-budget.

AWS CLI

Para recuperar un presupuesto asociado a una cuenta

En este ejemplo, se recupera el presupuesto de coste 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 API obtener más información, consulte DescribeBudgetla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-budgets.

AWS CLI

Para recuperar los presupuestos asociados a una cuenta

En este ejemplo, se recuperan los presupuestos de coste 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 API obtener más información, consulte DescribeBudgetsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar describe-notifications-for-budget.

AWS CLI

Para recuperar las notificaciones de un presupuesto

En este ejemplo, se recuperan las notificaciones de un presupuesto de costo 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"
       }
   ]
}

En el siguiente ejemplo de código se muestra cómo usar describe-subscribers-for-notification.

AWS CLI

Para recuperar los suscriptores de una notificación de presupuesto

En este ejemplo, se recuperan los suscriptores de una notificación de presupuesto de costo 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"
       }
   ]
}

En el siguiente ejemplo de código se muestra cómo usar update-budget.

AWS CLI

Para reemplazar un presupuesto por un presupuesto de costo y uso

En este ejemplo, se reemplaza un presupuesto de costo y uso por uno 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 API más información, consulte la Referencia de comandos UpdateBudget.AWS CLI

En el siguiente ejemplo de código se muestra cómo usar update-notification.

AWS CLI

Para reemplazar una notificación por un presupuesto de costo y uso

En este ejemplo, se sustituye una notificación del 80% de un presupuesto de coste 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 API obtener más información, consulte UpdateNotificationla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código se muestra cómo usar update-subscriber.

AWS CLI

Para reemplazar un suscriptor por un presupuesto de costo y uso

En este ejemplo, se reemplaza al suscriptor por un presupuesto de costo 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 API obtener más información, consulte UpdateSubscriberla Referencia de AWS CLI comandos.