を使用した Cost Explorer Service の例 AWS CLI

次のコード例は、Cost Explorer Service AWS Command Line Interface でを使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。

アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。

各例には、完全なソースコードへのリンクが含まれています。このリンクには、コンテキスト内でコードをセットアップして実行する方法の手順が記載されています。

トピック

アクション

アクション

次の例は、get-cost-and-usage を使用する方法を説明しています。

AWS CLI

2017 年 9 月のアカウントの S3 使用量を取得するには

次のget-cost-and-usage例では、2017 年 9 月のアカウントの S3 使用量を取得します。


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

filters.json の内容:


{
    "Dimensions": {
        "Key": "SERVICE",
        "Values": [
            "Amazon Simple Storage Service"
        ]
    }
}

出力:


{
    "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"
                        }
                    }
                }
            ]
        }
    ]
}

API 詳細については、「コマンドリファレンスGetCostAndUsage」の「」を参照してください。 AWS CLI

次のコード例は、get-dimension-values を使用する方法を示しています。

AWS CLI

ディメンションのタグをSERVICE「Elastic」の値で取得するには

この例ではSERVICE、ディメンションのタグを取得します。2017 年 1 月 1 日から 2017 年 5 月 18 日までの値は「Elastic」です。

コマンド:


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

出力:


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

API 詳細については、「コマンドリファレンスGetDimensionValues」の「」を参照してください。 AWS CLI

次のコード例は、get-reservation-coverage を使用する方法を示しています。

AWS CLI

us-east-1 リージョンの EC2 t2.nano インスタンスの予約カバレッジを取得するには

この例では、2017 年 EC2 7 月 9 日の米国東部 1 リージョンの t2.nano インスタンスの予約カバレッジを取得します。

コマンド:


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

出力:


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

API 詳細については、「コマンドリファレンスGetReservationCoverage」の「」を参照してください。 AWS CLI

次の例は、get-reservation-purchase-recommendation を使用する方法を説明しています。

AWS CLI

3 年間の期間EC2RIsで一部前払いの予約のレコメンデーションを取得するには

次のget-reservation-purchase-recommendation例では、過去 60 日間のEC2使用状況に基づいて、3 年間の期間を持つ一部前払い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

出力:


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

API 詳細については、「コマンドリファレンスGetReservationPurchaseRecommendation」の「」を参照してください。 AWS CLI

次のコード例は、get-reservation-utilization を使用する方法を示しています。

AWS CLI

アカウントの予約使用率を取得するには

次のget-reservation-utilization例では、2018-08-01アカウントのから 2018-03-01 までのすべての t2.nano インスタンスタイプの RI 使用率を取得します。


aws ce get-reservation-utilization \
    --time-period Start=2018-03-01,End=2018-08-01 \
    --filter file://filters.json

filters.json の内容:


{
    "Dimensions": {
        "Key": "INSTANCE_TYPE",
        "Values": [
            "t2.nano"
        ]
    }
}

出力:


{
    "Total": {
        "TotalAmortizedFee": "0",
        "UtilizationPercentage": "0",
        "PurchasedHours": "0",
        "NetRISavings": "0",
        "TotalActualHours": "0",
        "AmortizedRecurringFee": "0",
        "UnusedHours": "0",
        "TotalPotentialRISavings": "0",
        "OnDemandCostOfRIHoursUsed": "0",
        "AmortizedUpfrontFee": "0"
    },
    "UtilizationsByTime": []
}

API 詳細については、「コマンドリファレンスGetReservationUtilization」の「」を参照してください。 AWS CLI

次の例は、get-tags を使用する方法を説明しています。

AWS CLI

コスト配分タグのキーと値を取得するには

この例では、「Project」のキーと「」を含む値を持つすべてのコスト配分タグを取得しますsecretProject。

コマンド:


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

出力:


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

API 詳細については、「コマンドリファレンスGetTags」の「」を参照してください。 AWS CLI

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

AWS Cost and Usage Report

Firehose