GKE Hub V1 API - Class Google::Cloud::GkeHub::V1::GkeHub::Rest::Client (v2.5.0)

Reference documentation and code samples for the GKE Hub V1 API class Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.

REST client for the GkeHub service.

The GKE Hub service handles the registration of many Kubernetes clusters to Google Cloud, and the management of multi-cluster features over those clusters.

The GKE Hub service operates on the following resources:

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

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.

Inherits

  • Object

Includes

Methods

.configure

def self.configure() { |config| ... } -> Client::Configuration

Configure the GkeHub Client class.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns
Example 
# Modify the configuration for all GkeHub clients
::Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.configure do |config|
  config.timeout = 10.0
end

#configure

def configure() { |config| ... } -> Client::Configuration

Configure the GkeHub Client instance.

The configuration is set to the derived mode, meaning that values can be changed, but structural changes (adding new fields, etc.) are not allowed. Structural changes should be made on Client.configure.

See Configuration for a description of the configuration fields.

Yields
  • (config) — Configure the Client client.
Yield Parameter
Returns

#create_feature

def create_feature(request, options = nil) -> ::Gapic::Operation
def create_feature(parent: nil, feature_id: nil, resource: nil, request_id: nil) -> ::Gapic::Operation

Adds a new Feature.

Overloads 
def create_feature(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_feature via a request object, either of type CreateFeatureRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateFeatureRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_feature(parent: nil, feature_id: nil, resource: nil, request_id: nil) -> ::Gapic::Operation
Pass arguments to create_feature via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Feature will be created. Specified in the format projects/*/locations/*.
  • feature_id (::String) — The ID of the feature to create.
  • resource (::Google::Cloud::GkeHub::V1::Feature, ::Hash) — The Feature resource to create.
  • request_id (::String) — 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).

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateFeatureRequest.new

# Call the create_feature method.
result = client.create_feature request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_fleet

def create_fleet(request, options = nil) -> ::Gapic::Operation
def create_fleet(parent: nil, fleet: nil) -> ::Gapic::Operation

Creates a fleet.

Overloads 
def create_fleet(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_fleet via a request object, either of type CreateFleetRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateFleetRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_fleet(parent: nil, fleet: nil) -> ::Gapic::Operation
Pass arguments to create_fleet via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Fleet will be created. Specified in the format projects/*/locations/*.
  • fleet (::Google::Cloud::GkeHub::V1::Fleet, ::Hash) — Required. The fleet to create.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateFleetRequest.new

# Call the create_fleet method.
result = client.create_fleet request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_membership

def create_membership(request, options = nil) -> ::Gapic::Operation
def create_membership(parent: nil, membership_id: nil, resource: nil, request_id: nil) -> ::Gapic::Operation

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.

Overloads 
def create_membership(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_membership via a request object, either of type CreateMembershipRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateMembershipRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_membership(parent: nil, membership_id: nil, resource: nil, request_id: nil) -> ::Gapic::Operation
Pass arguments to create_membership via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Memberships will be created. Specified in the format projects/*/locations/*.
  • membership_id (::String) — 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.

  • resource (::Google::Cloud::GkeHub::V1::Membership, ::Hash) — Required. The membership to create.
  • request_id (::String) — 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).

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateMembershipRequest.new

# Call the create_membership method.
result = client.create_membership request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_membership_binding

def create_membership_binding(request, options = nil) -> ::Gapic::Operation
def create_membership_binding(parent: nil, membership_binding: nil, membership_binding_id: nil) -> ::Gapic::Operation

Creates a MembershipBinding.

Overloads 
def create_membership_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_membership_binding via a request object, either of type CreateMembershipBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateMembershipBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_membership_binding(parent: nil, membership_binding: nil, membership_binding_id: nil) -> ::Gapic::Operation
Pass arguments to create_membership_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the MembershipBinding will be created. Specified in the format projects/*/locations/*/memberships/*.
  • membership_binding (::Google::Cloud::GkeHub::V1::MembershipBinding, ::Hash) — Required. The MembershipBinding to create.
  • membership_binding_id (::String) — Required. The ID to use for the MembershipBinding.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateMembershipBindingRequest.new

# Call the create_membership_binding method.
result = client.create_membership_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_membership_rbac_role_binding

def create_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def create_membership_rbac_role_binding(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Gapic::Operation

Creates a Membership RBACRoleBinding.

Overloads 
def create_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_membership_rbac_role_binding via a request object, either of type CreateMembershipRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateMembershipRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_membership_rbac_role_binding(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Gapic::Operation
Pass arguments to create_membership_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the RBACRoleBinding will be created. Specified in the format projects/*/locations/*/memberships/*.
  • rbacrolebinding_id (::String) — Required. Client chosen ID for the RBACRoleBinding. rbacrolebinding_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.

  • rbacrolebinding (::Google::Cloud::GkeHub::V1::RBACRoleBinding, ::Hash) — Required. The rbacrolebindings to create.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateMembershipRBACRoleBindingRequest.new

# Call the create_membership_rbac_role_binding method.
result = client.create_membership_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_scope

def create_scope(request, options = nil) -> ::Gapic::Operation
def create_scope(parent: nil, scope_id: nil, scope: nil) -> ::Gapic::Operation

Creates a Scope.

Overloads 
def create_scope(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_scope via a request object, either of type CreateScopeRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateScopeRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_scope(parent: nil, scope_id: nil, scope: nil) -> ::Gapic::Operation
Pass arguments to create_scope via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Scope will be created. Specified in the format projects/*/locations/*.
  • scope_id (::String) — Required. Client chosen ID for the Scope. scope_id must be a ????
  • scope (::Google::Cloud::GkeHub::V1::Scope, ::Hash) — Required. The Scope to create.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateScopeRequest.new

# Call the create_scope method.
result = client.create_scope request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_scope_namespace

def create_scope_namespace(request, options = nil) -> ::Gapic::Operation
def create_scope_namespace(parent: nil, scope_namespace_id: nil, scope_namespace: nil) -> ::Gapic::Operation

Creates a fleet namespace.

Overloads 
def create_scope_namespace(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_scope_namespace via a request object, either of type CreateScopeNamespaceRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateScopeNamespaceRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_scope_namespace(parent: nil, scope_namespace_id: nil, scope_namespace: nil) -> ::Gapic::Operation
Pass arguments to create_scope_namespace via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Namespace will be created. Specified in the format projects/*/locations/*/scopes/*.
  • scope_namespace_id (::String) — Required. Client chosen ID for the Namespace. namespace_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.

  • scope_namespace (::Google::Cloud::GkeHub::V1::Namespace, ::Hash) — Required. The fleet namespace to create.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateScopeNamespaceRequest.new

# Call the create_scope_namespace method.
result = client.create_scope_namespace request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#create_scope_rbac_role_binding

def create_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def create_scope_rbac_role_binding(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Gapic::Operation

Creates a Scope RBACRoleBinding.

Overloads 
def create_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to create_scope_rbac_role_binding via a request object, either of type CreateScopeRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::CreateScopeRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def create_scope_rbac_role_binding(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Gapic::Operation
Pass arguments to create_scope_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the RBACRoleBinding will be created. Specified in the format projects/*/locations/*/scopes/*.
  • rbacrolebinding_id (::String) — Required. Client chosen ID for the RBACRoleBinding. rbacrolebinding_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.

  • rbacrolebinding (::Google::Cloud::GkeHub::V1::RBACRoleBinding, ::Hash) — Required. The rbacrolebindings to create.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::CreateScopeRBACRoleBindingRequest.new

# Call the create_scope_rbac_role_binding method.
result = client.create_scope_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_feature

def delete_feature(request, options = nil) -> ::Gapic::Operation
def delete_feature(name: nil, force: nil, request_id: nil) -> ::Gapic::Operation

Removes a Feature.

Overloads 
def delete_feature(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_feature via a request object, either of type DeleteFeatureRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteFeatureRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_feature(name: nil, force: nil, request_id: nil) -> ::Gapic::Operation
Pass arguments to delete_feature via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Feature resource name in the format projects/*/locations/*/features/*.
  • force (::Boolean) — If set to true, the delete will ignore any outstanding resources for this Feature (that is, FeatureState.has_resources is set to true). These resources will NOT be cleaned up or modified in any way.
  • request_id (::String) — 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).

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteFeatureRequest.new

# Call the delete_feature method.
result = client.delete_feature request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_fleet

def delete_fleet(request, options = nil) -> ::Gapic::Operation
def delete_fleet(name: nil) -> ::Gapic::Operation

Removes a Fleet. There must be no memberships remaining in the Fleet.

Overloads 
def delete_fleet(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_fleet via a request object, either of type DeleteFleetRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteFleetRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_fleet(name: nil) -> ::Gapic::Operation
Pass arguments to delete_fleet via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Fleet resource name in the format projects/*/locations/*/fleets/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteFleetRequest.new

# Call the delete_fleet method.
result = client.delete_fleet request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_membership

def delete_membership(request, options = nil) -> ::Gapic::Operation
def delete_membership(name: nil, request_id: nil, force: nil) -> ::Gapic::Operation

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.

Overloads 
def delete_membership(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_membership via a request object, either of type DeleteMembershipRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteMembershipRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_membership(name: nil, request_id: nil, force: nil) -> ::Gapic::Operation
Pass arguments to delete_membership via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Membership resource name in the format projects/*/locations/*/memberships/*.
  • request_id (::String) — 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).

  • force (::Boolean) — 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.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteMembershipRequest.new

# Call the delete_membership method.
result = client.delete_membership request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_membership_binding

def delete_membership_binding(request, options = nil) -> ::Gapic::Operation
def delete_membership_binding(name: nil) -> ::Gapic::Operation

Deletes a MembershipBinding.

Overloads 
def delete_membership_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_membership_binding via a request object, either of type DeleteMembershipBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteMembershipBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_membership_binding(name: nil) -> ::Gapic::Operation
Pass arguments to delete_membership_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The MembershipBinding resource name in the format projects/*/locations/*/memberships/*/bindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteMembershipBindingRequest.new

# Call the delete_membership_binding method.
result = client.delete_membership_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_membership_rbac_role_binding

def delete_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def delete_membership_rbac_role_binding(name: nil) -> ::Gapic::Operation

Deletes a Membership RBACRoleBinding.

Overloads 
def delete_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_membership_rbac_role_binding via a request object, either of type DeleteMembershipRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteMembershipRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_membership_rbac_role_binding(name: nil) -> ::Gapic::Operation
Pass arguments to delete_membership_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The RBACRoleBinding resource name in the format projects/*/locations/*/memberships/*/rbacrolebindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteMembershipRBACRoleBindingRequest.new

# Call the delete_membership_rbac_role_binding method.
result = client.delete_membership_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_scope

def delete_scope(request, options = nil) -> ::Gapic::Operation
def delete_scope(name: nil) -> ::Gapic::Operation

Deletes a Scope.

Overloads 
def delete_scope(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_scope via a request object, either of type DeleteScopeRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteScopeRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_scope(name: nil) -> ::Gapic::Operation
Pass arguments to delete_scope via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Scope resource name in the format projects/*/locations/*/scopes/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteScopeRequest.new

# Call the delete_scope method.
result = client.delete_scope request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_scope_namespace

def delete_scope_namespace(request, options = nil) -> ::Gapic::Operation
def delete_scope_namespace(name: nil) -> ::Gapic::Operation

Deletes a fleet namespace.

Overloads 
def delete_scope_namespace(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_scope_namespace via a request object, either of type DeleteScopeNamespaceRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteScopeNamespaceRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_scope_namespace(name: nil) -> ::Gapic::Operation
Pass arguments to delete_scope_namespace via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Namespace resource name in the format projects/*/locations/*/scopes/*/namespaces/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteScopeNamespaceRequest.new

# Call the delete_scope_namespace method.
result = client.delete_scope_namespace request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#delete_scope_rbac_role_binding

def delete_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def delete_scope_rbac_role_binding(name: nil) -> ::Gapic::Operation

Deletes a Scope RBACRoleBinding.

Overloads 
def delete_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to delete_scope_rbac_role_binding via a request object, either of type DeleteScopeRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::DeleteScopeRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def delete_scope_rbac_role_binding(name: nil) -> ::Gapic::Operation
Pass arguments to delete_scope_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The RBACRoleBinding resource name in the format projects/*/locations/*/scopes/*/rbacrolebindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::DeleteScopeRBACRoleBindingRequest.new

# Call the delete_scope_rbac_role_binding method.
result = client.delete_scope_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#generate_connect_manifest

def generate_connect_manifest(request, options = nil) -> ::Google::Cloud::GkeHub::V1::GenerateConnectManifestResponse
def generate_connect_manifest(name: nil, namespace: nil, proxy: nil, version: nil, is_upgrade: nil, registry: nil, image_pull_secret_content: nil) -> ::Google::Cloud::GkeHub::V1::GenerateConnectManifestResponse

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.

Overloads 
def generate_connect_manifest(request, options = nil) -> ::Google::Cloud::GkeHub::V1::GenerateConnectManifestResponse
Pass arguments to generate_connect_manifest via a request object, either of type Google::Cloud::GkeHub::V1::GenerateConnectManifestRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GenerateConnectManifestRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def generate_connect_manifest(name: nil, namespace: nil, proxy: nil, version: nil, is_upgrade: nil, registry: nil, image_pull_secret_content: nil) -> ::Google::Cloud::GkeHub::V1::GenerateConnectManifestResponse
Pass arguments to generate_connect_manifest via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Membership resource name the Agent will associate with, in the format projects/*/locations/*/memberships/*.
  • namespace (::String) — 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.

  • proxy (::String) — 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.
  • version (::String) — Optional. The Connect agent version to use. Defaults to the most current version.
  • is_upgrade (::Boolean) — Optional. If true, generate the resources for upgrade only. Some resources generated only for installation (e.g. secrets) will be excluded.
  • registry (::String) — Optional. The registry to fetch the connect agent image from. Defaults to gcr.io/gkeconnect.
  • image_pull_secret_content (::String) — Optional. The image pull secret content for the registry, if not public.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GenerateConnectManifestRequest.new

# Call the generate_connect_manifest method.
result = client.generate_connect_manifest request

# The returned object is of type Google::Cloud::GkeHub::V1::GenerateConnectManifestResponse.
p result

#generate_membership_rbac_role_binding_yaml

def generate_membership_rbac_role_binding_yaml(request, options = nil) -> ::Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLResponse
def generate_membership_rbac_role_binding_yaml(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLResponse

Generates a YAML of the RBAC policies for the specified RoleBinding and its associated impersonation resources.

Overloads 
def generate_membership_rbac_role_binding_yaml(request, options = nil) -> ::Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLResponse
Pass arguments to generate_membership_rbac_role_binding_yaml via a request object, either of type Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def generate_membership_rbac_role_binding_yaml(parent: nil, rbacrolebinding_id: nil, rbacrolebinding: nil) -> ::Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLResponse
Pass arguments to generate_membership_rbac_role_binding_yaml via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the RBACRoleBinding will be created. Specified in the format projects/*/locations/*/memberships/*.
  • rbacrolebinding_id (::String) — Required. Client chosen ID for the RBACRoleBinding. rbacrolebinding_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.

  • rbacrolebinding (::Google::Cloud::GkeHub::V1::RBACRoleBinding, ::Hash) — Required. The rbacrolebindings to generate the YAML for.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLRequest.new

# Call the generate_membership_rbac_role_binding_yaml method.
result = client.generate_membership_rbac_role_binding_yaml request

# The returned object is of type Google::Cloud::GkeHub::V1::GenerateMembershipRBACRoleBindingYAMLResponse.
p result

#get_feature

def get_feature(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Feature
def get_feature(name: nil, return_partial_success: nil) -> ::Google::Cloud::GkeHub::V1::Feature

Gets details of a single Feature.

Overloads 
def get_feature(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Feature
Pass arguments to get_feature via a request object, either of type Google::Cloud::GkeHub::V1::GetFeatureRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetFeatureRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_feature(name: nil, return_partial_success: nil) -> ::Google::Cloud::GkeHub::V1::Feature
Pass arguments to get_feature via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Feature resource name in the format projects/*/locations/*/features/*
  • return_partial_success (::Boolean) — Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetFeatureRequest.new

# Call the get_feature method.
result = client.get_feature request

# The returned object is of type Google::Cloud::GkeHub::V1::Feature.
p result

#get_fleet

def get_fleet(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Fleet
def get_fleet(name: nil) -> ::Google::Cloud::GkeHub::V1::Fleet

Returns the details of a fleet.

Overloads 
def get_fleet(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Fleet
Pass arguments to get_fleet via a request object, either of type Google::Cloud::GkeHub::V1::GetFleetRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetFleetRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_fleet(name: nil) -> ::Google::Cloud::GkeHub::V1::Fleet
Pass arguments to get_fleet via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Fleet resource name in the format projects/*/locations/*/fleets/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetFleetRequest.new

# Call the get_fleet method.
result = client.get_fleet request

# The returned object is of type Google::Cloud::GkeHub::V1::Fleet.
p result

#get_membership

def get_membership(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Membership
def get_membership(name: nil) -> ::Google::Cloud::GkeHub::V1::Membership

Gets the details of a Membership.

Overloads 
def get_membership(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Membership
Pass arguments to get_membership via a request object, either of type Google::Cloud::GkeHub::V1::GetMembershipRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetMembershipRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_membership(name: nil) -> ::Google::Cloud::GkeHub::V1::Membership
Pass arguments to get_membership via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Membership resource name in the format projects/*/locations/*/memberships/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetMembershipRequest.new

# Call the get_membership method.
result = client.get_membership request

# The returned object is of type Google::Cloud::GkeHub::V1::Membership.
p result

#get_membership_binding

def get_membership_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::MembershipBinding
def get_membership_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::MembershipBinding

Returns the details of a MembershipBinding.

Overloads 
def get_membership_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::MembershipBinding
Pass arguments to get_membership_binding via a request object, either of type Google::Cloud::GkeHub::V1::GetMembershipBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetMembershipBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_membership_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::MembershipBinding
Pass arguments to get_membership_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The MembershipBinding resource name in the format projects/*/locations/*/memberships/*/bindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetMembershipBindingRequest.new

# Call the get_membership_binding method.
result = client.get_membership_binding request

# The returned object is of type Google::Cloud::GkeHub::V1::MembershipBinding.
p result

#get_membership_rbac_role_binding

def get_membership_rbac_role_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
def get_membership_rbac_role_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding

Returns the details of a Membership RBACRoleBinding.

Overloads 
def get_membership_rbac_role_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
Pass arguments to get_membership_rbac_role_binding via a request object, either of type Google::Cloud::GkeHub::V1::GetMembershipRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetMembershipRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_membership_rbac_role_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
Pass arguments to get_membership_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The RBACRoleBinding resource name in the format projects/*/locations/*/memberships/*/rbacrolebindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetMembershipRBACRoleBindingRequest.new

# Call the get_membership_rbac_role_binding method.
result = client.get_membership_rbac_role_binding request

# The returned object is of type Google::Cloud::GkeHub::V1::RBACRoleBinding.
p result

#get_scope

def get_scope(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Scope
def get_scope(name: nil) -> ::Google::Cloud::GkeHub::V1::Scope

Returns the details of a Scope.

Overloads 
def get_scope(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Scope
Pass arguments to get_scope via a request object, either of type Google::Cloud::GkeHub::V1::GetScopeRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetScopeRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_scope(name: nil) -> ::Google::Cloud::GkeHub::V1::Scope
Pass arguments to get_scope via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Scope resource name in the format projects/*/locations/*/scopes/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetScopeRequest.new

# Call the get_scope method.
result = client.get_scope request

# The returned object is of type Google::Cloud::GkeHub::V1::Scope.
p result

#get_scope_namespace

def get_scope_namespace(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Namespace
def get_scope_namespace(name: nil) -> ::Google::Cloud::GkeHub::V1::Namespace

Returns the details of a fleet namespace.

Overloads 
def get_scope_namespace(request, options = nil) -> ::Google::Cloud::GkeHub::V1::Namespace
Pass arguments to get_scope_namespace via a request object, either of type Google::Cloud::GkeHub::V1::GetScopeNamespaceRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetScopeNamespaceRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_scope_namespace(name: nil) -> ::Google::Cloud::GkeHub::V1::Namespace
Pass arguments to get_scope_namespace via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The Namespace resource name in the format projects/*/locations/*/scopes/*/namespaces/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetScopeNamespaceRequest.new

# Call the get_scope_namespace method.
result = client.get_scope_namespace request

# The returned object is of type Google::Cloud::GkeHub::V1::Namespace.
p result

#get_scope_rbac_role_binding

def get_scope_rbac_role_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
def get_scope_rbac_role_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding

Returns the details of a Scope RBACRoleBinding.

Overloads 
def get_scope_rbac_role_binding(request, options = nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
Pass arguments to get_scope_rbac_role_binding via a request object, either of type Google::Cloud::GkeHub::V1::GetScopeRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::GetScopeRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def get_scope_rbac_role_binding(name: nil) -> ::Google::Cloud::GkeHub::V1::RBACRoleBinding
Pass arguments to get_scope_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameter
  • name (::String) — Required. The RBACRoleBinding resource name in the format projects/*/locations/*/scopes/*/rbacrolebindings/*.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::GetScopeRBACRoleBindingRequest.new

# Call the get_scope_rbac_role_binding method.
result = client.get_scope_rbac_role_binding request

# The returned object is of type Google::Cloud::GkeHub::V1::RBACRoleBinding.
p result

#initialize

def initialize() { |config| ... } -> Client

Create a new GkeHub REST client object.

Yields
  • (config) — Configure the GkeHub client.
Yield Parameter
Returns
  • (Client) — a new instance of Client
Example 
# Create a client using the default configuration
client = ::Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a client using a custom configuration
client = ::Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new do |config|
  config.timeout = 10.0
end

#list_bound_memberships

def list_bound_memberships(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
def list_bound_memberships(scope_name: nil, filter: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>

Lists Memberships bound to a Scope. The response includes relevant Memberships from all regions.

Overloads 
def list_bound_memberships(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
Pass arguments to list_bound_memberships via a request object, either of type ListBoundMembershipsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListBoundMembershipsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_bound_memberships(scope_name: nil, filter: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
Pass arguments to list_bound_memberships via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • scope_name (::String) — Required. Name of the Scope, in the format projects/*/locations/global/scopes/*, to which the Memberships are bound.
  • filter (::String) — Optional. Lists Memberships that match the filter expression, following the syntax outlined in https://google.aip.dev/160. Currently, filtering can be done only based on Memberships's name, labels, create_time, update_time, and unique_id.
  • page_size (::Integer) — 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. Pagination is currently not supported; therefore, setting this field does not have any impact for now.
  • page_token (::String) — Optional. Token returned by previous call to ListBoundMemberships which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListBoundMembershipsRequest.new

# Call the list_bound_memberships method.
result = client.list_bound_memberships request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Membership.
  p item
end

#list_features

def list_features(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Feature>
def list_features(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, return_partial_success: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Feature>

Lists Features in a given project and location.

Overloads 
def list_features(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Feature>
Pass arguments to list_features via a request object, either of type ListFeaturesRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListFeaturesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_features(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil, return_partial_success: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Feature>
Pass arguments to list_features via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Features will be listed. Specified in the format projects/*/locations/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Token returned by previous call to ListFeatures which specifies the position in the list from where to continue listing the resources.
  • filter (::String) —

    Lists Features that match the filter expression, following the syntax outlined in https://google.aip.dev/160.

    Examples:

    • Feature with the name "servicemesh" in project "foo-proj":

      name = "projects/foo-proj/locations/global/features/servicemesh"

    • Features that have a label called foo:

      labels.foo:*

    • Features that have a label called foo whose value is bar:

      labels.foo = bar

  • order_by (::String) — One or more fields to compare and use to sort the output. See https://google.aip.dev/132#ordering.
  • return_partial_success (::Boolean) — Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field in Feature proto will be populated. If set to false, the request will fail when some regions are unreachable.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListFeaturesRequest.new

# Call the list_features method.
result = client.list_features request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Feature.
  p item
end

#list_fleets

def list_fleets(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Fleet>
def list_fleets(parent: nil, page_token: nil, page_size: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Fleet>

Returns all fleets within an organization or a project that the caller has access to.

Overloads 
def list_fleets(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Fleet>
Pass arguments to list_fleets via a request object, either of type ListFleetsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListFleetsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_fleets(parent: nil, page_token: nil, page_size: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Fleet>
Pass arguments to list_fleets via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The organization or project to list for Fleets under, in the format organizations/*/locations/* or projects/*/locations/*.
  • page_token (::String) — Optional. A page token, received from a previous ListFleets call. Provide this to retrieve the subsequent page.

    When paginating, all other parameters provided to ListFleets must match the call that provided the page token.

  • page_size (::Integer) — Optional. The maximum number of fleets to return. The service may return fewer than this value. If unspecified, at most 200 fleets will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListFleetsRequest.new

# Call the list_fleets method.
result = client.list_fleets request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Fleet.
  p item
end

#list_membership_bindings

def list_membership_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::MembershipBinding>
def list_membership_bindings(parent: nil, page_size: nil, page_token: nil, filter: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::MembershipBinding>

Lists MembershipBindings.

Overloads 
def list_membership_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::MembershipBinding>
Pass arguments to list_membership_bindings via a request object, either of type ListMembershipBindingsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListMembershipBindingsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_membership_bindings(parent: nil, page_size: nil, page_token: nil, filter: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::MembershipBinding>
Pass arguments to list_membership_bindings via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent Membership for which the MembershipBindings will be listed. Specified in the format projects/*/locations/*/memberships/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListMembershipBindings which specifies the position in the list from where to continue listing the resources.
  • filter (::String) — Optional. Lists MembershipBindings that match the filter expression, following the syntax outlined in https://google.aip.dev/160.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListMembershipBindingsRequest.new

# Call the list_membership_bindings method.
result = client.list_membership_bindings request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::MembershipBinding.
  p item
end

#list_membership_rbac_role_bindings

def list_membership_rbac_role_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
def list_membership_rbac_role_bindings(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>

Lists all Membership RBACRoleBindings.

Overloads 
def list_membership_rbac_role_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
Pass arguments to list_membership_rbac_role_bindings via a request object, either of type ListMembershipRBACRoleBindingsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListMembershipRBACRoleBindingsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_membership_rbac_role_bindings(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
Pass arguments to list_membership_rbac_role_bindings via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Features will be listed. Specified in the format projects/*/locations/*/memberships/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListMembershipRBACRoleBindings which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListMembershipRBACRoleBindingsRequest.new

# Call the list_membership_rbac_role_bindings method.
result = client.list_membership_rbac_role_bindings request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::RBACRoleBinding.
  p item
end

#list_memberships

def list_memberships(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
def list_memberships(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>

Lists Memberships in a given project and location.

Overloads 
def list_memberships(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
Pass arguments to list_memberships via a request object, either of type ListMembershipsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListMembershipsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_memberships(parent: nil, page_size: nil, page_token: nil, filter: nil, order_by: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Membership>
Pass arguments to list_memberships via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — 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.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListMemberships which specifies the position in the list from where to continue listing the resources.
  • filter (::String) —

    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

  • order_by (::String) — Optional. One or more fields to compare and use to sort the output. See https://google.aip.dev/132#ordering.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListMembershipsRequest.new

# Call the list_memberships method.
result = client.list_memberships request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Membership.
  p item
end

#list_permitted_scopes

def list_permitted_scopes(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
def list_permitted_scopes(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>

Lists permitted Scopes.

Overloads 
def list_permitted_scopes(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
Pass arguments to list_permitted_scopes via a request object, either of type ListPermittedScopesRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListPermittedScopesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_permitted_scopes(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
Pass arguments to list_permitted_scopes via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Scope will be listed. Specified in the format projects/*/locations/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListPermittedScopes which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListPermittedScopesRequest.new

# Call the list_permitted_scopes method.
result = client.list_permitted_scopes request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Scope.
  p item
end

#list_scope_namespaces

def list_scope_namespaces(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Namespace>
def list_scope_namespaces(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Namespace>

Lists fleet namespaces.

Overloads 
def list_scope_namespaces(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Namespace>
Pass arguments to list_scope_namespaces via a request object, either of type ListScopeNamespacesRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListScopeNamespacesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_scope_namespaces(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Namespace>
Pass arguments to list_scope_namespaces via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Features will be listed. Specified in the format projects/*/locations/*/scopes/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListFeatures which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListScopeNamespacesRequest.new

# Call the list_scope_namespaces method.
result = client.list_scope_namespaces request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Namespace.
  p item
end

#list_scope_rbac_role_bindings

def list_scope_rbac_role_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
def list_scope_rbac_role_bindings(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>

Lists all Scope RBACRoleBindings.

Overloads 
def list_scope_rbac_role_bindings(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
Pass arguments to list_scope_rbac_role_bindings via a request object, either of type ListScopeRBACRoleBindingsRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListScopeRBACRoleBindingsRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_scope_rbac_role_bindings(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::RBACRoleBinding>
Pass arguments to list_scope_rbac_role_bindings via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Features will be listed. Specified in the format projects/*/locations/*/scopes/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListScopeRBACRoleBindings which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListScopeRBACRoleBindingsRequest.new

# Call the list_scope_rbac_role_bindings method.
result = client.list_scope_rbac_role_bindings request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::RBACRoleBinding.
  p item
end

#list_scopes

def list_scopes(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
def list_scopes(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>

Lists Scopes.

Overloads 
def list_scopes(request, options = nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
Pass arguments to list_scopes via a request object, either of type ListScopesRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::ListScopesRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def list_scopes(parent: nil, page_size: nil, page_token: nil) -> ::Gapic::Rest::PagedEnumerable<::Google::Cloud::GkeHub::V1::Scope>
Pass arguments to list_scopes via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • parent (::String) — Required. The parent (project and location) where the Scope will be listed. Specified in the format projects/*/locations/*.
  • page_size (::Integer) — 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.
  • page_token (::String) — Optional. Token returned by previous call to ListScopes which specifies the position in the list from where to continue listing the resources.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
Returns
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::ListScopesRequest.new

# Call the list_scopes method.
result = client.list_scopes request

# The returned object is of type Gapic::PagedEnumerable. You can iterate
# over elements, and API calls will be issued to fetch pages as needed.
result.each do |item|
  # Each element is of type ::Google::Cloud::GkeHub::V1::Scope.
  p item
end

#logger

def logger() -> Logger

The logger used for request/response debug logging.

Returns
  • (Logger)

#operations_client

def operations_client() -> ::Google::Cloud::GkeHub::V1::GkeHub::Rest::Operations

Get the associated client for long-running operations.

Returns

#universe_domain

def universe_domain() -> String

The effective universe domain

Returns
  • (String)

#update_feature

def update_feature(request, options = nil) -> ::Gapic::Operation
def update_feature(name: nil, update_mask: nil, resource: nil, request_id: nil) -> ::Gapic::Operation

Updates an existing Feature.

Overloads 
def update_feature(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_feature via a request object, either of type UpdateFeatureRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateFeatureRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_feature(name: nil, update_mask: nil, resource: nil, request_id: nil) -> ::Gapic::Operation
Pass arguments to update_feature via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Feature resource name in the format projects/*/locations/*/features/*.
  • update_mask (::Google::Protobuf::FieldMask, ::Hash) — Mask of fields to update.
  • resource (::Google::Cloud::GkeHub::V1::Feature, ::Hash) — Only fields specified in update_mask are updated. If you specify a field in the update_mask but don't specify its value here that field will be deleted. If you are updating a map field, set the value of a key to null or empty string to delete the key from the map. It's not possible to update a key's value to the empty string. If you specify the update_mask to be a special path "*", fully replaces all user-modifiable fields to match resource.
  • request_id (::String) — 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).

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateFeatureRequest.new

# Call the update_feature method.
result = client.update_feature request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_fleet

def update_fleet(request, options = nil) -> ::Gapic::Operation
def update_fleet(fleet: nil, update_mask: nil) -> ::Gapic::Operation

Updates a fleet.

Overloads 
def update_fleet(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_fleet via a request object, either of type UpdateFleetRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateFleetRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_fleet(fleet: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_fleet via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateFleetRequest.new

# Call the update_fleet method.
result = client.update_fleet request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_membership

def update_membership(request, options = nil) -> ::Gapic::Operation
def update_membership(name: nil, update_mask: nil, resource: nil, request_id: nil) -> ::Gapic::Operation

Updates an existing Membership.

Overloads 
def update_membership(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_membership via a request object, either of type UpdateMembershipRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateMembershipRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_membership(name: nil, update_mask: nil, resource: nil, request_id: nil) -> ::Gapic::Operation
Pass arguments to update_membership via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • name (::String) — Required. The Membership resource name in the format projects/*/locations/*/memberships/*.
  • update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. Mask of fields to update.
  • resource (::Google::Cloud::GkeHub::V1::Membership, ::Hash) — Required. Only fields specified in update_mask are updated. If you specify a field in the update_mask but don't specify its value here that field will be deleted. If you are updating a map field, set the value of a key to null or empty string to delete the key from the map. It's not possible to update a key's value to the empty string. If you specify the update_mask to be a special path "*", fully replaces all user-modifiable fields to match resource.
  • request_id (::String) — 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).

Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateMembershipRequest.new

# Call the update_membership method.
result = client.update_membership request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_membership_binding

def update_membership_binding(request, options = nil) -> ::Gapic::Operation
def update_membership_binding(membership_binding: nil, update_mask: nil) -> ::Gapic::Operation

Updates a MembershipBinding.

Overloads 
def update_membership_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_membership_binding via a request object, either of type UpdateMembershipBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateMembershipBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_membership_binding(membership_binding: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_membership_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateMembershipBindingRequest.new

# Call the update_membership_binding method.
result = client.update_membership_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_membership_rbac_role_binding

def update_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def update_membership_rbac_role_binding(rbacrolebinding: nil, update_mask: nil) -> ::Gapic::Operation

Updates a Membership RBACRoleBinding.

Overloads 
def update_membership_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_membership_rbac_role_binding via a request object, either of type UpdateMembershipRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateMembershipRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_membership_rbac_role_binding(rbacrolebinding: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_membership_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateMembershipRBACRoleBindingRequest.new

# Call the update_membership_rbac_role_binding method.
result = client.update_membership_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_scope

def update_scope(request, options = nil) -> ::Gapic::Operation
def update_scope(scope: nil, update_mask: nil) -> ::Gapic::Operation

Updates a scopes.

Overloads 
def update_scope(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_scope via a request object, either of type UpdateScopeRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateScopeRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_scope(scope: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_scope via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateScopeRequest.new

# Call the update_scope method.
result = client.update_scope request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_scope_namespace

def update_scope_namespace(request, options = nil) -> ::Gapic::Operation
def update_scope_namespace(scope_namespace: nil, update_mask: nil) -> ::Gapic::Operation

Updates a fleet namespace.

Overloads 
def update_scope_namespace(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_scope_namespace via a request object, either of type UpdateScopeNamespaceRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateScopeNamespaceRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_scope_namespace(scope_namespace: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_scope_namespace via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
  • scope_namespace (::Google::Cloud::GkeHub::V1::Namespace, ::Hash) — Required. A namespace with fields updated. The 'name' field in this namespace is used to identify the resource to update. Given 'updated' prefix to follow go/proto-best-practices-checkers#keyword_conflict
  • update_mask (::Google::Protobuf::FieldMask, ::Hash) — Required. The fields to be updated.
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateScopeNamespaceRequest.new

# Call the update_scope_namespace method.
result = client.update_scope_namespace request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end

#update_scope_rbac_role_binding

def update_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
def update_scope_rbac_role_binding(rbacrolebinding: nil, update_mask: nil) -> ::Gapic::Operation

Updates a Scope RBACRoleBinding.

Overloads 
def update_scope_rbac_role_binding(request, options = nil) -> ::Gapic::Operation
Pass arguments to update_scope_rbac_role_binding via a request object, either of type UpdateScopeRBACRoleBindingRequest or an equivalent Hash.
Parameters
  • request (::Google::Cloud::GkeHub::V1::UpdateScopeRBACRoleBindingRequest, ::Hash) — A request object representing the call parameters. Required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash.
  • options (::Gapic::CallOptions, ::Hash) — Overrides the default settings for this call, e.g, timeout, retries etc. Optional. 
def update_scope_rbac_role_binding(rbacrolebinding: nil, update_mask: nil) -> ::Gapic::Operation
Pass arguments to update_scope_rbac_role_binding via keyword arguments. Note that at least one keyword argument is required. To specify no parameters, or to keep all the default parameter values, pass an empty Hash as a request object (see above).
Parameters
Yields
  • (result, operation) — Access the result along with the TransportOperation object
Yield Parameters
  • result (::Gapic::Operation)
  • operation (::Gapic::Rest::TransportOperation)
Returns
  • (::Gapic::Operation)
Raises
  • (::Google::Cloud::Error) — if the REST call is aborted.
Example

Basic example

require "google/cloud/gke_hub/v1"

# Create a client object. The client can be reused for multiple calls.
client = Google::Cloud::GkeHub::V1::GkeHub::Rest::Client.new

# Create a request. To set request fields, pass in keyword arguments.
request = Google::Cloud::GkeHub::V1::UpdateScopeRBACRoleBindingRequest.new

# Call the update_scope_rbac_role_binding method.
result = client.update_scope_rbac_role_binding request

# The returned object is of type Gapic::Operation. You can use it to
# check the status of an operation, cancel it, or wait for results.
# Here is how to wait for a response.
result.wait_until_done! timeout: 60
if result.response?
  p result.response
else
  puts "No response received."
end