Class ClusterManagerClient (2.30.0)

ClusterManagerClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.container_v1beta1.services.cluster_manager.transports.base.ClusterManagerTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Google Kubernetes Engine Cluster Manager v1beta1

Properties

transport

Returns the transport used by the client instance.

Returns
TypeDescription
ClusterManagerTransportThe transport used by the client instance.

Methods

ClusterManagerClient

ClusterManagerClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.container_v1beta1.services.cluster_manager.transports.base.ClusterManagerTransport]] = None, client_options: typing.Optional[typing.Union[google.api_core.client_options.ClientOptions, dict]] = None, client_info: google.api_core.gapic_v1.client_info.ClientInfo = <google.api_core.gapic_v1.client_info.ClientInfo object>)

Instantiates the cluster manager client.

Parameters
NameDescription
credentials Optional[google.auth.credentials.Credentials]

The authorization credentials to attach to requests. These credentials identify the application to the service; if none are specified, the client will attempt to ascertain the credentials from the environment.

transport Union[str, ClusterManagerTransport]

The transport to use. If set to None, a transport is chosen automatically.

client_options Optional[Union[google.api_core.client_options.ClientOptions, dict]]

Custom options for the client. It won't take effect if a transport instance is provided. (1) The api_endpoint property can be used to override the default endpoint provided by the client. GOOGLE_API_USE_MTLS_ENDPOINT environment variable can also be used to override the endpoint: "always" (always use the default mTLS endpoint), "never" (always use the default regular endpoint) and "auto" (auto switch to the default mTLS endpoint if client certificate is present, this is the default value). However, the api_endpoint property takes precedence if provided. (2) If GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "true", then the client_cert_source property can be used to provide client certificate for mutual TLS transport. If not provided, the default SSL client certificate will be used if present. If GOOGLE_API_USE_CLIENT_CERTIFICATE is "false" or not set, no client certificate will be used.

client_info google.api_core.gapic_v1.client_info.ClientInfo

The client info used to send a user-agent string along with API requests. If None, then default info will be used. Generally, you only need to set this if you're developing your own client library.

Exceptions
TypeDescription
google.auth.exceptions.MutualTLSChannelErrorIf mutual TLS transport creation failed for any reason.

__exit__

__exit__(type, value, traceback)

Releases underlying transport's resources.

cancel_operation

cancel_operation(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CancelOperationRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    operation_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> None

Cancels the specified operation.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_cancel_operation():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CancelOperationRequest(
        project_id="project_id_value",
        zone="zone_value",
        operation_id="operation_id_value",
    )

    # Make the request
    client.cancel_operation(request=request)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CancelOperationRequest, dict]

The request object. CancelOperationRequest cancels a single operation.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the operation resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

operation_id str

Required. Deprecated. The server-assigned name of the operation. This field has been deprecated and replaced by the name field. This corresponds to the operation_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

check_autopilot_compatibility

check_autopilot_compatibility(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CheckAutopilotCompatibilityRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> (
    google.cloud.container_v1beta1.types.cluster_service.CheckAutopilotCompatibilityResponse
)

Checks the cluster compatibility with Autopilot mode, and returns a list of compatibility issues.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_check_autopilot_compatibility():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CheckAutopilotCompatibilityRequest(
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CheckAutopilotCompatibilityRequest, dict]

The request object. CheckAutopilotCompatibilityRequest requests getting the blockers for the given operation in the cluster.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.CheckAutopilotCompatibilityResponseCheckAutopilotCompatibilityResponse has a list of compatibility issues.

common_billing_account_path

common_billing_account_path(billing_account: str) -> str

Returns a fully-qualified billing_account string.

common_folder_path

common_folder_path(folder: str) -> str

Returns a fully-qualified folder string.

common_location_path

common_location_path(project: str, location: str) -> str

Returns a fully-qualified location string.

common_organization_path

common_organization_path(organization: str) -> str

Returns a fully-qualified organization string.

common_project_path

common_project_path(project: str) -> str

Returns a fully-qualified project string.

complete_ip_rotation

complete_ip_rotation(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CompleteIPRotationRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Completes master IP rotation.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_complete_ip_rotation():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CompleteIPRotationRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CompleteIPRotationRequest, dict]

The request object. CompleteIPRotationRequest moves the cluster master back into single-IP mode.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

complete_node_pool_upgrade

complete_node_pool_upgrade(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CompleteNodePoolUpgradeRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> None

CompleteNodePoolUpgrade will signal an on-going node pool upgrade to complete.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_complete_node_pool_upgrade():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CompleteNodePoolUpgradeRequest(
    )

    # Make the request
    client.complete_node_pool_upgrade(request=request)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CompleteNodePoolUpgradeRequest, dict]

The request object. CompleteNodePoolUpgradeRequest sets the name of target node pool to complete upgrade.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

create_cluster

create_cluster(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CreateClusterRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.Cluster
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Creates a cluster, consisting of the specified number and type of Google Compute Engine instances.

By default, the cluster is created in the project's default network <https://cloud.google.com/compute/docs/networks-and-firewalls#networks>__.

One firewall is added for the cluster. After cluster creation, the Kubelet creates routes for each node to allow the containers on that node to communicate with all other instances in the cluster.

Finally, an entry is added to the project's global metadata indicating which CIDR range the cluster is using.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_create_cluster():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CreateClusterRequest(
        project_id="project_id_value",
        zone="zone_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CreateClusterRequest, dict]

The request object. CreateClusterRequest creates a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the parent field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the parent field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster google.cloud.container_v1beta1.types.Cluster

Required. A cluster resource https://cloud.google.com/container-engine/reference/rest/v1beta1/projects.locations.clusters__ This corresponds to the cluster field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

create_node_pool

create_node_pool(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.CreateNodePoolRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    node_pool: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.NodePool
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Creates a node pool for a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_create_node_pool():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.CreateNodePoolRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.CreateNodePoolRequest, dict]

The request object. CreateNodePoolRequest creates a node pool for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the parent field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the parent field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the parent field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

node_pool google.cloud.container_v1beta1.types.NodePool

Required. The node pool to create. This corresponds to the node_pool field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

delete_cluster

delete_cluster(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.DeleteClusterRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Deletes the cluster, including the Kubernetes endpoint and all worker nodes.

Firewalls and routes that were configured during cluster creation are also deleted.

Other Google Compute Engine resources that might be in use by the cluster, such as load balancer resources, are not deleted if they weren't present when the cluster was initially created.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_delete_cluster():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.DeleteClusterRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.DeleteClusterRequest, dict]

The request object. DeleteClusterRequest deletes a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to delete. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

delete_node_pool

delete_node_pool(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.DeleteNodePoolRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    node_pool_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Deletes a node pool from a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_delete_node_pool():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.DeleteNodePoolRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.DeleteNodePoolRequest, dict]

The request object. DeleteNodePoolRequest deletes a node pool for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

node_pool_id str

Required. Deprecated. The name of the node pool to delete. This field has been deprecated and replaced by the name field. This corresponds to the node_pool_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

from_service_account_file

from_service_account_file(filename: str, *args, **kwargs)

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

Parameter
NameDescription
filename str

The path to the service account private key json file.

Returns
TypeDescription
ClusterManagerClientThe constructed client.

from_service_account_info

from_service_account_info(info: dict, *args, **kwargs)

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

Parameter
NameDescription
info dict

The service account private key info.

Returns
TypeDescription
ClusterManagerClientThe constructed client.

from_service_account_json

from_service_account_json(filename: str, *args, **kwargs)

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

Parameter
NameDescription
filename str

The path to the service account private key json file.

Returns
TypeDescription
ClusterManagerClientThe constructed client.

get_cluster

get_cluster(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.GetClusterRequest, dict
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Cluster

Gets the details for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_get_cluster():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.GetClusterRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.GetClusterRequest, dict]

The request object. GetClusterRequest gets the settings of a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to retrieve. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ClusterA Google Kubernetes Engine cluster.

get_json_web_keys

get_json_web_keys(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.GetJSONWebKeysRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.GetJSONWebKeysResponse

Gets the public component of the cluster signing keys in JSON Web Key format. This API is not yet intended for general use, and is not available for all clusters.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_get_json_web_keys():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.GetJSONWebKeysRequest(
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.GetJSONWebKeysRequest, dict]

The request object. GetJSONWebKeysRequest gets the public component of the keys used by the cluster to sign token requests. This will be the jwks_uri for the discover document returned by getOpenIDConfig. See the OpenID Connect Discovery 1.0 specification for details.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.GetJSONWebKeysResponseGetJSONWebKeysResponse is a valid JSON Web Key Set as specififed in rfc 7517

get_mtls_endpoint_and_cert_source

get_mtls_endpoint_and_cert_source(
    client_options: typing.Optional[
        google.api_core.client_options.ClientOptions
    ] = None,
)

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

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

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

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

Parameter
NameDescription
client_options google.api_core.client_options.ClientOptions

Custom options for the client. Only the api_endpoint and client_cert_source properties may be used in this method.

Exceptions
TypeDescription
google.auth.exceptions.MutualTLSChannelErrorIf any errors happen.
Returns
TypeDescription
Tuple[str, Callable[[], Tuple[bytes, bytes]]]returns the API endpoint and the client cert source to use.

get_node_pool

get_node_pool(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.GetNodePoolRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    node_pool_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.NodePool

Retrieves the requested node pool.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_get_node_pool():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.GetNodePoolRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.GetNodePoolRequest, dict]

The request object. GetNodePoolRequest retrieves a node pool for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

node_pool_id str

Required. Deprecated. The name of the node pool. This field has been deprecated and replaced by the name field. This corresponds to the node_pool_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.NodePoolNodePool contains the name and configuration for a cluster's node pool. Node pools are a set of nodes (i.e. VM's), with a common configuration and specification, under the control of the cluster master. They may have a set of Kubernetes labels applied to them, which may be used to reference them during pod scheduling. They may also be resized up or down, to accommodate the workload. These upgrade settings control the level of parallelism and the level of disruption caused by an upgrade. maxUnavailable controls the number of nodes that can be simultaneously unavailable. maxSurge controls the number of additional nodes that can be added to the node pool temporarily for the time of the upgrade to increase the number of available nodes. (maxUnavailable + maxSurge) determines the level of parallelism (how many nodes are being upgraded at the same time). Note: upgrades inevitably introduce some disruption since workloads need to be moved from old nodes to new, upgraded ones. Even if maxUnavailable=0, this holds true. (Disruption stays within the limits of PodDisruptionBudget, if it is configured.) Consider a hypothetical node pool with 5 nodes having maxSurge=2, maxUnavailable=1. This means the upgrade process upgrades 3 nodes simultaneously. It creates 2 additional (upgraded) nodes, then it brings down 3 old (not yet upgraded) nodes at the same time. This ensures that there are always at least 4 nodes available.

get_operation

get_operation(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.GetOperationRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    operation_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Gets the specified operation.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_get_operation():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.GetOperationRequest(
        project_id="project_id_value",
        zone="zone_value",
        operation_id="operation_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.GetOperationRequest, dict]

The request object. GetOperationRequest gets a single operation.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

operation_id str

Required. Deprecated. The server-assigned name of the operation. This field has been deprecated and replaced by the name field. This corresponds to the operation_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

get_server_config

get_server_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.GetServerConfigRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.ServerConfig

Returns configuration info about the Google Kubernetes Engine service.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_get_server_config():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.GetServerConfigRequest(
        project_id="project_id_value",
        zone="zone_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.GetServerConfigRequest, dict]

The request object. Gets the current Kubernetes Engine service configuration.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ to return operations for. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ServerConfigKubernetes Engine service configuration.

list_clusters

list_clusters(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.ListClustersRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.ListClustersResponse

Lists all clusters owned by a project in either the specified zone or all zones.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_list_clusters():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.ListClustersRequest(
        project_id="project_id_value",
        zone="zone_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.ListClustersRequest, dict]

The request object. ListClustersRequest lists clusters.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the parent field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides, or "-" for all zones. This field has been deprecated and replaced by the parent field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ListClustersResponseListClustersResponse is the result of ListClustersRequest.

list_locations

list_locations(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.ListLocationsRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.ListLocationsResponse

Fetches locations that offer Google Kubernetes Engine.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_list_locations():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.ListLocationsRequest(
        parent="parent_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.ListLocationsRequest, dict]

The request object. ListLocationsRequest is used to request the locations that offer GKE.

parent str

Required. Contains the name of the resource requested. Specified in the format projects/*. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ListLocationsResponseListLocationsResponse returns the list of all GKE locations and their recommendation state.

list_node_pools

list_node_pools(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.ListNodePoolsRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.ListNodePoolsResponse

Lists the node pools for a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_list_node_pools():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.ListNodePoolsRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.ListNodePoolsRequest, dict]

The request object. ListNodePoolsRequest lists the node pool(s) for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the parent field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the parent field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the parent field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ListNodePoolsResponseListNodePoolsResponse is the result of ListNodePoolsRequest.

list_operations

list_operations(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.ListOperationsRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.ListOperationsResponse

Lists all operations in a project in the specified zone or all zones.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_list_operations():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.ListOperationsRequest(
        project_id="project_id_value",
        zone="zone_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.ListOperationsRequest, dict]

The request object. ListOperationsRequest lists operations.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the parent field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ to return operations for, or - for all zones. This field has been deprecated and replaced by the parent field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.ListOperationsResponseListOperationsResponse is the result of ListOperationsRequest.

list_usable_subnetworks

list_usable_subnetworks(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.ListUsableSubnetworksRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> (
    google.cloud.container_v1beta1.services.cluster_manager.pagers.ListUsableSubnetworksPager
)

Lists subnetworks that can be used for creating clusters in a project.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_list_usable_subnetworks():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.ListUsableSubnetworksRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.ListUsableSubnetworksRequest, dict]

The request object. ListUsableSubnetworksRequest requests the list of usable subnetworks. available to a user for creating clusters.

parent str

Required. The parent project where subnetworks are usable. Specified in the format projects/*. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.services.cluster_manager.pagers.ListUsableSubnetworksPagerListUsableSubnetworksResponse is the response of ListUsableSubnetworksRequest. Iterating over this object will yield results and resolve additional pages automatically.

parse_common_billing_account_path

parse_common_billing_account_path(path: str) -> typing.Dict[str, str]

Parse a billing_account path into its component segments.

parse_common_folder_path

parse_common_folder_path(path: str) -> typing.Dict[str, str]

Parse a folder path into its component segments.

parse_common_location_path

parse_common_location_path(path: str) -> typing.Dict[str, str]

Parse a location path into its component segments.

parse_common_organization_path

parse_common_organization_path(path: str) -> typing.Dict[str, str]

Parse a organization path into its component segments.

parse_common_project_path

parse_common_project_path(path: str) -> typing.Dict[str, str]

Parse a project path into its component segments.

parse_topic_path

parse_topic_path(path: str) -> typing.Dict[str, str]

Parses a topic path into its component segments.

rollback_node_pool_upgrade

rollback_node_pool_upgrade(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.RollbackNodePoolUpgradeRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    node_pool_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Rolls back a previously Aborted or Failed NodePool upgrade. This makes no changes if the last upgrade successfully completed.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_rollback_node_pool_upgrade():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.RollbackNodePoolUpgradeRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.RollbackNodePoolUpgradeRequest, dict]

The request object. RollbackNodePoolUpgradeRequest rollbacks the previously Aborted or Failed NodePool upgrade. This will be an no-op if the last upgrade successfully completed.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to rollback. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

node_pool_id str

Required. Deprecated. The name of the node pool to rollback. This field has been deprecated and replaced by the name field. This corresponds to the node_pool_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_addons_config

set_addons_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetAddonsConfigRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    addons_config: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.AddonsConfig
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the addons for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_addons_config():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetAddonsConfigRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetAddonsConfigRequest, dict]

The request object. SetAddonsRequest sets the addons associated with the cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

addons_config google.cloud.container_v1beta1.types.AddonsConfig

Required. The desired configurations for the various addons available to run in the cluster. This corresponds to the addons_config field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_labels

set_labels(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetLabelsRequest, dict
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    resource_labels: typing.Optional[typing.MutableMapping[str, str]] = None,
    label_fingerprint: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets labels on a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_labels():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetLabelsRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        label_fingerprint="label_fingerprint_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetLabelsRequest, dict]

The request object. SetLabelsRequest sets the Google Cloud Platform labels on a Google Container Engine cluster, which will in turn set them for Google Compute Engine resources used by that cluster

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

resource_labels MutableMapping[str, str]

Required. The labels to set for that cluster. This corresponds to the resource_labels field on the request instance; if request is provided, this should not be set.

label_fingerprint str

Required. The fingerprint of the previous set of labels for this resource, used to detect conflicts. The fingerprint is initially generated by Kubernetes Engine and changes after every request to modify or update labels. You must always provide an up-to-date fingerprint hash when updating or changing labels. Make a get() request to the resource to get the latest fingerprint. This corresponds to the label_fingerprint field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_legacy_abac

set_legacy_abac(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetLegacyAbacRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    enabled: typing.Optional[bool] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Enables or disables the ABAC authorization mechanism on a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_legacy_abac():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetLegacyAbacRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        enabled=True,
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetLegacyAbacRequest, dict]

The request object. SetLegacyAbacRequest enables or disables the ABAC authorization mechanism for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to update. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

enabled bool

Required. Whether ABAC authorization will be enabled in the cluster. This corresponds to the enabled field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_locations

set_locations(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetLocationsRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    locations: typing.Optional[typing.MutableSequence[str]] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the locations for a specific cluster. Deprecated. Use projects.locations.clusters.update <https://cloud.google.com/kubernetes-engine/docs/reference/rest/v1beta1/projects.locations.clusters/update>__ instead.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_locations():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetLocationsRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        locations=['locations_value1', 'locations_value2'],
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetLocationsRequest, dict]

The request object. SetLocationsRequest sets the locations of the cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

locations MutableSequence[str]

Required. The desired list of Google Compute Engine zones https://cloud.google.com/compute/docs/zones#available__ in which the cluster's nodes should be located. Changing the locations a cluster is in will result in nodes being either created or removed from the cluster, depending on whether locations are being added or removed. This list must always include the cluster's primary zone. This corresponds to the locations field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_logging_service

set_logging_service(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetLoggingServiceRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    logging_service: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the logging service for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_logging_service():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetLoggingServiceRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        logging_service="logging_service_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetLoggingServiceRequest, dict]

The request object. SetLoggingServiceRequest sets the logging service of a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

logging_service str

Required. The logging service the cluster should use to write logs. Currently available options: - logging.googleapis.com/kubernetes - The Cloud Logging service with a Kubernetes-native resource model - logging.googleapis.com - The legacy Cloud Logging service (no longer available as of GKE 1.15). - none - no logs will be exported from the cluster. If left as an empty string,\ logging.googleapis.com/kubernetes will be used for GKE 1.14+ or logging.googleapis.com for earlier versions. This corresponds to the logging_service field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_maintenance_policy

set_maintenance_policy(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetMaintenancePolicyRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    maintenance_policy: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.MaintenancePolicy
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the maintenance policy for a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_maintenance_policy():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetMaintenancePolicyRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetMaintenancePolicyRequest, dict]

The request object. SetMaintenancePolicyRequest sets the maintenance policy for a cluster.

project_id str

Required. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. The name of the cluster to update. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

maintenance_policy google.cloud.container_v1beta1.types.MaintenancePolicy

Required. The maintenance policy to be set for the cluster. An empty field clears the existing maintenance policy. This corresponds to the maintenance_policy field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_master_auth

set_master_auth(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetMasterAuthRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets master auth materials. Currently supports changing the admin password or a specific cluster, either via password generation or explicitly setting the password.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_master_auth():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetMasterAuthRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        action="SET_USERNAME",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetMasterAuthRequest, dict]

The request object. SetMasterAuthRequest updates the admin password of a cluster.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_monitoring_service

set_monitoring_service(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetMonitoringServiceRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    monitoring_service: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the monitoring service for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_monitoring_service():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetMonitoringServiceRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        monitoring_service="monitoring_service_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetMonitoringServiceRequest, dict]

The request object. SetMonitoringServiceRequest sets the monitoring service of a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

monitoring_service str

Required. The monitoring service the cluster should use to write metrics. Currently available options: - "monitoring.googleapis.com/kubernetes" - The Cloud Monitoring service with a Kubernetes-native resource model - monitoring.googleapis.com - The legacy Cloud Monitoring service (no longer available as of GKE 1.15). - none - No metrics will be exported from the cluster. If left as an empty string,\ monitoring.googleapis.com/kubernetes will be used for GKE 1.14+ or monitoring.googleapis.com for earlier versions. This corresponds to the monitoring_service field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_network_policy

set_network_policy(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetNetworkPolicyRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    network_policy: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.NetworkPolicy
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Enables or disables Network Policy for a cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_network_policy():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetNetworkPolicyRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetNetworkPolicyRequest, dict]

The request object. SetNetworkPolicyRequest enables/disables network policy for a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

network_policy google.cloud.container_v1beta1.types.NetworkPolicy

Required. Configuration options for the NetworkPolicy feature. This corresponds to the network_policy field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_node_pool_autoscaling

set_node_pool_autoscaling(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetNodePoolAutoscalingRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the autoscaling settings of a specific node pool.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_node_pool_autoscaling():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetNodePoolAutoscalingRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetNodePoolAutoscalingRequest, dict]

The request object. SetNodePoolAutoscalingRequest sets the autoscaler settings of a node pool.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_node_pool_management

set_node_pool_management(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetNodePoolManagementRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    node_pool_id: typing.Optional[str] = None,
    management: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.NodeManagement
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Sets the NodeManagement options for a node pool.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_node_pool_management():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetNodePoolManagementRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetNodePoolManagementRequest, dict]

The request object. SetNodePoolManagementRequest sets the node management properties of a node pool.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to update. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

node_pool_id str

Required. Deprecated. The name of the node pool to update. This field has been deprecated and replaced by the name field. This corresponds to the node_pool_id field on the request instance; if request is provided, this should not be set.

management google.cloud.container_v1beta1.types.NodeManagement

Required. NodeManagement configuration for the node pool. This corresponds to the management field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

set_node_pool_size

set_node_pool_size(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.SetNodePoolSizeRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

SetNodePoolSizeRequest sets the size of a node pool. The new size will be used for all replicas, including future replicas created by modifying NodePool.locations][google.container.v1beta1.NodePool.locations].

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_set_node_pool_size():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.SetNodePoolSizeRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
        node_count=1070,
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.SetNodePoolSizeRequest, dict]

The request object. SetNodePoolSizeRequest sets the size of a node pool.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

start_ip_rotation

start_ip_rotation(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.StartIPRotationRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Starts master IP rotation.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_start_ip_rotation():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.StartIPRotationRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.StartIPRotationRequest, dict]

The request object. StartIPRotationRequest creates a new IP for the cluster and then performs a node upgrade on each node pool to point to the new IP.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

topic_path

topic_path(project: str, topic: str) -> str

Returns a fully-qualified topic string.

update_cluster

update_cluster(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.UpdateClusterRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    update: typing.Optional[
        google.cloud.container_v1beta1.types.cluster_service.ClusterUpdate
    ] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Updates the settings for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_update_cluster():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.UpdateClusterRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.UpdateClusterRequest, dict]

The request object. UpdateClusterRequest updates the settings of a cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

update google.cloud.container_v1beta1.types.ClusterUpdate

Required. A description of the update. This corresponds to the update field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

update_master

update_master(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.UpdateMasterRequest,
            dict,
        ]
    ] = None,
    *,
    project_id: typing.Optional[str] = None,
    zone: typing.Optional[str] = None,
    cluster_id: typing.Optional[str] = None,
    master_version: typing.Optional[str] = None,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Updates the master for a specific cluster.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_update_master():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.UpdateMasterRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        master_version="master_version_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.UpdateMasterRequest, dict]

The request object. UpdateMasterRequest updates the master of the cluster.

project_id str

Required. Deprecated. The Google Developers Console project ID or project number https://cloud.google.com/resource-manager/docs/creating-managing-projects__. This field has been deprecated and replaced by the name field. This corresponds to the project_id field on the request instance; if request is provided, this should not be set.

zone str

Required. Deprecated. The name of the Google Compute Engine zone https://cloud.google.com/compute/docs/zones#available__ in which the cluster resides. This field has been deprecated and replaced by the name field. This corresponds to the zone field on the request instance; if request is provided, this should not be set.

cluster_id str

Required. Deprecated. The name of the cluster to upgrade. This field has been deprecated and replaced by the name field. This corresponds to the cluster_id field on the request instance; if request is provided, this should not be set.

master_version str

Required. The Kubernetes version to change the master to. Users may specify either explicit versions offered by Kubernetes Engine or version aliases, which have the following behavior: - "latest": picks the highest valid Kubernetes version - "1.X": picks the highest valid patch+gke.N patch in the 1.X version - "1.X.Y": picks the highest valid gke.N patch in the 1.X.Y version - "1.X.Y-gke.N": picks an explicit Kubernetes version - "-": picks the default Kubernetes version This corresponds to the master_version field on the request instance; if request is provided, this should not be set.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.

update_node_pool

update_node_pool(
    request: typing.Optional[
        typing.Union[
            google.cloud.container_v1beta1.types.cluster_service.UpdateNodePoolRequest,
            dict,
        ]
    ] = None,
    *,
    retry: typing.Union[
        google.api_core.retry.Retry, google.api_core.gapic_v1.method._MethodDefault
    ] = _MethodDefault._DEFAULT_VALUE,
    timeout: typing.Union[float, object] = _MethodDefault._DEFAULT_VALUE,
    metadata: typing.Sequence[typing.Tuple[str, str]] = ()
) -> google.cloud.container_v1beta1.types.cluster_service.Operation

Updates the version and/or image type of a specific node pool.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import container_v1beta1

def sample_update_node_pool():
    # Create a client
    client = container_v1beta1.ClusterManagerClient()

    # Initialize request argument(s)
    request = container_v1beta1.UpdateNodePoolRequest(
        project_id="project_id_value",
        zone="zone_value",
        cluster_id="cluster_id_value",
        node_pool_id="node_pool_id_value",
        node_version="node_version_value",
        image_type="image_type_value",
    )

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

    # Handle the response
    print(response)
Parameters
NameDescription
request Union[google.cloud.container_v1beta1.types.UpdateNodePoolRequest, dict]

The request object. SetNodePoolVersionRequest updates the version of a node pool.

retry google.api_core.retry.Retry

Designation of what errors, if any, should be retried.

timeout float

The timeout for this request.

metadata Sequence[Tuple[str, str]]

Strings which should be sent along with the request as metadata.

Returns
TypeDescription
google.cloud.container_v1beta1.types.OperationThis operation resource represents operations that may have happened or are happening on the cluster. All fields are output only.