Method: projects.locations.memberships.create

创建新成员资格。

目前只有 Google Cloud 上的 GKE 集群支持此功能。如需注册其他集群,请按照 https://cloud.google.com/kubernetes-engine/enterprise/multicluster-management/connect/registering-a-cluster 中的说明执行操作。

HTTP 请求

POST https://gkehub.googleapis.com/v1alpha/{parent=projects/*/locations/*}/memberships

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。将在其中创建成员资格的父级对象(项目和位置),采用 projects/*/locations/* 格式。

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

  • gkehub.memberships.create

查询参数

参数
membershipId

string

必需。客户端为成员资格分配的 ID。membershipId 必须是符合 RFC 1123 规范的有效 DNS 标签:

  1. 长度不超过 63 个字符
  2. 必须由小写字母数字字符或 - 构成
  3. 必须以字母数字字符开头和结尾

可以用如下正则表达式来表示:[a-z0-9]([-a-z0-9]*[a-z0-9])?,且长度不超过 63 个字符。

requestId

string

可选。这是用来标识请求的请求 ID。您可以指定一个唯一的请求 ID,这样,在您必须重试请求时,服务器就会知道忽略该请求(如果该请求已完成)。服务器至少可以保证在第一次完成该请求后的 60 分钟内避免重复处理该请求。

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

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

请求正文

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

响应正文

如果成功,响应正文将包含一个新创建的 Operation 实例。

授权范围

需要以下 OAuth 范围:

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

如需了解详情,请参阅身份验证概览