Untuk mengetahui informasi versi, lihat catatan rilis Distributed Cloud terhubung.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Memesan hardware

Halaman ini menjelaskan cara memesan hardware Google Distributed Cloud terhubung. Distributed Cloud connected tersedia di negara berikut:

Australia
Austria
Belgia
Brasil
Kanada
Cile
Denmark
Finlandia
Prancis
Jerman
Hong Kong
Jepang
India
Indonesia
Italia
Malaysia
Meksiko
Belanda
Norwegia
Polandia
Arab Saudi
Singapura
Korea Selatan
Spanyol
Swedia
Swiss
Inggris Raya
Amerika Serikat
Uruguay

Sebelum memesan hardware, Anda harus memenuhi persyaratan penginstalan yang terhubung ke Distributed Cloud.

Pengadaan Distributed Cloud terhubung

Anda secara langsung mendapatkan hardware yang terhubung ke Distributed Cloud dalam konfigurasi bersertifikasi Google yang memenuhi persyaratan bisnis Anda, lalu membuat kontrak dengan integrator sistem (SI) bersertifikasi Google yang men-deploy dan mengelola hardware bersertifikasi Google Anda. Setiap deployment Distributed Cloud yang terhubung dilacak sebagai pesanan di Google Cloud konsol dan melalui Distributed Cloud Hardware Management API. Saat Anda membuat pesanan yang terhubung ke Distributed Cloud, Google dan SI bersertifikasi Google akan bekerja sama dengan Anda untuk menyediakan, men-deploy, memperbaiki, dan menonaktifkan hardware di sepanjang siklus prosesnya.

Varian hardware Distributed Cloud terhubung

Google telah mensertifikasi platform hardware yang terhubung dengan Distributed Cloud berikut:

Server G1 yang terhubung ke Distributed Cloud. Grup yang terdiri dari tiga mesin rackmount Dell XR11 1U. Untuk mengetahui informasi selengkapnya, lihat Hardware G1 server yang terhubung Distributed Cloud.
Server terhubung Distributed Cloud G2. Sasis Dell XR8000r yang diisi dengan tiga sled mesin XR8610t. Untuk mengetahui informasi selengkapnya, lihat Hardware server yang terhubung Distributed Cloud G2.

Untuk mengetahui daftar SKU server yang terhubung ke Distributed Cloud, lihat harga Distributed Cloud terhubung.

Prasyarat

Bagian ini menjelaskan Google Cloud persyaratan penyiapan dan informasi yang perlu Anda kumpulkan sebelum memesan hardware.

Google Cloud penyiapan

Sebelum memulai, pastikan Anda memiliki izin yang diperlukan dan API diaktifkan di project Google Cloud Anda. Anda harus menyelesaikan langkah-langkah ini, baik saat melakukan pemesanan langsung melalui konsol Google Cloud maupun melalui API terintegrasi.

Google Cloud project: Anda harus memiliki project Google Cloud dengan administrator yang diberi otorisasi untuk mengaktifkan Distributed Cloud Hardware Management API. Untuk mengetahui informasi selengkapnya tentang cara membuat project Google Cloud, lihat Membuat project. Project yang Anda gunakan untuk mengelola cluster harus sama dengan project yang Anda gunakan saat memesan hardware.
GDC Hardware Management API: Anda harus mengaktifkan GDC Hardware Management API. Di konsol Google Cloud , buka halaman GDC Hardware Management API. Jika perlu, klik Enable untuk mengaktifkan API.

Buka GDC Hardware Management API
Peran IAM: Untuk memesan hardware, Anda harus diberi peran IAM GDC Hardware Management Admin (gdchardwaremanagement.admin). Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.
Persyaratan kontrak: Sebelum Google dapat memproses permintaan pemenuhan, Anda harus memiliki kontrak yang valid dan ditandatangani yang tersimpan dalam sistem dan ID penagihan. Untuk informasi selengkapnya, lihat Menemukan ID akun Penagihan Cloud.

Kontak

Untuk melakukan pemesanan, Anda harus memberikan kontak berikut:

Kontak pesanan: Orang yang bertanggung jawab untuk mengelola deployment hardware yang terhubung ke Distributed Cloud di organisasi Anda. Berikan perwakilan perusahaan yang dapat kami hubungi untuk menyelesaikan proses penjualan dan kontrak.
Kontak situs: Orang yang bertanggung jawab atas situs deployment yang dipilih. Google akan menghubungi orang ini untuk menjadwalkan dan menyelesaikan pengiriman hardware yang terhubung ke Distributed Cloud Anda. Orang ini juga mengoordinasikan reparasi dan penonaktifan hardware dengan Google atau dengan SI bersertifikasi Google.
Kontak jaringan dan zona: Orang yang bertanggung jawab untuk mengintegrasikan hardware Distributed Cloud terhubung ke infrastruktur jaringan dan daya yang ada di situs deployment. Orang ini juga membantu pemecahan masalah bersama jika diperlukan.

Informasi situs

Sebelum melakukan pemesanan, kumpulkan informasi berikut:

ID pesanan: ID yang bermakna untuk pesanan hardware yang terhubung ke Distributed Cloud ini.
ID situs: ID yang bermakna untuk situs deployment untuk pesanan hardware yang terhubung ke Distributed Cloud ini.
ID zona: ID yang bermakna untuk target zona yang terhubung ke Distributed Cloud. Jika Anda hanya men-deploy satu zona per situs, gunakan ID situs sebagai ID zona.
Negara deployment: Negara tempat hardware Anda akan di-deploy. Negara memengaruhi mata uang penagihan dan ketersediaan hardware. Untuk memesan hardware di beberapa lokasi, buat pesanan terpisah untuk setiap negara.
Region: Lokasi geografis tempat data pelanggan dan pesanan Anda disimpan. Pilihan ini memastikan bahwa data Anda tetap berada di dalam region yang dipilih, sehingga membantu Anda memenuhi persyaratan kepatuhan.
Informasi perusahaan: Saat melakukan pemesanan, Anda harus memberikan nama perusahaan, alamat email, nomor telepon, dan alamat penagihan.

Informasi konfigurasi jaringan

Saat melakukan pemesanan, Anda harus membuat pilihan untuk konfigurasi jaringan. Gunakan informasi dalam tabel berikut untuk memahami konfigurasi jaringan yang perlu Anda berikan selama penempatan pesanan.

Jenis jaringan	Nama konfigurasi IP	Deskripsi
Jaringan pengelolaan mesin	Alamat pengelolaan mesin IPv4 dalam notasi CIDR	Setiap server memiliki alamat IP untuk traffic pengelolaan Distributed Cloud. Blok ini mengonfigurasi alamat IP dari subnet pengelolaan mesin yang digunakan untuk tugas ini.
	Subnet pengelolaan mesin IPv4 dalam notasi CIDR	Subnet yang dialokasikan untuk traffic pengelolaan Distributed Cloud. Traffic mencakup update software infrastruktur Distributed Cloud serta log dan metrik infrastruktur. Subnet ini harus cukup besar untuk memuat blok alamat IPv4 untuk pengelolaan mesin serta gateway default subnet pengelolaan mesin.
	Gateway default subnet pengelolaan mesin	Alamat IP gateway dalam subnet pengelolaan mesin
Traffic node Kubernetes	Alamat node Kubernetes IPv4 dalam notasi CIDR	Setiap server memiliki alamat IP untuk traffic terkait Kubernetes. Blok ini mengonfigurasi alamat IP dari subnet Kubernetes yang digunakan untuk traffic terkait Kubernetes.
	Blok alamat IPv4 untuk VIP bidang kontrol Kubernetes dalam notasi CIDR	Setiap cluster Kubernetes yang dibuat di zona edge memiliki satu VIP bidang kontrol yang ditetapkan dari blok alamat ini. Jika Anda hanya ingin membuat satu cluster di zona edge, Anda dapat menggunakan blok alamat `/32`. Jika tidak, blok alamat harus lebih besar.
	Subnet Kubernetes IPv4 dalam notasi CIDR	Subnet yang dialokasikan untuk traffic Kubernetes. Traffic mencakup download container, jaringan utama Kubernetes, log dan metrik Kubernetes, serta traffic bidang kontrol Kubernetes. Jika kosong, subnet ini secara default adalah subnet pengelolaan mesin IPv4. Anda juga dapat menentukan subnet terpisah di kolom ini. Subnet ini harus cukup besar untuk memuat blok alamat IPv4 untuk traffic node Kubernetes, blok alamat IPv4 untuk VIP bidang kontrol Kubernetes, gateway default subnet Kubernetes, dan VIP load balancer jaringan utama yang direncanakan. Jika tidak ditentukan, nilai ini sama dengan nilai jaringan pengelolaan.
	Gateway default subnet Kubernetes	Alamat IP gateway dalam subnet Kubernetes. Jika kosong, kolom ini akan ditetapkan secara default ke Default gateway of the machine management subnet.
	ID VLAN utama Kubernetes	Secara default, node Kubernetes, termasuk jaringan Kubernetes utama, berada di VLAN yang sama dengan jaringan pengelolaan mesin. Untuk tujuan segmentasi jaringan, Anda dapat memisahkan jaringan ini.
Server nama DNS	Server nama DNS 1	IP server nama DNS. Infrastruktur Distributed Cloud menyelesaikan kueri DNS melalui IP ini. Jika tidak ditentukan, DNS Google akan digunakan.
Server nama DNS	Server nama DNS 2	IP server nama DNS. Infrastruktur Distributed Cloud menyelesaikan kueri DNS melalui IP ini. Jika tidak ditentukan, DNS Google akan digunakan.

Memesan hardware Distributed Cloud yang terhubung menggunakan konsol Google Cloud

Di konsol Google Cloud , buka halaman Orders.
Buka Pesanan
Pilih project Google Cloud target.
Klik Buat pesanan tunggal.
Dalam formulir Detail pesanan, masukkan detail pesanan yang Anda kumpulkan di bagian Prasyarat dalam dokumen ini. Klik Lanjutkan.

Catatan: Setelah memasukkan informasi di halaman Detail pesanan, Anda dapat menyimpan draf pesanan dengan mengklik Simpan sebagai draf. Opsi ini tersedia untuk setiap langkah proses pemesanan.
Di formulir Select hardware, pilih konfigurasi server, jumlah node, dan bulan langganan.
- Untuk cluster standar, nilai default untuk Number of nodes adalah 3. Opsi node tunggal hanya tersedia untuk pelanggan yang ada dalam daftar yang diizinkan.
- Untuk menghindari penolakan pesanan atau keterlambatan pemenuhan, detail yang Anda berikan harus sesuai dengan kontrak Google yang telah Anda tandatangani.
- Setelah formulir selesai diisi, klik Lanjutkan.
Di formulir Tambahkan info situs, tambahkan informasi tentang situs tempat hardware yang terhubung ke Distributed Cloud akan dikirim dan diinstal. Anda dapat menambahkan situs baru atau memilih situs yang ada. Setelah selesai, klik Lanjutkan.
Di formulir Tambahkan info zona, tambahkan zona baru atau pilih zona yang sudah ada.
- Untuk Penyediaan cluster, jika Anda berencana mengonfigurasi cluster sendiri, pilih Saya akan mengonfigurasi cluster di situs saya. Jika Anda ingin Google mengonfigurasi cluster untuk Anda, Anda harus memberikan maksud cluster agar Google dapat mengirimkan pesanan Anda dengan cluster yang telah dikonfigurasi sebelumnya.
- Informasi di bagian Konfigurasi jaringan diperlukan untuk menghubungkan hardware di zona Anda ke jaringan Google Cloud . Untuk mengetahui informasi selengkapnya tentang opsi ini, lihat bagian Informasi konfigurasi jaringan dalam dokumen ini.
  - Anda dapat menyimpan pesanan sebagai draf, dan membiarkan perwakilan zona dan jaringan Anda memasukkan informasi. Jika tidak, berikan informasi jaringan IP yang diperlukan.
  - Untuk Pilih template pilihan untuk alamat IP, pilih template yang sesuai dengan persyaratan Anda. Template ini membantu memastikan bahwa detail IP yang benar diberikan. Untuk memasukkan alamat IP secara manual, pilih IP Kustom.
- Setelah formulir selesai diisi, klik Lanjutkan.
Di formulir Persyaratan penginstalan, masukkan persyaratan lokasi fisik Anda, lalu klik Lanjutkan.
Di Tinjau detail dan kirimkan, verifikasi bahwa detail pesanan sudah benar, lalu klik Buat. Setelah Anda mengklik Buat, pesanan akan ditinjau. Google Cloud Sales representative akan meninjau kiriman Anda dan menghubungi Anda untuk menyelesaikan pesanan. Perwakilan melakukan hal berikut:
- Meninjau persyaratan bisnis Anda untuk membantu Anda menyelesaikan konfigurasi hardware.
- Mengumpulkan informasi lebih lanjut tentang jaringan lokal, Google Cloud project, lokasi pemasangan, dan persyaratan lainnya yang tercantum dalam persyaratan pemasangan.
- Menggunakan informasi ini untuk mengonfigurasi hardware Distributed Cloud Anda sebelum pengiriman.

Tanggal penginstalan yang Anda minta akan otomatis ditetapkan ke tanggal pertama yang tersedia, biasanya 45 hari setelah Google menerima pesanan.

Memesan hardware yang terhubung ke Distributed Cloud menggunakan GDC Hardware Management API

GDC Hardware Management API memungkinkan Anda memesan hardware Distributed Cloud secara terprogram. Pesanan merupakan niat Anda untuk men-deploy Distributed Cloud terhubung. Pesanan harus menyertakan informasi berikut, yang digunakan selama masa aktif deployment yang terhubung ke Distributed Cloud Anda:

Kontak (POC) untuk pengelolaan pesanan dan pengiriman
Alamat lokasi pengiriman dan informasi apa pun yang relevan dengan pengiriman
Konfigurasi hardware
Konfigurasi jaringan

Mengaktifkan GDC Hardware Management API

Sebelum dapat menggunakan GDC Hardware Management API, Anda harus mengaktifkannya di target Google Cloud project. Untuk melakukannya, selesaikan langkah-langkah di bagian ini.

Konsol

Di konsol Google Cloud , buka halaman GDC Hardware Management API.

Mengaktifkan API
Klik Enable.

gcloud

Gunakan perintah berikut:

gcloud services enable gdchardwaremanagement.googleapis.com

Struktur pesanan

Untuk melakukan pemesanan menggunakan GDC Hardware Management API, Anda harus membuat resource Order, serta resource Site, Zone, dan Hardware yang menyertainya yang dirujuk oleh resource Order. Kemudian, Anda mengirimkan resource Order ke Google. Resource ini mendukung operasi CRUD standar. Nama setiap resource adalah jalur yang mencakup project ID dan region Google Cloud target Google Cloud .

Referensi ini memiliki fungsi berikut. Untuk mengetahui informasi selengkapnya tentang penggunaan GDC Hardware Management API, lihat Referensi CLI dan API Google Distributed Cloud.

Order. Resource ini meminta pembuatan satu atau beberapa zona Distributed Cloud. Saat Anda membuat resource ini, resource akan menerima nama yang dapat diakses di kolom create_order_response.name. Nama resource Order memiliki format berikut:
```
`projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID
```
dengan:
- PROJECT_ID: ID project Google Cloud target.
- REGION: region Google Cloud tempat Anda ingin men-deploy zona Distributed Cloud.
- ORDER_ID: ID unik yang mengidentifikasi pesanan ini. Sebaiknya berikan nilai ID pesanan unik yang terdiri dari huruf kecil, angka, dan tanda hubung. Jika tidak, panggilan pembuatan pesanan yang gagal dapat menghasilkan pesanan duplikat.
Site. Resource ini mewakili lokasi fisik tempat Anda ingin men-deploy hardware Distributed Cloud. Referensi ini mencakup informasi kontak pihak yang bertanggung jawab yang mengoordinasikan akses untuk pengiriman awal dan pemeliharaan di masa mendatang. Kontak ini mungkin berbeda dengan kontak yang Anda berikan pada pesanan.
Hardware. Resource ini membuat instance SKU Distributed Cloud terhubung dan merepresentasikan server atau rak Distributed Cloud. Setiap resource Hardware mereferensikan resource Order,Site, dan Zone terkait. Untuk melihat SKU yang tersedia, gunakan panggilan API ListSkus.
Zone. Resource ini menentukan konfigurasi jaringan mesin yang terhubung Distributed Cloud dan cluster terkait. Zona Distributed Cloud mencakup satu atau beberapa rak yang terhubung ke Distributed Cloud atau semua mesin server yang terhubung ke Distributed Cloud yang di-deploy di lokasi Anda.

Saat Anda mengirimkan resource Order ke Google dan statusnya berubah dari DRAFT menjadi SUBMITTED atau INFO_COMPLETE, sebagian besar nilai kolom menjadi hanya baca.

Siklus proses pesanan

Resource Order dapat memiliki salah satu status yang tercantum di State. Pihak yang terlibat dapat memberikan komentar pada pesanan, yang disimpan sebagai resource Comment yang berada di bawah resource Order yang sesuai. Anda dapat membaca dan mengirimkan komentar melalui GDC Hardware Management API dan konsol Google Cloud .

GDC Hardware Management API mendukung operasi siklus proses pesanan berikut:

Buat dan kirimkan pesanan. Anda dapat membuat dan langsung mengirimkan pesanan, atau membuatnya secara bertahap dan menyimpannya dalam status DRAFT hingga Anda siap mengirimkannya. Proses ini dijelaskan di bagian selanjutnya dalam panduan ini.
Periksa status pesanan. Jika pesanan dikirimkan dengan type INFO_COMPLETE dan Anda telah menandatangani kontrak dengan Google, pesanan akan diproses melalui urutan status berikut: ACCEPTED, BUILDING, SHIPPING, INSTALLING, dan COMPLETED. Status resource Zone dan Hardware terkait diperbarui secara bersamaan dengan resource Order.
Menyelesaikan masalah pesanan. Jika kami memerlukan informasi lebih lanjut dari Anda atau Anda belum menandatangani kontrak dengan Google, pesanan akan memasuki status ADDITIONAL_INFO_NEEDED dan menunggu penyelesaian melalui komentar. Cari petunjuk lebih lanjut dalam komentar, dan hubungi Google jika langkah selanjutnya tidak jelas.
Menghapus pesanan yang belum dikirimkan. Anda dapat menghapus pesanan yang belum dikirimkan dengan panggilan DELETE.
Mengubah pesanan yang dikirimkan. Anda dapat mengubah pesanan, situs, dan zona yang dikirimkan menggunakan panggilan PATCH masing-masing. Kolom berikut dapat diedit setelah pengiriman:
- Semua resource: display_name, labels
- Pesanan: organization_contact
- Situs: access_times, sebagian besar kolom organization_contact, tetapi bukan alamat situs
- Hardware: requested_installation_date jika setidaknya satu hal berikut berlaku:
  - Tanggal baru lebih dari 45 hari dari sekarang
  - requested_installation_date baru lebih lambat dari waktu saat ini requested_installation_date dan estimated_installation_date kosong
  - requested_installation_date baru lebih lambat dari requested_installation_date dan estimated_installation_date saat ini setidaknya 7 hari dari sekarang
Tidak ada informasi lain yang dapat diubah setelah pesanan dikirimkan, tetapi Anda dapat meminta Google melakukannya dengan memberikan komentar.
Membatalkan pesanan yang dikirimkan. Anda dapat membatalkan pesanan yang telah dikirimkan dengan menambahkan komentar ke pesanan tersebut untuk meminta pembatalan.

Pilih project Google Cloud target

Project Google Cloud adalah konstruksi yang merangkum sekumpulan Google Cloud resource, membuatnya tersedia untuk Anda gunakan, dan menetapkan aturan untuk kontrol akses dan penagihan untuk resource tersebut.

Sebaiknya Anda membuat project Google Cloud terpisah per domain administratif dan tidak membuat dependensi lintas project di seluruh deployment yang terhubung ke Distributed Cloud. Khususnya, jangan gunakan kembali hal berikut di berbagai project Google Cloud :

Urutan, zona, dan resource hardware dalam GDC Hardware Management API
Resource cluster di Distributed Cloud Edge Container API
Log dan metrik di Cloud Monitoring
Kredensial dan referensi lainnya

Untuk mengetahui informasi selengkapnya tentang Google Cloud project, lihat artikel Membuat dan mengelola project.

Pilih wilayah Google Cloud target

Pilihan spesifik Google Cloud region untuk deployment yang terhubung ke Distributed Cloud Anda bergantung pada persyaratan bisnis dan konsekuensi hukum dari target lokasi geografis Anda.

Jika Anda mengintegrasikan deployment yang terhubung ke Distributed Cloud ke jejakGoogle Cloud multi-region yang ada, sebaiknya petakan setiap zona yang terhubung ke Distributed Cloud ke Google Cloud region yang menghosting dependensi zona tersebut.

Jika Anda tidak mengintegrasikan deployment yang terhubung dengan Distributed Cloud dengan jejak Google Cloud yang ada, sebaiknya pilih beragam wilayah Google Cloud untuk meningkatkan keandalan. Misalnya:

Petakan setiap zona yang terhubung ke Distributed Cloud ke Google Cloud region yang didukung terdekat. Hal ini membatasi dampak kesalahan bidang pengelolaan pada satu wilayah geografis.
Gabungkan Distributed Cloud yang terhubung di beberapa Google Cloud region. Hal ini membatasi jumlah zona yang terhubung ke Distributed Cloud yang dapat terpengaruh oleh kesalahan bidang pengelolaan; namun, zona yang terpengaruh tersebar di wilayah geografis yang lebih besar.

Distributed Cloud Connected mendukung wilayah Google Cloud berikut:
Asia: asia-east1, asia-east2, asia-northeast1, asia-northeast3, asia-south1, asia-south2, asia-southeast1, asia-southeast2
Eropa: europe-central2, europe-north1, europe-west1, europe-west2, europe-west3, europe-west4, europe-west6, europe-west8, europe-west9
Timur Tengah: me-central1, me-west1
Oceania: australia-southeast1
Amerika Utara: 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
Amerika Selatan: southamerica-east1, southamerica-west1

Menyiapkan lingkungan Anda

Sebelum memulai, selesaikan prasyarat berikut:

Siapkan lingkungan pengembangan Python.
Instal library klien GDC Hardware Management API menggunakan perintah berikut:
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
Aktifkan GDC Hardware Management API di project Google Cloud target.

Membuat dan mengirimkan pesanan hardware yang terhubung ke Distributed Cloud menggunakan GDC Hardware Management API

Langkah-langkah di bagian ini adalah contoh yang menggambarkan cara membuat dan mengirimkan resource Order ke Google menggunakan GDC Hardware Management API. Untuk menyelesaikan langkah-langkah di bagian ini, Anda harus memiliki peran Admin Pengelolaan Hardware GDC (roles/gdchardwaremanagement.admin) di project Google Cloud Anda. Untuk mengetahui detail jenis dan metode yang tersedia, lihat referensi library klien Python.

Buat resource Order. Contoh:

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()

Pesanan Anda kini dalam status DRAFT dan telah diberi nama resource yang disimpan di kolom create_order_response.name. Gunakan nama resource ini saat mengubah atau melacak status pesanan ini.

Buat resource Site Contoh:

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()

Buat resource Zone Contoh:

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()

Buat resource Hardware. Anda harus menentukan nilai hardware_id yang unik untuk setiap mesin dalam deployment yang terhubung ke Distributed Cloud. Contoh:

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()

Kirimkan resource Order ke 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()
```
Jenis pengiriman INFO_COMPLETE menunjukkan bahwa Anda telah memberikan semua informasi yang diperlukan dalam resource Zone dan Hardware. Jika ada nilai kolom yang tidak ada, pengiriman akan gagal dengan pesan error yang menjelaskan masalah tersebut. Jika Anda ingin memulai percakapan dengan Google tanpa mengisi pesanan sepenuhnya, kirimkan dengan status INFO_PENDING untuk melewati validasi ini.

Pengujian

Jika Anda ingin mengirimkan pesanan percobaan, hubungi Google untuk mendapatkan akses ke lingkungan sandbox. Setelah project atau organisasi Anda diberi akses, Anda dapat menggunakan SKU pengujian yang dapat diidentifikasi dengan awalan fake-. Pesanan uji coba berjalan melalui tahap yang dijelaskan sebelumnya, tetapi tidak memicu biaya moneter atau pengiriman hardware.

Pemecahan masalah

Bagian ini menjelaskan error yang paling sering terjadi, penyebabnya, dan solusi yang tersedia.

Error: `400 FAILED_PRECONDITION`

Jika Anda menerima kode error 400 dengan status FAILED_PRECONDITION sebagai respons terhadap panggilan API, periksa apakah permintaan Anda valid untuk operasi yang ingin Anda selesaikan. Contoh permintaan tidak valid mencakup pengiriman resource Order dengan kolom atau nilai yang tidak ada, atau mencoba menghapus resource Hardware yang terkait dengan resource Order yang dikirim sebelumnya.

Error: `400 INVALID_ARGUMENT`

Jika Anda menerima kode error 400 dengan status INVALID_ARGUMENT sebagai respons terhadap panggilan API Anda, periksa nama dan nilai kolom yang salah yang tidak cocok dengan jenis yang diharapkan, atau nilai yang hilang. Anda mungkin juga menerima error ini jika menggunakan updateMask dalam permintaan PATCH dan satu atau beberapa kolom yang ditentukan dalam updateMask tidak valid.

Untuk mengatasi masalah ini, lihat GDC Hardware Management API untuk memverifikasi bahwa semua nama dan nilai kolom sudah benar, termasuk pemformatan. Jika menggunakan payload JSON, pastikan semua informasi yang diperlukan disertakan dalam payload.

Error: `401 UNAUTHENTICATED`

Jika Anda menerima kode error 401 dengan status UNAUTHENTICATED sebagai respons terhadap panggilan API Anda, periksa konfigurasi autentikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan Kredensial Default Aplikasi.

Error: `403 PERMISSION_DENIED`

Jika Anda menerima kode error 403 dengan status PERMISSION_DENIED sebagai respons terhadap panggilan API Anda, periksa apakah akun layanan yang digunakan untuk melakukan panggilan API memiliki hak istimewa yang memadai untuk mengakses objek dan resource target. Selain itu, pastikan kredensial sudah benar dan masa berlakunya belum habis.

Error: `404 NOT_FOUND`

Jika Anda menerima kode error 404 dengan status NOT_FOUND sebagai respons terhadap panggilan API Anda, periksa apakah nama dan jalur resource yang ditentukan dalam panggilan API Anda valid. Lihat GDC Hardware Management API untuk memverifikasi bahwa URL permintaan Anda disusun dengan benar dan semua kolom yang disertakan dalam URL valid.

Melacak status pesanan Anda

Anda dapat melacak status pesanan di Google Cloud konsol di halaman Pesanan. Tabel berikut mencantumkan kemungkinan status dan artinya.

Status UI	Arti
Draf	Pesanan disimpan sebagai draf.
Sedang ditinjau	Pesanan dikirim dan sedang ditinjau oleh Google.
Diterima	Google menerima pesanan dan meneruskannya ke pemenuhan pesanan oleh Google untuk diproses.
Membangun Hardware	Hardware sedang dibangun dan disediakan oleh SI bersertifikasi Google Anda.
Mengirimkan Hardware	Perangkat keras sedang dikirim ke alamat situs yang diberikan.
Menginstal	Perangkat keras sedang diinstal di alamat situs yang diberikan.
Dalam proses	Pesanan selesai sebagian. Misalnya, beberapa hardware telah dikirim dan diinstal.
Selesai	Pesanan selesai.
Info tidak ada	Kami memerlukan informasi tambahan dari Anda.
Tindakan yang diperlukan	Perlu segera diperhatikan karena ada masalah mendasar yang sangat penting.
Dibatalkan	Pesanan ditolak.

Langkah berikutnya

Men-deploy workload di Google Distributed Cloud terhubung