이 페이지는 아직 한국어로 제공되지 않으며 번역 작업 중입니다. 번역에 관한 질문이나 의견이 있으시면 언제든지 저희에게 연락해 주십시오.

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