Package Classes (0.3.11)

Summary of entries of Classes for alloydb.

Classes

AlloyDBAdminAsyncClient

Service describing handlers for resources

AlloyDBAdminClient

Service describing handlers for resources

ListBackupsAsyncPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __aiter__ method to iterate through its backups field.

If there are more pages, the __aiter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListBackupsPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __iter__ method to iterate through its backups field.

If there are more pages, the __iter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersAsyncPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __aiter__ method to iterate through its clusters field.

If there are more pages, the __aiter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __iter__ method to iterate through its clusters field.

If there are more pages, the __iter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesAsyncPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __aiter__ method to iterate through its instances field.

If there are more pages, the __aiter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __iter__ method to iterate through its instances field.

If there are more pages, the __iter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsAsyncPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __aiter__ method to iterate through its supported_database_flags field.

If there are more pages, the __aiter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __iter__ method to iterate through its supported_database_flags field.

If there are more pages, the __iter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersAsyncPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __aiter__ method to iterate through its users field.

If there are more pages, the __aiter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __iter__ method to iterate through its users field.

If there are more pages, the __iter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AutomatedBackupPolicy

Message describing the user-specified automated backup policy. All fields in the automated backup policy are optional. Defaults for each field are provided if they are not set.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

QuantityBasedRetention

A quantity based policy specifies that a certain number of the most recent successful backups should be retained.

TimeBasedRetention

A time based retention policy specifies that all backups within a certain time period should be retained.

WeeklySchedule

A weekly schedule starts a backup at prescribed start times within a day, for the specified days of the week.

The weekly schedule message is flexible and can be used to create many types of schedules. For example, to have a daily backup that starts at 22:00, configure the start_times field to have one element "22:00" and the days_of_week field to have all seven days of the week.

Backup

Message describing Backup object

AnnotationsEntry

The abstract base class for a message.

LabelsEntry

The abstract base class for a message.

QuantityBasedExpiry

A backup's position in a quantity-based retention queue, of backups with the same source cluster and type, with length, retention, specified by the backup's retention policy. Once the position is greater than the retention, the backup is eligible to be garbage collected.

Example: 5 backups from the same source cluster and type with a quantity-based retention of 3 and denoted by backup_id (position, retention).

Safe: backup_5 (1, 3), backup_4, (2, 3), backup_3 (3, 3). Awaiting garbage collection: backup_2 (4, 3), backup_1 (5, 3)

State

Backup State

Type

Backup Type

BackupSource

Message describing a BackupSource.

BatchCreateInstanceStatus

Message for current status of an instance in the BatchCreateInstances operation. For example, lets say a BatchCreateInstances workflow has 4 instances, Instance1 through Instance4. Lets also assume that 2 instances succeeded but the third failed to create and the 4th was never picked up for creation because of failure of the previous one. Then, resulting states would look something like:

  1. Instance1 = ROLLED_BACK
  2. Instance2 = ROLLED_BACK
  3. Instance3 = FAILED
  4. Instance4 = FAILED

However, while the operation is running, the instance might be in other states including PENDING_CREATE, ACTIVE, DELETING and CREATING. The states / do not get further updated once the operation is done.

State

State contains all valid instance states for the BatchCreateInstances operation. This is mainly used for status reporting through the LRO metadata.

BatchCreateInstancesMetadata

Message for metadata that is specific to BatchCreateInstances API. NEXT_ID: 3

InstanceStatusesEntry

The abstract base class for a message.

BatchCreateInstancesRequest

Message for creating a batch of instances under the specified cluster.

BatchCreateInstancesResponse

Message for creating batches of instances in a cluster.

Cluster

A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AnnotationsEntry

The abstract base class for a message.

ClusterType

Type of Cluster

LabelsEntry

The abstract base class for a message.

NetworkConfig

Metadata related to network configuration.

PrimaryConfig

Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY.

SecondaryConfig

Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.

State

Cluster State

ClusterView

View on Cluster. Pass this enum to rpcs that returns a cluster message to control which subsets of fields to get.

ConnectionInfo

ConnectionInfo singleton resource. https://google.aip.dev/156

ContinuousBackupConfig

ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ContinuousBackupInfo

ContinuousBackupInfo describes the continuous backup properties of a cluster.

ContinuousBackupSource

Message describing a ContinuousBackupSource.

CreateBackupRequest

Message for creating a Backup

CreateClusterRequest

Message for creating a Cluster

CreateInstanceRequest

Message for creating a Instance

CreateInstanceRequests

See usage below for notes.

CreateSecondaryClusterRequest

CreateSecondaryInstanceRequest

Message for creating a Secondary Instance

CreateUserRequest

Message for creating a User

DatabaseVersion

The supported database engine versions.

DeleteBackupRequest

Message for deleting a Backup

DeleteClusterRequest

Message for deleting a Cluster

DeleteInstanceRequest

Message for deleting a Instance

DeleteUserRequest

Message for deleting a User

EncryptionConfig

EncryptionConfig describes the encryption config of a cluster or a backup that is encrypted with a CMEK (customer-managed encryption key).

EncryptionInfo

EncryptionInfo describes the encryption information of a cluster or a backup.

Type

Possible encryption types.

FailoverInstanceRequest

Message for triggering failover on an Instance

GenerateClientCertificateRequest

Message for requests to generate a client certificate signed by the Cluster CA.

GenerateClientCertificateResponse

Message returned by a GenerateClientCertificate operation.

GetBackupRequest

Message for getting a Backup

GetClusterRequest

Message for getting a Cluster

GetConnectionInfoRequest

Request message for GetConnectionInfo.

GetInstanceRequest

Message for getting a Instance

GetUserRequest

Message for getting a User

InjectFaultRequest

Message for triggering fault injection on an instance

FaultType

FaultType contains all valid types of faults that can be injected to an instance.

Instance

An Instance is a computing unit that an end customer can connect to. It's the main unit of computing resources in AlloyDB.

AnnotationsEntry

The abstract base class for a message.

AvailabilityType

The Availability type of an instance. Potential values:

  • ZONAL: The instance serves data from only one zone. Outages in that zone affect instance availability.
  • REGIONAL: The instance can serve data from more than one zone in a region (it is highly available).

ClientConnectionConfig

Client connection configuration

DatabaseFlagsEntry

The abstract base class for a message.

InstanceType

Type of an Instance

    -  Read pool of size 1 can only have zonal availability.
    -  Read pools with node count of 2 or more can have regional
       availability (nodes are present in 2 or more zones in a
       region).
SECONDARY (3):
    SECONDARY instances support read operations
    only. SECONDARY instance is a cross-region read
    replica

LabelsEntry

The abstract base class for a message.

MachineConfig

MachineConfig describes the configuration of a machine.

Node

Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.

QueryInsightsInstanceConfig

QueryInsights Instance specific configuration.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ReadPoolConfig

Configuration for a read pool instance.

State

Instance State

InstanceView

View on Instance. Pass this enum to rpcs that returns an Instance message to control which subsets of fields to get.

ListBackupsRequest

Message for requesting list of Backups

ListBackupsResponse

Message for response to listing Backups

ListClustersRequest

Message for requesting list of Clusters

ListClustersResponse

Message for response to listing Clusters

ListInstancesRequest

Message for requesting list of Instances

ListInstancesResponse

Message for response to listing Instances

ListSupportedDatabaseFlagsRequest

Message for listing the information about the supported Database flags.

ListSupportedDatabaseFlagsResponse

Message for response to listing SupportedDatabaseFlags.

ListUsersRequest

Message for requesting list of Users

ListUsersResponse

Message for response to listing Users

MigrationSource

Subset of the source instance configuration that is available when reading the cluster resource.

MigrationSourceType

Denote the type of migration source that created this cluster.

OperationMetadata

Represents the metadata of the long-running operation.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PromoteClusterRequest

Message for promoting a Cluster

RestartInstanceRequest

RestoreClusterRequest

Message for restoring a Cluster from a backup or another cluster at a given point in time.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SslConfig

SSL configuration.

CaSource

Certificate Authority (CA) source for SSL/TLS certificates.

SslMode

SSL mode options.

SupportedDatabaseFlag

SupportedDatabaseFlag gives general information about a database flag, like type and allowed values. This is a static value that is defined on the server side, and it cannot be modified by callers. To set the Database flags on a particular Instance, a caller should modify the Instance.database_flags field.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

IntegerRestrictions

Restrictions on INTEGER type values.

StringRestrictions

Restrictions on STRING type values

ValueType

ValueType describes the semantic type of the value that the flag accepts. Regardless of the ValueType, the Instance.database_flags field accepts the stringified version of the value, i.e. "20" or "3.14".

UpdateBackupRequest

Message for updating a Backup

UpdateClusterRequest

Message for updating a Cluster

UpdateInstanceRequest

Message for updating a Instance

UpdateUserRequest

Message for updating a User

User

Message describing User object.

UserType

Enum that details the user type.

UserPassword

The username/password for a database user. Used for specifying initial users at cluster creation time.

AlloyDBAdminAsyncClient

Service describing handlers for resources

AlloyDBAdminClient

Service describing handlers for resources

ListBackupsAsyncPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __aiter__ method to iterate through its backups field.

If there are more pages, the __aiter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListBackupsPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __iter__ method to iterate through its backups field.

If there are more pages, the __iter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersAsyncPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __aiter__ method to iterate through its clusters field.

If there are more pages, the __aiter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __iter__ method to iterate through its clusters field.

If there are more pages, the __iter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDatabasesAsyncPager

A pager for iterating through list_databases requests.

This class thinly wraps an initial ListDatabasesResponse object, and provides an __aiter__ method to iterate through its databases field.

If there are more pages, the __aiter__ method will make additional ListDatabases requests and continue to iterate through the databases field on the corresponding responses.

All the usual ListDatabasesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDatabasesPager

A pager for iterating through list_databases requests.

This class thinly wraps an initial ListDatabasesResponse object, and provides an __iter__ method to iterate through its databases field.

If there are more pages, the __iter__ method will make additional ListDatabases requests and continue to iterate through the databases field on the corresponding responses.

All the usual ListDatabasesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesAsyncPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __aiter__ method to iterate through its instances field.

If there are more pages, the __aiter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __iter__ method to iterate through its instances field.

If there are more pages, the __iter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsAsyncPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __aiter__ method to iterate through its supported_database_flags field.

If there are more pages, the __aiter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __iter__ method to iterate through its supported_database_flags field.

If there are more pages, the __iter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersAsyncPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __aiter__ method to iterate through its users field.

If there are more pages, the __aiter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __iter__ method to iterate through its users field.

If there are more pages, the __iter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AutomatedBackupPolicy

Message describing the user-specified automated backup policy. All fields in the automated backup policy are optional. Defaults for each field are provided if they are not set.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

QuantityBasedRetention

A quantity based policy specifies that a certain number of the most recent successful backups should be retained.

TimeBasedRetention

A time based retention policy specifies that all backups within a certain time period should be retained.

WeeklySchedule

A weekly schedule starts a backup at prescribed start times within a day, for the specified days of the week.

The weekly schedule message is flexible and can be used to create many types of schedules. For example, to have a daily backup that starts at 22:00, configure the start_times field to have one element "22:00" and the days_of_week field to have all seven days of the week.

Backup

Message describing Backup object

AnnotationsEntry

The abstract base class for a message.

LabelsEntry

The abstract base class for a message.

QuantityBasedExpiry

A backup's position in a quantity-based retention queue, of backups with the same source cluster and type, with length, retention, specified by the backup's retention policy. Once the position is greater than the retention, the backup is eligible to be garbage collected.

Example: 5 backups from the same source cluster and type with a quantity-based retention of 3 and denoted by backup_id (position, retention).

Safe: backup_5 (1, 3), backup_4, (2, 3), backup_3 (3, 3). Awaiting garbage collection: backup_2 (4, 3), backup_1 (5, 3)

State

Backup State

Type

Backup Type

BackupSource

Message describing a BackupSource.

BatchCreateInstanceStatus

Message for current status of an instance in the BatchCreateInstances operation. For example, lets say a BatchCreateInstances workflow has 4 instances, Instance1 through Instance4. Lets also assume that 2 instances succeeded but the third failed to create and the 4th was never picked up for creation because of failure of the previous one. Then, resulting states would look something like:

  1. Instance1 = ROLLED_BACK
  2. Instance2 = ROLLED_BACK
  3. Instance3 = FAILED
  4. Instance4 = FAILED

However, while the operation is running, the instance might be in other states including PENDING_CREATE, ACTIVE, DELETING and CREATING. The states / do not get further updated once the operation is done.

State

State contains all valid instance states for the BatchCreateInstances operation. This is mainly used for status reporting through the LRO metadata.

BatchCreateInstancesMetadata

Message for metadata that is specific to BatchCreateInstances API. NEXT_ID: 3

InstanceStatusesEntry

The abstract base class for a message.

BatchCreateInstancesRequest

Message for creating a batch of instances under the specified cluster.

BatchCreateInstancesResponse

Message for creating batches of instances in a cluster.

Cluster

A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AnnotationsEntry

The abstract base class for a message.

ClusterType

Type of Cluster

LabelsEntry

The abstract base class for a message.

NetworkConfig

Metadata related to network configuration.

PrimaryConfig

Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY.

PscConfig

PscConfig contains PSC related configuration at a cluster level.

SecondaryConfig

Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.

State

Cluster State

ClusterView

View on Cluster. Pass this enum to rpcs that returns a cluster message to control which subsets of fields to get.

ConnectionInfo

ConnectionInfo singleton resource. https://google.aip.dev/156

ContinuousBackupConfig

ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ContinuousBackupInfo

ContinuousBackupInfo describes the continuous backup properties of a cluster.

ContinuousBackupSource

Message describing a ContinuousBackupSource.

CreateBackupRequest

Message for creating a Backup

CreateClusterRequest

Message for creating a Cluster

CreateInstanceRequest

Message for creating a Instance

CreateInstanceRequests

See usage below for notes.

CreateSecondaryClusterRequest

CreateSecondaryInstanceRequest

Message for creating a Secondary Instance

CreateUserRequest

Message for creating a User

Database

Message describing Database object.

DatabaseVersion

The supported database engine versions.

DeleteBackupRequest

Message for deleting a Backup

DeleteClusterRequest

Message for deleting a Cluster

DeleteInstanceRequest

Message for deleting a Instance

DeleteUserRequest

Message for deleting a User

EncryptionConfig

EncryptionConfig describes the encryption config of a cluster or a backup that is encrypted with a CMEK (customer-managed encryption key).

EncryptionInfo

EncryptionInfo describes the encryption information of a cluster or a backup.

Type

Possible encryption types.

FailoverInstanceRequest

Message for triggering failover on an Instance

GenerateClientCertificateRequest

Message for requests to generate a client certificate signed by the Cluster CA.

GenerateClientCertificateResponse

Message returned by a GenerateClientCertificate operation.

GetBackupRequest

Message for getting a Backup

GetClusterRequest

Message for getting a Cluster

GetConnectionInfoRequest

Request message for GetConnectionInfo.

GetInstanceRequest

Message for getting a Instance

GetUserRequest

Message for getting a User

InjectFaultRequest

Message for triggering fault injection on an instance

FaultType

FaultType contains all valid types of faults that can be injected to an instance.

Instance

An Instance is a computing unit that an end customer can connect to. It's the main unit of computing resources in AlloyDB.

AnnotationsEntry

The abstract base class for a message.

AvailabilityType

The Availability type of an instance. Potential values:

  • ZONAL: The instance serves data from only one zone. Outages in that zone affect instance availability.
  • REGIONAL: The instance can serve data from more than one zone in a region (it is highly available).

ClientConnectionConfig

Client connection configuration

DatabaseFlagsEntry

The abstract base class for a message.

InstanceNetworkConfig

Metadata related to instance level network configuration.

AuthorizedNetwork

AuthorizedNetwork contains metadata for an authorized network.

InstanceType

Type of an Instance

    -  Read pool of size 1 can only have zonal availability.
    -  Read pools with node count of 2 or more can have regional
       availability (nodes are present in 2 or more zones in a
       region).
SECONDARY (3):
    SECONDARY instances support read operations
    only. SECONDARY instance is a cross-region read
    replica

LabelsEntry

The abstract base class for a message.

MachineConfig

MachineConfig describes the configuration of a machine.

Node

Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.

PscInstanceConfig

PscInstanceConfig contains PSC related configuration at an instance level.

PscInterfaceConfig

Configuration for setting up a PSC interface. This information needs to be provided by the customer. PSC interfaces will be created and added to VMs via SLM (adding a network interface will require recreating the VM). For HA instances this will be done via LDTM.

QueryInsightsInstanceConfig

QueryInsights Instance specific configuration.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ReadPoolConfig

Configuration for a read pool instance.

State

Instance State

UpdatePolicy

Policy to be used while updating the instance.

Mode

Specifies the available modes of update.

InstanceView

View on Instance. Pass this enum to rpcs that returns an Instance message to control which subsets of fields to get.

ListBackupsRequest

Message for requesting list of Backups

ListBackupsResponse

Message for response to listing Backups

ListClustersRequest

Message for requesting list of Clusters

ListClustersResponse

Message for response to listing Clusters

ListDatabasesRequest

Message for requesting list of Databases.

ListDatabasesResponse

Message for response to listing Databases.

ListInstancesRequest

Message for requesting list of Instances

ListInstancesResponse

Message for response to listing Instances

ListSupportedDatabaseFlagsRequest

Message for listing the information about the supported Database flags.

ListSupportedDatabaseFlagsResponse

Message for response to listing SupportedDatabaseFlags.

ListUsersRequest

Message for requesting list of Users

ListUsersResponse

Message for response to listing Users

MigrationSource

Subset of the source instance configuration that is available when reading the cluster resource.

MigrationSourceType

Denote the type of migration source that created this cluster.

OperationMetadata

Represents the metadata of the long-running operation.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PromoteClusterRequest

Message for promoting a Cluster

RestartInstanceRequest

RestoreClusterRequest

Message for restoring a Cluster from a backup or another cluster at a given point in time.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SslConfig

SSL configuration.

CaSource

Certificate Authority (CA) source for SSL/TLS certificates.

SslMode

SSL mode options.

SupportedDatabaseFlag

SupportedDatabaseFlag gives general information about a database flag, like type and allowed values. This is a static value that is defined on the server side, and it cannot be modified by callers. To set the Database flags on a particular Instance, a caller should modify the Instance.database_flags field.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

IntegerRestrictions

Restrictions on INTEGER type values.

StringRestrictions

Restrictions on STRING type values

ValueType

ValueType describes the semantic type of the value that the flag accepts. Regardless of the ValueType, the Instance.database_flags field accepts the stringified version of the value, i.e. "20" or "3.14".

UpdateBackupRequest

Message for updating a Backup

UpdateClusterRequest

Message for updating a Cluster

UpdateInstanceRequest

Message for updating a Instance

UpdateUserRequest

Message for updating a User

User

Message describing User object.

UserType

Enum that details the user type.

UserPassword

The username/password for a database user. Used for specifying initial users at cluster creation time.

AlloyDBAdminAsyncClient

Service describing handlers for resources

AlloyDBAdminClient

Service describing handlers for resources

ListBackupsAsyncPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __aiter__ method to iterate through its backups field.

If there are more pages, the __aiter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListBackupsPager

A pager for iterating through list_backups requests.

This class thinly wraps an initial ListBackupsResponse object, and provides an __iter__ method to iterate through its backups field.

If there are more pages, the __iter__ method will make additional ListBackups requests and continue to iterate through the backups field on the corresponding responses.

All the usual ListBackupsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersAsyncPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __aiter__ method to iterate through its clusters field.

If there are more pages, the __aiter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListClustersPager

A pager for iterating through list_clusters requests.

This class thinly wraps an initial ListClustersResponse object, and provides an __iter__ method to iterate through its clusters field.

If there are more pages, the __iter__ method will make additional ListClusters requests and continue to iterate through the clusters field on the corresponding responses.

All the usual ListClustersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDatabasesAsyncPager

A pager for iterating through list_databases requests.

This class thinly wraps an initial ListDatabasesResponse object, and provides an __aiter__ method to iterate through its databases field.

If there are more pages, the __aiter__ method will make additional ListDatabases requests and continue to iterate through the databases field on the corresponding responses.

All the usual ListDatabasesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListDatabasesPager

A pager for iterating through list_databases requests.

This class thinly wraps an initial ListDatabasesResponse object, and provides an __iter__ method to iterate through its databases field.

If there are more pages, the __iter__ method will make additional ListDatabases requests and continue to iterate through the databases field on the corresponding responses.

All the usual ListDatabasesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesAsyncPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __aiter__ method to iterate through its instances field.

If there are more pages, the __aiter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListInstancesPager

A pager for iterating through list_instances requests.

This class thinly wraps an initial ListInstancesResponse object, and provides an __iter__ method to iterate through its instances field.

If there are more pages, the __iter__ method will make additional ListInstances requests and continue to iterate through the instances field on the corresponding responses.

All the usual ListInstancesResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsAsyncPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __aiter__ method to iterate through its supported_database_flags field.

If there are more pages, the __aiter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListSupportedDatabaseFlagsPager

A pager for iterating through list_supported_database_flags requests.

This class thinly wraps an initial ListSupportedDatabaseFlagsResponse object, and provides an __iter__ method to iterate through its supported_database_flags field.

If there are more pages, the __iter__ method will make additional ListSupportedDatabaseFlags requests and continue to iterate through the supported_database_flags field on the corresponding responses.

All the usual ListSupportedDatabaseFlagsResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersAsyncPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __aiter__ method to iterate through its users field.

If there are more pages, the __aiter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

ListUsersPager

A pager for iterating through list_users requests.

This class thinly wraps an initial ListUsersResponse object, and provides an __iter__ method to iterate through its users field.

If there are more pages, the __iter__ method will make additional ListUsers requests and continue to iterate through the users field on the corresponding responses.

All the usual ListUsersResponse attributes are available on the pager. If multiple requests are made, only the most recent response is retained, and thus used for attribute lookup.

AutomatedBackupPolicy

Message describing the user-specified automated backup policy. All fields in the automated backup policy are optional. Defaults for each field are provided if they are not set.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

LabelsEntry

The abstract base class for a message.

QuantityBasedRetention

A quantity based policy specifies that a certain number of the most recent successful backups should be retained.

TimeBasedRetention

A time based retention policy specifies that all backups within a certain time period should be retained.

WeeklySchedule

A weekly schedule starts a backup at prescribed start times within a day, for the specified days of the week.

The weekly schedule message is flexible and can be used to create many types of schedules. For example, to have a daily backup that starts at 22:00, configure the start_times field to have one element "22:00" and the days_of_week field to have all seven days of the week.

Backup

Message describing Backup object

AnnotationsEntry

The abstract base class for a message.

LabelsEntry

The abstract base class for a message.

QuantityBasedExpiry

A backup's position in a quantity-based retention queue, of backups with the same source cluster and type, with length, retention, specified by the backup's retention policy. Once the position is greater than the retention, the backup is eligible to be garbage collected.

Example: 5 backups from the same source cluster and type with a quantity-based retention of 3 and denoted by backup_id (position, retention).

Safe: backup_5 (1, 3), backup_4, (2, 3), backup_3 (3, 3). Awaiting garbage collection: backup_2 (4, 3), backup_1 (5, 3)

State

Backup State

Type

Backup Type

BackupSource

Message describing a BackupSource.

BatchCreateInstanceStatus

Message for current status of an instance in the BatchCreateInstances operation. For example, lets say a BatchCreateInstances workflow has 4 instances, Instance1 through Instance4. Lets also assume that 2 instances succeeded but the third failed to create and the 4th was never picked up for creation because of failure of the previous one. Then, resulting states would look something like:

  1. Instance1 = ROLLED_BACK
  2. Instance2 = ROLLED_BACK
  3. Instance3 = FAILED
  4. Instance4 = FAILED

However, while the operation is running, the instance might be in other states including PENDING_CREATE, ACTIVE, DELETING and CREATING. The states / do not get further updated once the operation is done.

State

State contains all valid instance states for the BatchCreateInstances operation. This is mainly used for status reporting through the LRO metadata.

BatchCreateInstancesMetadata

Message for metadata that is specific to BatchCreateInstances API. NEXT_ID: 3

InstanceStatusesEntry

The abstract base class for a message.

BatchCreateInstancesRequest

Message for creating a batch of instances under the specified cluster.

BatchCreateInstancesResponse

Message for creating batches of instances in a cluster.

Cluster

A cluster is a collection of regional AlloyDB resources. It can include a primary instance and one or more read pool instances. All cluster resources share a storage layer, which scales as needed.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

AnnotationsEntry

The abstract base class for a message.

ClusterType

Type of Cluster

LabelsEntry

The abstract base class for a message.

NetworkConfig

Metadata related to network configuration.

PrimaryConfig

Configuration for the primary cluster. It has the list of clusters that are replicating from this cluster. This should be set if and only if the cluster is of type PRIMARY.

SecondaryConfig

Configuration information for the secondary cluster. This should be set if and only if the cluster is of type SECONDARY.

State

Cluster State

ClusterView

View on Cluster. Pass this enum to rpcs that returns a cluster message to control which subsets of fields to get.

ConnectionInfo

ConnectionInfo singleton resource. https://google.aip.dev/156

ContinuousBackupConfig

ContinuousBackupConfig describes the continuous backups recovery configurations of a cluster.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ContinuousBackupInfo

ContinuousBackupInfo describes the continuous backup properties of a cluster.

ContinuousBackupSource

Message describing a ContinuousBackupSource.

CreateBackupRequest

Message for creating a Backup

CreateClusterRequest

Message for creating a Cluster

CreateInstanceRequest

Message for creating a Instance

CreateInstanceRequests

See usage below for notes.

CreateSecondaryClusterRequest

CreateSecondaryInstanceRequest

Message for creating a Secondary Instance

CreateUserRequest

Message for creating a User

Database

Message describing Database object.

DatabaseVersion

The supported database engine versions.

DeleteBackupRequest

Message for deleting a Backup

DeleteClusterRequest

Message for deleting a Cluster

DeleteInstanceRequest

Message for deleting a Instance

DeleteUserRequest

Message for deleting a User

EncryptionConfig

EncryptionConfig describes the encryption config of a cluster or a backup that is encrypted with a CMEK (customer-managed encryption key).

EncryptionInfo

EncryptionInfo describes the encryption information of a cluster or a backup.

Type

Possible encryption types.

FailoverInstanceRequest

Message for triggering failover on an Instance

GenerateClientCertificateRequest

Message for requests to generate a client certificate signed by the Cluster CA.

GenerateClientCertificateResponse

Message returned by a GenerateClientCertificate operation.

GetBackupRequest

Message for getting a Backup

GetClusterRequest

Message for getting a Cluster

GetConnectionInfoRequest

Request message for GetConnectionInfo.

GetInstanceRequest

Message for getting a Instance

GetUserRequest

Message for getting a User

InjectFaultRequest

Message for triggering fault injection on an instance

FaultType

FaultType contains all valid types of faults that can be injected to an instance.

Instance

An Instance is a computing unit that an end customer can connect to. It's the main unit of computing resources in AlloyDB.

AnnotationsEntry

The abstract base class for a message.

AvailabilityType

The Availability type of an instance. Potential values:

  • ZONAL: The instance serves data from only one zone. Outages in that zone affect instance availability.
  • REGIONAL: The instance can serve data from more than one zone in a region (it is highly available).

ClientConnectionConfig

Client connection configuration

DatabaseFlagsEntry

The abstract base class for a message.

InstanceNetworkConfig

Metadata related to instance level network configuration.

AuthorizedNetwork

AuthorizedNetwork contains metadata for an authorized network.

InstanceType

Type of an Instance

    -  Read pool of size 1 can only have zonal availability.
    -  Read pools with node count of 2 or more can have regional
       availability (nodes are present in 2 or more zones in a
       region).
SECONDARY (3):
    SECONDARY instances support read operations
    only. SECONDARY instance is a cross-region read
    replica

LabelsEntry

The abstract base class for a message.

MachineConfig

MachineConfig describes the configuration of a machine.

Node

Details of a single node in the instance. Nodes in an AlloyDB instance are ephemereal, they can change during update, failover, autohealing and resize operations.

PscInstanceConfig

PscInstanceConfig contains PSC related configuration at an instance level.

PscInterfaceConfig

Configuration for setting up a PSC interface. This information needs to be provided by the customer. PSC interfaces will be created and added to VMs via SLM (adding a network interface will require recreating the VM). For HA instances this will be done via LDTM.

QueryInsightsInstanceConfig

QueryInsights Instance specific configuration.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

ReadPoolConfig

Configuration for a read pool instance.

State

Instance State

UpdatePolicy

Policy to be used while updating the instance.

Mode

Specifies the available modes of update.

InstanceView

View on Instance. Pass this enum to rpcs that returns an Instance message to control which subsets of fields to get.

ListBackupsRequest

Message for requesting list of Backups

ListBackupsResponse

Message for response to listing Backups

ListClustersRequest

Message for requesting list of Clusters

ListClustersResponse

Message for response to listing Clusters

ListDatabasesRequest

Message for requesting list of Databases.

ListDatabasesResponse

Message for response to listing Databases.

ListInstancesRequest

Message for requesting list of Instances

ListInstancesResponse

Message for response to listing Instances

ListSupportedDatabaseFlagsRequest

Message for listing the information about the supported Database flags.

ListSupportedDatabaseFlagsResponse

Message for response to listing SupportedDatabaseFlags.

ListUsersRequest

Message for requesting list of Users

ListUsersResponse

Message for response to listing Users

MigrationSource

Subset of the source instance configuration that is available when reading the cluster resource.

MigrationSourceType

Denote the type of migration source that created this cluster.

OperationMetadata

Represents the metadata of the long-running operation.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

PromoteClusterRequest

Message for promoting a Cluster

RestartInstanceRequest

RestoreClusterRequest

Message for restoring a Cluster from a backup or another cluster at a given point in time.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

SslConfig

SSL configuration.

CaSource

Certificate Authority (CA) source for SSL/TLS certificates.

SslMode

SSL mode options.

SupportedDatabaseFlag

SupportedDatabaseFlag gives general information about a database flag, like type and allowed values. This is a static value that is defined on the server side, and it cannot be modified by callers. To set the Database flags on a particular Instance, a caller should modify the Instance.database_flags field.

This message has oneof_ fields (mutually exclusive fields). For each oneof, at most one member field can be set at the same time. Setting any member of the oneof automatically clears all other members.

.. _oneof: https://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields

IntegerRestrictions

Restrictions on INTEGER type values.

StringRestrictions

Restrictions on STRING type values

ValueType

ValueType describes the semantic type of the value that the flag accepts. Regardless of the ValueType, the Instance.database_flags field accepts the stringified version of the value, i.e. "20" or "3.14".

UpdateBackupRequest

Message for updating a Backup

UpdateClusterRequest

Message for updating a Cluster

UpdateInstanceRequest

Message for updating a Instance

UpdateUserRequest

Message for updating a User

User

Message describing User object.

UserType

Enum that details the user type.

UserPassword

The username/password for a database user. Used for specifying initial users at cluster creation time.

Modules

pagers

API documentation for alloydb_v1.services.alloy_db_admin.pagers module.

pagers

API documentation for alloydb_v1alpha.services.alloy_db_admin.pagers module.

pagers

API documentation for alloydb_v1beta.services.alloy_db_admin.pagers module.