Method: projects.locations.privateClouds.externalAddresses.patch

更新单个外部 IP 地址的参数。仅应用 updateMask 中指定的字段。

在操作处理期间,资源在操作完全完成之前会暂时处于 ACTIVE 状态。在该时间段内,您无法更新相应资源。使用操作状态来确定处理何时完全完成。

HTTP 请求

PATCH https://vmwareengine.googleapis.com/v1/{externalAddress.name=projects/*/locations/*/privateClouds/*/externalAddresses/*}

网址采用 gRPC 转码语法。

路径参数

参数
externalAddress.name

string

仅限输出。标识符。相应外部 IP 地址的资源名称。资源名称是无方案 URI,遵循 https://cloud.google.com/apis/design/resource_names 中的惯例。例如 projects/my-project/locations/us-central1-a/privateClouds/my-cloud/externalAddresses/my-address

查询参数

参数
updateMask

string (FieldMask format)

必需。字段掩码用于指定更新将在 ExternalAddress 资源中覆盖的字段。updateMask 中指定的字段与资源相关,而不是与完整请求相关。如果字段在掩码中,则会被覆盖。 如果用户未提供掩码,则所有字段都将被覆盖。

这是完全限定字段名称的逗号分隔列表。示例:"user.displayName,photo"

requestId

string

可选。这是用来标识请求的请求 ID。您可以指定一个唯一的请求 ID,这样,在您必须重试请求时,服务器就会知道忽略该请求(如果该请求已完成)。服务器可保证在至少 60 分钟内,一个请求不会导致创建重复的承诺。

例如,假设在您最初发出一个请求后,该请求超时,然后您使用相同的请求 ID 再次发出该请求,那么服务器便可检查是否收到了最初那个具有该请求 ID 的操作。如果收到了,服务器便会忽略这第二个请求。这样可以防止客户端意外创建重复的承诺。

请求 ID 必须是有效的 UUID,且不支持全部由零组成的 UUID(即 00000000-0000-0000-0000-000000000000)。

请求正文

请求正文包含一个 ExternalAddress 实例。

响应正文

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

授权范围

需要以下 OAuth 范围:

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

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