Google Cloud-Preisinformationen abrufen

Die Google Cloud Pricing API besteht aus einer Reihe von API-Ressourcen, mit denen Sie die Preise und andere Informationen für Google Cloud-Dienste abrufen können.

Auf dieser Seite werden Ihnen einige Beispiele für API-Anfragen gezeigt, die Sie stellen können, um Informationen zu öffentlich aufgeführten Diensten und Artikelnummern abzurufen. Außerdem werden Ihnen Dienste und Artikelnummern gezeigt, die nur für Ihr Cloud-Rechnungskonto als Teil eines Vertrags mit Google Cloud verfügbar sind.

Mit der Pricing API können Sie eine Liste der Dienste oder den Preis für eine bestimmte Artikelnummer (stock keeping unit, SKU) abrufen. Eine Artikelnummer identifiziert eindeutig eine Ressource, die Sie kaufen können. Ein Beispiel für eine Artikelnummer ist Nvidia Tesla K80 GPU attached to Spot Preemptible VMs running in Warsaw. Wenn Sie einen Vertrag mit benutzerdefinierten Preisen haben, können Sie auch die Pricing API verwenden, um die mit Ihrem Cloud-Rechnungskonto verknüpften benutzerdefinierten Preise abzurufen.

Eine vollständige Liste der verfügbaren Ressourcen in der Pricing API und detaillierte Informationen zu den Anfrage- und Antwortformaten finden Sie in der API-Referenz.

Hinweise

Cloud Billing API aktivieren.

Aktivieren Sie die API

Informationen zu öffentlichen Diensten und Preisen abrufen

Die folgenden Beispiele zeigen API-Aufrufe, mit denen Sie öffentlich aufgeführte Informationen zu Google Cloud-Diensten und Artikelnummern abrufen können.

Um Informationen zu öffentlichen Diensten, Artikelnummern oder Preisen abzurufen, müssen Sie einen API-Schlüssel erstellen.

Liste mit öffentlichen Google Cloud-Diensten abrufen

Im folgenden Beispiel werden alle öffentlichen Google Cloud-Dienste aufgelistet, einschließlich der Metadaten für jeden einzelnen Dienst.

Sie benötigen keine spezifischen IAM-Berechtigungen für diesen API-Aufruf.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • API_KEY: Ihr Google Cloud API-Schlüssel.
  • PAGE_SIZE (Optional): Die Anzahl der zurückzugebenden Dienste. Der Standardwert ist 50.
  • PAGE_TOKEN (Optional): Das Seitentoken, das Sie in einer früheren Antwort vom nextPageToken erhalten.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    "https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v2beta/services?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

Die Antwort enthält eine Liste der Dienste und Informationen zu jedem Dienst. Das folgende Beispiel zeigt das Format für Compute Engine.

Die Ergebnisse sind paginiert und sind auf 50 Dienste pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Artikelnummern pro Seite reduzieren möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 

{
  "services": [
    {
      "name": "services/6F81-5844-456A",
      "serviceId": "6F81-5844-456A",
      "displayName": "Compute Engine",
    },
    ...
  ]
  "nextPageToken": "alphanumeric-page-token"
}

Liste von Artikelnummern für einen öffentlichen Google Cloud-Dienst abrufen

Im folgenden Beispiel werden die öffentlichen Artikelnummern für einen bestimmten Dienst aufgelistet.

Sie benötigen keine spezifischen IAM-Berechtigungen für diesen API-Aufruf.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • API_KEY: Ihr Google Cloud API-Schlüssel.
  • FILTER: Die Dienste, nach denen die Artikelnummern gefiltert werden sollen. Verwenden Sie beispielsweise den Filter service="services/DA34-426B-A397", um Artikelnummern für Compute Engine aufzulisten.
  • PAGE_SIZE (Optional): Die maximale Anzahl der zurückzugebenden Artikelnummern. Der Standardwert ist 50 und der Höchstwert 5.000.
  • PAGE_TOKEN (Optional): Das Seitentoken, das sich im nextPageToken in der Antwort befindet.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    "https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER"

PowerShell

Führen Sie folgenden Befehl aus:

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v2beta/skus?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=FILTER" | Select-Object -Expand Content
Die folgende Antwort zeigt einige Beispiel-Artikelnummern, die für Compute Engine zurückgegeben wurden. Die Ergebnisse sind paginiert und auf 50 Artikelnummern pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Artikelnummern pro Seite ändern möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 
{
  "skus": [
    {
      "name": "skus/0008-F633-76AA",
      "skuId": "0008-F633-76AA",
      "displayName": "Example L4 GPU attached to Spot Preemptible VMs running in Hong Kong",
      "service": "6F81-5844-456A",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Compute"
          },
          {
            "category": "GPUs"
          },
          {
            "category": "GPUs Preemptible"
          },
          {
            "category": "L4"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "asia-east2"
          }
        }
      }
    },
    {
      "name": "skus/000F-0B14-D302",
      "skuId": "000F-0B14-D302",
      "displayName": "Example Sole Tenancy Instance Ram running in Turin",
      "service": "6F81-5844-456A",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Compute"
          },
          {
            "category": "GCE"
          },
          {
            "category": "VMs On Demand"
          },
          {
            "category": "Memory: Per GB"
          },
          {
            "category": "C3"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "europe-west12"
          }
        }
      }
    }
  ],
  "nextPageToken": "alphanumeric-nextpageToken"
}

Preise für alle öffentlichen Google Cloud-SKUs abrufen

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SKU_ID: Eine bestimmte SKU-ID, für die der Preis abgerufen werden soll. Um Preise für alle Artikelnummern abzurufen, verwenden Sie `-`.
  • API_KEY: Ihr Google Cloud API-Schlüssel.
  • PAGE_SIZE (Optional): Die Anzahl der zurückzugebenden Dienste. Der Standardwert ist 50.
  • PAGE_TOKEN (Optional): Das Seitentoken, das Sie in einer früheren Antwort vom nextPageToken erhalten.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/prices?key=API_KEY&pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

Die Antwort enthält Preisinformationen für jede Artikelnummer. Das folgende Beispiel zeigt das Format für alle öffentlichen Artikelnummern mit einer Seitengröße von „2“.

Die Ergebnisse sind paginiert und enthalten standardmäßig 50 Preise pro Seite. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Ergebnisse pro Seite ändern möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 

{
  "prices": [
    {
      "name": "skus/0000-9B70-F099/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            }
          }
        ],
        "unitInfo": {
          "unit": "h",
          "unitDescription": "hour",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      }
    },
    {
      "name": "skus/0002-17F9-0731/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD"
            }
          },
          {
            "startAmount": {
              "value": "1"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            }
          },
          {
            "startAmount": {
              "value": "1024"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            }
          }
        ],
        "unitInfo": {
          "unit": "GiBy.mo",
          "unitDescription": "gibibyte month",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      }
    }
  ],
  "nextPageToken": "1234alphanumericCode"
}

Preis einer öffentlichen Artikelnummer abrufen

Im folgenden Beispiel wird der Preis einer öffentlich aufgeführten Artikelnummer abgerufen. Eine vollständige Liste der Google Cloud-Artikelnummer-IDs finden Sie auf der Seite "Artikelnummern".

Sie benötigen keine spezifischen IAM-Berechtigungen für diesen API-Aufruf.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • API_KEY: Ihr Google Cloud API-Schlüssel.
  • SKU_ID: Die Artikelnummer-ID, die Sie mit der Methode skus.list abrufen können. Die ID ist der String nach der Kennzeichnung skus/.
  • CURRENCY: (Optional) Der ISO-4217-Währungscode für den Preis. Wenn nicht angegeben, wird der Preis in derselben Währung wie Ihr Cloud-Rechnungskonto angegeben.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY"

PowerShell

Führen Sie folgenden Befehl aus:

$headers = @{  }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/skus/SKU_ID/price?key=API_KEY¤cyCode=CURRENCY" | Select-Object -Expand Content
Das folgende Beispiel zeigt die Preisdetails für die Artikelnummer-ID 0012-B7F2-DD14. 
{
  "name": "skus/0012-B7F2-DD14/price",
  "currencyCode": "USD",
  "valueType": "rate",
  "rate": {
    "tiers": [
      {
        "startAmount": {
          "value": "0"
        },
        "listPrice": {
          "currencyCode": "USD",
          "nanos": 1397000
        }
      }
    ],
    "unitInfo": {
      "unit": "GiBy.h",
      "unitDescription": "gibibyte hour",
      "unitQuantity": {
        "value": "1"
      }
    },
    "aggregationInfo": {
      "level": "ACCOUNT",
      "interval": "MONTHLY"
    }
  }
}

Spezifische Informationen zu Ihrem Cloud-Rechnungskonto abrufen

Die folgenden Beispiele zeigen API-Aufrufe, die spezifische Informationen für Ihr Cloud-Rechnungskonto abrufen, z. B. bestimmte Artikelnummern oder Preisinformationen, die möglicherweise Teil Ihres Vertrags mit benutzerdefinierten Preisen sind.

Abhängig von der verwendeten API-Ressource benötigen Sie die folgenden Berechtigungen für das Cloud-Rechnungskonto:

  • Zum Abrufen von Informationen zu Diensten mit billingAccounts.services benötigen Sie:

    • billing.billingAccountServices.get
    • billing.billingAccountServices.list

  • Zum Abrufen von Informationen zu Artikelnummern mit billingAccounts.skus benötigen Sie:

    • billing.billingAccountSkus.get
    • billing.billingAccountSkus.list

  • Zum Abrufen von Informationen zu Artikelnummergruppen mit billingAccounts.skugroups benötigen Sie:

    • billing.billingAccountSkuGroups.get
    • billing.billingAccountSkuGroups.list

  • Wenn Sie mit billingAccounts.skugroups.skus Informationen zu Artikelnummern abrufen möchten, die Teil von Artikelnummergruppen sind, benötigen Sie:

    • billing.billingAccountSkuGroupSkus.get
    • billing.billingAccountSkuGroupSkus.list

  • Zum Abrufen von Informationen zu Preisen von Artikelnummern mit billingAccounts.skus.price benötigen Sie:

    • billing.billingAccountPrice.get

Wenn Sie die API mit einem Dienstkonto aufrufen, muss das Dienstkonto die Berechtigungen haben.

Die folgenden vordefinierten Rollen haben die Berechtigungen, um spezifische Informationen zu Ihrem Cloud-Rechnungskonto abzurufen:

  • Rechnungskontoadministrator
  • Rechnungskonto-Betrachter

Liste der Artikelnummergruppen für Ihr Cloud-Rechnungskonto abrufen

Wenn Sie einen Preisvertrag mit Google Cloud haben, bezieht sich Ihr Vertrag möglicherweise auf Artikelnummergruppen, die Artikelnummern enthalten, die in eine bestimmte Kategorie fallen. Die Artikelnummergruppe BigQuery enthält beispielsweise Artikelnummern für die Bigquery-Analyse und -Speicherung an verschiedenen Standorten.

Das folgende Beispiel listet die Artikelnummergruppen auf, die für Ihr Cloud-Rechnungskonto zur Verfügung stehen.

Zum Ausführen dieses API-Aufrufs benötigen Sie die IAM-Berechtigung billing.billingAccountSkuGroups.list für Ihr Cloud-Rechnungskonto.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • BILLING_ACCOUNT_ID: Ihre Cloud-Rechnungskonto-ID.
  • PAGE_SIZE (Optional): Die maximale Anzahl der zurückzugebenden Artikelnummergruppen. Der Standardwert ist 50 und der Höchstwert 5.000.
  • PAGE_TOKEN (Optional): Das Seitentoken, das sich im nextPageToken in der Antwort befindet.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

Die Antwort ist eine Liste von Artikelnummergruppen im folgenden Format.

Die Ergebnisse sind paginiert und auf 50 Artikelnummergruppen pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Artikelnummern pro Seite reduzieren möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 

{
    "billingAccountSkuGroups": [
      {
        "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/001234-group-id-1",
        "displayName": "SKU group name 1"
      },
      {
        "name": "billingAccounts/012345-567890-ABCDEF/skuGroups/0045657-group-id-2",
        "displayName": "SKU group name 2"
      },
      ...
      "nextPageToken": "A1234-alphanumeric-page-token"
}

Liste der Artikelnummern in einer Artikelnummergruppe für Ihr Cloud-Rechnungskonto abrufen

Im folgenden Beispiel werden die Artikelnummern in einer Artikelnummergruppe aufgelistet, die möglicherweise Teil Ihres Vertrags mit benutzerdefinierten Preisen ist.

Zum Ausführen dieses API-Aufrufs benötigen Sie die IAM-Berechtigung billing.billingAccountSkuGroupSkus.list für Ihr Cloud-Rechnungskonto.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SKU_GROUP_ID: die Artikelnummergruppen-ID, die Sie von der billingAccount.skuGroups.list method erhalten.
  • BILLING_ACCOUNT_ID: Ihre Cloud-Rechnungskonto-ID.
  • PAGE_SIZE (Optional): Die Anzahl der abzurufenden Artikelnummergruppen. Der Standardwert ist 5.000.
  • PAGE_TOKEN (Optional): Das Seitentoken, das sich im nextPageToken in der Antwort befindet.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skuGroups/SKU_GROUP_ID/skus?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

Das folgende Beispiel zeigt die ersten beiden Artikelnummern für die Artikelnummergruppe Network Data Transfer mit der ID 28934b47-792e-4afa-a025-7720d410482f.

Die Ergebnisse sind paginiert und auf 5.000 Artikelnummergruppen pro Seite beschränkt. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Artikelnummern pro Seite reduzieren möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 

{
  "billingAccountSkuGroupSkus": [
    {
      "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/0009-6F35-3126",
      "skuId": "0009-6F35-3126",
      "displayName": "Network Internet Data Transfer from EMEA to Seoul",
      "service": "9662-B51E-5089",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Network"
          },
          {
            "category": "Data Transfer"
          },
          {
            "category": "Cloud SQL"
          },
          {
            "category": "Premium"
          }
        ]
      },
      "geoTaxonomy": {
        "type": "REGIONAL",
        "regionalMetadata": {
          "region": {
            "region": "europe-west1"
          }
        }
      }
    },
    {
      "name": "billingAccounts/12345-ABCDE-EXAMPLE/skuGroups/28934b47-792e-4afa-a025-7720d410482f/skus/000B-47CC-2924",
      "skuId": "000B-47CC-2924",
      "displayName": "API Gateway Network Internet Data Transfer Intercontinental from/to Oceania",
      "service": "36A9-155B-23F0",
      "productTaxonomy": {
        "taxonomyCategories": [
          {
            "category": "GCP"
          },
          {
            "category": "Network"
          },
          {
            "category": "Data Transfer"
          },
          {
            "category": "API Gateway"
          },
          {
            "category": "Premium"
          }
        ]
      },
      "geoTaxonomy": {}
    }
  ],
  "nextPageToken": "alphanumeric-nextPageToken"
}

Preise für alle Google Cloud-SKUs für Ihr Cloud-Rechnungskonto abrufen

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SKU_ID: Eine bestimmte SKU-ID, für die der Preis abgerufen werden soll. Um Preise für alle Artikelnummern abzurufen, verwenden Sie `-`.
  • API_KEY: Ihr Google Cloud API-Schlüssel.
  • PAGE_SIZE (Optional): Die Anzahl der zurückzugebenden Dienste. Der Standardwert ist 50.
  • PAGE_TOKEN (Optional): Das Seitentoken, das Sie in einer früheren Antwort vom nextPageToken erhalten.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN"

PowerShell

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/prices?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN" | Select-Object -Expand Content

Die Antwort enthält eine Liste der SKU-IDs und ihrer Preise, einschließlich der SKUs, die nur für Ihr Cloud-Rechnungskonto verfügbar sind, sowie Preisinformationen für jede SKU. Das folgende Beispiel zeigt das Format für alle Artikelnummern mit der Seitengröße „2“.

Die Ergebnisse sind paginiert und enthalten standardmäßig 50 Preise pro Seite. Die Antwort enthält ein nextPageToken, mit dem Sie die nächste Ergebnisseite abrufen können. Legen Sie pageToken=PAGE_TOKEN fest, um den nächsten Batch abzurufen. Wenn Sie die Anzahl der Ergebnisse pro Seite ändern möchten, legen Sie pageSize=PAGE_SIZE fest. Wenn alle Artikel aufgelistet sind, wird kein Token zurückgegeben. 

{
  "billingAccountPrices": [
    {
      "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0000-9B70-F099/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 690000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          }
        ],
        "unitInfo": {
          "unit": "h",
          "unitDescription": "hour",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      },
      "priceReason": {
        "type": "default-price",
        "defaultPrice": {}
      }
    },
    {
      "name": "billingAccounts/01ABCD-EFGH23-UVWXYZ/skus/0002-17F9-0731/price",
      "currencyCode": "USD",
      "valueType": "rate",
      "rate": {
        "tiers": [
          {
            "startAmount": {
              "value": "0"
            },
            "listPrice": {
              "currencyCode": "USD"
            },
            "contractPrice": {
              "currencyCode": "USD"
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          },
          {
            "startAmount": {
              "value": "1"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 390000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          },
          {
            "startAmount": {
              "value": "1024"
            },
            "listPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            },
            "contractPrice": {
              "currencyCode": "USD",
              "nanos": 340000000
            },
            "effectiveDiscountPercent": {
              "value": "0"
            }
          }
        ],
        "unitInfo": {
          "unit": "GiBy.mo",
          "unitDescription": "gibibyte month",
          "unitQuantity": {
            "value": "1"
          }
        },
        "aggregationInfo": {
          "level": "LEVEL_ACCOUNT",
          "interval": "INTERVAL_MONTHLY"
        }
      },
      "priceReason": {
        "type": "default-price",
        "defaultPrice": {}
      }
    }
  ],
  "nextPageToken": "1234alphanumericCode"
}

Preise für Artikelnummern für Ihr Cloud-Rechnungskonto abrufen

Im folgenden Beispiel wird der Preis abgerufen, den Sie für eine Artikelnummer bezahlen. Wenn die Artikelnummer Teil eines Vertrags mit benutzerdefinierten Preisen ist, enthält die Antwort Informationen über den Rabatt auf den Listenpreis.

Zum Ausführen dieses API-Aufrufs benötigen Sie die IAM-Berechtigung billing.billingAccountPrice.get für Ihr Cloud-Rechnungskonto.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SKU_ID: Die Artikelnummer-ID, die Sie mit der Methode billingAccounts.skus abrufen können. Die ID ist der String nach der Kennzeichnung skus/.
  • BILLING_ACCOUNT_ID: Ihre Cloud-Rechnungskonto-ID.
  • CURRENCY: (Optional) Der ISO-4217-Währungscode für den Preis. Wenn nicht angegeben, wird der Preis in derselben Währung wie Ihr Cloud-Rechnungskonto angegeben.

HTTP-Methode und URL:

GET https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY

Senden Sie die Anfrage mithilfe einer der folgenden Optionen:

curl

Führen Sie folgenden Befehl aus:

curl -X GET \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY"

PowerShell

Führen Sie folgenden Befehl aus:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://cloudbilling.googleapis.com/v1beta/billingAccounts/BILLING_ACCOUNT_ID/skus/SKU_ID/price?currencyCode=CURRENCY" | Select-Object -Expand Content
Die Antwort enthält Details zu den Ihnen in Rechnung gestellten Kosten für die Artikelnummer im Objekt priceReason. Das folgende Beispiel zeigt die Preisdetails für die Artikelnummer-ID 0012-B7F2-DD14. In diesem Beispiel hat das Cloud-Rechnungskonto einen Preisvertrag, bezahlt aber den Listenpreis für diese Artikelnummer. 
{
  "name": "billingAccounts/015978-D9414D-B80267/skus/0012-B7F2-DD14/price",
  "currencyCode": "USD",
  "valueType": "rate",
  "rate": {
    "tiers": [
      {
        "startAmount": {
          "value": "0"
        },
        "listPrice": {
          "currencyCode": "USD",
          "nanos": 1270000
        },
        "contractPrice": {
          "currencyCode": "USD",
          "nanos": 1270000
        }
      }
    ],
    "unitInfo": {
      "unit": "GiBy.h",
      "unitDescription": "gibibyte hour",
      "unitQuantity": {
        "value": "1"
      }
    },
    "aggregationInfo": {
      "level": "ACCOUNT",
      "interval": "MONTHLY"
    }
  },
  "priceReason": {
    "type": "default-price",
    "defaultPrice": {}
  }
}