Cette documentation concerne AWS CLI uniquement la version 1 du. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.
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.
Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du service AWS Command Line Interface with Cost Explorer.
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 façon de configurer et d'exécuter le code en contexte.
Rubriques
Actions
L'exemple de code suivant montre comment utiliserget-cost-and-usage.
- AWS CLI
-
Pour récupérer l'utilisation S3 d'un compte pour le mois de septembre 2017
L'
get-cost-and-usageexemple suivant récupère l'utilisation S3 d'un compte pour le mois de septembre 2017.aws ce get-cost-and-usage \ --time-periodStart=2017-09-01,End=2017-10-01\ --granularityMONTHLY\ --metrics"BlendedCost""UnblendedCost""UsageQuantity"\ --group-byType=DIMENSION,Key=SERVICEType=TAG,Key=Environment\ --filterfile://filters.jsonContenu de
filters.json:{ "Dimensions": { "Key": "SERVICE", "Values": [ "Amazon Simple Storage Service" ] } }Sortie :
{ "GroupDefinitions": [ { "Type": "DIMENSION", "Key": "SERVICE" }, { "Type": "TAG", "Key": "Environment" } ], "ResultsByTime": [ { "Estimated": false, "TimePeriod": { "Start": "2017-09-01", "End": "2017-10-01" }, "Total": {}, "Groups": [ { "Keys": [ "Amazon Simple Storage Service", "Environment$" ], "Metrics": { "BlendedCost": { "Amount": "40.3527508453", "Unit": "USD" }, "UnblendedCost": { "Amount": "40.3543773134", "Unit": "USD" }, "UsageQuantity": { "Amount": "9312771.098461578", "Unit": "N/A" } } }, { "Keys": [ "Amazon Simple Storage Service", "Environment$Dev" ], "Metrics": { "BlendedCost": { "Amount": "0.2682364644", "Unit": "USD" }, "UnblendedCost": { "Amount": "0.2682364644", "Unit": "USD" }, "UsageQuantity": { "Amount": "22403.4395271182", "Unit": "N/A" } } } ] } ] }-
Pour plus de détails sur l'API, reportez-vous GetCostAndUsage
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-dimension-values.
- AWS CLI
-
Pour récupérer les balises de la dimension SERVICE, avec la valeur « Elastic »
Cet exemple extrait les balises de la dimension SERVICE, avec une valeur « Elastic » pour la période allant du 1er janvier 2017 au 18 mai 2017.
Commande :
aws ce get-dimension-values --search-stringElastic--time-periodStart=2017-01-01,End=2017-05-18--dimensionSERVICESortie :
{ "TotalSize": 6, "DimensionValues": [ { "Attributes": {}, "Value": "Amazon ElastiCache" }, { "Attributes": {}, "Value": "EC2 - Other" }, { "Attributes": {}, "Value": "Amazon Elastic Compute Cloud - Compute" }, { "Attributes": {}, "Value": "Amazon Elastic Load Balancing" }, { "Attributes": {}, "Value": "Amazon Elastic MapReduce" }, { "Attributes": {}, "Value": "Amazon Elasticsearch Service" } ], "ReturnSize": 6 }-
Pour plus de détails sur l'API, reportez-vous GetDimensionValues
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-reservation-coverage.
- AWS CLI
-
Pour récupérer la couverture des réservations pour les instances EC2 t2.nano dans la région us-east-1
Cet exemple permet de récupérer la couverture des réservations pour les instances EC2 t2.nano dans la région us-east-1 entre juillet et septembre 2017.
Commande :
aws ce get-reservation-coverage --time-periodStart=2017-07-01,End=2017-10-01--group-byType=Dimension,Key=REGION--filterfile://filters.jsonfiltres.json :
{ "And": [ { "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] }, "Dimensions": { "Key": "REGION", "Values": [ "us-east-1" ] } } ] }Sortie :
{ "TotalSize": 6, "DimensionValues": [ { "Attributes": {}, "Value": "Amazon ElastiCache" }, { "Attributes": {}, "Value": "EC2 - Other" }, { "Attributes": {}, "Value": "Amazon Elastic Compute Cloud - Compute" }, { "Attributes": {}, "Value": "Amazon Elastic Load Balancing" }, { "Attributes": {}, "Value": "Amazon Elastic MapReduce" }, { "Attributes": {}, "Value": "Amazon Elasticsearch Service" } ], "ReturnSize": 6 }-
Pour plus de détails sur l'API, reportez-vous GetReservationCoverage
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-reservation-purchase-recommendation.
- AWS CLI
-
Pour récupérer les recommandations de réservation pour une réservation initiale partielle d' EC2 RIs une durée de trois ans
L'
get-reservation-purchase-recommendationexemple suivant extrait des recommandations pour les EC2 instances partielles initiales d'une durée de trois ans, sur la base des 60 derniers jours d' EC2 utilisation.aws ce get-reservation-purchase-recommendation \ --service"Amazon Redshift"\ --lookback-period-in-daysSIXTY_DAYS\ --term-in-yearsTHREE_YEARS\ --payment-optionPARTIAL_UPFRONTSortie :
{ "Recommendations": [], "Metadata": { "GenerationTimestamp": "2018-08-08T15:20:57Z", "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b" } }-
Pour plus de détails sur l'API, reportez-vous GetReservationPurchaseRecommendation
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-reservation-utilization.
- AWS CLI
-
Pour récupérer l'utilisation des réservations pour votre compte
L'
get-reservation-utilizationexemple suivant récupère l'utilisation du RI pour tous les types d'instances t2.nano entre le 01/03/2018 et le 01/08/2018 pour le compte.aws ce get-reservation-utilization \ --time-periodStart=2018-03-01,End=2018-08-01\ --filterfile://filters.jsonContenu de
filters.json:{ "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] } }Sortie :
{ "Total": { "TotalAmortizedFee": "0", "UtilizationPercentage": "0", "PurchasedHours": "0", "NetRISavings": "0", "TotalActualHours": "0", "AmortizedRecurringFee": "0", "UnusedHours": "0", "TotalPotentialRISavings": "0", "OnDemandCostOfRIHoursUsed": "0", "AmortizedUpfrontFee": "0" }, "UtilizationsByTime": [] }-
Pour plus de détails sur l'API, reportez-vous GetReservationUtilization
à la section Référence des AWS CLI commandes.
-
L'exemple de code suivant montre comment utiliserget-tags.
- AWS CLI
-
Pour récupérer les clés et les valeurs d'une balise de répartition des coûts
Cet exemple extrait toutes les balises de répartition des coûts dont la clé est « Project » et une valeur contenant « SecretProject ».
Commande :
aws ce get-tags --search-stringsecretProject--time-periodStart=2017-01-01,End=2017-05-18--tag-keyProjectSortie :
{ "ReturnSize": 2, "Tags": [ "secretProject1", "secretProject2" ], "TotalSize": 2 }-
Pour plus de détails sur l'API, reportez-vous GetTags
à la section Référence des AWS CLI commandes.
-
