Google Cloud-Preisinformationen abrufen

Die Google Cloud Pricing API besteht aus einer Reihe von API-Ressourcen, mit denen Sie 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 T4 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

Öffentliche Dienst- und Preisinformationen abrufen

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

Wenn Sie Informationen zu öffentlichen Diensten, Artikelnummern oder Preisen abrufen möchten, 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, um diesen API-Aufruf durchzuführen.

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 mit Diensten sowie Informationen zu jedem Dienst. Das folgende Beispiel zeigt das Format für Compute Engine.

Die Ergebnisse sind paginiert und 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 ändern 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, um diesen API-Aufruf durchzuführen.

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. Zum Auflisten von Artikelnummern für Compute Engine verwenden Sie beispielsweise den Filter service="services/6F81-5844-456A".
  • PAGE_SIZE (Optional): Die maximale Anzahl der zurückzugebenden SKUs. 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-Artikelnummern abrufen

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

  • SKU_ID: Eine bestimmte Artikelnummer-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, um diesen API-Aufruf durchzuführen.

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.

Je nach verwendeter 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

  • Wenn Sie mit billingAccounts.skus Informationen zu Artikelnummern abrufen möchten, benötigen Sie:

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

  • Zum Abrufen von Informationen zu Gruppen von Artikelnummern 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.

Im folgenden Beispiel werden die Artikelnummergruppen aufgelistet, die für Ihr Cloud-Rechnungskonto verfügbar sind.

Für diesen API-Aufruf 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 ändern 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 von 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.

Für diesen API-Aufruf 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

Im folgenden Beispiel werden die ersten beiden Artikelnummern für die Artikelnummergruppe Network Data Transfer mit der ID 28934b47-792e-4afa-a025-7720d410482f gezeigt.

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 ändern 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 Artikelnummer-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 von Artikelnummer-IDs und ihrer Preise, einschließlich der Artikelnummern, die nur für Ihr Cloud-Rechnungskonto verfügbar sind, und Preisinformationen für jede Artikelnummer. Das folgende Beispiel zeigt das Format für alle 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. 

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

Für diesen API-Aufruf 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 im Objekt priceReason Details dazu, wie Ihnen die Artikelnummer in Rechnung gestellt wird. 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": {}
  }
}