Wiederkehrende Verwendungen erstellen

Auf dieser Seite finden Sie eine Anleitung für den Infrastrukturbetreiber (IO), wie er wiederkehrende Nutzungen erstellt, um die Abrechnungskosten für Ihre Google Distributed Cloud (GDC) Airgap-Instanz und Informationen zur Dienstnutzung zu verwalten.

Mit der RecurringUsage-Ressource können Sie die Gebühr für eine bestimmte Artikelnummer für einen konstanten und definierten Zeitraum festlegen. Sie bestellen beispielsweise einen Dienst für ein Jahr, der innerhalb eines Kalenderjahres beginnt und endet. Distributed Cloud bietet sowohl Artikelnummern (Stock Keeping Units, SKUs), für die Gebühren basierend auf der Nutzung anfallen, als auch SKUs, die nicht nutzungsbasiert sind. Verwenden Sie die Ressource RecurringUsage aus der Billing API, um monatlich wiederkehrende Pauschalgebühren zu verwalten.

Abrechnungsanforderungen ermitteln

Das Einrichten von Abos mit Festgebühr mit einer RecurringUsage-Ressource ist ein optionaler Schritt. Sehen Sie sich die folgenden Anwendungsfälle an, um Ihre Abrechnungsanforderungen zu ermitteln:

  • Wenn Sie Google Cloud Billing verwenden, um Fixkosten und Rechnungsstellung zu erfassen, müssen Sie in Ihrer Distributed Cloud-Umgebung keine wiederkehrenden Nutzungsgebühren einrichten.

  • Wenn Sie eine monatliche wiederkehrende Pauschalgebühr hinzufügen möchten, z. B. Supportkosten, müssen Sie die wiederkehrende Gebühr einer SKU zuordnen, z. B. einer Support-SKU. In diesem Fall müssen Sie mit der Einrichtung der ReccurringUsage-Ressource fortfahren.

Hinweise

Bevor Sie fortfahren, benötigen Sie Folgendes:

  • Die Rolle „Organisationsabrechnungsbetrachter“ im Administratorcluster der Organisation. Wenden Sie sich an Ihren Sicherheitsadministrator, um die Rolle „Organisationsabrechnungsbetrachter“ (organization-billing-viewer) für den Namespace billing-system zu erhalten. Mit dieser Berechtigung können Sie zugehörige Ressourcen zur Validierung lesen.

  • Ein iac-Repository mit einer kustomization.yaml-Datei und einem recurringusages-Verzeichnis zum Speichern der Dateien mit der benutzerdefinierten RecurringUsages-Ressource.

Benutzerdefinierte RecurringUsage-Ressource erstellen

So erstellen Sie die Ressource RecurringUsage:

  1. Erstellen Sie eine YAML-Datei mit dem Pfad infrastructure/zonal/zones/ZONE_NAME/TARGET_CLUSTER/bil/recurringusages/RECURRING_USAGE_NAME.yaml.

    Ersetzen Sie die folgenden Variablen:

    • TARGET_CLUSTER: Der Name des Clusters, auf den Sie Zugriff haben, hier mit dem Administratorcluster der Organisation.
    • RECURRING_USAGE_NAME: Der Name, den Sie der YAML-Datei geben.

  2. Fügen Sie die Ressource RecurringUsage und den folgenden Inhalt hinzu:

    apiVersion: billing.private.gdc.goog/v1alpha1
kind: RecurringUsage
metadata:
  name: RECURRING_USAGE_NAME
  namespace: billing-system
skuDescriptionRef:
  name: SKU_DESCRIPTION_NAME
  namespace: billing-system
usageQuantity:
  units: UNITS
  nanos: NANOS
startTime: START_TIME
endTime: END_TIME

    Ersetzen Sie die folgenden Variablen:

    Variable Beschreibung
    RECURRING_USAGE_NAME Der Name, der der Ressource gegeben werden soll. Jede Ressource, die Sie erstellen, muss einen eindeutigen Namen haben. Um den Namen eindeutig zu machen, hängen Sie einen Zeitstempel an den Namen an, den Sie SKU_DESCRIPTION_NAME geben. Beispiel: 
    RECURRING_USAGE_NAME=${SKU_DESCRIPTION_NAME}-$(date +"%Y-%m-%d-%H%M%S")
    SKU_DESCRIPTION_NAME Der Name der referenzierten SKU-Beschreibung, also SKU_ID in Kleinbuchstaben. Der Name der SKU-Beschreibung besteht aus 12 alphanumerischen Zeichen in Kleinschreibung, die durch Bindestriche in Gruppen von vier Zeichen getrennt sind. Beispiel: 0000-ffff-aaaa
    UNITS Eine ganze Einheit des Nutzungsvolumens. Wenn die Gebühr beispielsweise für 1.50 Einheiten gilt, legen Sie für dieses Feld 1 und für das Feld NANOS 500000000 fest.
    NANOS Ein Nano einer ganzen Einheit. Wenn die Gebühr beispielsweise für 1, 50 Einheiten gilt, legen Sie für das Feld UNITS den Wert 1 und für dieses Feld den Wert 500000000 fest.
    START_TIME Der Zeitstempel für den Beginn der Abrechnung für eine bestimmte Artikelnummer. Der Zeitstempel muss dem RFC 3339-Format entsprechen. Wenn Sie beispielsweise einen Dienst bestellen, der am 01/01/2024 beginnt, fügen Sie den Zeitstempelwert als 2024-01-01T00:00:00Z hinzu.

    Dieses Feld ist optional. Wenn es nicht festgelegt ist, wird die Gebühr erhoben, sobald Sie die Merge-Anfrage in GitLab senden. Sie können dieses Feld erst festlegen, wenn Sie die Merge-Anfrage in GitLab senden. Wenn die angeforderte Startzeit in der Vergangenheit liegt, eskaliere den Vorfall an den GDC-Support.
    END_TIME Der Zeitstempel für das Ende der Belastung für eine bestimmte Artikelnummer. Der Zeitstempel muss dem RFC 3339-Format entsprechen. Wenn Sie beispielsweise einen Dienst bestellen, der am 01/01/2024 beginnt und am 01/01/2025 endet, fügen Sie den Zeitstempelwert als 2025-01-01T00:00:00Z hinzu.

     Dieses Feld ist optional. Wenn es nicht festgelegt ist, fallen weiterhin Gebühren an. Sie können dieses Feld erst festlegen, wenn Sie die Merge-Anfrage in GitLab senden. Wenn die angeforderte Endzeit in der Vergangenheit liegt, eskaliere den Vorfall an den GDC-Support.

  3. Speichern Sie die wiederkehrende Nutzung im Ordner recurringusages.

  4. Erstellen Sie einen Pull-Request mit der YAML-Datei und der erforderlichen kustomization-Datei.

  5. Prüfen Sie, ob die benutzerdefinierte Ressource RecurringUsage erstellt wurde:

    kubectl get recurringusages.billing.private.gdc.goog RECURRING_USAGE_NAME -n billing-system -o yaml

    Wenn Sie die benutzerdefinierte Ressource RecurringUsage nicht erstellen können, folgen Sie der Anleitung unter IAC-R0001, um das Problem genauer zu untersuchen.