Exemples d’utilisation de l’AWS CLI avec Cost Explorer Service - AWS Command Line Interface
Actions

Exemples d’utilisation de l’AWS CLI avec Cost Explorer Service

Les exemples de code suivants montrent comment réaliser des actions et mettre en œuvre des scénarios courants en utilisant l’AWS Command Line Interface avec Cost Explorer Service.

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.

Rubriques

Actions

L’exemple de code suivant montre comment utiliser get-cost-and-usage.

AWS CLI

Pour récupérer les données d’utilisation de S3 d’un compte pour le mois de septembre 2017

L’exemple get-cost-and-usage suivant récupère les données l’utilisation de S3 d’un compte pour le mois de septembre 2017.

aws ce get-cost-and-usage \
    --time-period Start=2017-09-01,End=2017-10-01 \
    --granularity MONTHLY \
    --metrics "BlendedCost" "UnblendedCost" "UsageQuantity" \
    --group-by Type=DIMENSION,Key=SERVICE Type=TAG,Key=Environment \
    --filter file://filters.json

Contenu 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, consultez GetCostAndUsage dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-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 la valeur « Elastic » pour la période allant du 1er janvier 2017 au 18 mai 2017.

Commande :

aws ce get-dimension-values --search-string Elastic --time-period Start=2017-01-01,End=2017-05-18 --dimension SERVICE

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, consultez GetDimensionValues dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-reservation-coverage.

AWS CLI

Pour récupérer la couverture des réserves pour les instances EC2 t2.nano dans la région us-east-1

Cet exemple récupère la couverture des réserves 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-period Start=2017-07-01,End=2017-10-01 --group-by Type=Dimension,Key=REGION --filter file://filters.json

filters.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, consultez GetReservationCoverage dans la Référence des commandes de l’AWS CLI.

L’exemple de code suivant montre comment utiliser get-reservation-purchase-recommendation.

AWS CLI

Pour récupérer les recommandations de réserve pour les instances réservées EC2 initiales partielles soumises à un engagement de trois ans

L’exemple get-reservation-purchase-recommendation suivant récupère les recommandations pour les instances EC2 initiales partielles soumises à un engagement de trois ans, sur la base des 60 derniers jours d’utilisation d’EC2.

aws ce get-reservation-purchase-recommendation \
    --service "Amazon Redshift" \
    --lookback-period-in-days SIXTY_DAYS \
    --term-in-years THREE_YEARS \
    --payment-option PARTIAL_UPFRONT

Sortie :

{
    "Recommendations": [],
    "Metadata": {
        "GenerationTimestamp": "2018-08-08T15:20:57Z",
        "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b"
    }
}

L’exemple de code suivant montre comment utiliser get-reservation-utilization.

AWS CLI

Pour récupérer l’utilisation des réserves pour votre compte

L’exemple get-reservation-utilization suivant récupère l’utilisation des instances réservées 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-period Start=2018-03-01,End=2018-08-01 \
    --filter file://filters.json

Contenu 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": []
}

L’exemple de code suivant montre comment utiliser get-tags.

AWS CLI

Pour récupérer les clés et les valeurs d’une balise de répartition des coûts

Cet exemple récupère toutes les balises de répartition des coûts dont la clé est « Project » et dont la valeur contient « secretProject ».

Commande :

aws ce get-tags --search-string secretProject --time-period Start=2017-01-01,End=2017-05-18 --tag-key Project

Sortie :

{
  "ReturnSize": 2,
  "Tags": [
    "secretProject1",
    "secretProject2"
  ],
  "TotalSize": 2
}

  • Pour plus de détails sur l’API, consultez GetTags dans la Référence des commandes de l’AWS CLI.