gcp_alloydb_cluster

ancestors

Type: UNORDERED_LIST_STRING

automated_backup_policy

Type: STRUCT
Provider name: automatedBackupPolicy
Description: The automated backup policy for this cluster. If no policy is provided then the default policy will be used. If backups are supported for the cluster, the default policy takes one backup a day, has a backup window of 1 hour, and retains backups for 14 days. For more information on the defaults, consult the documentation for the message type.

• backup_window
  Type: STRING
  Provider name: backupWindow
  Description: The length of the time window during which a backup can be taken. If a backup does not succeed within this time window, it will be canceled and considered failed. The backup window must be at least 5 minutes long. There is no upper bound on the window. If not set, it defaults to 1 hour.
  
• enabled
  Type: BOOLEAN
  Provider name: enabled
  Description: Whether automated automated backups are enabled. If not set, defaults to true.
  
• encryption_config
  Type: STRUCT
  Provider name: encryptionConfig
  Description: Optional. The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.
  
  • kms_key_name
    Type: STRING
    Provider name: kmsKeyName
    Description: The fully-qualified resource name of the KMS key. Each Cloud KMS key is regionalized and has the following format: projects/[PROJECT]/locations/[REGION]/keyRings/[RING]/cryptoKeys/[KEY_NAME]
    
• location
  Type: STRING
  Provider name: location
  Description: The location where the backup will be stored. Currently, the only supported option is to store the backup in the same region as the cluster. If empty, defaults to the region of the cluster.
  
• quantity_based_retention
  Type: STRUCT
  Provider name: quantityBasedRetention
  Description: Quantity-based Backup retention policy to retain recent backups.
  
  • count
    Type: INT32
    Provider name: count
    Description: The number of backups to retain.
    
• time_based_retention
  Type: STRUCT
  Provider name: timeBasedRetention
  Description: Time-based Backup retention policy.
  
  • retention_period
    Type: STRING
    Provider name: retentionPeriod
    Description: The retention period.
    
• weekly_schedule
  Type: STRUCT
  Provider name: weeklySchedule
  Description: Weekly schedule for the Backup.
  
  • days_of_week
    Type: UNORDERED_LIST_STRING
    Provider name: daysOfWeek
    Description: The days of the week to perform a backup. If this field is left empty, the default of every day of the week is used.
    
  • start_times
    Type: UNORDERED_LIST_STRUCT
    Provider name: startTimes
    Description: The times during the day to start a backup. The start times are assumed to be in UTC and to be an exact hour (e.g., 04:00:00). If no start times are provided, a single fixed start time is chosen arbitrarily.
    
    • hours
      Type: INT32
      Provider name: hours
      Description: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value “24:00:00” for scenarios like business closing time.
      
    • minutes
      Type: INT32
      Provider name: minutes
      Description: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
      
    • nanos
      Type: INT32
      Provider name: nanos
      Description: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
      
    • seconds
      Type: INT32
      Provider name: seconds
      Description: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
      

backup_source

Type: STRUCT
Provider name: backupSource
Description: Output only. Cluster created from backup.

• backup_name
  Type: STRING
  Provider name: backupName
  Description: Required. The name of the backup resource with the format: * projects/{project}/locations/{region}/backups/{backup_id}
  
• backup_uid
  Type: STRING
  Provider name: backupUid
  Description: Output only. The system-generated UID of the backup which was used to create this resource. The UID is generated when the backup is created, and it is retained until the backup is deleted.
  

cluster_type

Type: STRING
Provider name: clusterType
Description: Output only. The type of the cluster. This is an output-only field and it’s populated at the Cluster creation time or the Cluster promotion time. The cluster type is determined by which RPC was used to create the cluster (i.e. CreateCluster vs. CreateSecondaryCluster
Possible values:

• CLUSTER_TYPE_UNSPECIFIED - The type of the cluster is unknown.
  
• PRIMARY - Primary cluster that support read and write operations.
  
• SECONDARY - Secondary cluster that is replicating from another region. This only supports read.
  

continuous_backup_config

Type: STRUCT
Provider name: continuousBackupConfig
Description: Optional. Continuous backup configuration for this cluster.

• enabled
  Type: BOOLEAN
  Provider name: enabled
  Description: Whether ContinuousBackup is enabled.
  
• encryption_config
  Type: STRUCT
  Provider name: encryptionConfig
  Description: The encryption config can be specified to encrypt the backups with a customer-managed encryption key (CMEK). When this field is not specified, the backup will then use default encryption scheme to protect the user data.
  
  • kms_key_name
    Type: STRING
    Provider name: kmsKeyName
    Description: The fully-qualified resource name of the KMS key. Each Cloud KMS key is regionalized and has the following format: projects/[PROJECT]/locations/[REGION]/keyRings/[RING]/cryptoKeys/[KEY_NAME]
    
• recovery_window_days
  Type: INT32
  Provider name: recoveryWindowDays
  Description: The number of days that are eligible to restore from using PITR. To support the entire recovery window, backups and logs are retained for one day more than the recovery window. If not set, defaults to 14 days.
  

continuous_backup_info

Type: STRUCT
Provider name: continuousBackupInfo
Description: Output only. Continuous backup properties for this cluster.

• earliest_restorable_time
  Type: TIMESTAMP
  Provider name: earliestRestorableTime
  Description: Output only. The earliest restorable time that can be restored to. Output only field.
  
• enabled_time
  Type: TIMESTAMP
  Provider name: enabledTime
  Description: Output only. When ContinuousBackup was most recently enabled. Set to null if ContinuousBackup is not enabled.
  
• encryption_info
  Type: STRUCT
  Provider name: encryptionInfo
  Description: Output only. The encryption information for the WALs and backups required for ContinuousBackup.
  
  • encryption_type
    Type: STRING
    Provider name: encryptionType
    Description: Output only. Type of encryption.
    Possible values:
    
    • TYPE_UNSPECIFIED - Encryption type not specified. Defaults to GOOGLE_DEFAULT_ENCRYPTION.
      
    • GOOGLE_DEFAULT_ENCRYPTION - The data is encrypted at rest with a key that is fully managed by Google. No key version will be populated. This is the default state.
      
    • CUSTOMER_MANAGED_ENCRYPTION - The data is encrypted at rest with a key that is managed by the customer. KMS key versions will be populated.
      
  • kms_key_versions
    Type: UNORDERED_LIST_STRING
    Provider name: kmsKeyVersions
    Description: Output only. Cloud KMS key versions that are being used to protect the database or the backup.
    
• schedule
  Type: UNORDERED_LIST_STRING
  Provider name: schedule
  Description: Output only. Days of the week on which a continuous backup is taken. Output only field. Ignored if passed into the request.
  

create_time

Type: TIMESTAMP
Provider name: createTime
Description: Output only. Create time stamp

database_version

Type: STRING
Provider name: databaseVersion
Description: Optional. The database engine major version. This is an optional field and it is populated at the Cluster creation time. If a database version is not supplied at cluster creation time, then a default database version will be used.
Possible values:

• DATABASE_VERSION_UNSPECIFIED - This is an unknown database version.
  
• POSTGRES_13 - DEPRECATED - The database version is Postgres 13.
  
• POSTGRES_14 - The database version is Postgres 14.
  
• POSTGRES_15 - The database version is Postgres 15.
  
• POSTGRES_16 - The database version is Postgres 16.
  

delete_time

Type: TIMESTAMP
Provider name: deleteTime
Description: Output only. Delete time stamp

encryption_config

Type: STRUCT
Provider name: encryptionConfig
Description: Optional. The encryption config can be specified to encrypt the data disks and other persistent data resources of a cluster with a customer-managed encryption key (CMEK). When this field is not specified, the cluster will then use default encryption scheme to protect the user data.

• kms_key_name
  Type: STRING
  Provider name: kmsKeyName
  Description: The fully-qualified resource name of the KMS key. Each Cloud KMS key is regionalized and has the following format: projects/[PROJECT]/locations/[REGION]/keyRings/[RING]/cryptoKeys/[KEY_NAME]
  

encryption_info

Type: STRUCT
Provider name: encryptionInfo
Description: Output only. The encryption information for the cluster.

• encryption_type
  Type: STRING
  Provider name: encryptionType
  Description: Output only. Type of encryption.
  Possible values:
  
  • TYPE_UNSPECIFIED - Encryption type not specified. Defaults to GOOGLE_DEFAULT_ENCRYPTION.
    
  • GOOGLE_DEFAULT_ENCRYPTION - The data is encrypted at rest with a key that is fully managed by Google. No key version will be populated. This is the default state.
    
  • CUSTOMER_MANAGED_ENCRYPTION - The data is encrypted at rest with a key that is managed by the customer. KMS key versions will be populated.
    
• kms_key_versions
  Type: UNORDERED_LIST_STRING
  Provider name: kmsKeyVersions
  Description: Output only. Cloud KMS key versions that are being used to protect the database or the backup.
  

etag

Type: STRING
Provider name: etag
Description: For Resource freshness validation (https://google.aip.dev/154)

gcp_display_name

Type: STRING
Provider name: displayName
Description: User-settable and human-readable display name for the Cluster.

initial_user

Type: STRUCT
Provider name: initialUser
Description: Input only. Initial user to setup during cluster creation. Required. If used in RestoreCluster this is ignored.

• password
  Type: STRING
  Provider name: password
  Description: The initial password for the user.
  
• user
  Type: STRING
  Provider name: user
  Description: The database username.
  

labels

Type: UNORDERED_LIST_STRING

maintenance_schedule

Type: STRUCT
Provider name: maintenanceSchedule
Description: Output only. The maintenance schedule for the cluster, generated for a specific rollout if a maintenance window is set.

• start_time
  Type: TIMESTAMP
  Provider name: startTime
  Description: Output only. The scheduled start time for the maintenance.
  

maintenance_update_policy

Type: STRUCT
Provider name: maintenanceUpdatePolicy
Description: Optional. The maintenance update policy determines when to allow or deny updates.

• maintenance_windows
  Type: UNORDERED_LIST_STRUCT
  Provider name: maintenanceWindows
  Description: Preferred windows to perform maintenance. Currently limited to 1.
  
  • day
    Type: STRING
    Provider name: day
    Description: Preferred day of the week for maintenance, e.g. MONDAY, TUESDAY, etc.
    Possible values:
    
    • DAY_OF_WEEK_UNSPECIFIED - The day of the week is unspecified.
      
    • MONDAY - Monday
      
    • TUESDAY - Tuesday
      
    • WEDNESDAY - Wednesday
      
    • THURSDAY - Thursday
      
    • FRIDAY - Friday
      
    • SATURDAY - Saturday
      
    • SUNDAY - Sunday
      
  • start_time
    Type: STRUCT
    Provider name: startTime
    Description: Preferred time to start the maintenance operation on the specified day. Maintenance will start within 1 hour of this time.
    
    • hours
      Type: INT32
      Provider name: hours
      Description: Hours of a day in 24 hour format. Must be greater than or equal to 0 and typically must be less than or equal to 23. An API may choose to allow the value “24:00:00” for scenarios like business closing time.
      
    • minutes
      Type: INT32
      Provider name: minutes
      Description: Minutes of an hour. Must be greater than or equal to 0 and less than or equal to 59.
      
    • nanos
      Type: INT32
      Provider name: nanos
      Description: Fractions of seconds, in nanoseconds. Must be greater than or equal to 0 and less than or equal to 999,999,999.
      
    • seconds
      Type: INT32
      Provider name: seconds
      Description: Seconds of a minute. Must be greater than or equal to 0 and typically must be less than or equal to 59. An API may allow the value 60 if it allows leap-seconds.
      

migration_source

Type: STRUCT
Provider name: migrationSource
Description: Output only. Cluster created via DMS migration.

• host_port
  Type: STRING
  Provider name: hostPort
  Description: Output only. The host and port of the on-premises instance in host:port format
  
• reference_id
  Type: STRING
  Provider name: referenceId
  Description: Output only. Place holder for the external source identifier(e.g DMS job name) that created the cluster.
  
• source_type
  Type: STRING
  Provider name: sourceType
  Description: Output only. Type of migration source.
  Possible values:
  
  • MIGRATION_SOURCE_TYPE_UNSPECIFIED - Migration source is unknown.
    
  • DMS - DMS source means the cluster was created via DMS migration job.
    

name

Type: STRING
Provider name: name
Description: Output only. The name of the cluster resource with the format: * projects/{project}/locations/{region}/clusters/{cluster_id} where the cluster ID segment should satisfy the regex expression [a-z0-9-]+. For more details see https://google.aip.dev/122. The prefix of the cluster resource name is the name of the parent resource: * projects/{project}/locations/{region}

network

Type: STRING
Provider name: network
Description: Required. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: projects/{project}/global/networks/{network_id}. This is required to create a cluster. Deprecated, use network_config.network instead.

network_config

Type: STRUCT
Provider name: networkConfig

• allocated_ip_range
  Type: STRING
  Provider name: allocatedIpRange
  Description: Optional. Name of the allocated IP range for the private IP AlloyDB cluster, for example: “google-managed-services-default”. If set, the instance IPs for this cluster will be created in the allocated range. The range name must comply with RFC 1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])?. Field name is intended to be consistent with Cloud SQL.
  
• network
  Type: STRING
  Provider name: network
  Description: Optional. The resource link for the VPC network in which cluster resources are created and from which they are accessible via Private IP. The network must belong to the same project as the cluster. It is specified in the form: projects/{project_number}/global/networks/{network_id}. This is required to create a cluster.
  

organization_id

Type: STRING

parent

Type: STRING

primary_config

Type: STRUCT
Provider name: primaryConfig
Description: Output only. Cross Region replication config specific to PRIMARY cluster.

• secondary_cluster_names
  Type: UNORDERED_LIST_STRING
  Provider name: secondaryClusterNames
  Description: Output only. Names of the clusters that are replicating from this cluster.
  

project_id

Type: STRING

project_number

Type: STRING

psc_config

Type: STRUCT
Provider name: pscConfig
Description: Optional. The configuration for Private Service Connect (PSC) for the cluster.

• psc_enabled
  Type: BOOLEAN
  Provider name: pscEnabled
  Description: Optional. Create an instance that allows connections from Private Service Connect endpoints to the instance.
  

reconciling

Type: BOOLEAN
Provider name: reconciling
Description: Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Cluster does not match the user’s intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.

resource_name

Type: STRING

satisfies_pzs

Type: BOOLEAN
Provider name: satisfiesPzs
Description: Output only. Reserved for future use.

secondary_config

Type: STRUCT
Provider name: secondaryConfig
Description: Cross Region replication config specific to SECONDARY cluster.

• primary_cluster_name
  Type: STRING
  Provider name: primaryClusterName
  Description: The name of the primary cluster name with the format: * projects/{project}/locations/{region}/clusters/{cluster_id}
  

ssl_config

Type: STRUCT
Provider name: sslConfig
Description: SSL configuration for this AlloyDB cluster.

• ca_source
  Type: STRING
  Provider name: caSource
  Description: Optional. Certificate Authority (CA) source. Only CA_SOURCE_MANAGED is supported currently, and is the default value.
  Possible values:
  
  • CA_SOURCE_UNSPECIFIED - Certificate Authority (CA) source not specified. Defaults to CA_SOURCE_MANAGED.
    
  • CA_SOURCE_MANAGED - Certificate Authority (CA) managed by the AlloyDB Cluster.
    
• ssl_mode
  Type: STRING
  Provider name: sslMode
  Description: Optional. SSL mode. Specifies client-server SSL/TLS connection behavior.
  Possible values:
  
  • SSL_MODE_UNSPECIFIED - SSL mode is not specified. Defaults to ENCRYPTED_ONLY.
    
  • SSL_MODE_ALLOW - SSL connections are optional. CA verification not enforced.
    
  • SSL_MODE_REQUIRE - SSL connections are required. CA verification not enforced. Clients may use locally self-signed certificates (default psql client behavior).
    
  • SSL_MODE_VERIFY_CA - SSL connections are required. CA verification enforced. Clients must have certificates signed by a Cluster CA, for example, using GenerateClientCertificate.
    
  • ALLOW_UNENCRYPTED_AND_ENCRYPTED - SSL connections are optional. CA verification not enforced.
    
  • ENCRYPTED_ONLY - SSL connections are required. CA verification not enforced.
    

state

Type: STRING
Provider name: state
Description: Output only. The current serving state of the cluster.
Possible values:

• STATE_UNSPECIFIED - The state of the cluster is unknown.
  
• READY - The cluster is active and running.
  
• STOPPED - The cluster is stopped. All instances in the cluster are stopped. Customers can start a stopped cluster at any point and all their instances will come back to life with same names and IP resources. In this state, customer pays for storage. Associated backups could also be present in a stopped cluster.
  
• EMPTY - The cluster is empty and has no associated resources. All instances, associated storage and backups have been deleted.
  
• CREATING - The cluster is being created.
  
• DELETING - The cluster is being deleted.
  
• FAILED - The creation of the cluster failed.
  
• BOOTSTRAPPING - The cluster is bootstrapping with data from some other source. Direct mutations to the cluster (e.g. adding read pool) are not allowed.
  
• MAINTENANCE - The cluster is under maintenance. AlloyDB regularly performs maintenance and upgrades on customer clusters. Updates on the cluster are not allowed while the cluster is in this state.
  
• PROMOTING - The cluster is being promoted.
  

subscription_type

Type: STRING
Provider name: subscriptionType
Description: Optional. Subscription type of the cluster.
Possible values:

• SUBSCRIPTION_TYPE_UNSPECIFIED - This is an unknown subscription type. By default, the subscription type is STANDARD.
  
• STANDARD - Standard subscription.
  
• TRIAL - Trial subscription.
  

tags

Type: UNORDERED_LIST_STRING

trial_metadata

Type: STRUCT
Provider name: trialMetadata
Description: Output only. Metadata for free trial clusters

• end_time
  Type: TIMESTAMP
  Provider name: endTime
  Description: End time of the trial cluster.
  
• grace_end_time
  Type: TIMESTAMP
  Provider name: graceEndTime
  Description: grace end time of the cluster.
  
• start_time
  Type: TIMESTAMP
  Provider name: startTime
  Description: start time of the trial cluster.
  
• upgrade_time
  Type: TIMESTAMP
  Provider name: upgradeTime
  Description: Upgrade time of trial cluster to Standard cluster.
  

uid

Type: STRING
Provider name: uid
Description: Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.

update_time

Type: TIMESTAMP
Provider name: updateTime
Description: Output only. Update time stamp