Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Cost Explorer Service.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
Tópicos
Ações
O código de exemplo a seguir mostra como usar get-cost-and-usage.
- AWS CLI
-
Para recuperar o uso do S3 de uma conta no mês de setembro de 2017
O exemplo
get-cost-and-usagea seguir recupera o uso do S3 de uma conta no mês de setembro de 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.jsonConteúdo de
filters.json:{ "Dimensions": { "Key": "SERVICE", "Values": [ "Amazon Simple Storage Service" ] } }Saída:
{ "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" } } } ] } ] }-
Para ver detalhes da API, consulte GetCostAndUsage
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-dimension-values.
- AWS CLI
-
Para recuperar as tags da dimensão SERVICE, com um valor de “Elastic”
Este exemplo recupera as tags da dimensão SERVICE, com um valor de “Elastic” de 01 de janeiro de 2017 a 18 de maio de 2017.
Comando:
aws ce get-dimension-values --search-stringElastic--time-periodStart=2017-01-01,End=2017-05-18--dimensionSERVICESaída:
{ "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 }-
Para ver detalhes da API, consulte GetDimensionValues
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-reservation-coverage.
- AWS CLI
-
Para recuperar a cobertura da reserva de instâncias t2.nano do EC2 na região us-east-1
Este exemplo recupera a cobertura da reserva de instâncias t2.nano do EC2 na região us-east-1 de julho a setembro de 2017.
Comando:
aws ce get-reservation-coverage --time-periodStart=2017-07-01,End=2017-10-01--group-byType=Dimension,Key=REGION--filterfile://filters.jsonfilters.json:
{ "And": [ { "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] }, "Dimensions": { "Key": "REGION", "Values": [ "us-east-1" ] } } ] }Saída:
{ "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 }-
Para ver detalhes da API, consulte GetReservationCoverage
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-reservation-purchase-recommendation.
- AWS CLI
-
Para recuperar as recomendações de reserva de IRs do EC2 com pagamento adiantado parcial com prazo de três anos
O exemplo
get-reservation-purchase-recommendationa seguir recupera recomendações de instâncias do EC2 com pagamento adiantado parcial com prazo de três anos, com base nos últimos 60 dias de uso do EC2.aws ce get-reservation-purchase-recommendation \ --service"Amazon Redshift"\ --lookback-period-in-daysSIXTY_DAYS\ --term-in-yearsTHREE_YEARS\ --payment-optionPARTIAL_UPFRONTSaída:
{ "Recommendations": [], "Metadata": { "GenerationTimestamp": "2018-08-08T15:20:57Z", "RecommendationId": "00d59dde-a1ad-473f-8ff2-iexample3330b" } }-
Para ver detalhes da API, consulte GetReservationPurchaseRecommendation
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-reservation-utilization.
- AWS CLI
-
Para recuperar a utilização de reserva de sua conta
O exemplo
get-reservation-utilizationa seguir recupera a utilização de IR para todos os tipos de instância t2.nano de 01/03/2018 a 01/08/2018 da conta.aws ce get-reservation-utilization \ --time-periodStart=2018-03-01,End=2018-08-01\ --filterfile://filters.jsonConteúdo de
filters.json:{ "Dimensions": { "Key": "INSTANCE_TYPE", "Values": [ "t2.nano" ] } }Saída:
{ "Total": { "TotalAmortizedFee": "0", "UtilizationPercentage": "0", "PurchasedHours": "0", "NetRISavings": "0", "TotalActualHours": "0", "AmortizedRecurringFee": "0", "UnusedHours": "0", "TotalPotentialRISavings": "0", "OnDemandCostOfRIHoursUsed": "0", "AmortizedUpfrontFee": "0" }, "UtilizationsByTime": [] }-
Para ver detalhes da API, consulte GetReservationUtilization
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar get-tags.
- AWS CLI
-
Para recuperar chaves e valores para uma tag de alocação de custos
Este exemplo recupera todas as tags de alocação de custos com uma chave de “Projeto” e um valor que contém “secretProject”.
Comando:
aws ce get-tags --search-stringsecretProject--time-periodStart=2017-01-01,End=2017-05-18--tag-keyProjectSaída:
{ "ReturnSize": 2, "Tags": [ "secretProject1", "secretProject2" ], "TotalSize": 2 }-
Para ver detalhes da API, consulte GetTags
na Referência de comandos da AWS CLI.
-
