Class BareMetalSolutionClient (1.7.5)

BareMetalSolutionClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.bare_metal_solution_v2.services.bare_metal_solution.transports.base.BareMetalSolutionTransport, typing.Callable[[...], google.cloud.bare_metal_solution_v2.services.bare_metal_solution.transports.base.BareMetalSolutionTransport]]] = 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>)

Performs management operations on Bare Metal Solution servers.

The baremetalsolution.googleapis.com service provides management capabilities for Bare Metal Solution servers. To access the API methods, you must assign Bare Metal Solution IAM roles containing the desired permissions to your staff in your Google Cloud project. You must also enable the Bare Metal Solution API. Once enabled, the methods act upon specific servers in your Bare Metal Solution environment.

Properties

api_endpoint

Return the API endpoint used by the client instance.

Returns
Type Description
str The API endpoint used by the client instance.

transport

Returns the transport used by the client instance.

Returns
Type Description
BareMetalSolutionTransport The transport used by the client instance.

universe_domain

Return the universe domain used by the client instance.

Returns
Type Description
str The universe domain used by the client instance.

Methods

BareMetalSolutionClient

BareMetalSolutionClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.bare_metal_solution_v2.services.bare_metal_solution.transports.base.BareMetalSolutionTransport, typing.Callable[[...], google.cloud.bare_metal_solution_v2.services.bare_metal_solution.transports.base.BareMetalSolutionTransport]]] = 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 bare metal solution client.

Parameters
Name Description
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 Optional[Union[str,BareMetalSolutionTransport,Callable[..., BareMetalSolutionTransport]]]

The transport to use, or a Callable that constructs and returns a new transport. If a Callable is given, it will be called with the same set of initialization arguments as used in the BareMetalSolutionTransport constructor. 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. 1. The api_endpoint property can be used to override the default endpoint provided by the client when transport is not explicitly provided. Only if this property is not set and transport was not explicitly provided, the endpoint is determined by the GOOGLE_API_USE_MTLS_ENDPOINT environment variable, which have one of the following values: "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). 2. If the GOOGLE_API_USE_CLIENT_CERTIFICATE environment variable is "true", then the client_cert_source property can be used to provide a client certificate for mTLS 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. 3. The universe_domain property can be used to override the default "googleapis.com" universe. Note that the api_endpoint property still takes precedence; and universe_domain is currently not supported for mTLS.

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
Type Description
google.auth.exceptions.MutualTLSChannelError If mutual TLS transport creation failed for any reason.

__exit__

__exit__(type, value, traceback)

Releases underlying transport's resources.

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.

create_nfs_share

create_nfs_share(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.CreateNfsShareRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    nfs_share: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.nfs_share.NfsShare
    ] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Create an NFS share.

# 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 bare_metal_solution_v2

def sample_create_nfs_share():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.CreateNfsShareRequest(
        parent="parent_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.CreateNfsShareRequest, dict]

The request object. Message for creating an NFS share.

parent str

Required. The parent project and location. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

nfs_share google.cloud.bare_metal_solution_v2.types.NfsShare

Required. The NfsShare to create. This corresponds to the nfs_share 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be NfsShare An NFS share.

create_provisioning_config

create_provisioning_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.provisioning.CreateProvisioningConfigRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    provisioning_config: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.provisioning.ProvisioningConfig
    ] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.provisioning.ProvisioningConfig

Create new ProvisioningConfig.

# 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 bare_metal_solution_v2

def sample_create_provisioning_config():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.CreateProvisioningConfigRequest(
        parent="parent_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.CreateProvisioningConfigRequest, dict]

The request object. Request for CreateProvisioningConfig.

parent str

Required. The parent project and location containing the ProvisioningConfig. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

provisioning_config google.cloud.bare_metal_solution_v2.types.ProvisioningConfig

Required. The ProvisioningConfig to create. This corresponds to the provisioning_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
Type Description
google.cloud.bare_metal_solution_v2.types.ProvisioningConfig A provisioning configuration.

create_ssh_key

create_ssh_key(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.ssh_key.CreateSSHKeyRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    ssh_key: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.ssh_key.SSHKey
    ] = None,
    ssh_key_id: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.ssh_key.SSHKey

Register a public SSH key in the specified project for use with the interactive serial console feature.

# 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 bare_metal_solution_v2

def sample_create_ssh_key():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.CreateSSHKeyRequest(
        parent="parent_value",
        ssh_key_id="ssh_key_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.CreateSSHKeyRequest, dict]

The request object. Message for registering a public SSH key in a project.

parent str

Required. The parent containing the SSH keys. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

ssh_key google.cloud.bare_metal_solution_v2.types.SSHKey

Required. The SSH key to register. This corresponds to the ssh_key field on the request instance; if request is provided, this should not be set.

ssh_key_id str

Required. The ID to use for the key, which will become the final component of the key's resource name. This value must match the regex: [a-zA-Z0-9@.-_]{1,64} This corresponds to the ssh_key_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
Type Description
google.cloud.bare_metal_solution_v2.types.SSHKey An SSH key, used for authorizing with the interactive serial console feature.

create_volume_snapshot

create_volume_snapshot(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume_snapshot.CreateVolumeSnapshotRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    volume_snapshot: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.volume_snapshot.VolumeSnapshot
    ] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.volume_snapshot.VolumeSnapshot

Takes a snapshot of a boot volume. Returns INVALID_ARGUMENT if called for a non-boot volume.

# 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 bare_metal_solution_v2

def sample_create_volume_snapshot():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.CreateVolumeSnapshotRequest(
        parent="parent_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.CreateVolumeSnapshotRequest, dict]

The request object. Message for creating a volume snapshot.

parent str

Required. The volume to snapshot. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

volume_snapshot google.cloud.bare_metal_solution_v2.types.VolumeSnapshot

Required. The snapshot to create. This corresponds to the volume_snapshot 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
Type Description
google.cloud.bare_metal_solution_v2.types.VolumeSnapshot A snapshot of a volume. Only boot volumes can have snapshots.

delete_nfs_share

delete_nfs_share(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.DeleteNfsShareRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Delete an NFS share. The underlying volume is automatically deleted.

# 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 bare_metal_solution_v2

def sample_delete_nfs_share():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.DeleteNfsShareRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.DeleteNfsShareRequest, dict]

The request object. Message for deleting an NFS share.

name str

Required. The name of the NFS share to delete. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

delete_ssh_key

delete_ssh_key(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.ssh_key.DeleteSSHKeyRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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

Deletes a public SSH key registered in the specified 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 bare_metal_solution_v2

def sample_delete_ssh_key():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.DeleteSSHKeyRequest(
        name="name_value",
    )

    # Make the request
    client.delete_ssh_key(request=request)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.DeleteSSHKeyRequest, dict]

The request object. Message for deleting an SSH key from a project.

name str

Required. The name of the SSH key to delete. Currently, the only valid value for the location is "global". This corresponds to the name 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.

delete_volume_snapshot

delete_volume_snapshot(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume_snapshot.DeleteVolumeSnapshotRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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

Deletes a volume snapshot. Returns INVALID_ARGUMENT if called for a non-boot volume.

# 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 bare_metal_solution_v2

def sample_delete_volume_snapshot():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.DeleteVolumeSnapshotRequest(
        name="name_value",
    )

    # Make the request
    client.delete_volume_snapshot(request=request)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.DeleteVolumeSnapshotRequest, dict]

The request object. Message for deleting named Volume snapshot.

name str

Required. The name of the snapshot to delete. This corresponds to the name 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.

detach_lun

detach_lun(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.DetachLunRequest, dict
        ]
    ] = None,
    *,
    instance: typing.Optional[str] = None,
    lun: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Detach LUN from Instance.

# 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 bare_metal_solution_v2

def sample_detach_lun():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.DetachLunRequest(
        instance="instance_value",
        lun="lun_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.DetachLunRequest, dict]

The request object. Message for detach specific LUN from an Instance.

instance str

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

lun str

Required. Name of the Lun to detach. This corresponds to the lun 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Instance A server.

disable_interactive_serial_console

disable_interactive_serial_console(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.DisableInteractiveSerialConsoleRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Disable the interactive serial console feature on an instance.

# 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 bare_metal_solution_v2

def sample_disable_interactive_serial_console():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.DisableInteractiveSerialConsoleRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.DisableInteractiveSerialConsoleRequest, dict]

The request object. Message for disabling the interactive serial console on an instance.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be DisableInteractiveSerialConsoleResponse Message for response of DisableInteractiveSerialConsole.

enable_interactive_serial_console

enable_interactive_serial_console(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.EnableInteractiveSerialConsoleRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Enable the interactive serial console feature on an instance.

# 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 bare_metal_solution_v2

def sample_enable_interactive_serial_console():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.EnableInteractiveSerialConsoleRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.EnableInteractiveSerialConsoleRequest, dict]

The request object. Message for enabling the interactive serial console on an instance.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be EnableInteractiveSerialConsoleResponse Message for response of EnableInteractiveSerialConsole.

evict_lun

evict_lun(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.lun.EvictLunRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Skips lun's cooloff and deletes it now. Lun must be in cooloff state.

# 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 bare_metal_solution_v2

def sample_evict_lun():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.EvictLunRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.EvictLunRequest, dict]

The request object. Request for skip lun cooloff and delete it.

name str

Required. The name of the lun. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

evict_volume

evict_volume(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.EvictVolumeRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Skips volume's cooloff and deletes it now. Volume must be in cooloff state.

# 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 bare_metal_solution_v2

def sample_evict_volume():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.EvictVolumeRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.EvictVolumeRequest, dict]

The request object. Request for skip volume cooloff and delete it.

name str

Required. The name of the Volume. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be google.protobuf.empty_pb2.Empty A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }

from_service_account_file

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

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

Parameter
Name Description
filename str

The path to the service account private key json file.

Returns
Type Description
BareMetalSolutionClient The 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
Name Description
info dict

The service account private key info.

Returns
Type Description
BareMetalSolutionClient The 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
Name Description
filename str

The path to the service account private key json file.

Returns
Type Description
BareMetalSolutionClient The constructed client.

get_instance

get_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.GetInstanceRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.instance.Instance

Get details about a single server.

# 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 bare_metal_solution_v2

def sample_get_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetInstanceRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetInstanceRequest, dict]

The request object. Message for requesting server information.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.Instance A server.

get_location

get_location(
    request: typing.Optional[
        google.cloud.location.locations_pb2.GetLocationRequest
    ] = None,
    *,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.location.locations_pb2.Location

Gets information about a location.

Parameters
Name Description
request .location_pb2.GetLocationRequest

The request object. Request message for GetLocation method.

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
Type Description
.location_pb2.Location Location object.

get_lun

get_lun(
    request: typing.Optional[
        typing.Union[google.cloud.bare_metal_solution_v2.types.lun.GetLunRequest, dict]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.lun.Lun

Get details of a single storage logical unit number(LUN).

# 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 bare_metal_solution_v2

def sample_get_lun():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetLunRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetLunRequest, dict]

The request object. Message for requesting storage lun information.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.Lun A storage volume logical unit number (LUN).

get_mtls_endpoint_and_cert_source

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

Deprecated. 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
Name Description
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
Type Description
google.auth.exceptions.MutualTLSChannelError If any errors happen.
Returns
Type Description
Tuple[str, Callable[[], Tuple[bytes, bytes]]] returns the API endpoint and the client cert source to use.

get_network

get_network(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.network.GetNetworkRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.network.Network

Get details of a single network.

# 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 bare_metal_solution_v2

def sample_get_network():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetNetworkRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetNetworkRequest, dict]

The request object. Message for requesting network information.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.Network A Network.

get_nfs_share

get_nfs_share(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.GetNfsShareRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.nfs_share.NfsShare

Get details of a single NFS share.

# 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 bare_metal_solution_v2

def sample_get_nfs_share():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetNfsShareRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetNfsShareRequest, dict]

The request object. Message for requesting NFS share information.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.NfsShare An NFS share.

get_provisioning_config

get_provisioning_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.provisioning.GetProvisioningConfigRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.provisioning.ProvisioningConfig

Get ProvisioningConfig by name.

# 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 bare_metal_solution_v2

def sample_get_provisioning_config():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetProvisioningConfigRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetProvisioningConfigRequest, dict]

The request object. Request for GetProvisioningConfig.

name str

Required. Name of the ProvisioningConfig. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.ProvisioningConfig A provisioning configuration.

get_volume

get_volume(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.GetVolumeRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.volume.Volume

Get details of a single storage volume.

# 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 bare_metal_solution_v2

def sample_get_volume():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetVolumeRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetVolumeRequest, dict]

The request object. Message for requesting storage volume information.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.Volume A storage volume.

get_volume_snapshot

get_volume_snapshot(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume_snapshot.GetVolumeSnapshotRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.volume_snapshot.VolumeSnapshot

Returns the specified snapshot resource. Returns INVALID_ARGUMENT if called for a non-boot volume.

# 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 bare_metal_solution_v2

def sample_get_volume_snapshot():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.GetVolumeSnapshotRequest(
        name="name_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.GetVolumeSnapshotRequest, dict]

The request object. Message for requesting volume snapshot information.

name str

Required. The name of the snapshot. This corresponds to the name 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
Type Description
google.cloud.bare_metal_solution_v2.types.VolumeSnapshot A snapshot of a volume. Only boot volumes can have snapshots.

instance_config_path

instance_config_path(project: str, location: str, instance_config: str) -> str

Returns a fully-qualified instance_config string.

instance_path

instance_path(project: str, location: str, instance: str) -> str

Returns a fully-qualified instance string.

instance_quota_path

instance_quota_path(project: str, location: str, instance_quota: str) -> str

Returns a fully-qualified instance_quota string.

interconnect_attachment_path

interconnect_attachment_path(
    project: str, region: str, interconnect_attachment: str
) -> str

Returns a fully-qualified interconnect_attachment string.

list_instances

list_instances(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.ListInstancesRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListInstancesPager
)

List servers in a given project and location.

# 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 bare_metal_solution_v2

def sample_list_instances():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListInstancesRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListInstancesRequest, dict]

The request object. Message for requesting the list of servers.

parent str

Required. Parent value for ListInstancesRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListInstancesPager Response message for the list of servers. Iterating over this object will yield results and resolve additional pages automatically.

list_locations

list_locations(
    request: typing.Optional[
        google.cloud.location.locations_pb2.ListLocationsRequest
    ] = None,
    *,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.location.locations_pb2.ListLocationsResponse

Lists information about the supported locations for this service.

Parameters
Name Description
request .location_pb2.ListLocationsRequest

The request object. Request message for ListLocations method.

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
Type Description
.location_pb2.ListLocationsResponse Response message for ListLocations method.

list_luns

list_luns(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.lun.ListLunsRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListLunsPager
)

List storage volume luns for given storage volume.

# 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 bare_metal_solution_v2

def sample_list_luns():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListLunsRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListLunsRequest, dict]

The request object. Message for requesting a list of storage volume luns.

parent str

Required. Parent value for ListLunsRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListLunsPager Response message containing the list of storage volume luns. Iterating over this object will yield results and resolve additional pages automatically.

list_network_usage

list_network_usage(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.network.ListNetworkUsageRequest,
            dict,
        ]
    ] = None,
    *,
    location: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.network.ListNetworkUsageResponse

List all Networks (and used IPs for each Network) in the vendor account associated with the specified 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 bare_metal_solution_v2

def sample_list_network_usage():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListNetworkUsageRequest(
        location="location_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListNetworkUsageRequest, dict]

The request object. Request to get networks with IPs.

location str

Required. Parent value (project and location). This corresponds to the location 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
Type Description
google.cloud.bare_metal_solution_v2.types.ListNetworkUsageResponse Response with Networks with IPs

list_networks

list_networks(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.network.ListNetworksRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListNetworksPager
)

List network in a given project and location.

# 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 bare_metal_solution_v2

def sample_list_networks():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListNetworksRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListNetworksRequest, dict]

The request object. Message for requesting a list of networks.

parent str

Required. Parent value for ListNetworksRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListNetworksPager Response message containing the list of networks. Iterating over this object will yield results and resolve additional pages automatically.

list_nfs_shares

list_nfs_shares(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.ListNfsSharesRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListNfsSharesPager
)

List NFS shares.

# 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 bare_metal_solution_v2

def sample_list_nfs_shares():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListNfsSharesRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListNfsSharesRequest, dict]

The request object. Message for requesting a list of NFS shares.

parent str

Required. Parent value for ListNfsSharesRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListNfsSharesPager Response message containing the list of NFS shares. Iterating over this object will yield results and resolve additional pages automatically.

list_os_images

list_os_images(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.osimage.ListOSImagesRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListOSImagesPager
)

Retrieves the list of OS images which are currently approved.

# 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 bare_metal_solution_v2

def sample_list_os_images():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListOSImagesRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListOSImagesRequest, dict]

The request object. Request for getting all available OS images.

parent str

Required. Parent value for ListProvisioningQuotasRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListOSImagesPager Request for getting all available OS images. Iterating over this object will yield results and resolve additional pages automatically.

list_provisioning_quotas

list_provisioning_quotas(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.provisioning.ListProvisioningQuotasRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListProvisioningQuotasPager
)

List the budget details to provision resources on a given 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 bare_metal_solution_v2

def sample_list_provisioning_quotas():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListProvisioningQuotasRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListProvisioningQuotasRequest, dict]

The request object. Message for requesting the list of provisioning quotas.

parent str

Required. Parent value for ListProvisioningQuotasRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListProvisioningQuotasPager Response message for the list of provisioning quotas. Iterating over this object will yield results and resolve additional pages automatically.

list_ssh_keys

list_ssh_keys(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.ssh_key.ListSSHKeysRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListSSHKeysPager
)

Lists the public SSH keys registered for the specified project. These SSH keys are used only for the interactive serial console feature.

# 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 bare_metal_solution_v2

def sample_list_ssh_keys():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListSSHKeysRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListSSHKeysRequest, dict]

The request object. Message for listing the public SSH keys in a project.

parent str

Required. The parent containing the SSH keys. Currently, the only valid value for the location is "global". 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListSSHKeysPager Message for response of ListSSHKeys. Iterating over this object will yield results and resolve additional pages automatically.

list_volume_snapshots

list_volume_snapshots(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume_snapshot.ListVolumeSnapshotsRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListVolumeSnapshotsPager
)

Retrieves the list of snapshots for the specified volume. Returns a response with an empty list of snapshots if called for a non-boot volume.

# 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 bare_metal_solution_v2

def sample_list_volume_snapshots():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListVolumeSnapshotsRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListVolumeSnapshotsRequest, dict]

The request object. Message for requesting a list of volume snapshots.

parent str

Required. Parent value for ListVolumesRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListVolumeSnapshotsPager Response message containing the list of volume snapshots. Iterating over this object will yield results and resolve additional pages automatically.

list_volumes

list_volumes(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.ListVolumesRequest, dict
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListVolumesPager
)

List storage volumes in a given project and location.

# 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 bare_metal_solution_v2

def sample_list_volumes():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ListVolumesRequest(
        parent="parent_value",
    )

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

    # Handle the response
    for response in page_result:
        print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ListVolumesRequest, dict]

The request object. Message for requesting a list of storage volumes.

parent str

Required. Parent value for ListVolumesRequest. 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
Type Description
google.cloud.bare_metal_solution_v2.services.bare_metal_solution.pagers.ListVolumesPager Response message containing the list of storage volumes. Iterating over this object will yield results and resolve additional pages automatically.

lun_path

lun_path(project: str, location: str, volume: str, lun: str) -> str

Returns a fully-qualified lun string.

network_config_path

network_config_path(project: str, location: str, network_config: str) -> str

Returns a fully-qualified network_config string.

network_path

network_path(project: str, location: str, network: str) -> str

Returns a fully-qualified network string.

nfs_share_path

nfs_share_path(project: str, location: str, nfs_share: str) -> str

Returns a fully-qualified nfs_share string.

os_image_path

os_image_path(project: str, location: str, os_image: str) -> str

Returns a fully-qualified os_image string.

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_instance_config_path

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

Parses a instance_config path into its component segments.

parse_instance_path

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

Parses a instance path into its component segments.

parse_instance_quota_path

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

Parses a instance_quota path into its component segments.

parse_interconnect_attachment_path

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

Parses a interconnect_attachment path into its component segments.

parse_lun_path

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

Parses a lun path into its component segments.

parse_network_config_path

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

Parses a network_config path into its component segments.

parse_network_path

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

Parses a network path into its component segments.

parse_nfs_share_path

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

Parses a nfs_share path into its component segments.

parse_os_image_path

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

Parses a os_image path into its component segments.

parse_provisioning_config_path

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

Parses a provisioning_config path into its component segments.

parse_provisioning_quota_path

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

Parses a provisioning_quota path into its component segments.

parse_server_network_template_path

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

Parses a server_network_template path into its component segments.

parse_ssh_key_path

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

Parses a ssh_key path into its component segments.

parse_volume_config_path

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

Parses a volume_config path into its component segments.

parse_volume_path

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

Parses a volume path into its component segments.

parse_volume_snapshot_path

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

Parses a volume_snapshot path into its component segments.

provisioning_config_path

provisioning_config_path(
    project: str, location: str, provisioning_config: str
) -> str

Returns a fully-qualified provisioning_config string.

provisioning_quota_path

provisioning_quota_path(
    project: str, location: str, provisioning_quota: str
) -> str

Returns a fully-qualified provisioning_quota string.

rename_instance

rename_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.RenameInstanceRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    new_instance_id: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.instance.Instance

RenameInstance sets a new name for an instance. Use with caution, previous names become immediately invalidated.

# 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 bare_metal_solution_v2

def sample_rename_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.RenameInstanceRequest(
        name="name_value",
        new_instance_id="new_instance_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.RenameInstanceRequest, dict]

The request object. Message requesting rename of a server.

name str

Required. The name field is used to identify the instance. Format: projects/{project}/locations/{location}/instances/{instance} This corresponds to the name field on the request instance; if request is provided, this should not be set.

new_instance_id str

Required. The new id of the instance. This corresponds to the new_instance_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
Type Description
google.cloud.bare_metal_solution_v2.types.Instance A server.

rename_network

rename_network(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.network.RenameNetworkRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    new_network_id: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.network.Network

RenameNetwork sets a new name for a network. Use with caution, previous names become immediately invalidated.

# 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 bare_metal_solution_v2

def sample_rename_network():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.RenameNetworkRequest(
        name="name_value",
        new_network_id="new_network_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.RenameNetworkRequest, dict]

The request object. Message requesting rename of a server.

name str

Required. The name field is used to identify the network. Format: projects/{project}/locations/{location}/networks/{network} This corresponds to the name field on the request instance; if request is provided, this should not be set.

new_network_id str

Required. The new id of the network. This corresponds to the new_network_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
Type Description
google.cloud.bare_metal_solution_v2.types.Network A Network.

rename_nfs_share

rename_nfs_share(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.RenameNfsShareRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    new_nfsshare_id: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.nfs_share.NfsShare

RenameNfsShare sets a new name for an nfsshare. Use with caution, previous names become immediately invalidated.

# 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 bare_metal_solution_v2

def sample_rename_nfs_share():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.RenameNfsShareRequest(
        name="name_value",
        new_nfsshare_id="new_nfsshare_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.RenameNfsShareRequest, dict]

The request object. Message requesting rename of a server.

name str

Required. The name field is used to identify the nfsshare. Format: projects/{project}/locations/{location}/nfsshares/{nfsshare} This corresponds to the name field on the request instance; if request is provided, this should not be set.

new_nfsshare_id str

Required. The new id of the nfsshare. This corresponds to the new_nfsshare_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
Type Description
google.cloud.bare_metal_solution_v2.types.NfsShare An NFS share.

rename_volume

rename_volume(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.RenameVolumeRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    new_volume_id: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.volume.Volume

RenameVolume sets a new name for a volume. Use with caution, previous names become immediately invalidated.

# 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 bare_metal_solution_v2

def sample_rename_volume():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.RenameVolumeRequest(
        name="name_value",
        new_volume_id="new_volume_id_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.RenameVolumeRequest, dict]

The request object. Message requesting rename of a server.

name str

Required. The name field is used to identify the volume. Format: projects/{project}/locations/{location}/volumes/{volume} This corresponds to the name field on the request instance; if request is provided, this should not be set.

new_volume_id str

Required. The new id of the volume. This corresponds to the new_volume_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
Type Description
google.cloud.bare_metal_solution_v2.types.Volume A storage volume.

reset_instance

reset_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.ResetInstanceRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Perform an ungraceful, hard reset on a server. Equivalent to shutting the power off and then turning it back on.

# 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 bare_metal_solution_v2

def sample_reset_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ResetInstanceRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ResetInstanceRequest, dict]

The request object. Message requesting to reset a server.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be ResetInstanceResponse Response message from resetting a server.

resize_volume

resize_volume(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.ResizeVolumeRequest, dict
        ]
    ] = None,
    *,
    volume: typing.Optional[str] = None,
    size_gib: typing.Optional[int] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Emergency Volume resize.

# 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 bare_metal_solution_v2

def sample_resize_volume():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.ResizeVolumeRequest(
        volume="volume_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.ResizeVolumeRequest, dict]

The request object. Request for emergency resize Volume.

volume str

Required. Volume to resize. This corresponds to the volume field on the request instance; if request is provided, this should not be set.

size_gib int

New Volume size, in GiB. This corresponds to the size_gib 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Volume A storage volume.

restore_volume_snapshot

restore_volume_snapshot(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume_snapshot.RestoreVolumeSnapshotRequest,
            dict,
        ]
    ] = None,
    *,
    volume_snapshot: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Uses the specified snapshot to restore its parent volume. Returns INVALID_ARGUMENT if called for a non-boot volume.

# 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 bare_metal_solution_v2

def sample_restore_volume_snapshot():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.RestoreVolumeSnapshotRequest(
        volume_snapshot="volume_snapshot_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.RestoreVolumeSnapshotRequest, dict]

The request object. Message for restoring a volume snapshot.

volume_snapshot str

Required. Name of the snapshot which will be used to restore its parent volume. This corresponds to the volume_snapshot 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be VolumeSnapshot A snapshot of a volume. Only boot volumes can have snapshots.

server_network_template_path

server_network_template_path(
    project: str, location: str, server_network_template: str
) -> str

Returns a fully-qualified server_network_template string.

ssh_key_path

ssh_key_path(project: str, location: str, ssh_key: str) -> str

Returns a fully-qualified ssh_key string.

start_instance

start_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.StartInstanceRequest,
            dict,
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Starts a server that was shutdown.

# 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 bare_metal_solution_v2

def sample_start_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.StartInstanceRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.StartInstanceRequest, dict]

The request object. Message requesting to start a server.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be StartInstanceResponse Response message from starting a server.

stop_instance

stop_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.StopInstanceRequest, dict
        ]
    ] = None,
    *,
    name: typing.Optional[str] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Stop a running server.

# 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 bare_metal_solution_v2

def sample_stop_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.StopInstanceRequest(
        name="name_value",
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.StopInstanceRequest, dict]

The request object. Message requesting to stop a server.

name str

Required. Name of the resource. This corresponds to the name 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be StopInstanceResponse Response message from stopping a server.

submit_provisioning_config

submit_provisioning_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.provisioning.SubmitProvisioningConfigRequest,
            dict,
        ]
    ] = None,
    *,
    parent: typing.Optional[str] = None,
    provisioning_config: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.provisioning.ProvisioningConfig
    ] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.provisioning.SubmitProvisioningConfigResponse
)

Submit a provisiong configuration for a given 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 bare_metal_solution_v2

def sample_submit_provisioning_config():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.SubmitProvisioningConfigRequest(
        parent="parent_value",
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.SubmitProvisioningConfigRequest, dict]

The request object. Request for SubmitProvisioningConfig.

parent str

Required. The parent project and location containing the ProvisioningConfig. This corresponds to the parent field on the request instance; if request is provided, this should not be set.

provisioning_config google.cloud.bare_metal_solution_v2.types.ProvisioningConfig

Required. The ProvisioningConfig to create. This corresponds to the provisioning_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
Type Description
google.cloud.bare_metal_solution_v2.types.SubmitProvisioningConfigResponse Response for SubmitProvisioningConfig.

update_instance

update_instance(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.instance.UpdateInstanceRequest,
            dict,
        ]
    ] = None,
    *,
    instance: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.instance.Instance
    ] = None,
    update_mask: typing.Optional[google.protobuf.field_mask_pb2.FieldMask] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Update details of a single server.

# 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 bare_metal_solution_v2

def sample_update_instance():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.UpdateInstanceRequest(
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.UpdateInstanceRequest, dict]

The request object. Message requesting to updating a server.

instance google.cloud.bare_metal_solution_v2.types.Instance

Required. The server to update. The name field is used to identify the instance to update. Format: projects/{project}/locations/{location}/instances/{instance} This corresponds to the instance field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

The list of fields to update. The currently supported fields are: labels hyperthreading_enabled os_image This corresponds to the update_mask 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Instance A server.

update_network

update_network(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.network.UpdateNetworkRequest, dict
        ]
    ] = None,
    *,
    network: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.network.Network
    ] = None,
    update_mask: typing.Optional[google.protobuf.field_mask_pb2.FieldMask] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Update details of a single network.

# 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 bare_metal_solution_v2

def sample_update_network():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.UpdateNetworkRequest(
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.UpdateNetworkRequest, dict]

The request object. Message requesting to updating a network.

network google.cloud.bare_metal_solution_v2.types.Network

Required. The network to update. The name field is used to identify the instance to update. Format: projects/{project}/locations/{location}/networks/{network} This corresponds to the network field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

The list of fields to update. The only currently supported fields are: labels, reservations, vrf.vlan_attachments This corresponds to the update_mask 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Network A Network.

update_nfs_share

update_nfs_share(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.nfs_share.UpdateNfsShareRequest,
            dict,
        ]
    ] = None,
    *,
    nfs_share: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.nfs_share.NfsShare
    ] = None,
    update_mask: typing.Optional[google.protobuf.field_mask_pb2.FieldMask] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Update details of a single NFS share.

# 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 bare_metal_solution_v2

def sample_update_nfs_share():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.UpdateNfsShareRequest(
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.UpdateNfsShareRequest, dict]

The request object. Message requesting to updating an NFS share.

nfs_share google.cloud.bare_metal_solution_v2.types.NfsShare

Required. The NFS share to update. The name field is used to identify the NFS share to update. Format: projects/{project}/locations/{location}/nfsShares/{nfs_share} This corresponds to the nfs_share field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

The list of fields to update. The only currently supported fields are: labels allowed_clients This corresponds to the update_mask 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be NfsShare An NFS share.

update_provisioning_config

update_provisioning_config(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.provisioning.UpdateProvisioningConfigRequest,
            dict,
        ]
    ] = None,
    *,
    provisioning_config: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.provisioning.ProvisioningConfig
    ] = None,
    update_mask: typing.Optional[google.protobuf.field_mask_pb2.FieldMask] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.bare_metal_solution_v2.types.provisioning.ProvisioningConfig

Update existing ProvisioningConfig.

# 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 bare_metal_solution_v2

def sample_update_provisioning_config():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.UpdateProvisioningConfigRequest(
    )

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

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.UpdateProvisioningConfigRequest, dict]

The request object. Message for updating a ProvisioningConfig.

provisioning_config google.cloud.bare_metal_solution_v2.types.ProvisioningConfig

Required. The ProvisioningConfig to update. This corresponds to the provisioning_config field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

Required. The list of fields to update. This corresponds to the update_mask 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
Type Description
google.cloud.bare_metal_solution_v2.types.ProvisioningConfig A provisioning configuration.

update_volume

update_volume(
    request: typing.Optional[
        typing.Union[
            google.cloud.bare_metal_solution_v2.types.volume.UpdateVolumeRequest, dict
        ]
    ] = None,
    *,
    volume: typing.Optional[
        google.cloud.bare_metal_solution_v2.types.volume.Volume
    ] = None,
    update_mask: typing.Optional[google.protobuf.field_mask_pb2.FieldMask] = None,
    retry: typing.Optional[
        typing.Union[
            google.api_core.retry.retry_unary.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.api_core.operation.Operation

Update details of a single storage volume.

# 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 bare_metal_solution_v2

def sample_update_volume():
    # Create a client
    client = bare_metal_solution_v2.BareMetalSolutionClient()

    # Initialize request argument(s)
    request = bare_metal_solution_v2.UpdateVolumeRequest(
    )

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

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

    response = operation.result()

    # Handle the response
    print(response)
Parameters
Name Description
request Union[google.cloud.bare_metal_solution_v2.types.UpdateVolumeRequest, dict]

The request object. Message for updating a volume.

volume google.cloud.bare_metal_solution_v2.types.Volume

Required. The volume to update. The name field is used to identify the volume to update. Format: projects/{project}/locations/{location}/volumes/{volume} This corresponds to the volume field on the request instance; if request is provided, this should not be set.

update_mask google.protobuf.field_mask_pb2.FieldMask

The list of fields to update. The only currently supported fields are: 'labels' This corresponds to the update_mask 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
Type Description
google.api_core.operation.Operation An object representing a long-running operation. The result type for the operation will be Volume A storage volume.

volume_config_path

volume_config_path(project: str, location: str, volume_config: str) -> str

Returns a fully-qualified volume_config string.

volume_path

volume_path(project: str, location: str, volume: str) -> str

Returns a fully-qualified volume string.

volume_snapshot_path

volume_snapshot_path(
    project: str, location: str, volume: str, snapshot: str
) -> str

Returns a fully-qualified volume_snapshot string.