BigtableInstanceAdminClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.transports.base.BigtableInstanceAdminTransport, typing.Callable[[...], google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.transports.base.BigtableInstanceAdminTransport]]] = 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>)Service for creating, configuring, and deleting Cloud Bigtable Instances and Clusters. Provides access to the Instance and Cluster schemas only, not the tables' metadata or data stored in those tables.
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 |
BigtableInstanceAdminTransport |
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
BigtableInstanceAdminClient
BigtableInstanceAdminClient(*, credentials: typing.Optional[google.auth.credentials.Credentials] = None, transport: typing.Optional[typing.Union[str, google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.transports.base.BigtableInstanceAdminTransport, typing.Callable[[...], google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.transports.base.BigtableInstanceAdminTransport]]] = 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 bigtable instance admin 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,BigtableInstanceAdminTransport,Callable[..., BigtableInstanceAdminTransport]]]
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 BigtableInstanceAdminTransport 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 |
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 |
| 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.
app_profile_path
app_profile_path(project: str, instance: str, app_profile: str) -> strReturns a fully-qualified app_profile string.
cluster_path
cluster_path(project: str, instance: str, cluster: str) -> strReturns a fully-qualified cluster string.
common_billing_account_path
common_billing_account_path(billing_account: str) -> strReturns a fully-qualified billing_account string.
common_folder_path
common_folder_path(folder: str) -> strReturns a fully-qualified folder string.
common_location_path
common_location_path(project: str, location: str) -> strReturns a fully-qualified location string.
common_organization_path
common_organization_path(organization: str) -> strReturns a fully-qualified organization string.
common_project_path
common_project_path(project: str) -> strReturns a fully-qualified project string.
create_app_profile
create_app_profile(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.CreateAppProfileRequest,
dict,
]
] = None,
*,
parent: typing.Optional[str] = None,
app_profile_id: typing.Optional[str] = None,
app_profile: typing.Optional[
google.cloud.bigtable_admin_v2.types.instance.AppProfile
] = 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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.AppProfileCreates an app profile within an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.CreateAppProfileRequest, dict]
The request object. Request message for BigtableInstanceAdmin.CreateAppProfile. |
parent |
str
Required. The unique name of the instance in which to create the new app profile. Values are of the form |
app_profile_id |
str
Required. The ID to be used when referring to the new app profile within its instance, e.g., just |
app_profile |
google.cloud.bigtable_admin_v2.types.AppProfile
Required. The app profile to be created. Fields marked |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.AppProfile |
A configuration object describing how Cloud Bigtable should treat traffic from a particular end user application. |
create_cluster
create_cluster(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.CreateClusterRequest,
dict,
]
] = None,
*,
parent: typing.Optional[str] = None,
cluster_id: typing.Optional[str] = None,
cluster: typing.Optional[
google.cloud.bigtable_admin_v2.types.instance.Cluster
] = 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, typing.Union[str, bytes]]] = ()
) -> google.api_core.operation.OperationCreates a cluster within an instance.
Note that exactly one of Cluster.serve_nodes and Cluster.cluster_config.cluster_autoscaling_config can be set. If serve_nodes is set to non-zero, then the cluster is manually scaled. If cluster_config.cluster_autoscaling_config is non-empty, then autoscaling is enabled.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.CreateClusterRequest, dict]
The request object. Request message for BigtableInstanceAdmin.CreateCluster. |
parent |
str
Required. The unique name of the instance in which to create the new cluster. Values are of the form |
cluster_id |
str
Required. The ID to be used when referring to the new cluster within its instance, e.g., just |
cluster |
google.cloud.bigtable_admin_v2.types.Cluster
Required. The cluster to be created. Fields marked |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.api_core.operation.Operation |
An object representing a long-running operation. The result type for the operation will be Cluster A resizable group of nodes in a particular cloud location, capable of serving all Tables][google.bigtable.admin.v2.Table] in the parent Instance][google.bigtable.admin.v2.Instance]. |
create_instance
create_instance(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.CreateInstanceRequest,
dict,
]
] = None,
*,
parent: typing.Optional[str] = None,
instance_id: typing.Optional[str] = None,
instance: typing.Optional[
google.cloud.bigtable_admin_v2.types.instance.Instance
] = None,
clusters: typing.Optional[
typing.MutableMapping[
str, google.cloud.bigtable_admin_v2.types.instance.Cluster
]
] = 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, typing.Union[str, bytes]]] = ()
) -> google.api_core.operation.OperationCreate an instance within a project.
Note that exactly one of Cluster.serve_nodes and Cluster.cluster_config.cluster_autoscaling_config can be set. If serve_nodes is set to non-zero, then the cluster is manually scaled. If cluster_config.cluster_autoscaling_config is non-empty, then autoscaling is enabled.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.CreateInstanceRequest, dict]
The request object. Request message for BigtableInstanceAdmin.CreateInstance. |
parent |
str
Required. The unique name of the project in which to create the new instance. Values are of the form |
instance_id |
str
Required. The ID to be used when referring to the new instance within its project, e.g., just |
instance |
google.cloud.bigtable_admin_v2.types.Instance
Required. The instance to create. Fields marked |
clusters |
MutableMapping[str, google.cloud.bigtable_admin_v2.types.Cluster]
Required. The clusters to be created within the instance, mapped by desired cluster ID, e.g., just |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| 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 collection of Bigtable Tables][google.bigtable.admin.v2.Table] and the resources that serve them. All tables in an instance are served from all Clusters][google.bigtable.admin.v2.Cluster] in the instance. |
create_logical_view
create_logical_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.CreateLogicalViewRequest,
dict,
]
] = None,
*,
parent: typing.Optional[str] = None,
logical_view: typing.Optional[
google.cloud.bigtable_admin_v2.types.instance.LogicalView
] = None,
logical_view_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, typing.Union[str, bytes]]] = ()
) -> google.api_core.operation.OperationCreates a logical view within an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.CreateLogicalViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.CreateLogicalView. |
parent |
str
Required. The parent instance where this logical view will be created. Format: |
logical_view |
google.cloud.bigtable_admin_v2.types.LogicalView
Required. The logical view to create. This corresponds to the |
logical_view_id |
str
Required. The ID to use for the logical view, which will become the final component of the logical view's resource name. This corresponds to the |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.api_core.operation.Operation |
An object representing a long-running operation. The result type for the operation will be LogicalView A SQL logical view object that can be referenced in SQL queries. |
create_materialized_view
create_materialized_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.CreateMaterializedViewRequest,
dict,
]
] = None,
*,
parent: typing.Optional[str] = None,
materialized_view: typing.Optional[
google.cloud.bigtable_admin_v2.types.instance.MaterializedView
] = None,
materialized_view_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, typing.Union[str, bytes]]] = ()
) -> google.api_core.operation.OperationCreates a materialized view within an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.CreateMaterializedViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.CreateMaterializedView. |
parent |
str
Required. The parent instance where this materialized view will be created. Format: |
materialized_view |
google.cloud.bigtable_admin_v2.types.MaterializedView
Required. The materialized view to create. This corresponds to the |
materialized_view_id |
str
Required. The ID to use for the materialized view, which will become the final component of the materialized view's resource name. This corresponds to the |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.api_core.operation.Operation |
An object representing a long-running operation. The result type for the operation will be MaterializedView A materialized view object that can be referenced in SQL queries. |
crypto_key_path
crypto_key_path(project: str, location: str, key_ring: str, crypto_key: str) -> strReturns a fully-qualified crypto_key string.
delete_app_profile
delete_app_profile(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.DeleteAppProfileRequest,
dict,
]
] = None,
*,
name: typing.Optional[str] = None,
ignore_warnings: typing.Optional[bool] = 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, typing.Union[str, bytes]]] = ()
) -> NoneDeletes an app profile from an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.DeleteAppProfileRequest, dict]
The request object. Request message for BigtableInstanceAdmin.DeleteAppProfile. |
name |
str
Required. The unique name of the app profile to be deleted. Values are of the form |
ignore_warnings |
bool
Required. If true, ignore safety checks when deleting the app profile. This corresponds to the |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
delete_cluster
delete_cluster(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.DeleteClusterRequest,
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, typing.Union[str, bytes]]] = ()
) -> NoneDeletes a cluster from an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.DeleteClusterRequest, dict]
The request object. Request message for BigtableInstanceAdmin.DeleteCluster. |
name |
str
Required. The unique name of the cluster to be deleted. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
delete_instance
delete_instance(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.DeleteInstanceRequest,
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, typing.Union[str, bytes]]] = ()
) -> NoneDelete an instance from a project.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.DeleteInstanceRequest, dict]
The request object. Request message for BigtableInstanceAdmin.DeleteInstance. |
name |
str
Required. The unique name of the instance to be deleted. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
delete_logical_view
delete_logical_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.DeleteLogicalViewRequest,
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, typing.Union[str, bytes]]] = ()
) -> NoneDeletes a logical view from an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.DeleteLogicalViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.DeleteLogicalView. |
name |
str
Required. The unique name of the logical view to be deleted. Format: |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
delete_materialized_view
delete_materialized_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.DeleteMaterializedViewRequest,
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, typing.Union[str, bytes]]] = ()
) -> NoneDeletes a materialized view from an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.DeleteMaterializedViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.DeleteMaterializedView. |
name |
str
Required. The unique name of the materialized view to be deleted. Format: |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
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 |
BigtableInstanceAdminClient |
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 |
BigtableInstanceAdminClient |
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 |
BigtableInstanceAdminClient |
The constructed client. |
get_app_profile
get_app_profile(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.GetAppProfileRequest,
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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.AppProfileGets information about an app profile.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.GetAppProfileRequest, dict]
The request object. Request message for BigtableInstanceAdmin.GetAppProfile. |
name |
str
Required. The unique name of the requested app profile. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.AppProfile |
A configuration object describing how Cloud Bigtable should treat traffic from a particular end user application. |
get_cluster
get_cluster(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.GetClusterRequest,
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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.ClusterGets information about a cluster.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.GetClusterRequest, dict]
The request object. Request message for BigtableInstanceAdmin.GetCluster. |
name |
str
Required. The unique name of the requested cluster. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.Cluster |
A resizable group of nodes in a particular cloud location, capable of serving all Tables][google.bigtable.admin.v2.Table] in the parent Instance][google.bigtable.admin.v2.Instance]. |
get_iam_policy
get_iam_policy(
request: typing.Optional[
typing.Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]
] = None,
*,
resource: 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, typing.Union[str, bytes]]] = ()
) -> google.iam.v1.policy_pb2.PolicyGets the access control policy for an instance resource. Returns an empty policy if an instance exists but does not have a policy set.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]
The request object. Request message for |
resource |
str
REQUIRED: The resource for which the policy is being requested. See the operation documentation for the appropriate value for this field. This corresponds to the |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.iam.v1.policy_pb2.Policy |
An Identity and Access Management (IAM) policy, which specifies access controls for Google Cloud resources. A Policy is a collection of bindings. A binding binds one or more members, or principals, to a single role. Principals can be user accounts, service accounts, Google groups, and domains (such as G Suite). A role is a named list of permissions; each role can be an IAM predefined role or a user-created custom role. For some types of Google Cloud resources, a binding can also specify a condition, which is a logical expression that allows access to a resource only if the expression evaluates to true. A condition can add constraints based on attributes of the request, the resource, or both. To learn which resources support conditions in their IAM policies, see the [IAM documentation](\ https://cloud.google.com/iam/help/conditions/resource-policies). **JSON example:** :literal:\ { "bindings": [ { "role": "roles/resourcemanager.organizationAdmin", "members": [ "user:mike@example.com", "group:admins@example.com", "domain:google.com", "serviceAccount:my-project-id@appspot.gserviceaccount.com" ] }, { "role": "roles/resourcemanager.organizationViewer", "members": [ "user:eve@example.com" ], "condition": { "title": "expirable access", "description": "Does not grant access after Sep 2020", "expression": "request.time < timestamp('2020-10-01t00:00:00.000z')",="" }="" }="" ],="" "etag":="" "bwwwja0yfja=", " version":="" 3="">\ \ **YAML example:** :literal:\ bindings: - members: - user:mike@example.com - group:admins@example.com - domain:google.com - serviceAccount:my-project-id@appspot.gserviceaccount.com role: roles/resourcemanager.organizationAdmin - members: - user:eve@example.com role: roles/resourcemanager.organizationViewer condition: title: expirable access description: Does not grant access after Sep 2020 expression: request.time < timestamp('2020-10-01t00:00:00.000z')="" etag:="" bwwwja0yfja="version:">\ \ For a description of IAM and its features, see the [IAM documentation](\ https://cloud.google.com/iam/docs/). |
get_instance
get_instance(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.InstanceGets information about an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.GetInstanceRequest, dict]
The request object. Request message for BigtableInstanceAdmin.GetInstance. |
name |
str
Required. The unique name of the requested instance. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.Instance |
A collection of Bigtable Tables][google.bigtable.admin.v2.Table] and the resources that serve them. All tables in an instance are served from all Clusters][google.bigtable.admin.v2.Cluster] in the instance. |
get_logical_view
get_logical_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.GetLogicalViewRequest,
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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.LogicalViewGets information about a logical view.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.GetLogicalViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.GetLogicalView. |
name |
str
Required. The unique name of the requested logical view. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.LogicalView |
A SQL logical view object that can be referenced in SQL queries. |
get_materialized_view
get_materialized_view(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.GetMaterializedViewRequest,
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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.instance.MaterializedViewGets information about a materialized view.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.GetMaterializedViewRequest, dict]
The request object. Request message for BigtableInstanceAdmin.GetMaterializedView. |
name |
str
Required. The unique name of the requested materialized view. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.MaterializedView |
A materialized view object that can be referenced in SQL queries. |
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 |
| 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. |
hot_tablet_path
hot_tablet_path(project: str, instance: str, cluster: str, hot_tablet: str) -> strReturns a fully-qualified hot_tablet string.
instance_path
instance_path(project: str, instance: str) -> strReturns a fully-qualified instance string.
list_app_profiles
list_app_profiles(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListAppProfilesRequest,
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, typing.Union[str, bytes]]] = ()
) -> (
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListAppProfilesPager
)Lists information about app profiles in an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListAppProfilesRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListAppProfiles. |
parent |
str
Required. The unique name of the instance for which a list of app profiles is requested. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListAppProfilesPager |
Response message for BigtableInstanceAdmin.ListAppProfiles. Iterating over this object will yield results and resolve additional pages automatically. |
list_clusters
list_clusters(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListClustersRequest,
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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListClustersResponseLists information about clusters in an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListClustersRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListClusters. |
parent |
str
Required. The unique name of the instance for which a list of clusters is requested. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.ListClustersResponse |
Response message for BigtableInstanceAdmin.ListClusters. |
list_hot_tablets
list_hot_tablets(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListHotTabletsRequest,
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, typing.Union[str, bytes]]] = ()
) -> (
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListHotTabletsPager
)Lists hot tablets in a cluster, within the time range provided. Hot tablets are ordered based on CPU usage.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListHotTabletsRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListHotTablets. |
parent |
str
Required. The cluster name to list hot tablets. Value is in the following form: |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListHotTabletsPager |
Response message for BigtableInstanceAdmin.ListHotTablets. Iterating over this object will yield results and resolve additional pages automatically. |
list_instances
list_instances(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.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, typing.Union[str, bytes]]] = ()
) -> google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListInstancesResponseLists information about instances in a project.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListInstancesRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListInstances. |
parent |
str
Required. The unique name of the project for which a list of instances is requested. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.types.ListInstancesResponse |
Response message for BigtableInstanceAdmin.ListInstances. |
list_logical_views
list_logical_views(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListLogicalViewsRequest,
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, typing.Union[str, bytes]]] = ()
) -> (
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListLogicalViewsPager
)Lists information about logical views in an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListLogicalViewsRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListLogicalViews. |
parent |
str
Required. The unique name of the instance for which the list of logical views is requested. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListLogicalViewsPager |
Response message for BigtableInstanceAdmin.ListLogicalViews. Iterating over this object will yield results and resolve additional pages automatically. |
list_materialized_views
list_materialized_views(
request: typing.Optional[
typing.Union[
google.cloud.bigtable_admin_v2.types.bigtable_instance_admin.ListMaterializedViewsRequest,
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, typing.Union[str, bytes]]] = ()
) -> (
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListMaterializedViewsPager
)Lists information about materialized views in an instance.
| Parameters | |
|---|---|
| Name | Description |
request |
Union[google.cloud.bigtable_admin_v2.types.ListMaterializedViewsRequest, dict]
The request object. Request message for BigtableInstanceAdmin.ListMaterializedViews. |
parent |
str
Required. The unique name of the instance for which the list of materialized views is requested. Values are of the form |
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, Union[str, bytes]]]
Key/value pairs which should be sent along with the request as metadata. Normally, each value must be of type |
| Returns | |
|---|---|
| Type | Description |
google.cloud.bigtable_admin_v2.services.bigtable_instance_admin.pagers.ListMaterializedViewsPager |
Response message for BigtableInstanceAdmin.ListMaterializedViews. Iterating over this object will yield results and resolve additional pages automatically. |
logical_view_path
logical_view_path(project: str, instance: str, logical_view: str) -> strReturns a fully-qualified logical_view string.
materialized_view_path
materialized_view_path(project: str, instance: str, materialized_view: str) -> strReturns a fully-qualified materialized_view string.
parse_app_profile_path
parse_app_profile_path(path: str) -> typing.Dict[str, str]Parses a app_profile path into its component segments.
parse_cluster_path
parse_cluster_path(path: str) -> typing.Dict[str, str]Parses a cluster path into its component segments.