pulumi-gcp 8.9.0a1731221331__py3-none-any.whl → 8.9.0a1731432418__py3-none-any.whl

pulumi_gcp/sql/_inputs.py

@@ -266,6 +266,12 @@ if not MYPY:
         PEM representation of the trusted CA's x509
         certificate.
         """
+        cascadable_replica: NotRequired[pulumi.Input[bool]]
+        """
+        Specifies if the replica is a cascadable replica. If true, instance must be in different region from primary.
+
+        > **NOTE:** Only supported for SQL Server database.
+        """
         client_certificate: NotRequired[pulumi.Input[str]]
         """
         PEM representation of the replica's x509
@@ -324,6 +330,7 @@ elif False:
 class DatabaseInstanceReplicaConfigurationArgs:
     def __init__(__self__, *,
                  ca_certificate: Optional[pulumi.Input[str]] = None,
+                 cascadable_replica: Optional[pulumi.Input[bool]] = None,
                  client_certificate: Optional[pulumi.Input[str]] = None,
                  client_key: Optional[pulumi.Input[str]] = None,
                  connect_retry_interval: Optional[pulumi.Input[int]] = None,
@@ -337,6 +344,9 @@ class DatabaseInstanceReplicaConfigurationArgs:
         """
         :param pulumi.Input[str] ca_certificate: PEM representation of the trusted CA's x509
                certificate.
+        :param pulumi.Input[bool] cascadable_replica: Specifies if the replica is a cascadable replica. If true, instance must be in different region from primary.
+               
+               > **NOTE:** Only supported for SQL Server database.
         :param pulumi.Input[str] client_certificate: PEM representation of the replica's x509
                certificate.
         :param pulumi.Input[str] client_key: PEM representation of the replica's private key. The
@@ -361,6 +371,8 @@ class DatabaseInstanceReplicaConfigurationArgs:
         """
         if ca_certificate is not None:
             pulumi.set(__self__, "ca_certificate", ca_certificate)
+        if cascadable_replica is not None:
+            pulumi.set(__self__, "cascadable_replica", cascadable_replica)
         if client_certificate is not None:
             pulumi.set(__self__, "client_certificate", client_certificate)
         if client_key is not None:
@@ -395,6 +407,20 @@ class DatabaseInstanceReplicaConfigurationArgs:
     def ca_certificate(self, value: Optional[pulumi.Input[str]]):
         pulumi.set(self, "ca_certificate", value)
 
+    @property
+    @pulumi.getter(name="cascadableReplica")
+    def cascadable_replica(self) -> Optional[pulumi.Input[bool]]:
+        """
+        Specifies if the replica is a cascadable replica. If true, instance must be in different region from primary.
+
+        > **NOTE:** Only supported for SQL Server database.
+        """
+        return pulumi.get(self, "cascadable_replica")
+
+    @cascadable_replica.setter
+    def cascadable_replica(self, value: Optional[pulumi.Input[bool]]):
+        pulumi.set(self, "cascadable_replica", value)
+
     @property
     @pulumi.getter(name="clientCertificate")
     def client_certificate(self) -> Optional[pulumi.Input[str]]:

pulumi_gcp/sql/database_instance.py

@@ -32,6 +32,7 @@ class DatabaseInstanceArgs:
                  project: Optional[pulumi.Input[str]] = None,
                  region: Optional[pulumi.Input[str]] = None,
                  replica_configuration: Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']] = None,
+                 replica_names: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  restore_backup_context: Optional[pulumi.Input['DatabaseInstanceRestoreBackupContextArgs']] = None,
                  root_password: Optional[pulumi.Input[str]] = None,
                  settings: Optional[pulumi.Input['DatabaseInstanceSettingsArgs']] = None):
@@ -75,7 +76,8 @@ class DatabaseInstanceArgs:
                
                - - -
         :param pulumi.Input['DatabaseInstanceReplicaConfigurationArgs'] replica_configuration: The configuration for replication. The
-               configuration is detailed below. Valid only for MySQL instances.
+               configuration is detailed below.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] replica_names: List of replica names. Can be updated.
         :param pulumi.Input['DatabaseInstanceRestoreBackupContextArgs'] restore_backup_context: The context needed to restore the database to a backup run. This field will
                cause the provider to trigger the database to restore from the backup run indicated. The configuration is detailed below.
                **NOTE:** Restoring from a backup is an imperative action and not recommended via this provider. Adding or modifying this
@@ -105,6 +107,8 @@ class DatabaseInstanceArgs:
             pulumi.set(__self__, "region", region)
         if replica_configuration is not None:
             pulumi.set(__self__, "replica_configuration", replica_configuration)
+        if replica_names is not None:
+            pulumi.set(__self__, "replica_names", replica_names)
         if restore_backup_context is not None:
             pulumi.set(__self__, "restore_backup_context", restore_backup_context)
         if root_password is not None:
@@ -264,7 +268,7 @@ class DatabaseInstanceArgs:
     def replica_configuration(self) -> Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']]:
         """
         The configuration for replication. The
-        configuration is detailed below. Valid only for MySQL instances.
+        configuration is detailed below.
         """
         return pulumi.get(self, "replica_configuration")
 
@@ -272,6 +276,18 @@ class DatabaseInstanceArgs:
     def replica_configuration(self, value: Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']]):
         pulumi.set(self, "replica_configuration", value)
 
+    @property
+    @pulumi.getter(name="replicaNames")
+    def replica_names(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+        """
+        List of replica names. Can be updated.
+        """
+        return pulumi.get(self, "replica_names")
+
+    @replica_names.setter
+    def replica_names(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+        pulumi.set(self, "replica_names", value)
+
     @property
     @pulumi.getter(name="restoreBackupContext")
     def restore_backup_context(self) -> Optional[pulumi.Input['DatabaseInstanceRestoreBackupContextArgs']]:
@@ -335,6 +351,7 @@ class _DatabaseInstanceState:
                  public_ip_address: Optional[pulumi.Input[str]] = None,
                  region: Optional[pulumi.Input[str]] = None,
                  replica_configuration: Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']] = None,
+                 replica_names: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  restore_backup_context: Optional[pulumi.Input['DatabaseInstanceRestoreBackupContextArgs']] = None,
                  root_password: Optional[pulumi.Input[str]] = None,
                  self_link: Optional[pulumi.Input[str]] = None,
@@ -360,7 +377,7 @@ class _DatabaseInstanceState:
                includes an up-to-date reference of supported versions.
         :param pulumi.Input[bool] deletion_protection: Whether or not to allow the provider to destroy the instance. Unless this field is set to false
                in state, a `destroy` or `update` command that deletes the instance will fail. Defaults to `true`.
-        :param pulumi.Input[str] dns_name: The dns name of the instance.
+        :param pulumi.Input[str] dns_name: The DNS name of the instance. See [Connect to an instance using Private Service Connect](https://cloud.google.com/sql/docs/mysql/configure-private-service-connect#view-summary-information-cloud-sql-instances-psc-enabled) for more details.
         :param pulumi.Input[str] encryption_key_name: The full path to the encryption key used for the CMEK disk encryption.  Setting
                up disk encryption currently requires manual steps outside of this provider.
                The provided key must be in the same region as the SQL instance.  In order
@@ -389,7 +406,8 @@ class _DatabaseInstanceState:
                
                - - -
         :param pulumi.Input['DatabaseInstanceReplicaConfigurationArgs'] replica_configuration: The configuration for replication. The
-               configuration is detailed below. Valid only for MySQL instances.
+               configuration is detailed below.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] replica_names: List of replica names. Can be updated.
         :param pulumi.Input['DatabaseInstanceRestoreBackupContextArgs'] restore_backup_context: The context needed to restore the database to a backup run. This field will
                cause the provider to trigger the database to restore from the backup run indicated. The configuration is detailed below.
                **NOTE:** Restoring from a backup is an imperative action and not recommended via this provider. Adding or modifying this
@@ -439,6 +457,8 @@ class _DatabaseInstanceState:
             pulumi.set(__self__, "region", region)
         if replica_configuration is not None:
             pulumi.set(__self__, "replica_configuration", replica_configuration)
+        if replica_names is not None:
+            pulumi.set(__self__, "replica_names", replica_names)
         if restore_backup_context is not None:
             pulumi.set(__self__, "restore_backup_context", restore_backup_context)
         if root_password is not None:
@@ -528,7 +548,7 @@ class _DatabaseInstanceState:
     @pulumi.getter(name="dnsName")
     def dns_name(self) -> Optional[pulumi.Input[str]]:
         """
-        The dns name of the instance.
+        The DNS name of the instance. See [Connect to an instance using Private Service Connect](https://cloud.google.com/sql/docs/mysql/configure-private-service-connect#view-summary-information-cloud-sql-instances-psc-enabled) for more details.
         """
         return pulumi.get(self, "dns_name")
 
@@ -698,7 +718,7 @@ class _DatabaseInstanceState:
     def replica_configuration(self) -> Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']]:
         """
         The configuration for replication. The
-        configuration is detailed below. Valid only for MySQL instances.
+        configuration is detailed below.
         """
         return pulumi.get(self, "replica_configuration")
 
@@ -706,6 +726,18 @@ class _DatabaseInstanceState:
     def replica_configuration(self, value: Optional[pulumi.Input['DatabaseInstanceReplicaConfigurationArgs']]):
         pulumi.set(self, "replica_configuration", value)
 
+    @property
+    @pulumi.getter(name="replicaNames")
+    def replica_names(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
+        """
+        List of replica names. Can be updated.
+        """
+        return pulumi.get(self, "replica_names")
+
+    @replica_names.setter
+    def replica_names(self, value: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]):
+        pulumi.set(self, "replica_names", value)
+
     @property
     @pulumi.getter(name="restoreBackupContext")
     def restore_backup_context(self) -> Optional[pulumi.Input['DatabaseInstanceRestoreBackupContextArgs']]:
@@ -797,6 +829,7 @@ class DatabaseInstance(pulumi.CustomResource):
                  project: Optional[pulumi.Input[str]] = None,
                  region: Optional[pulumi.Input[str]] = None,
                  replica_configuration: Optional[pulumi.Input[Union['DatabaseInstanceReplicaConfigurationArgs', 'DatabaseInstanceReplicaConfigurationArgsDict']]] = None,
+                 replica_names: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  restore_backup_context: Optional[pulumi.Input[Union['DatabaseInstanceRestoreBackupContextArgs', 'DatabaseInstanceRestoreBackupContextArgsDict']]] = None,
                  root_password: Optional[pulumi.Input[str]] = None,
                  settings: Optional[pulumi.Input[Union['DatabaseInstanceSettingsArgs', 'DatabaseInstanceSettingsArgsDict']]] = None,
@@ -910,6 +943,39 @@ class DatabaseInstance(pulumi.CustomResource):
             })
         ```
 
+        ## Switchover (SQL Server Only)
+
+        Users can perform a switchover on any direct `cascadable` replica by following the steps below.
+
+          ~>**WARNING:** Failure to follow these steps can lead to data loss (You will be warned during plan stage). To prevent data loss during a switchover, please verify your plan with the checklist below.
+
+        For a more in-depth walkthrough with example code, see the Switchover Guide
+
+        ### Steps to Invoke Switchover
+
+        Create a `cascadable` replica in a different region from the primary (`cascadable_replica` is set to true in `replica_configuration`)
+
+        #### Invoking switchover in the replica resource:
+        1. Change instance_type from `READ_REPLICA_INSTANCE` to `CLOUD_SQL_INSTANCE`
+        2. Remove `master_instance_name`
+        3. Remove `replica_configuration`
+        4. Add current primary's name to the replica's `replica_names` list
+
+        #### Updating the primary resource:
+        1. Change `instance_type` from `CLOUD_SQL_INSTANCE` to `READ_REPLICA_INSTANCE`
+        2. Set `master_instance_name` to the original replica (which will be primary after switchover)
+        3. Set `replica_configuration` and set `cascadable_replica` to `true`
+        4. Remove original replica from `replica_names`
+           
+            > **NOTE**: Do **not** delete the replica_names field, even if it has no replicas remaining. Set replica_names = [ ] to indicate it having no replicas.
+
+        #### Plan and verify that:
+        - `pulumi preview` outputs **"0 to add, 0 to destroy"**
+        - `pulumi preview` does not say **"must be replaced"** for any resource
+        - Every resource **"will be updated in-place"**
+        - Only the 2 instances involved in switchover have planned changes
+        - (Recommended) Use `deletion_protection` on instances as a safety measure
+
         ## Import
 
         Database instances can be imported using one of any of these accepted formats:
@@ -980,7 +1046,8 @@ class DatabaseInstance(pulumi.CustomResource):
                
                - - -
         :param pulumi.Input[Union['DatabaseInstanceReplicaConfigurationArgs', 'DatabaseInstanceReplicaConfigurationArgsDict']] replica_configuration: The configuration for replication. The
-               configuration is detailed below. Valid only for MySQL instances.
+               configuration is detailed below.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] replica_names: List of replica names. Can be updated.
         :param pulumi.Input[Union['DatabaseInstanceRestoreBackupContextArgs', 'DatabaseInstanceRestoreBackupContextArgsDict']] restore_backup_context: The context needed to restore the database to a backup run. This field will
                cause the provider to trigger the database to restore from the backup run indicated. The configuration is detailed below.
                **NOTE:** Restoring from a backup is an imperative action and not recommended via this provider. Adding or modifying this
@@ -1104,6 +1171,39 @@ class DatabaseInstance(pulumi.CustomResource):
             })
         ```
 
+        ## Switchover (SQL Server Only)
+
+        Users can perform a switchover on any direct `cascadable` replica by following the steps below.
+
+          ~>**WARNING:** Failure to follow these steps can lead to data loss (You will be warned during plan stage). To prevent data loss during a switchover, please verify your plan with the checklist below.
+
+        For a more in-depth walkthrough with example code, see the Switchover Guide
+
+        ### Steps to Invoke Switchover
+
+        Create a `cascadable` replica in a different region from the primary (`cascadable_replica` is set to true in `replica_configuration`)
+
+        #### Invoking switchover in the replica resource:
+        1. Change instance_type from `READ_REPLICA_INSTANCE` to `CLOUD_SQL_INSTANCE`
+        2. Remove `master_instance_name`
+        3. Remove `replica_configuration`
+        4. Add current primary's name to the replica's `replica_names` list
+
+        #### Updating the primary resource:
+        1. Change `instance_type` from `CLOUD_SQL_INSTANCE` to `READ_REPLICA_INSTANCE`
+        2. Set `master_instance_name` to the original replica (which will be primary after switchover)
+        3. Set `replica_configuration` and set `cascadable_replica` to `true`
+        4. Remove original replica from `replica_names`
+           
+            > **NOTE**: Do **not** delete the replica_names field, even if it has no replicas remaining. Set replica_names = [ ] to indicate it having no replicas.
+
+        #### Plan and verify that:
+        - `pulumi preview` outputs **"0 to add, 0 to destroy"**
+        - `pulumi preview` does not say **"must be replaced"** for any resource
+        - Every resource **"will be updated in-place"**
+        - Only the 2 instances involved in switchover have planned changes
+        - (Recommended) Use `deletion_protection` on instances as a safety measure
+
         ## Import
 
         Database instances can be imported using one of any of these accepted formats:
@@ -1160,6 +1260,7 @@ class DatabaseInstance(pulumi.CustomResource):
                  project: Optional[pulumi.Input[str]] = None,
                  region: Optional[pulumi.Input[str]] = None,
                  replica_configuration: Optional[pulumi.Input[Union['DatabaseInstanceReplicaConfigurationArgs', 'DatabaseInstanceReplicaConfigurationArgsDict']]] = None,
+                 replica_names: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  restore_backup_context: Optional[pulumi.Input[Union['DatabaseInstanceRestoreBackupContextArgs', 'DatabaseInstanceRestoreBackupContextArgsDict']]] = None,
                  root_password: Optional[pulumi.Input[str]] = None,
                  settings: Optional[pulumi.Input[Union['DatabaseInstanceSettingsArgs', 'DatabaseInstanceSettingsArgsDict']]] = None,
@@ -1185,6 +1286,7 @@ class DatabaseInstance(pulumi.CustomResource):
             __props__.__dict__["project"] = project
             __props__.__dict__["region"] = region
             __props__.__dict__["replica_configuration"] = None if replica_configuration is None else pulumi.Output.secret(replica_configuration)
+            __props__.__dict__["replica_names"] = replica_names
             __props__.__dict__["restore_backup_context"] = restore_backup_context
             __props__.__dict__["root_password"] = None if root_password is None else pulumi.Output.secret(root_password)
             __props__.__dict__["settings"] = settings
@@ -1230,6 +1332,7 @@ class DatabaseInstance(pulumi.CustomResource):
             public_ip_address: Optional[pulumi.Input[str]] = None,
             region: Optional[pulumi.Input[str]] = None,
             replica_configuration: Optional[pulumi.Input[Union['DatabaseInstanceReplicaConfigurationArgs', 'DatabaseInstanceReplicaConfigurationArgsDict']]] = None,
+            replica_names: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             restore_backup_context: Optional[pulumi.Input[Union['DatabaseInstanceRestoreBackupContextArgs', 'DatabaseInstanceRestoreBackupContextArgsDict']]] = None,
             root_password: Optional[pulumi.Input[str]] = None,
             self_link: Optional[pulumi.Input[str]] = None,
@@ -1260,7 +1363,7 @@ class DatabaseInstance(pulumi.CustomResource):
                includes an up-to-date reference of supported versions.
         :param pulumi.Input[bool] deletion_protection: Whether or not to allow the provider to destroy the instance. Unless this field is set to false
                in state, a `destroy` or `update` command that deletes the instance will fail. Defaults to `true`.
-        :param pulumi.Input[str] dns_name: The dns name of the instance.
+        :param pulumi.Input[str] dns_name: The DNS name of the instance. See [Connect to an instance using Private Service Connect](https://cloud.google.com/sql/docs/mysql/configure-private-service-connect#view-summary-information-cloud-sql-instances-psc-enabled) for more details.
         :param pulumi.Input[str] encryption_key_name: The full path to the encryption key used for the CMEK disk encryption.  Setting
                up disk encryption currently requires manual steps outside of this provider.
                The provided key must be in the same region as the SQL instance.  In order
@@ -1289,7 +1392,8 @@ class DatabaseInstance(pulumi.CustomResource):
                
                - - -
         :param pulumi.Input[Union['DatabaseInstanceReplicaConfigurationArgs', 'DatabaseInstanceReplicaConfigurationArgsDict']] replica_configuration: The configuration for replication. The
-               configuration is detailed below. Valid only for MySQL instances.
+               configuration is detailed below.
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] replica_names: List of replica names. Can be updated.
         :param pulumi.Input[Union['DatabaseInstanceRestoreBackupContextArgs', 'DatabaseInstanceRestoreBackupContextArgsDict']] restore_backup_context: The context needed to restore the database to a backup run. This field will
                cause the provider to trigger the database to restore from the backup run indicated. The configuration is detailed below.
                **NOTE:** Restoring from a backup is an imperative action and not recommended via this provider. Adding or modifying this
@@ -1324,6 +1428,7 @@ class DatabaseInstance(pulumi.CustomResource):
         __props__.__dict__["public_ip_address"] = public_ip_address
         __props__.__dict__["region"] = region
         __props__.__dict__["replica_configuration"] = replica_configuration
+        __props__.__dict__["replica_names"] = replica_names
         __props__.__dict__["restore_backup_context"] = restore_backup_context
         __props__.__dict__["root_password"] = root_password
         __props__.__dict__["self_link"] = self_link
@@ -1388,7 +1493,7 @@ class DatabaseInstance(pulumi.CustomResource):
     @pulumi.getter(name="dnsName")
     def dns_name(self) -> pulumi.Output[str]:
         """
-        The dns name of the instance.
+        The DNS name of the instance. See [Connect to an instance using Private Service Connect](https://cloud.google.com/sql/docs/mysql/configure-private-service-connect#view-summary-information-cloud-sql-instances-psc-enabled) for more details.
         """
         return pulumi.get(self, "dns_name")
 
@@ -1506,10 +1611,18 @@ class DatabaseInstance(pulumi.CustomResource):
     def replica_configuration(self) -> pulumi.Output['outputs.DatabaseInstanceReplicaConfiguration']:
         """
         The configuration for replication. The
-        configuration is detailed below. Valid only for MySQL instances.
+        configuration is detailed below.
         """
         return pulumi.get(self, "replica_configuration")
 
+    @property
+    @pulumi.getter(name="replicaNames")
+    def replica_names(self) -> pulumi.Output[Sequence[str]]:
+        """
+        List of replica names. Can be updated.
+        """
+        return pulumi.get(self, "replica_names")
+
     @property
     @pulumi.getter(name="restoreBackupContext")
     def restore_backup_context(self) -> pulumi.Output[Optional['outputs.DatabaseInstanceRestoreBackupContext']]:

pulumi_gcp/sql/get_database_instance.py

@@ -27,7 +27,7 @@ class GetDatabaseInstanceResult:
     """
     A collection of values returned by getDatabaseInstance.
     """
-    def __init__(__self__, available_maintenance_versions=None, clones=None, connection_name=None, database_version=None, deletion_protection=None, dns_name=None, encryption_key_name=None, first_ip_address=None, id=None, instance_type=None, ip_addresses=None, maintenance_version=None, master_instance_name=None, name=None, private_ip_address=None, project=None, psc_service_attachment_link=None, public_ip_address=None, region=None, replica_configurations=None, restore_backup_contexts=None, root_password=None, self_link=None, server_ca_certs=None, service_account_email_address=None, settings=None):
+    def __init__(__self__, available_maintenance_versions=None, clones=None, connection_name=None, database_version=None, deletion_protection=None, dns_name=None, encryption_key_name=None, first_ip_address=None, id=None, instance_type=None, ip_addresses=None, maintenance_version=None, master_instance_name=None, name=None, private_ip_address=None, project=None, psc_service_attachment_link=None, public_ip_address=None, region=None, replica_configurations=None, replica_names=None, restore_backup_contexts=None, root_password=None, self_link=None, server_ca_certs=None, service_account_email_address=None, settings=None):
         if available_maintenance_versions and not isinstance(available_maintenance_versions, list):
             raise TypeError("Expected argument 'available_maintenance_versions' to be a list")
         pulumi.set(__self__, "available_maintenance_versions", available_maintenance_versions)
@@ -88,6 +88,9 @@ class GetDatabaseInstanceResult:
         if replica_configurations and not isinstance(replica_configurations, list):
             raise TypeError("Expected argument 'replica_configurations' to be a list")
         pulumi.set(__self__, "replica_configurations", replica_configurations)
+        if replica_names and not isinstance(replica_names, list):
+            raise TypeError("Expected argument 'replica_names' to be a list")
+        pulumi.set(__self__, "replica_names", replica_names)
         if restore_backup_contexts and not isinstance(restore_backup_contexts, list):
             raise TypeError("Expected argument 'restore_backup_contexts' to be a list")
         pulumi.set(__self__, "restore_backup_contexts", restore_backup_contexts)
@@ -210,6 +213,11 @@ class GetDatabaseInstanceResult:
     def replica_configurations(self) -> Sequence['outputs.GetDatabaseInstanceReplicaConfigurationResult']:
         return pulumi.get(self, "replica_configurations")
 
+    @property
+    @pulumi.getter(name="replicaNames")
+    def replica_names(self) -> Sequence[str]:
+        return pulumi.get(self, "replica_names")
+
     @property
     @pulumi.getter(name="restoreBackupContexts")
     def restore_backup_contexts(self) -> Sequence['outputs.GetDatabaseInstanceRestoreBackupContextResult']:
@@ -267,6 +275,7 @@ class AwaitableGetDatabaseInstanceResult(GetDatabaseInstanceResult):
             public_ip_address=self.public_ip_address,
             region=self.region,
             replica_configurations=self.replica_configurations,
+            replica_names=self.replica_names,
             restore_backup_contexts=self.restore_backup_contexts,
             root_password=self.root_password,
             self_link=self.self_link,
@@ -321,6 +330,7 @@ def get_database_instance(name: Optional[str] = None,
         public_ip_address=pulumi.get(__ret__, 'public_ip_address'),
         region=pulumi.get(__ret__, 'region'),
         replica_configurations=pulumi.get(__ret__, 'replica_configurations'),
+        replica_names=pulumi.get(__ret__, 'replica_names'),
         restore_backup_contexts=pulumi.get(__ret__, 'restore_backup_contexts'),
         root_password=pulumi.get(__ret__, 'root_password'),
         self_link=pulumi.get(__ret__, 'self_link'),
@@ -372,6 +382,7 @@ def get_database_instance_output(name: Optional[pulumi.Input[str]] = None,
         public_ip_address=pulumi.get(__response__, 'public_ip_address'),
         region=pulumi.get(__response__, 'region'),
         replica_configurations=pulumi.get(__response__, 'replica_configurations'),
+        replica_names=pulumi.get(__response__, 'replica_names'),
         restore_backup_contexts=pulumi.get(__response__, 'restore_backup_contexts'),
         root_password=pulumi.get(__response__, 'root_password'),
         self_link=pulumi.get(__response__, 'self_link'),

pulumi_gcp/sql/outputs.py

@@ -254,6 +254,8 @@ class DatabaseInstanceReplicaConfiguration(dict):
         suggest = None
         if key == "caCertificate":
             suggest = "ca_certificate"
+        elif key == "cascadableReplica":
+            suggest = "cascadable_replica"
         elif key == "clientCertificate":
             suggest = "client_certificate"
         elif key == "clientKey":
@@ -284,6 +286,7 @@ class DatabaseInstanceReplicaConfiguration(dict):
 
     def __init__(__self__, *,
                  ca_certificate: Optional[str] = None,
+                 cascadable_replica: Optional[bool] = None,
                  client_certificate: Optional[str] = None,
                  client_key: Optional[str] = None,
                  connect_retry_interval: Optional[int] = None,
@@ -297,6 +300,9 @@ class DatabaseInstanceReplicaConfiguration(dict):
         """
         :param str ca_certificate: PEM representation of the trusted CA's x509
                certificate.
+        :param bool cascadable_replica: Specifies if the replica is a cascadable replica. If true, instance must be in different region from primary.
+               
+               > **NOTE:** Only supported for SQL Server database.
         :param str client_certificate: PEM representation of the replica's x509
                certificate.
         :param str client_key: PEM representation of the replica's private key. The
@@ -321,6 +327,8 @@ class DatabaseInstanceReplicaConfiguration(dict):
         """
         if ca_certificate is not None:
             pulumi.set(__self__, "ca_certificate", ca_certificate)
+        if cascadable_replica is not None:
+            pulumi.set(__self__, "cascadable_replica", cascadable_replica)
         if client_certificate is not None:
             pulumi.set(__self__, "client_certificate", client_certificate)
         if client_key is not None:
@@ -351,6 +359,16 @@ class DatabaseInstanceReplicaConfiguration(dict):
         """
         return pulumi.get(self, "ca_certificate")
 
+    @property
+    @pulumi.getter(name="cascadableReplica")
+    def cascadable_replica(self) -> Optional[bool]:
+        """
+        Specifies if the replica is a cascadable replica. If true, instance must be in different region from primary.
+
+        > **NOTE:** Only supported for SQL Server database.
+        """
+        return pulumi.get(self, "cascadable_replica")
+
     @property
     @pulumi.getter(name="clientCertificate")
     def client_certificate(self) -> Optional[str]:
@@ -2324,6 +2342,7 @@ class GetDatabaseInstanceIpAddressResult(dict):
 class GetDatabaseInstanceReplicaConfigurationResult(dict):
     def __init__(__self__, *,
                  ca_certificate: str,
+                 cascadable_replica: bool,
                  client_certificate: str,
                  client_key: str,
                  connect_retry_interval: int,
@@ -2336,6 +2355,7 @@ class GetDatabaseInstanceReplicaConfigurationResult(dict):
                  verify_server_certificate: bool):
         """
         :param str ca_certificate: PEM representation of the trusted CA's x509 certificate.
+        :param bool cascadable_replica: Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.
         :param str client_certificate: PEM representation of the replica's x509 certificate.
         :param str client_key: PEM representation of the replica's private key. The corresponding public key in encoded in the client_certificate.
         :param int connect_retry_interval: The number of seconds between connect retries. MySQL's default is 60 seconds.
@@ -2348,6 +2368,7 @@ class GetDatabaseInstanceReplicaConfigurationResult(dict):
         :param bool verify_server_certificate: True if the master's common name value is checked during the SSL handshake.
         """
         pulumi.set(__self__, "ca_certificate", ca_certificate)
+        pulumi.set(__self__, "cascadable_replica", cascadable_replica)
         pulumi.set(__self__, "client_certificate", client_certificate)
         pulumi.set(__self__, "client_key", client_key)
         pulumi.set(__self__, "connect_retry_interval", connect_retry_interval)
@@ -2367,6 +2388,14 @@ class GetDatabaseInstanceReplicaConfigurationResult(dict):
         """
         return pulumi.get(self, "ca_certificate")
 
+    @property
+    @pulumi.getter(name="cascadableReplica")
+    def cascadable_replica(self) -> bool:
+        """
+        Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.
+        """
+        return pulumi.get(self, "cascadable_replica")
+
     @property
     @pulumi.getter(name="clientCertificate")
     def client_certificate(self) -> str:
@@ -3511,6 +3540,7 @@ class GetDatabaseInstancesInstanceResult(dict):
                  public_ip_address: str,
                  region: str,
                  replica_configurations: Sequence['outputs.GetDatabaseInstancesInstanceReplicaConfigurationResult'],
+                 replica_names: Sequence[str],
                  restore_backup_contexts: Sequence['outputs.GetDatabaseInstancesInstanceRestoreBackupContextResult'],
                  root_password: str,
                  self_link: str,
@@ -3530,6 +3560,7 @@ class GetDatabaseInstancesInstanceResult(dict):
         :param str psc_service_attachment_link: The link to service attachment of PSC instance.
         :param str region: To filter out the Cloud SQL instances which are located in the specified region.
         :param Sequence['GetDatabaseInstancesInstanceReplicaConfigurationArgs'] replica_configurations: The configuration for replication.
+        :param Sequence[str] replica_names: The replicas of the instance.
         :param str root_password: Initial root password. Required for MS SQL Server.
         :param str self_link: The URI of the created resource.
         :param str service_account_email_address: The service account email address assigned to the instance.
@@ -3554,6 +3585,7 @@ class GetDatabaseInstancesInstanceResult(dict):
         pulumi.set(__self__, "public_ip_address", public_ip_address)
         pulumi.set(__self__, "region", region)
         pulumi.set(__self__, "replica_configurations", replica_configurations)
+        pulumi.set(__self__, "replica_names", replica_names)
         pulumi.set(__self__, "restore_backup_contexts", restore_backup_contexts)
         pulumi.set(__self__, "root_password", root_password)
         pulumi.set(__self__, "self_link", self_link)
@@ -3692,6 +3724,14 @@ class GetDatabaseInstancesInstanceResult(dict):
         """
         return pulumi.get(self, "replica_configurations")
 
+    @property
+    @pulumi.getter(name="replicaNames")
+    def replica_names(self) -> Sequence[str]:
+        """
+        The replicas of the instance.
+        """
+        return pulumi.get(self, "replica_names")
+
     @property
     @pulumi.getter(name="restoreBackupContexts")
     def restore_backup_contexts(self) -> Sequence['outputs.GetDatabaseInstancesInstanceRestoreBackupContextResult']:
@@ -3827,6 +3867,7 @@ class GetDatabaseInstancesInstanceIpAddressResult(dict):
 class GetDatabaseInstancesInstanceReplicaConfigurationResult(dict):
     def __init__(__self__, *,
                  ca_certificate: str,
+                 cascadable_replica: bool,
                  client_certificate: str,
                  client_key: str,
                  connect_retry_interval: int,
@@ -3839,6 +3880,7 @@ class GetDatabaseInstancesInstanceReplicaConfigurationResult(dict):
                  verify_server_certificate: bool):
         """
         :param str ca_certificate: PEM representation of the trusted CA's x509 certificate.
+        :param bool cascadable_replica: Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.
         :param str client_certificate: PEM representation of the replica's x509 certificate.
         :param str client_key: PEM representation of the replica's private key. The corresponding public key in encoded in the client_certificate.
         :param int connect_retry_interval: The number of seconds between connect retries. MySQL's default is 60 seconds.
@@ -3851,6 +3893,7 @@ class GetDatabaseInstancesInstanceReplicaConfigurationResult(dict):
         :param bool verify_server_certificate: True if the master's common name value is checked during the SSL handshake.
         """
         pulumi.set(__self__, "ca_certificate", ca_certificate)
+        pulumi.set(__self__, "cascadable_replica", cascadable_replica)
         pulumi.set(__self__, "client_certificate", client_certificate)
         pulumi.set(__self__, "client_key", client_key)
         pulumi.set(__self__, "connect_retry_interval", connect_retry_interval)
@@ -3870,6 +3913,14 @@ class GetDatabaseInstancesInstanceReplicaConfigurationResult(dict):
         """
         return pulumi.get(self, "ca_certificate")
 
+    @property
+    @pulumi.getter(name="cascadableReplica")
+    def cascadable_replica(self) -> bool:
+        """
+        Specifies if a SQL Server replica is a cascadable replica. A cascadable replica is a SQL Server cross region replica that supports replica(s) under it.
+        """
+        return pulumi.get(self, "cascadable_replica")
+
     @property
     @pulumi.getter(name="clientCertificate")
     def client_certificate(self) -> str:

pulumi_gcp/storage/_inputs.py

@@ -1683,7 +1683,7 @@ if not MYPY:
         """
         storage_filters: NotRequired[pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgsDict']]
         """
-        A nested object resource
+        A nested object resource.
         Structure is documented below.
         """
 elif False:
@@ -1699,7 +1699,7 @@ class InsightsReportConfigObjectMetadataReportOptionsArgs:
         :param pulumi.Input[Sequence[pulumi.Input[str]]] metadata_fields: The metadata fields included in an inventory report.
         :param pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsStorageDestinationOptionsArgs'] storage_destination_options: Options for where the inventory reports are stored.
                Structure is documented below.
-        :param pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs'] storage_filters: A nested object resource
+        :param pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs'] storage_filters: A nested object resource.
                Structure is documented below.
         """
         pulumi.set(__self__, "metadata_fields", metadata_fields)
@@ -1736,7 +1736,7 @@ class InsightsReportConfigObjectMetadataReportOptionsArgs:
     @pulumi.getter(name="storageFilters")
     def storage_filters(self) -> Optional[pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs']]:
         """
-        A nested object resource
+        A nested object resource.
         Structure is documented below.
         """
         return pulumi.get(self, "storage_filters")

pulumi_gcp/storage/outputs.py

@@ -1338,7 +1338,7 @@ class InsightsReportConfigObjectMetadataReportOptions(dict):
         :param Sequence[str] metadata_fields: The metadata fields included in an inventory report.
         :param 'InsightsReportConfigObjectMetadataReportOptionsStorageDestinationOptionsArgs' storage_destination_options: Options for where the inventory reports are stored.
                Structure is documented below.
-        :param 'InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs' storage_filters: A nested object resource
+        :param 'InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs' storage_filters: A nested object resource.
                Structure is documented below.
         """
         pulumi.set(__self__, "metadata_fields", metadata_fields)
@@ -1367,7 +1367,7 @@ class InsightsReportConfigObjectMetadataReportOptions(dict):
     @pulumi.getter(name="storageFilters")
     def storage_filters(self) -> Optional['outputs.InsightsReportConfigObjectMetadataReportOptionsStorageFilters']:
         """
-        A nested object resource
+        A nested object resource.
         Structure is documented below.
         """
         return pulumi.get(self, "storage_filters")