Class GkeHubMembershipServiceAsyncClient (1.3.0)

The GKE Hub MembershipService handles the registration of many Kubernetes clusters to Google Cloud, represented with the Membership resource.

GKE Hub is currently only available in the global region.

Membership management may be non-trivial: it is recommended to use one of the Google-provided client libraries or tools where possible when working with Membership resources.

Returns the transport used by the client instance.

Instantiates the gke hub membership service client.

Returns a fully-qualified billing_account string.

Returns a fully-qualified folder string.

Returns a fully-qualified location string.

Returns a fully-qualified organization string.

Returns a fully-qualified project string.

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.

from google.cloud import gkehub_v1beta1

def sample_create_membership():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.CreateMembershipRequest(
        parent="parent_value",
        membership_id="membership_id_value",
    )

    # Make the request
    operation = client.create_membership(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

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.

from google.cloud import gkehub_v1beta1

def sample_delete_membership():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.DeleteMembershipRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_membership(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Creates an instance of this client using the provided credentials file.

Creates an instance of this client using the provided credentials info.

Creates an instance of this client using the provided credentials file.

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.

from google.cloud import gkehub_v1beta1

def sample_generate_connect_manifest():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.GenerateConnectManifestRequest(
        name="name_value",
    )

    # Make the request
    response = client.generate_connect_manifest(request=request)

    # Handle the response
    print(response)

GenerateExclusivityManifest generates the manifests to update the exclusivity artifacts in the cluster if needed. Exclusivity artifacts include the Membership custom resource definition (CRD) and the singleton Membership custom resource (CR). Combined with ValidateExclusivity, exclusivity artifacts guarantee that a Kubernetes cluster is only registered to a single GKE Hub.

The Membership CRD is versioned, and may require conversion when the GKE Hub API server begins serving a newer version of the CRD and corresponding CR. The response will be the converted CRD and CR if there are any differences between the versions.

from google.cloud import gkehub_v1beta1

def sample_generate_exclusivity_manifest():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.GenerateExclusivityManifestRequest(
        name="name_value",
    )

    # Make the request
    response = client.generate_exclusivity_manifest(request=request)

    # Handle the response
    print(response)

Gets the details of a Membership.

from google.cloud import gkehub_v1beta1

def sample_get_membership():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.GetMembershipRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_membership(request=request)

    # Handle the response
    print(response)

Return the API endpoint and client cert source for mutual TLS.

The client cert source is determined in the following order: (1) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is not "true", the client cert source is None. (2) if client_options.client_cert_source is provided, use the provided one; if the default client cert source exists, use the default one; otherwise the client cert source is None.

The API endpoint is determined in the following order: (1) if client_options.api_endpoint if provided, use the provided one. (2) if GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "always", use the default mTLS endpoint; if the environment variabel is "never", use the default API endpoint; otherwise if client cert source exists, use the default mTLS endpoint, otherwise use the default API endpoint.

More details can be found at https://google.aip.dev/auth/4114.

Returns an appropriate transport class.

Lists Memberships in a given project and location.

from google.cloud import gkehub_v1beta1

def sample_list_memberships():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.ListMembershipsRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_memberships(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Returns a fully-qualified membership string.

Parse a billing_account path into its component segments.

Parse a folder path into its component segments.

Parse a location path into its component segments.

Parse a organization path into its component segments.

Parse a project path into its component segments.

Parses a membership path into its component segments.

Updates an existing Membership.

from google.cloud import gkehub_v1beta1

def sample_update_membership():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.UpdateMembershipRequest(
        name="name_value",
    )

    # Make the request
    operation = client.update_membership(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

ValidateExclusivity validates the state of exclusivity in the cluster. The validation does not depend on an existing Hub membership resource.

from google.cloud import gkehub_v1beta1

def sample_validate_exclusivity():
    # Create a client
    client = gkehub_v1beta1.GkeHubMembershipServiceClient()

    # Initialize request argument(s)
    request = gkehub_v1beta1.ValidateExclusivityRequest(
        parent="parent_value",
        intended_membership="intended_membership_value",
    )

    # Make the request
    response = client.validate_exclusivity(request=request)

    # Handle the response
    print(response)