GKE Hub v1beta1 API - Class GkeHubMembershipServiceClientImpl (2.0.0-beta06)

public sealed class GkeHubMembershipServiceClientImpl : GkeHubMembershipServiceClient

Reference documentation and code samples for the GKE Hub v1beta1 API class GkeHubMembershipServiceClientImpl.

GkeHubMembershipService client wrapper implementation, for convenient use.

Inheritance

object > GkeHubMembershipServiceClient > GkeHubMembershipServiceClientImpl

Namespace

Google.Cloud.GkeHub.V1Beta1

Assembly

Google.Cloud.GkeHub.V1Beta1.dll

Remarks

The GKE Hub MembershipService handles the registration of many Kubernetes clusters to Google Cloud, represented with the [Membership][google.cloud.gkehub.v1beta1.Membership] resource.

GKE Hub is currently available in the global region and all regions in https://cloud.google.com/compute/docs/regions-zones.

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.

Constructors

GkeHubMembershipServiceClientImpl(GkeHubMembershipServiceClient, GkeHubMembershipServiceSettings, ILogger)

public GkeHubMembershipServiceClientImpl(GkeHubMembershipService.GkeHubMembershipServiceClient grpcClient, GkeHubMembershipServiceSettings settings, ILogger logger)

Constructs a client wrapper for the GkeHubMembershipService service, with the specified gRPC client and settings.

Parameters
NameDescription
grpcClientGkeHubMembershipServiceGkeHubMembershipServiceClient

The underlying gRPC client.

settingsGkeHubMembershipServiceSettings

The base GkeHubMembershipServiceSettings used within this client.

loggerILogger

Optional ILogger to use within this client.

Properties

CreateMembershipOperationsClient

public override OperationsClient CreateMembershipOperationsClient { get; }

The long-running operations client for CreateMembership.

Property Value
TypeDescription
OperationsClient
Overrides

DeleteMembershipOperationsClient

public override OperationsClient DeleteMembershipOperationsClient { get; }

The long-running operations client for DeleteMembership.

Property Value
TypeDescription
OperationsClient
Overrides

GrpcClient

public override GkeHubMembershipService.GkeHubMembershipServiceClient GrpcClient { get; }

The underlying gRPC GkeHubMembershipService client

Property Value
TypeDescription
GkeHubMembershipServiceGkeHubMembershipServiceClient
Overrides

IAMPolicyClient

public override IAMPolicyClient IAMPolicyClient { get; }

The IAMPolicyClient associated with this client.

Property Value
TypeDescription
IAMPolicyClient
Overrides

LocationsClient

public override LocationsClient LocationsClient { get; }

The LocationsClient associated with this client.

Property Value
TypeDescription
LocationsClient
Overrides

UpdateMembershipOperationsClient

public override OperationsClient UpdateMembershipOperationsClient { get; }

The long-running operations client for UpdateMembership.

Property Value
TypeDescription
OperationsClient
Overrides

Methods

CreateMembership(CreateMembershipRequest, CallSettings)

public override Operation<Membership, OperationMetadata> CreateMembership(CreateMembershipRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestCreateMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationMembershipOperationMetadata

The RPC response.

Overrides

CreateMembershipAsync(CreateMembershipRequest, CallSettings)

public override Task<Operation<Membership, OperationMetadata>> CreateMembershipAsync(CreateMembershipRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestCreateMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationMembershipOperationMetadata

A Task containing the RPC response.

Overrides

DeleteMembership(DeleteMembershipRequest, CallSettings)

public override Operation<Empty, OperationMetadata> DeleteMembership(DeleteMembershipRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestDeleteMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationEmptyOperationMetadata

The RPC response.

Overrides

DeleteMembershipAsync(DeleteMembershipRequest, CallSettings)

public override Task<Operation<Empty, OperationMetadata>> DeleteMembershipAsync(DeleteMembershipRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestDeleteMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationEmptyOperationMetadata

A Task containing the RPC response.

Overrides

GenerateConnectManifest(GenerateConnectManifestRequest, CallSettings)

public override GenerateConnectManifestResponse GenerateConnectManifest(GenerateConnectManifestRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestGenerateConnectManifestRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
GenerateConnectManifestResponse

The RPC response.

Overrides

GenerateConnectManifestAsync(GenerateConnectManifestRequest, CallSettings)

public override Task<GenerateConnectManifestResponse> GenerateConnectManifestAsync(GenerateConnectManifestRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestGenerateConnectManifestRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskGenerateConnectManifestResponse

A Task containing the RPC response.

Overrides

GenerateExclusivityManifest(GenerateExclusivityManifestRequest, CallSettings)

public override GenerateExclusivityManifestResponse GenerateExclusivityManifest(GenerateExclusivityManifestRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestGenerateExclusivityManifestRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
GenerateExclusivityManifestResponse

The RPC response.

Overrides

GenerateExclusivityManifestAsync(GenerateExclusivityManifestRequest, CallSettings)

public override Task<GenerateExclusivityManifestResponse> GenerateExclusivityManifestAsync(GenerateExclusivityManifestRequest request, CallSettings callSettings = null)

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.

Parameters
NameDescription
requestGenerateExclusivityManifestRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskGenerateExclusivityManifestResponse

A Task containing the RPC response.

Overrides

GetMembership(GetMembershipRequest, CallSettings)

public override Membership GetMembership(GetMembershipRequest request, CallSettings callSettings = null)

Gets the details of a Membership.

Parameters
NameDescription
requestGetMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
Membership

The RPC response.

Overrides

GetMembershipAsync(GetMembershipRequest, CallSettings)

public override Task<Membership> GetMembershipAsync(GetMembershipRequest request, CallSettings callSettings = null)

Gets the details of a Membership.

Parameters
NameDescription
requestGetMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskMembership

A Task containing the RPC response.

Overrides

ListMemberships(ListMembershipsRequest, CallSettings)

public override PagedEnumerable<ListMembershipsResponse, Membership> ListMemberships(ListMembershipsRequest request, CallSettings callSettings = null)

Lists Memberships in a given project and location.

Parameters
NameDescription
requestListMembershipsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedEnumerableListMembershipsResponseMembership

A pageable sequence of Membership resources.

Overrides

ListMembershipsAsync(ListMembershipsRequest, CallSettings)

public override PagedAsyncEnumerable<ListMembershipsResponse, Membership> ListMembershipsAsync(ListMembershipsRequest request, CallSettings callSettings = null)

Lists Memberships in a given project and location.

Parameters
NameDescription
requestListMembershipsRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
PagedAsyncEnumerableListMembershipsResponseMembership

A pageable asynchronous sequence of Membership resources.

Overrides

UpdateMembership(UpdateMembershipRequest, CallSettings)

public override Operation<Membership, OperationMetadata> UpdateMembership(UpdateMembershipRequest request, CallSettings callSettings = null)

Updates an existing Membership.

Parameters
NameDescription
requestUpdateMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
OperationMembershipOperationMetadata

The RPC response.

Overrides

UpdateMembershipAsync(UpdateMembershipRequest, CallSettings)

public override Task<Operation<Membership, OperationMetadata>> UpdateMembershipAsync(UpdateMembershipRequest request, CallSettings callSettings = null)

Updates an existing Membership.

Parameters
NameDescription
requestUpdateMembershipRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskOperationMembershipOperationMetadata

A Task containing the RPC response.

Overrides

ValidateExclusivity(ValidateExclusivityRequest, CallSettings)

public override ValidateExclusivityResponse ValidateExclusivity(ValidateExclusivityRequest request, CallSettings callSettings = null)

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

Parameters
NameDescription
requestValidateExclusivityRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
ValidateExclusivityResponse

The RPC response.

Overrides

ValidateExclusivityAsync(ValidateExclusivityRequest, CallSettings)

public override Task<ValidateExclusivityResponse> ValidateExclusivityAsync(ValidateExclusivityRequest request, CallSettings callSettings = null)

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

Parameters
NameDescription
requestValidateExclusivityRequest

The request object containing all of the parameters for the API call.

callSettingsCallSettings

If not null, applies overrides to this RPC call.

Returns
TypeDescription
TaskValidateExclusivityResponse

A Task containing the RPC response.

Overrides