D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # AWS Budgets exemples utilisant AWS CLI Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du AWS Command Line Interface with AWS Budgets. Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés. Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `create-budget` L'exemple de code suivant montre comment utiliser`create-budget`. **AWS CLI** **Pour créer un budget de coûts et d’utilisation** La commande `create-budget` suivante crée un budget de coûts et d’utilisation. ``` aws budgets create-budget \ --account-id 111122223333 \ --budget file://budget.json \ --notifications-with-subscribers file://notifications-with-subscribers.json ``` Contenu 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" } ``` Contenu de `notifications-with-subscribers.json` : ``` [ { "Notification": { "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL", "Threshold": 80, "ThresholdType": "PERCENTAGE" }, "Subscribers": [ { "Address": "example@example.com", "SubscriptionType": "EMAIL" } ] } ] ``` + Pour plus de détails sur l'API, reportez-vous [CreateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-budget.html)à la section *Référence des AWS CLI commandes*. ### `create-notification` L'exemple de code suivant montre comment utiliser`create-notification`. **AWS CLI** **Pour créer une notification pour le budget de coûts et d’utilisation spécifié** Cet exemple crée une notification pour le budget de coûts et d’utilisation spécifié. Commande : ``` 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 ``` + Pour plus de détails sur l'API, reportez-vous [CreateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-notification.html)à la section *Référence des AWS CLI commandes*. ### `create-subscriber` L'exemple de code suivant montre comment utiliser`create-subscriber`. **AWS CLI** **Pour créer un abonné pour une notification associée à un budget de coûts et d’utilisation** Cet exemple crée un abonné pour la notification spécifiée. Commande : ``` 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 ``` + Pour plus de détails sur l'API, reportez-vous [CreateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/create-subscriber.html)à la section *Référence des AWS CLI commandes*. ### `delete-budget` L'exemple de code suivant montre comment utiliser`delete-budget`. **AWS CLI** **Pour supprimer un budget de coûts et d’utilisation** Cet exemple supprime le budget de coûts et d’utilisation spécifié. Commande : ``` aws budgets delete-budget --account-id 111122223333 --budget-name "Example Budget" ``` + Pour plus de détails sur l'API, reportez-vous [DeleteBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-budget.html)à la section *Référence des AWS CLI commandes*. ### `delete-notification` L'exemple de code suivant montre comment utiliser`delete-notification`. **AWS CLI** **Pour supprimer une notification d’un budget** Cet exemple supprime la notification spécifiée du budget spécifié. Commande : ``` aws budgets delete-notification --account-id 111122223333 --budget-name "Example Budget" --notification NotificationType=ACTUAL,ComparisonOperator=GREATER_THAN,Threshold=80,ThresholdType=PERCENTAGE ``` + Pour plus de détails sur l'API, reportez-vous [DeleteNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-notification.html)à la section *Référence des AWS CLI commandes*. ### `delete-subscriber` L'exemple de code suivant montre comment utiliser`delete-subscriber`. **AWS CLI** **Pour supprimer un abonné d’une notification** Cet exemple supprime l’abonné spécifié de la notification spécifiée. Commande : ``` 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 ``` + Pour plus de détails sur l'API, reportez-vous [DeleteSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/delete-subscriber.html)à la section *Référence des AWS CLI commandes*. ### `describe-budget` L'exemple de code suivant montre comment utiliser`describe-budget`. **AWS CLI** **Pour extraire un budget associé à un compte** Cet exemple extrait le budget de coûts et d’utilisation spécifié. Commande : ``` aws budgets describe-budget --account-id 111122223333 --budget-name "Example Budget" ``` Sortie : ``` { "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" ] } } } ``` + Pour plus de détails sur l'API, reportez-vous [DescribeBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budget.html)à la section *Référence des AWS CLI commandes*. ### `describe-budgets` L'exemple de code suivant montre comment utiliser`describe-budgets`. **AWS CLI** **Pour extraire les budgets associés à un compte** Cet exemple extrait les budgets de coûts et d’utilisation d’un compte. Commande : ``` aws budgets describe-budgets --account-id 111122223333 --max-results 20 ``` Sortie : ``` { "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" ] } } ] } ``` + Pour plus de détails sur l'API, reportez-vous [DescribeBudgets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-budgets.html)à la section *Référence des AWS CLI commandes*. ### `describe-notifications-for-budget` L'exemple de code suivant montre comment utiliser`describe-notifications-for-budget`. **AWS CLI** **Pour extraire les notifications relatives à un budget** Cet exemple extrait les notifications relatives à un budget de coûts et d’utilisation. Commande : ``` aws budgets describe-notifications-for-budget --account-id 111122223333 --budget-name "Example Budget" --max-results 5 ``` Sortie : ``` { "Notifications": [ { "Threshold": 80.0, "ComparisonOperator": "GREATER_THAN", "NotificationType": "ACTUAL" } ] } ``` + Pour plus de détails sur l'API, reportez-vous [DescribeNotificationsForBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-notifications-for-budget.html)à la section *Référence des AWS CLI commandes*. ### `describe-subscribers-for-notification` L'exemple de code suivant montre comment utiliser`describe-subscribers-for-notification`. **AWS CLI** **Pour extraire les abonnés à une notification relative au budget** Cet exemple extrait les abonnés à une notification relative au budget de coûts et d’utilisation. Commande : ``` 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 ``` Sortie : ``` { "Subscribers": [ { "SubscriptionType": "EMAIL", "Address": "example2@example.com" }, { "SubscriptionType": "EMAIL", "Address": "example@example.com" } ] } ``` + Pour plus de détails sur l'API, reportez-vous [DescribeSubscribersForNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/describe-subscribers-for-notification.html)à la section *Référence des AWS CLI commandes*. ### `update-budget` L'exemple de code suivant montre comment utiliser`update-budget`. **AWS CLI** **Pour remplacer un budget par un budget de coûts et d’utilisation** Cet exemple remplace un budget de coûts et d’utilisation par un nouveau budget. Commande : ``` 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" } ``` + Pour plus de détails sur l'API, reportez-vous [UpdateBudget](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-budget.html)à la section *Référence des AWS CLI commandes*. ### `update-notification` L'exemple de code suivant montre comment utiliser`update-notification`. **AWS CLI** **Pour remplacer une notification relative à un budget de coûts et d’utilisation** Cet exemple remplace une notification de 80 % pour un budget de coûts et d’utilisation par une notification de 90 %. Commande : ``` 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 ``` + Pour plus de détails sur l'API, reportez-vous [UpdateNotification](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-notification.html)à la section *Référence des AWS CLI commandes*. ### `update-subscriber` L'exemple de code suivant montre comment utiliser`update-subscriber`. **AWS CLI** **Pour remplacer un abonné à un budget de coûts et d’utilisation** Cet exemple remplace l’abonné à un budget de coûts et d’utilisation. Commande : ``` 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 ``` + Pour plus de détails sur l'API, reportez-vous [UpdateSubscriber](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/budgets/update-subscriber.html)à la section *Référence des AWS CLI commandes*.