Versionsinformationen finden Sie in den Versionshinweisen zu Distributed Cloud Connect.

Hardware bestellen

Auf dieser Seite wird beschrieben, wie Sie mit Google Distributed Cloud verbundene Hardware bestellen. Distributed Cloud Connected ist in den folgenden Ländern verfügbar:

Australien
Österreich
Belgien
Brasilien
Kanada
Chile
Dänemark
Finnland
Frankreich
Deutschland
Hongkong
Japan
Indien
Indonesien
Italien
Malaysia
Mexiko
Niederlande
Norwegen
Polen
Saudi-Arabien
Singapur
Südkorea
Spanien
Schweden
Schweiz
Vereinigtes Königreich
USA
Uruguay

Bevor Sie die Hardware bestellen, müssen Sie die Installationsanforderungen für Distributed Cloud Connected erfüllen.

Beschaffungsmodelle für Distributed Cloud Connected

Sie können die mit Distributed Cloud verbundene Hardware je nach Ihren geschäftlichen Anforderungen auf eine der folgenden Arten bestellen:

Hardware im Besitz von Google Sie können die mit Distributed Cloud verbundene Hardware direkt bei Google bestellen. In diesem Szenario beschafft, wartet, repariert und außer Betrieb nimmt Google die mit Distributed Cloud verbundene Hardware. Nach Ablauf Ihres Vertrags holt Google die Distributed Cloud-Hardware ab und vernichtet alle darauf gespeicherten Daten.
Vom Kunden beschaffte Hardware Sie können Distributed Cloud Connected bei einem von Google zertifizierten Systemintegrator (SI) bestellen, nachdem Sie mit Google eine Bereitstellungskonfiguration vereinbart haben, die Ihren geschäftlichen Anforderungen entspricht. In diesem Szenario sind Sie Eigentümer der mit Distributed Cloud verbundenen Hardware. Der SI arbeitet mit Ihnen und Google zusammen, um die Hardware bereitzustellen, zu reparieren und außer Betrieb zu nehmen. Nach Ablauf Ihres Vertrags löscht der SI alle Google-Software und Ihre Daten von der mit Distributed Cloud verbundenen Hardware. Sie können die Hardware dann wiederverwenden oder entsorgen. Diese Art der Beschaffung ist nur für mit Distributed Cloud verbundene Server verfügbar.

Vorbereitung

Sie müssen die folgenden Informationen bereithalten, bevor Sie eine Bestellung aufgeben:

Bestellkontakt Eine Person, die für die Verwaltung der Bereitstellung von mit Distributed Cloud verbundener Hardware in Ihrer Organisation verantwortlich ist.
Standortkontakt Eine Person, die für den ausgewählten Bereitstellungsstandort verantwortlich ist. Google kontaktiert diese Person, um die Lieferung Ihrer mit Distributed Cloud verbundenen Hardware zu planen und abzuschließen. Diese Person koordiniert auch Hardware-Reparaturen und die Außerbetriebnahme mit Google oder einem von Google zertifizierten SI.
Zonenkontakt Eine Person, die für die Integration der mit Distributed Cloud verbundenen Hardware in die vorhandene Netzwerk- und Strominfrastruktur am Bereitstellungsstandort verantwortlich ist.
Bestell-ID Eine aussagekräftige ID für diese Bestellung von mit Distributed Cloud verbundener Hardware.
Standort-ID Eine aussagekräftige ID für den Bereitstellungsstandort für diese Bestellung von mit Distributed Cloud verbundener Hardware.
Zonen-ID Eine aussagekräftige ID für die Zielzone von Distributed Cloud Connected. Wenn Sie nur eine Zone pro Standort bereitstellen, verwenden Sie die Standort-ID als Zonen-ID.

Mit Distributed Cloud verbundene Hardware über die Google Cloud Console bestellen

Rufen Sie in der Google Cloud Console die Seite Bestellungen auf.
Zu den Bestellungen
Wählen Sie das Ziel Google Cloud projekt aus.
Klicken Sie auf Auftrag erstellen.
Füllen Sie das Antragsformular aus und senden Sie es ab.

Ein Google Cloud Vertriebsmitarbeiter prüft Ihre Anfrage und kontaktiert Sie, um die Bestellung abzuschließen. Der Mitarbeiter führt folgende Schritte aus:

Er prüft Ihre geschäftlichen Anforderungen, um Ihnen bei der endgültigen Konfiguration Ihrer Hardware zu helfen.
Er erfasst weitere Informationen zu Ihrem lokalen Netzwerk, Google Cloud Ihrem Projekt, dem Installationsstandort und anderen Anforderungen, die in den Installationsanforderungen aufgeführt sind.
Anhand dieser Informationen konfiguriert er Ihre Distributed Cloud-Hardware vor der Lieferung.

Mit Distributed Cloud verbundene Hardware über die GDC Hardware Management API bestellen

Mit der GDC Hardware Management API können Sie programmatisch eine Bestellung für Distributed Cloud-Hardware aufgeben. Eine Bestellung stellt Ihre Absicht dar, Distributed Cloud Connected bereitzustellen. Eine Bestellung muss die folgenden Informationen enthalten, die während der gesamten Lebensdauer Ihrer Distributed Cloud Connected-Bereitstellung verwendet werden:

Ansprechpartner für Auftragsverwaltung und Lieferung
Adresse des Lieferstandorts und alle für die Lieferung relevanten Informationen
Hardwarekonfiguration
Netzwerkkonfiguration

Sie müssen mit Ihrem Google-Vertriebsmitarbeiter zusammenarbeiten, um den Fragebogen zu Kundeninformationen (Customer Information Questionnaire, CIQ) auszufüllen und den Umfang und die Konfiguration Ihrer Distributed Cloud Connected-Bereitstellung festzulegen.

GDC Hardware Management API aktivieren

Bevor Sie die GDC Hardware Management API verwenden können, müssen Sie sie im Ziel Google Cloud projekt aktivieren. Führen Sie dazu die Schritte in diesem Abschnitt aus.

Console

Rufen Sie in der Google Cloud Console die Seite GDC Hardware Management API auf.

API aktivieren
Klicken Sie auf Aktivieren.

gcloud

Verwenden Sie den folgenden Befehl:

gcloud services enable gdchardwaremanagement.googleapis.com

Struktur einer Bestellung

Wenn Sie eine Bestellung über die GDC Hardware Management API aufgeben möchten, müssen Sie eine Order-Ressource sowie die zugehörigen Site-, Zone- und Hardware-Ressourcen erstellen, auf die die Order-Ressource verweist. Anschließend senden Sie die Order-Ressource an Google. Diese Ressourcen unterstützen standardmäßige CRUD-Vorgänge. Der Name jeder Ressource ist ein Pfad, der die Ziel Google Cloud projekt-ID und die Google Cloud Region enthält.

Diese Ressourcen haben die folgenden Funktionen. Weitere Informationen zur Verwendung der GDC Hardware Management API finden Sie in der Referenz zur Google Distributed Cloud CLI und API.

Order : Mit dieser Ressource wird die Erstellung einer oder mehrerer Distributed Cloud-Zonen angefordert. Wenn Sie diese Ressource erstellen, erhält sie einen Namen, auf den Sie im Feld create_order_response.name zugreifen können. Der Name der Order-Ressource hat das folgende Format:
```
`projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID
```
Dabei gilt:
- PROJECT_ID: Die ID des Ziel Google Cloud projekts.
- REGION: die Google Cloud Region, in der Sie Ihre Distributed Cloud-Zonen bereitstellen möchten.
- ORDER_ID: Eine eindeutige ID, die diese Bestellung identifiziert. Wenn sie nicht angegeben wird, wird automatisch ein Wert generiert. Wir empfehlen, einen eindeutigen Wert für die Bestell-ID anzugeben, der aus Kleinbuchstaben, Ziffern und Bindestrichen besteht. Andernfalls können bei fehlgeschlagenen Aufrufen zur Auftragserstellung doppelte Bestellungen generiert werden.
Site: Diese Ressource stellt den physischen Standort dar, an dem Sie Ihre Distributed Cloud-Hardware bereitstellen möchten. Diese Ressource enthält die Kontaktdaten einer verantwortlichen Person, die den Zugriff für die Erstlieferung und die zukünftige Wartung koordiniert. Dieser Kontakt kann sich von dem unterscheiden, den Sie in der Bestellung angegeben haben.
Hardware: Diese Ressource instanziiert eine mit Distributed Cloud verbundene SKU und stellt einen Distributed Cloud-Server oder ein Rack dar. Jede Hardware-Ressource verweist auf die zugehörigen Order-, Site- und Zone-Ressourcen. Die verfügbaren SKUs können Sie mit dem ListSkus API-Aufruf aufrufen.
Zone: Diese Ressource gibt die Netzwerkkonfiguration Ihrer mit Distributed Cloud verbundenen Maschinen und der zugehörigen Cluster an. Eine Distributed Cloud-Zone umfasst ein oder mehrere mit Distributed Cloud verbundene Racks oder alle mit Distributed Cloud verbundenen Servermaschinen, die an Ihrem Standort bereitgestellt werden.

Wenn Sie eine Order Ressource an Google senden und sich ihr Status von DRAFT in SUBMITTED oder INFO_COMPLETE ändert, werden die meisten Feldwerte schreibgeschützt.

Lebenszyklus einer Bestellung

Eine Order Ressource kann einen der in State aufgeführten Status haben. Beteiligte können Kommentare zur Bestellung hinterlassen, die als Comment-Ressourcen gespeichert werden, die in der entsprechenden Order-Ressource verschachtelt sind. Sie können Kommentare sowohl über die GDC Hardware Management API als auch über die Google Cloud Console lesen und senden.

Die GDC Hardware Management API unterstützt die folgenden Vorgänge im Lebenszyklus von Bestellungen:

Bestellung erstellen und senden Sie können eine Bestellung erstellen und sofort senden oder sie schrittweise erstellen und im Status DRAFT speichern, bis Sie sie senden möchten. Dieser Vorgang wird im Rest dieses Leitfadens beschrieben.
Bestellstatus prüfen Wenn die Bestellung mit Typ INFO_COMPLETE gesendet wird und Sie einen Vertrag mit Google abgeschlossen haben, durchläuft die Bestellung die folgende Status folge: ACCEPTED, BUILDING, SHIPPING, INSTALLING und COMPLETED. Die Status der zugehörigen Zone und Hardware Ressourcen werden synchron mit der Order Ressource aktualisiert.
Probleme mit der Bestellung beheben Wenn wir weitere Informationen von Ihnen benötigen oder Sie keinen Vertrag mit Google abgeschlossen haben, wechselt die Bestellung in den Status ADDITIONAL_INFO_NEEDED und wartet auf die Lösung über Kommentare. Weitere Anweisungen finden Sie in einem Kommentar. Wenden Sie sich an Google, wenn die nächsten Schritte an irgendeiner Stelle unklar sind.
Nicht gesendete Bestellung löschen Sie können eine nicht gesendete Bestellung mit einem DELETE-Aufruf löschen.
Gesendete Bestellung ändern Sie können die gesendete Bestellung, den Standort und die Zone mit dem entsprechenden PATCH Aufruf ändern. Die folgenden Felder können nach dem Senden bearbeitet werden:
- Alle Ressourcen: display_name, labels
- Bestellung: organization_contact
- Standort: access_times, die meisten Felder von organization_contact, aber nicht die Standortadresse
- Hardware: requested_installation_date, wenn mindestens eine der folgenden Bedingungen erfüllt ist:
  - Das neue Datum liegt mehr als 45 Tage in der Zukunft.
  - Das neue requested_installation_date liegt nach dem aktuellen requested_installation_date und estimated_installation_date ist leer.
  - Das neue requested_installation_date liegt nach dem aktuellen requested_installation_date und estimated_installation_date liegt mindestens 7 Tage in der Zukunft.
Nachdem eine Bestellung gesendet wurde, können keine weiteren Informationen mehr geändert werden. Sie können Google jedoch bitten, dies zu tun, indem Sie einen Kommentarhinterlassen.
Gesendete Bestellung stornieren Sie können eine gesendete Bestellung stornieren, indem Sie einen Kommentar hinzufügen, in dem Sie die Stornierung anfordern.

Ziel Google Cloud projekt auswählen

Ein Google Cloud Projekt ist ein Konstrukt, das eine Reihe von Google Cloud Ressourcen kapselt, sie Ihnen zur Verfügung stellt und Regeln für die Zugriffssteuerung und Abrechnung für diese Ressourcen festlegt.

Wir empfehlen, ein separates Google Cloud Projekt pro Verwaltungsdomain zu erstellen, z. B. ein Land oder eine Unternehmensabteilung, und für einen allgemeinen Anwendungsfall, z. B. Edge im Vergleich zu Core, und Ihre Distributed Cloud Connected-Bereitstellung für die Domain über dieses Google Cloud Projekt zu verwalten.

Mit dem Google Cloud Projekt können Sie die folgenden Verwaltungsaufgaben ausführen:

Mit Distributed Cloud verbundene Hardware bestellen
Mit Distributed Cloud verbundene Cluster konfigurieren und in einer Flotte registrieren
Software-Roll-outs verwalten
Mit Distributed Cloud verbundene Daten in Cloud Storage verwalten
Mit Distributed Cloud verbundene Anmeldedaten in Secret Manager verwalten
Mit Distributed Cloud verbundene Logs und Messwerte in Cloud Monitoring verwalten

Ihre genaue Google Cloud Projektstruktur hängt von Ihren geschäftlichen Anforderungen ab. Wir empfehlen , projektübergreifende Abhängigkeiten zu vermeiden und Ressourcen immer in jedem Google Cloud Projekt zu erstellen und zu verwenden.

Hardware, die in einem bestimmten Google Cloud Projekt bestellt wurde, wird immer in diesem Google Cloud Projekt verwaltet.

Ziel Google Cloud region auswählen

Die spezifische Auswahl der Google Cloud Regionen für Ihre Distributed Cloud Connected Bereitstellung hängt von Ihren geschäftlichen Anforderungen und den rechtlichen Auswirkungen Ihrer Zielstandorte ab.

Wenn Sie Ihre Distributed Cloud Connected-Bereitstellung in eine vorhandene Multi-Region Google Cloud Konfiguration einbinden, empfehlen wir, jede Distributed Cloud Connected-Zone der Google Cloud Region zuzuordnen, in der sich die Abhängigkeiten dieser Zone befinden.

Wenn Sie die Distributed Cloud Connected-Bereitstellung nicht in eine vorhandene Google Cloud Konfiguration einbinden, empfehlen wir, die Auswahl der Google Cloud Regionen zu diversifizieren, um die Zuverlässigkeit zu erhöhen. Beispiel:

Ordnen Sie jede Distributed Cloud Connected-Zone der nächstgelegenen unterstützten Google Cloud Region zu. Dadurch wird die Auswirkung eines Fehlers in der Steuerungsebene auf eine einzelne geografische Region beschränkt.
Verteilen Sie Ihre Distributed Cloud Connected-Bereitstellung auf mehrere Google Cloud Regionen. Dadurch wird die Anzahl der mit Distributed Cloud verbundenen Zonen begrenzt, die von einem Fehler in der Steuerungsebene betroffen sein können. Die betroffenen Zonen sind jedoch über eine größere geografische Region verteilt.

Distributed Cloud Connected unterstützt die folgenden Google Cloud Regionen:
Asien: asia-east1, asia-east2, asia-northeast1, asia-northeast3, asia-south1, asia-south2, asia-southeast1, asia-southeast2
Europa: europe-central2, europe-north1, europe-west1, europe-west2, europe-west3, europe-west4, europe-west6, europe-west8, europe-west9
Naher Osten: me-central1, me-west1
Ozeanien: australia-southeast1
Nordamerika: northamerica-northeast1, northamerica-northeast2, us-central1, us-central2, us-east1, us-east4, us-east5, us-east7, us-south1, us-west1, us-west2, us-west3, us-west4, us-west8
Südamerika: southamerica-east1, southamerica-west1

Umgebung einrichten

Bevor Sie beginnen, müssen die folgenden Voraussetzungen erfüllt sein:

Richten Sie eine Python-Entwicklungsumgebung ein.
Installieren Sie die Clientbibliothek der GDC Hardware Management API mit dem folgenden Befehl:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
Aktivieren Sie die GDC Hardware Management API im Ziel Google Cloud projekt.

Bestellung für mit Distributed Cloud verbundene Hardware über die GDC Hardware Management API erstellen und senden

Die Schritte in diesem Abschnitt sind Beispiele, die veranschaulichen, wie Sie eine Order-Ressource mit der GDC Hardware Management API erstellen und an Google senden. Für die Schritte in diesem Abschnitt benötigen Sie die Rolle „GDC Hardware Management Admin“ (roles/gdchardwaremanagement.admin) in Ihrem Google Cloud Projekt. Weitere Informationen zu den verfügbaren Typen und Methoden finden Sie in der Referenz zur Python-Clientbibliothek.

Erstellen Sie eine Order-Ressource. Beispiel:

import datetime
from google.cloud import gdchardwaremanagement_v1alpha
from google.protobuf.timestamp_pb2 import Timestamp
from google.type import postal_address_pb2

client = gdchardwaremanagement_v1alpha.GDCHardwareManagementClient()

contact = gdchardwaremanagement_v1alpha.Contact(
    given_name="John",
    family_name="Customer",
    email="jcustomer@example.com",
    phone="+1 123 456 7890",
)

organization_contact = gdchardwaremanagement_v1alpha.OrganizationContact(
    address=postal_address_pb2.PostalAddress(
        organization="Example Organization",
        address_lines=["1800 Amphibious Blvd."],
        locality="Mountain View",
        administrative_area="CA",
        postal_code="94045",
        region_code="US",
    ),
    contacts=[contact],
)

order = gdchardwaremanagement_v1alpha.Order(
    organization_contact=organization_contact,
    customer_motivation="I like Google Distributed Cloud!",
    fulfillment_time=Timestamp(
        seconds=int(datetime.datetime(2024, 11, 22, 9, 0).timestamp()),
    ),
    region_code="US",
)

create_order_response = client.create_order(
    request=gdchardwaremanagement_v1alpha.CreateOrderRequest(
        parent="projects/myProject/locations/us-east1",
        order_id="myOrderID",
        order=order,
    ),
).result()

Ihre Bestellung hat jetzt den Status DRAFT und es wurde ihr ein Ressourcenname zugewiesen, der im Feld create_order_response.name gespeichert ist. Verwenden Sie diesen Ressourcennamen, wenn Sie den Status dieser Bestellung ändern oder verfolgen möchten.

Erstellen Sie eine Site-Ressource. Beispiel:

site = gdchardwaremanagement_v1alpha.Site(
    organization_contact=organization_contact,
    google_maps_pin_uri="https://maps.app.goo.gl/z7bE8z8fffg6Sri46",
)

create_site_response = client.create_site(
    request=gdchardwaremanagement_v1alpha.CreateSiteRequest(
        parent="projects/myProject/locations/us-east1",
        site_id="mySite",
        site=site,
    ),
).result()

Erstellen Sie eine Zone-Ressource. Beispiel:

zone = gdchardwaremanagement_v1alpha.Zone(
    contacts=[contact],
    network_config=gdchardwaremanagement_v1alpha.ZoneNetworkConfig(
        management_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
            address_range="192.0.2.0/24",
            default_gateway_ip_address="192.0.2.1",
        ),
        machine_mgmt_ipv4_range="192.0.2.8/29",
        kubernetes_ipv4_subnet=gdchardwaremanagement_v1alpha.Subnet(
            address_range="203.0.113.0/24",
            default_gateway_ip_address="203.0.113.1",
        ),
        kubernetes_node_ipv4_range="203.0.113.8/29",
        kubernetes_control_plane_ipv4_range="203.0.113.16/29",
    ),
)

create_zone_response = client.create_zone(
    request=gdchardwaremanagement_v1alpha.CreateZoneRequest(
        parent="projects/myProject/locations/us-east1",
        zone_id="myZone",
        zone=zone,
    ),
).result()

Erstellen Sie die Hardware-Ressourcen. Sie müssen für jede Maschine in Ihrer Distributed Cloud Connected-Bereitstellung einen eindeutigen hardware_id-Wert angeben. Beispiel:

from google.type import date_pb2

hardware = gdchardwaremanagement_v1alpha.Hardware(
    order=create_order_response.name,
    site=create_site_response.name,
    zone=create_zone_response.name,
    config=gdchardwaremanagement_v1alpha.HardwareConfig(
        sku="projects/myProject/locations/us-east1/skus/gdce-server-l",
        power_supply=gdchardwaremanagement_v1alpha.types.PowerSupply.POWER_SUPPLY_AC,
    ),
    physical_info=gdchardwaremanagement_v1alpha.HardwarePhysicalInfo(
        power_receptacle=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.PowerReceptacleType.NEMA_5_15,
        network_uplink=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.NetworkUplinkType.RJ_45,
        voltage=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Voltage.VOLTAGE_110,
        amperes=gdchardwaremanagement_v1alpha.types.HardwarePhysicalInfo.Amperes.AMPERES_15,
    ),
    installation_info=gdchardwaremanagement_v1alpha.HardwareInstallationInfo(
        rack_location="Floor 2, Room 201, Row 7, Rack 3",
        power_distance_meters=2,
        switch_distance_meters=2,
        rack_unit_dimensions=gdchardwaremanagement_v1alpha.Dimensions(
            width_inches=19,
            height_inches=1.75,
            depth_inches=30,
        ),
        rack_space=gdchardwaremanagement_v1alpha.RackSpace(
            start_rack_unit=12,
            end_rack_unit=12,
        ),
        rack_type=gdchardwaremanagement_v1alpha.types.HardwareInstallationInfo.RackType.FOUR_POST,
    ),
    requested_installation_date=date_pb2.Date(year=2024, month=11, day=22),
)

create_hardware_response = client.create_hardware(
    request=gdchardwaremanagement_v1alpha.CreateHardwareRequest(
        parent="projects/myProject/locations/us-east1",
        hardware_id="machineHardwareID",
        hardware=hardware,
    ),
).result()

Senden Sie die Order-Ressource an Google:
```
submit_order_response = client.submit_order(
    request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
        name=create_order_response.name,
        type_=gdchardwaremanagement_v1alpha.types.SubmitOrderRequest.Type.INFO_COMPLETE,
    ),
).result()
```
Der Übermittlungstyp INFO_COMPLETE gibt an, dass Sie alle erforderlichen Informationen in den Ressourcen Zone und Hardware angegeben haben. Wenn Feldwerte fehlen, schlägt die Übermittlung mit einer Fehlermeldung fehl, in der das Problem beschrieben wird. Wenn Sie ein Gespräch mit Google beginnen möchten, ohne die Bestellung vollständig auszufüllen, senden Sie sie mit dem Status INFO_PENDING, um diese Validierungen zu überspringen.

Test

Wenn Sie eine Testbestellung aufgeben möchten, wenden Sie sich an Google, um Zugriff auf eine Sandbox-Umgebung zu erhalten. Nachdem Ihrem Projekt oder Ihrer Organisation Zugriff gewährt wurde, können Sie eine Test-SKU verwenden, die durch das Präfix fake- gekennzeichnet ist. Testbestellungen durchlaufen die zuvor beschriebenen Phasen, lösen jedoch keine Kosten oder einen Hardwareversand aus.

Fehlerbehebung

In diesem Abschnitt werden die häufigsten Fehler, ihre Ursachen und verfügbaren Lösungen beschrieben.

Fehler: `400 FAILED_PRECONDITION`

Wenn Sie als Antwort auf Ihren API-Aufruf einen 400-Fehlercode mit dem Status FAILED_PRECONDITION erhalten, prüfen Sie, ob Ihre Anfrage für den Vorgang gültig ist, den Sie ausführen möchten. Beispiele für ungültige Anfragen sind das Senden einer Order-Ressource mit fehlenden Feldern oder Werten oder der Versuch, eine Hardware-Ressource zu löschen, die mit einer zuvor gesendeten Order-Ressource verknüpft ist.

Fehler: `400 INVALID_ARGUMENT`

Wenn Sie als Antwort auf Ihren API-Aufruf einen 400-Fehlercode mit dem Status INVALID_ARGUMENT erhalten, prüfen Sie, ob falsche Feldnamen und Werte vorhanden sind, die nicht mit den erwarteten Typen übereinstimmen, oder ob Werte fehlen. Dieser Fehler kann auch auftreten, wenn Sie in einer PATCH-Anfrage eine updateMask verwenden und eines oder mehrere Felder, die in der updateMask angegeben sind, ungültig sind.

Informationen zur Behebung dieses Problems finden Sie unter GDC Hardware Management API Prüfen Sie, ob alle Feldnamen und ‑werte korrekt sind, einschließlich der Formatierung. Wenn Sie eine JSON-Nutzlast verwenden, prüfen Sie, ob alle erforderlichen Informationen in der Nutzlast enthalten sind.

Fehler: `401 UNAUTHENTICATED`

Wenn Sie als Antwort auf Ihren API-Aufruf einen 401-Fehlercode mit dem Status UNAUTHENTICATED erhalten, prüfen Sie Ihre Authentifizierungskonfiguration. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.

Fehler: `403 PERMISSION_DENIED`

Wenn Sie als Antwort auf Ihren API-Aufruf einen 403-Fehlercode mit dem Status PERMISSION_DENIED erhalten, prüfen Sie, ob das Dienstkonto, das für den API-Aufruf verwendet wurde, ausreichende Berechtigungen für den Zugriff auf die Zielobjekte und ‑ressourcen hat. Prüfen Sie außerdem, ob die Anmeldedaten korrekt und nicht abgelaufen sind.

Fehler: `404 NOT_FOUND`

Wenn Sie als Antwort auf Ihren API-Aufruf einen 404-Fehlercode mit dem Status NOT_FOUND erhalten, prüfen Sie, ob die in Ihrem API-Aufruf angegebenen Ressourcennamen und ‑pfade gültig sind. Unter GDC Hardware Management API können Sie prüfen, ob Ihre Anfrage-URL korrekt strukturiert ist und ob alle in der URL enthaltenen Felder gültig sind.

Nächste Schritte

Arbeitslasten in Google Distributed Cloud Connected bereitstellen