如需了解版本信息，请参阅 Distributed Cloud Connected 版本说明。

订购硬件

本页面介绍了如何订购 Google Distributed Cloud Connected 硬件。 Distributed Cloud Connected 可在以下国家/地区使用：

澳大利亚
奥地利
比利时
巴西
加拿大
丹麦
芬兰
法国
德国
香港
日本
印度
印度尼西亚
意大利
荷兰
挪威
波兰
沙特阿拉伯
新加坡
韩国
西班牙
瑞典
瑞士
英国
美国

在订购硬件之前，您必须满足分布式云连接安装要求。

Distributed Cloud Connected 订单类型

您可以根据自己的业务需求，通过以下方式之一订购 Distributed Cloud connected 硬件：

Google 自有硬件。您可以直接向 Google 订购 Distributed Cloud connected 硬件。在这种场景中，Google 会采购、维护、维修和停用 Distributed Cloud Connected 硬件。合同结束后，Google 会收回 Distributed Cloud 硬件并销毁存储在其中的所有数据。
由客户自行采购的硬件。在与 Google 协商确定符合您业务要求的部署配置后，您可以从 Google 合作伙伴 SI 订购 Distributed Cloud Connected。在此场景中，您拥有 Distributed Cloud Connected 硬件。SI 会与您和 Google 合作部署、维修和停用硬件。当合同结束时，SI 会从 Distributed Cloud Connected 硬件中清除所有 Google 软件和您的数据。然后，您可以随意重复使用或处置硬件。

使用 Google Cloud 控制台订购 Distributed Cloud connected 硬件

在 Google Cloud 控制台中，前往订单页面。
前往“订单”页面
选择目标 Google Cloud 项目。
点击创建订单。
填写申请表单并提交。

Google Cloud 销售代表会审核您提交的申请，并与您联系以完成订单。客服人员会执行以下操作：

审核您的业务需求，帮助您选择最佳的硬件配置。
收集有关本地网络、 Google Cloud 项目、安装地点以及安装要求中列出的其他要求的信息。
使用此信息在交付之前配置 Distributed Cloud 硬件。

使用 GDC Hardware Management API 订购 Distributed Cloud connected 硬件

如需使用 GDC Hardware Management API 下单，您必须创建 Order 资源，以及 Order 资源引用的随附 Site、Zone 和 Hardware 资源。然后，您将 Order 资源提交给 Google。

这些资源具有以下功能。如需详细了解如何使用 GDC Hardware Management API，请参阅 Google Distributed Cloud CLI 和 API 参考文档。

Order。此资源请求创建一个或多个 Distributed Cloud 区域。创建此资源时，系统会为其分配一个可在 create_order_response.name 字段中访问的名称。Order 资源名称采用以下格式：
```
`projects/`PROJECT_ID`/locations/`REGION`/orders/`ORDER_ID
```
其中：
- PROJECT_ID：目标 Google Cloud 项目的 ID。
- REGION：您要在其中部署 Distributed Cloud 区域的 Google Cloud 区域。
- ORDER_ID：用于标识相应订单的唯一 ID。如果省略，系统会自动生成一个值。建议您提供一个由小写字母、数字和短划线组成的唯一订单 ID 值。否则，失败的订单创建调用可能会生成重复订单。
Site。此资源表示您要部署 Distributed Cloud 硬件的物理位置。此资源包含负责协调初始交付和未来维护的负责方的联系信息。此联系人可能与您在订单中提供的联系人不同。
Hardware。此资源表示 Distributed Cloud 服务器或机架。每个 Hardware 资源都会引用关联的 Order、Site 和 Zone 资源。如需查看可用的 SKU，请使用 ListSkus API 调用。
Zone。此资源表示将部署在您本地环境中的 Distributed Cloud connected 硬件。Distributed Cloud 可用区涵盖一个或多个 Distributed Cloud connected 机架，或部署在您位置的所有 Distributed Cloud connected 服务器机器。

在完成本部分中的步骤之前，您必须与 Google 销售代表合作，完成客户信息问卷 (CIQ)，并最终确定 Distributed Cloud Connected 部署的范围和配置。您需要提供此信息才能下单。

前提条件

在开始之前，请完成以下前提条件：

设置 Python 开发环境。
使用以下命令安装 GDC 硬件管理 API 客户端库：
```
python3 -m pip install google-cloud-gdchardwaremanagement
```
在目标 Google Cloud 项目上启用 GDC Hardware Management API。

使用 GDC Hardware Management API 创建并提交 Distributed Cloud connected 硬件订单

本部分中的步骤是一些示例，用于说明如何使用 GDC 硬件管理 API 创建 Order 资源并将其提交给 Google。如需完成此部分中的步骤，您必须在 Google Cloud 项目中拥有 GDC Hardware Management Admin (roles/gdchardwaremanagement.admin) 角色。

创建 Order 资源。例如：

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

您的订单现在处于 DRAFT 状态，并且已分配一个存储在 create_order_response.name 字段中的资源名称。在修改或跟踪相应订单的状态时，请使用此资源名称。

创建 Site 资源。例如：

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

创建 Zone 资源。例如：

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

创建 Hardware 资源。您必须为 Distributed Cloud connected 部署中的每台机器指定唯一的 hardware_id 值。例如：

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

向 Google 提交 Order 资源：

submit_order_response = client.submit_order(
    request=gdchardwaremanagement_v1alpha.SubmitOrderRequest(
        name=create_order_response.name,
    ),
).result()

后续步骤

在 Google Distributed Cloud connected 上部署工作负载