Method: projects.locations.zones.signal

指示可用区的状态。

HTTP 请求

POST https://gdchardwaremanagement.googleapis.com/v1alpha/{name=projects/*/locations/*/zones/*}:signal

网址采用 gRPC 转码语法。

路径参数

参数
name

string

必需。可用区的名称。格式:projects/{project}/locations/{location}/zones/{zone}

请求正文

请求正文中包含结构如下的数据:

JSON 表示法
{
  "requestId": string,
  "stateSignal": enum (StateSignal),
  "provisioningStateSignal": enum /1.13.0/docs/f="/distributed-cloud/connected/latest/docs/reference/hardware/rest/v1alpha/projects.locations.zones/signal#ProvisioningStateSignal">ProvisioningStateSignal),
  "step": string,
  "details": string
}
字段
requestId

string

可选。此请求的可选唯一标识符。请参阅 AIP-155。

stateSignal

enum (StateSignal)

可选。要为此区域发送的状态信号。必须设置 stateSignal 或 provisioningStateSignal,但不能同时设置这两者。

provisioningStateSignal

enum (ProvisioningStateSignal)

可选。要为此可用区发送的预配状态信号。必须设置 stateSignal 或 provisioningStateSignal,但不能同时设置这两者。

step

string

可选。正在执行的步骤。当 stateSignal 为 FACTORY_TURNUP_CHECKS_STARTED 或 FACTORY_TURNUP_CHECKS_FAILED 时,提供更精细的状态。

details

string

可选。其他详细信息,例如 stateSignal 为 FACTORY_TURNUP_CHECKS_FAILED 时的出错提示。它还可以包含网站验证输出。

响应正文

如果成功,则响应正文包含一个 Operation 实例。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/cloud-platform

如需了解详情,请参阅 Authentication Overview。

IAM 权限

需要拥有 name 资源的以下 IAM 权限:

  • gdchardwaremanagement.zones.update

如需了解详情,请参阅 IAM 文档。

StateSignal

可用区的有效状态信号。

枚举
STATE_SIGNAL_UNSPECIFIED 未指定可用区的状态信号。
FACTORY_TURNUP_CHECKS_STARTED 已开始进行工厂启动检查。
FACTORY_TURNUP_CHECKS_PASSED 该可用区已准备好进行站点启用。
READY_FOR_SITE_TURNUP

该可用区已准备好进行站点启用。已弃用,但未删除。

FACTORY_TURNUP_CHECKS_FAILED 该可用区未通过工厂启动检查。
VERIFY_CLUSTER_INTENT_PRESENCE 验证是否存在有效的集群 intent。
SITE_VALIDATION_PASSED 网站验证已通过所有检查。
SITE_VALIDATION_FAILED 网站验证失败。

ProvisioningStateSignal

可用区的有效预配状态信号。

枚举
PROVISIONING_STATE_SIGNAL_UNSPECIFIED 未指定配置状态信号。
PROVISIONING_IN_PROGRESS 正在进行配置。
PROVISIONING_COMPLETE 配置已完成。