Method: projects.locations.privateClouds.externalAddresses.create

在给定的私有云中创建新的 ExternalAddress 资源。与私有云对应的网络政策必须启用外部 IP 地址网络服务 (NetworkPolicy.external_ip)。

HTTP 请求

POST https://vmwareengine.googleapis.com/v1/{parent=projects/*/locations/*/privateClouds/*}/externalAddresses

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要在其中创建新外部 IP 地址的私有云的资源名称。资源名称是无方案 URI，遵循 https://cloud.google.com/apis/design/resource_names 中的惯例。例如 projects/my-project/locations/us-central1-a/privateClouds/my-cloud

必须对指定的资源 parent 具有以下 IAM 权限才能进行授权：

  • vmwareengine.externalAddresses.create

查询参数

参数
externalAddressId

string

必需。要创建的 ExternalAddress 的用户提供的标识符。此标识符在父级中的 ExternalAddress 资源之间必须是唯一的，并且会成为名称 URI 中的最终令牌。该标识符必须满足以下要求：

  • 只能包含 1-63 个字母数字字符和连字符
  • 以字母字符开头
  • 以非连字符结尾
  • 格式不是 UUID
  • 符合 RFC 1034（第 3.5 节）
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。