Beispiele für die Verwendung der AWS CLI mit Cost Explorer Service

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit Cost Explorer Service nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Aktionen

get-cost-and-usage

Das folgende Codebeispiel zeigt, wie get-cost-and-usage verwendet wird.

AWS CLI

So rufen Sie die S3-Nutzung eines Kontos für den Monat September 2017 ab

Im folgenden get-cost-and-usage-Beispiel rufen Sie die S3-Nutzung eines Kontos für den Monat September 2017 ab.

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

Inhalt von filters.json:

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

Ausgabe:

{
    "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-Details finden Sie unter GetCostAndUsage in der AWS CLI-Befehlsreferenz.

get-dimension-values

Das folgende Codebeispiel zeigt, wie get-dimension-values verwendet wird.

AWS CLI

So rufen Sie die Tags für die Dimension SERVICE mit dem Wert „Elastic“ ab

In diesem Beispiel werden die Tags für die Dimension SERVICE mit dem Wert „Elastic“ für den Zeitraum 1. Januar 2017 bis 18. Mai 2017 abgerufen.

Befehl:

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

Ausgabe:

{
   "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-Details finden Sie unter GetDimensionValues in der AWS CLI-Befehlsreferenz.

get-reservation-coverage

Das folgende Codebeispiel zeigt, wie get-reservation-coverage verwendet wird.

AWS CLI

So rufen Sie die Reservierungsabdeckung für t2.nano-Instances von EC2 in der Region us-east-1 ab

In diesem Beispiel rufen Sie die Reservierungsabdeckung für t2.nano-Instances von EC2 in der Region us-east-1 für Juli bis September 2017 ab.

Befehl:

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

Ausgabe:

{
   "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-Details finden Sie unter GetReservationCoverage in der AWS CLI-Befehlsreferenz.

get-reservation-purchase-recommendation

Das folgende Codebeispiel zeigt, wie get-reservation-purchase-recommendation verwendet wird.

AWS CLI

So rufen Sie die Reservierungsempfehlungen für EC2-RIs mit teilweiser Vorauszahlung und einer Laufzeit von 3 Jahren ab

Im folgenden get-reservation-purchase-recommendation-Beispiel werden Empfehlungen für EC2-Instances mit teilweiser Vorauszahlung und einer Laufzeit von 3 Jahren abgerufen, basierend auf den letzten 60 Tagen der EC2-Nutzung.

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

Ausgabe:

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

• API-Details finden Sie unter GetReservationPurchaseRecommendation in der AWS CLI-Befehlsreferenz.

get-reservation-utilization

Das folgende Codebeispiel zeigt, wie get-reservation-utilization verwendet wird.

AWS CLI

So rufen Sie Reservierungsauslastung für Ihr Konto ab

Im folgenden get-reservation-utilization-Beispiel wird die RI-Auslastung für alle t2.nano-Instance-Typen vom 01.03.2018 bis 01.08.2018 für das Konto abgerufen.

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

Inhalt von filters.json:

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

Ausgabe:

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

• API-Details finden Sie unter GetReservationUtilization in der AWS CLI-Befehlsreferenz.

get-tags

Das folgende Codebeispiel zeigt, wie get-tags verwendet wird.

AWS CLI

So rufen Sie Schlüssel und Werte für ein Kostenzuordnungs-Tag ab

In diesem Beispiel werden alle Kostenzuordnungs-Tags mit dem Schlüssel „Project“ und einem Wert, der „secretProject“ enthält, abgerufen.

Befehl:

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

Ausgabe:

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

• API-Details finden Sie unter GetTags in der AWS CLI-Befehlsreferenz.