GKE Hub API (gkehub:v1beta)

2023-10-06

6 new methods

Additions

    Methods
  • gkehub.projects.locations.memberships.delete

      Parameter Order : name

      Description : Removes a Membership. **This is currently only supported for GKE clusters on Google Cloud**. To unregister other clusters, follow the instructions at https://cloud.google.com/anthos/multicluster-management/connect/unregistering-a-cluster.

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

      Path : v1beta/{+name}

      HTTP Method : DELETE

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}

      Parameters :

        force

          Location : query

          Description : Optional. If set to true, any subresource from this Membership will also be deleted. Otherwise, the request will only work if the Membership has no subresource.

          Type : boolean

        requestId

          Type : string

          Location : query

          Description : Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

        name

          Location : path

          Required : Yes

          Description : Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+/memberships/[^/]+$

          Type : string

  • gkehub.projects.locations.memberships.patch

      Parameters :

        requestId

          Location : query

          Type : string

          Description : Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

        name

          Description : Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`.

          Required : Yes

          Location : path

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+/memberships/[^/]+$

        updateMask

          Location : query

          Description : Required. Mask of fields to update.

          Format : google-fieldmask

          Type : string

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}

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

      Path : v1beta/{+name}

      Description : Updates an existing Membership.

      Parameter Order : name

      HTTP Method : PATCH

  • gkehub.projects.locations.memberships.generateConnectManifest

      Parameters :

        namespace

          Type : string

          Location : query

          Description : Optional. Namespace for GKE Connect agent resources. Defaults to `gke-connect`. The Connect Agent is authorized automatically when run in the default namespace. Otherwise, explicit authorization must be granted with an additional IAM binding.

        name

          Required : Yes

          Type : string

          Location : path

          Description : Required. The Membership resource name the Agent will associate with, in the format `projects/*/locations/*/memberships/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+/memberships/[^/]+$

        imagePullSecretContent

          Type : string

          Format : byte

          Description : Optional. The image pull secret content for the registry, if not public.

          Location : query

        version

          Description : Optional. The Connect agent version to use. Defaults to the most current version.

          Type : string

          Location : query

        registry

          Type : string

          Location : query

          Description : Optional. The registry to fetch the connect agent image from. Defaults to gcr.io/gkeconnect.

        proxy

          Format : byte

          Description : Optional. URI of a proxy if connectivity from the agent to gkeconnect.googleapis.com requires the use of a proxy. Format must be in the form `http(s)://{proxy_address}`, depending on the HTTP/HTTPS protocol supported by the proxy. This will direct the connect agent's outbound traffic through a HTTP(S) proxy.

          Type : string

          Location : query

        isUpgrade

          Location : query

          Type : boolean

          Description : Optional. If true, generate the resources for upgrade only. Some resources generated only for installation (e.g. secrets) will be excluded.

      Description : Generates the manifest for deployment of the GKE connect agent. **This method is used internally by Google-provided libraries.** Most clients should not need to call this method directly.

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

      Parameter Order : name

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}:generateConnectManifest

      HTTP Method : GET

      Path : v1beta/{+name}:generateConnectManifest

  • gkehub.projects.locations.memberships.create

      Description : Creates a new Membership. **This is currently only supported for GKE clusters on Google Cloud**. To register other clusters, follow the instructions at https://cloud.google.com/anthos/multicluster-management/connect/registering-a-cluster.

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

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships

      Parameters :

        membershipId

          Location : query

          Description : Required. Client chosen ID for the membership. `membership_id` must be a valid RFC 1123 compliant DNS label: 1. At most 63 characters in length 2. It must consist of lower case alphanumeric characters or `-` 3. It must start and end with an alphanumeric character Which can be expressed as the regex: `[a-z0-9]([-a-z0-9]*[a-z0-9])?`, with a maximum length of 63 characters.

          Type : string

        parent

          Type : string

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Required : Yes

          Description : Required. The parent (project and location) where the Memberships will be created. Specified in the format `projects/*/locations/*`.

          Location : path

        requestId

          Description : Optional. A request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).

          Location : query

          Type : string

      Path : v1beta/{+parent}/memberships

      HTTP Method : POST

      Parameter Order : parent

  • gkehub.projects.locations.memberships.list

      Parameters :

        parent

          Type : string

          Description : Required. The parent (project and location) where the Memberships will be listed. Specified in the format `projects/*/locations/*`. `projects/*/locations/-` list memberships in all the regions.

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Location : path

        orderBy

          Description : Optional. One or more fields to compare and use to sort the output. See https://google.aip.dev/132#ordering.

          Location : query

          Type : string

        filter

          Type : string

          Location : query

          Description : Optional. Lists Memberships that match the filter expression, following the syntax outlined in https://google.aip.dev/160. Examples: - Name is `bar` in project `foo-proj` and location `global`: name = "projects/foo-proj/locations/global/membership/bar" - Memberships that have a label called `foo`: labels.foo:* - Memberships that have a label called `foo` whose value is `bar`: labels.foo = bar - Memberships in the CREATING state: state = CREATING

        pageToken

          Description : Optional. Token returned by previous call to `ListMemberships` which specifies the position in the list from where to continue listing the resources.

          Location : query

          Type : string

        pageSize

          Type : integer

          Description : Optional. When requesting a 'page' of resources, `page_size` specifies number of resources to return. If unspecified or set to 0, all resources will be returned.

          Location : query

          Format : int32

      Description : Lists Memberships in a given project and location.

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

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships

      Path : v1beta/{+parent}/memberships

      Parameter Order : parent

      HTTP Method : GET

  • gkehub.projects.locations.memberships.get

      Description : Gets the details of a Membership.

      HTTP Method : GET

      Parameter Order : name

      Flat Path : v1beta/projects/{projectsId}/locations/{locationsId}/memberships/{membershipsId}

      Path : v1beta/{+name}

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

      Parameters :

        name

          Required : Yes

          Description : Required. The Membership resource name in the format `projects/*/locations/*/memberships/*`.

          Pattern : ^projects/[^/]+/locations/[^/]+/memberships/[^/]+$

          Type : string

          Location : path