pulumi-gcp 7.12.0a1709074764__py3-none-any.whl → 7.12.0a1709133800__py3-none-any.whl

pulumi_gcp/sql/database_instance.py

@@ -817,6 +817,7 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         main = gcp.sql.DatabaseInstance("main",
+            name="main-instance",
             database_version="POSTGRES_15",
             region="us-central1",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
@@ -831,20 +832,20 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
         import pulumi_random as random
 
-        private_network = gcp.compute.Network("privateNetwork", opts=pulumi.ResourceOptions(provider=google_beta))
-        private_ip_address = gcp.compute.GlobalAddress("privateIpAddress",
+        private_network = gcp.compute.Network("private_network", name="private-network")
+        private_ip_address = gcp.compute.GlobalAddress("private_ip_address",
+            name="private-ip-address",
             purpose="VPC_PEERING",
             address_type="INTERNAL",
             prefix_length=16,
-            network=private_network.id,
-            opts=pulumi.ResourceOptions(provider=google_beta))
-        private_vpc_connection = gcp.servicenetworking.Connection("privateVpcConnection",
+            network=private_network.id)
+        private_vpc_connection = gcp.servicenetworking.Connection("private_vpc_connection",
             network=private_network.id,
             service="servicenetworking.googleapis.com",
-            reserved_peering_ranges=[private_ip_address.name],
-            opts=pulumi.ResourceOptions(provider=google_beta))
-        db_name_suffix = random.RandomId("dbNameSuffix", byte_length=4)
+            reserved_peering_ranges=[private_ip_address.name])
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
         instance = gcp.sql.DatabaseInstance("instance",
+            name=db_name_suffix.hex.apply(lambda hex: f"private-instance-{hex}"),
             region="us-central1",
             database_version="MYSQL_5_7",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
@@ -854,9 +855,7 @@ class DatabaseInstance(pulumi.CustomResource):
                     private_network=private_network.id,
                     enable_private_path_for_google_cloud_services=True,
                 ),
-            ),
-            opts=pulumi.ResourceOptions(provider=google_beta,
-                depends_on=[private_vpc_connection]))
+            ))
         ```
         ### ENTERPRISE_PLUS Instance with data_cache_config
 
@@ -865,13 +864,39 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         main = gcp.sql.DatabaseInstance("main",
+            name="enterprise-plus-main-instance",
             database_version="MYSQL_8_0_31",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-perf-optimized-N-2",
+                edition="ENTERPRISE_PLUS",
                 data_cache_config=gcp.sql.DatabaseInstanceSettingsDataCacheConfigArgs(
                     data_cache_enabled=True,
                 ),
-                edition="ENTERPRISE_PLUS",
-                tier="db-perf-optimized-N-2",
+            ))
+        ```
+        ### Cloud SQL Instance with PSC connectivity
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        main = gcp.sql.DatabaseInstance("main",
+            name="psc-enabled-main-instance",
+            database_version="MYSQL_8_0",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                ip_configuration=gcp.sql.DatabaseInstanceSettingsIpConfigurationArgs(
+                    psc_configs=[gcp.sql.DatabaseInstanceSettingsIpConfigurationPscConfigArgs(
+                        psc_enabled=True,
+                        allowed_consumer_projects=["allowed-consumer-project-name"],
+                    )],
+                    ipv4_enabled=False,
+                ),
+                backup_configuration=gcp.sql.DatabaseInstanceSettingsBackupConfigurationArgs(
+                    enabled=True,
+                    binary_log_enabled=True,
+                ),
+                availability_type="REGIONAL",
             ))
         ```
 
@@ -981,6 +1006,7 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         main = gcp.sql.DatabaseInstance("main",
+            name="main-instance",
             database_version="POSTGRES_15",
             region="us-central1",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
@@ -995,20 +1021,20 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
         import pulumi_random as random
 
-        private_network = gcp.compute.Network("privateNetwork", opts=pulumi.ResourceOptions(provider=google_beta))
-        private_ip_address = gcp.compute.GlobalAddress("privateIpAddress",
+        private_network = gcp.compute.Network("private_network", name="private-network")
+        private_ip_address = gcp.compute.GlobalAddress("private_ip_address",
+            name="private-ip-address",
             purpose="VPC_PEERING",
             address_type="INTERNAL",
             prefix_length=16,
-            network=private_network.id,
-            opts=pulumi.ResourceOptions(provider=google_beta))
-        private_vpc_connection = gcp.servicenetworking.Connection("privateVpcConnection",
+            network=private_network.id)
+        private_vpc_connection = gcp.servicenetworking.Connection("private_vpc_connection",
             network=private_network.id,
             service="servicenetworking.googleapis.com",
-            reserved_peering_ranges=[private_ip_address.name],
-            opts=pulumi.ResourceOptions(provider=google_beta))
-        db_name_suffix = random.RandomId("dbNameSuffix", byte_length=4)
+            reserved_peering_ranges=[private_ip_address.name])
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
         instance = gcp.sql.DatabaseInstance("instance",
+            name=db_name_suffix.hex.apply(lambda hex: f"private-instance-{hex}"),
             region="us-central1",
             database_version="MYSQL_5_7",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
@@ -1018,9 +1044,7 @@ class DatabaseInstance(pulumi.CustomResource):
                     private_network=private_network.id,
                     enable_private_path_for_google_cloud_services=True,
                 ),
-            ),
-            opts=pulumi.ResourceOptions(provider=google_beta,
-                depends_on=[private_vpc_connection]))
+            ))
         ```
         ### ENTERPRISE_PLUS Instance with data_cache_config
 
@@ -1029,13 +1053,39 @@ class DatabaseInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         main = gcp.sql.DatabaseInstance("main",
+            name="enterprise-plus-main-instance",
             database_version="MYSQL_8_0_31",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-perf-optimized-N-2",
+                edition="ENTERPRISE_PLUS",
                 data_cache_config=gcp.sql.DatabaseInstanceSettingsDataCacheConfigArgs(
                     data_cache_enabled=True,
                 ),
-                edition="ENTERPRISE_PLUS",
-                tier="db-perf-optimized-N-2",
+            ))
+        ```
+        ### Cloud SQL Instance with PSC connectivity
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        main = gcp.sql.DatabaseInstance("main",
+            name="psc-enabled-main-instance",
+            database_version="MYSQL_8_0",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                ip_configuration=gcp.sql.DatabaseInstanceSettingsIpConfigurationArgs(
+                    psc_configs=[gcp.sql.DatabaseInstanceSettingsIpConfigurationPscConfigArgs(
+                        psc_enabled=True,
+                        allowed_consumer_projects=["allowed-consumer-project-name"],
+                    )],
+                    ipv4_enabled=False,
+                ),
+                backup_configuration=gcp.sql.DatabaseInstanceSettingsBackupConfigurationArgs(
+                    enabled=True,
+                    binary_log_enabled=True,
+                ),
+                availability_type="REGIONAL",
             ))
         ```
 

pulumi_gcp/sql/get_backup_run.py

@@ -131,7 +131,7 @@ def get_backup_run(backup_id: Optional[int] = None,
     import pulumi
     import pulumi_gcp as gcp
 
-    backup = gcp.sql.get_backup_run(instance=google_sql_database_instance["main"]["name"],
+    backup = gcp.sql.get_backup_run(instance=main["name"],
         most_recent=True)
     ```
 
@@ -178,7 +178,7 @@ def get_backup_run_output(backup_id: Optional[pulumi.Input[Optional[int]]] = Non
     import pulumi
     import pulumi_gcp as gcp
 
-    backup = gcp.sql.get_backup_run(instance=google_sql_database_instance["main"]["name"],
+    backup = gcp.sql.get_backup_run(instance=main["name"],
         most_recent=True)
     ```
 

pulumi_gcp/sql/get_ca_certs.py

@@ -96,6 +96,22 @@ def get_ca_certs(instance: Optional[str] = None,
     and
     [API](https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/instances/listServerCas).
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+
+    def not_implemented(msg):
+        raise NotImplementedError(msg)
+
+    ca_certs = gcp.sql.get_ca_certs(instance="primary-database-server")
+    furthest_expiration_time = not_implemented("reverse(sort([fork,vindata.google_sql_ca_certs.ca_certs.certs:v.expiration_time]))")[0]
+    latest_ca_cert = [v.cert for v in ca_certs.certs if v.expiration_time == furthest_expiration_time]
+    pulumi.export("dbLatestCaCert", latest_ca_cert)
+    ```
+
 
     :param str instance: The name or self link of the instance.
     :param str project: The ID of the project in which the resource belongs. If `project` is not provided, the provider project is used.
@@ -124,6 +140,22 @@ def get_ca_certs_output(instance: Optional[pulumi.Input[str]] = None,
     and
     [API](https://cloud.google.com/sql/docs/mysql/admin-api/rest/v1beta4/instances/listServerCas).
 
+    ## Example Usage
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+
+    def not_implemented(msg):
+        raise NotImplementedError(msg)
+
+    ca_certs = gcp.sql.get_ca_certs(instance="primary-database-server")
+    furthest_expiration_time = not_implemented("reverse(sort([fork,vindata.google_sql_ca_certs.ca_certs.certs:v.expiration_time]))")[0]
+    latest_ca_cert = [v.cert for v in ca_certs.certs if v.expiration_time == furthest_expiration_time]
+    pulumi.export("dbLatestCaCert", latest_ca_cert)
+    ```
+
 
     :param str instance: The name or self link of the instance.
     :param str project: The ID of the project in which the resource belongs. If `project` is not provided, the provider project is used.

pulumi_gcp/sql/get_database.py

@@ -121,7 +121,7 @@ def get_database(instance: Optional[str] = None,
     import pulumi_gcp as gcp
 
     qa = gcp.sql.get_database(name="test-sql-database",
-        instance=google_sql_database_instance["main"]["name"])
+        instance=main["name"])
     ```
 
 
@@ -162,7 +162,7 @@ def get_database_output(instance: Optional[pulumi.Input[str]] = None,
     import pulumi_gcp as gcp
 
     qa = gcp.sql.get_database(name="test-sql-database",
-        instance=google_sql_database_instance["main"]["name"])
+        instance=main["name"])
     ```
 
 

pulumi_gcp/sql/get_databases.py

@@ -83,7 +83,7 @@ def get_databases(instance: Optional[str] = None,
     import pulumi
     import pulumi_gcp as gcp
 
-    qa = gcp.sql.get_databases(instance=google_sql_database_instance["main"]["name"])
+    qa = gcp.sql.get_databases(instance=main["name"])
     ```
 
 
@@ -117,7 +117,7 @@ def get_databases_output(instance: Optional[pulumi.Input[str]] = None,
     import pulumi
     import pulumi_gcp as gcp
 
-    qa = gcp.sql.get_databases(instance=google_sql_database_instance["main"]["name"])
+    qa = gcp.sql.get_databases(instance=main["name"])
     ```
 
 

pulumi_gcp/sql/source_representation_instance.py

@@ -474,13 +474,14 @@ class SourceRepresentationInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         instance = gcp.sql.SourceRepresentationInstance("instance",
+            name="my-instance",
+            region="us-central1",
             database_version="MYSQL_8_0",
-            dump_file_path="gs://replica-bucket/source-database.sql.gz",
             host="10.20.30.40",
-            password="password-for-the-user",
             port=3306,
-            region="us-central1",
-            username="some-user")
+            username="some-user",
+            password="password-for-the-user",
+            dump_file_path="gs://replica-bucket/source-database.sql.gz")
         ```
         ### Sql Source Representation Instance Postgres
 
@@ -489,13 +490,14 @@ class SourceRepresentationInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         instance = gcp.sql.SourceRepresentationInstance("instance",
+            name="my-instance",
+            region="us-central1",
             database_version="POSTGRES_9_6",
-            dump_file_path="gs://replica-bucket/source-database.sql.gz",
             host="10.20.30.40",
-            password="password-for-the-user",
             port=3306,
-            region="us-central1",
-            username="some-user")
+            username="some-user",
+            password="password-for-the-user",
+            dump_file_path="gs://replica-bucket/source-database.sql.gz")
         ```
 
         ## Import
@@ -566,13 +568,14 @@ class SourceRepresentationInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         instance = gcp.sql.SourceRepresentationInstance("instance",
+            name="my-instance",
+            region="us-central1",
             database_version="MYSQL_8_0",
-            dump_file_path="gs://replica-bucket/source-database.sql.gz",
             host="10.20.30.40",
-            password="password-for-the-user",
             port=3306,
-            region="us-central1",
-            username="some-user")
+            username="some-user",
+            password="password-for-the-user",
+            dump_file_path="gs://replica-bucket/source-database.sql.gz")
         ```
         ### Sql Source Representation Instance Postgres
 
@@ -581,13 +584,14 @@ class SourceRepresentationInstance(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         instance = gcp.sql.SourceRepresentationInstance("instance",
+            name="my-instance",
+            region="us-central1",
             database_version="POSTGRES_9_6",
-            dump_file_path="gs://replica-bucket/source-database.sql.gz",
             host="10.20.30.40",
-            password="password-for-the-user",
             port=3306,
-            region="us-central1",
-            username="some-user")
+            username="some-user",
+            password="password-for-the-user",
+            dump_file_path="gs://replica-bucket/source-database.sql.gz")
         ```
 
         ## Import

pulumi_gcp/sql/ssl_cert.py

@@ -270,13 +270,14 @@ class SslCert(pulumi.CustomResource):
         import pulumi_gcp as gcp
         import pulumi_random as random
 
-        db_name_suffix = random.RandomId("dbNameSuffix", byte_length=4)
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
         main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
             database_version="MYSQL_5_7",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
                 tier="db-f1-micro",
             ))
-        client_cert = gcp.sql.SslCert("clientCert",
+        client_cert = gcp.sql.SslCert("client_cert",
             common_name="client-name",
             instance=main.name)
         ```
@@ -312,13 +313,14 @@ class SslCert(pulumi.CustomResource):
         import pulumi_gcp as gcp
         import pulumi_random as random
 
-        db_name_suffix = random.RandomId("dbNameSuffix", byte_length=4)
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
         main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
             database_version="MYSQL_5_7",
             settings=gcp.sql.DatabaseInstanceSettingsArgs(
                 tier="db-f1-micro",
             ))
-        client_cert = gcp.sql.SslCert("clientCert",
+        client_cert = gcp.sql.SslCert("client_cert",
             common_name="client-name",
             instance=main.name)
         ```

pulumi_gcp/sql/user.py

@@ -369,6 +369,83 @@ class User(pulumi.CustomResource):
         """
         Creates a new Google SQL User on a Google SQL User Instance. For more information, see the [official documentation](https://cloud.google.com/sql/), or the [JSON API](https://cloud.google.com/sql/docs/admin-api/v1beta4/users).
 
+        ## Example Usage
+
+        Example creating a SQL User.
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="MYSQL_5_7",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+            ))
+        users = gcp.sql.User("users",
+            name="me",
+            instance=main.name,
+            host="me.com",
+            password="changeme")
+        ```
+
+        Example using [Cloud SQL IAM database authentication](https://cloud.google.com/sql/docs/mysql/authentication).
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+        import pulumi_std as std
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="POSTGRES_15",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                database_flags=[gcp.sql.DatabaseInstanceSettingsDatabaseFlagArgs(
+                    name="cloudsql.iam_authentication",
+                    value="on",
+                )],
+            ))
+        iam_user = gcp.sql.User("iam_user",
+            name="me@example.com",
+            instance=main.name,
+            type="CLOUD_IAM_USER")
+        iam_service_account_user = gcp.sql.User("iam_service_account_user",
+            name=std.trimsuffix(input=service_account["email"],
+                suffix=".gserviceaccount.com").result,
+            instance=main.name,
+            type="CLOUD_IAM_SERVICE_ACCOUNT")
+        ```
+
+        Example using [Cloud SQL IAM Group authentication](https://cloud.google.com/sql/docs/mysql/iam-authentication#iam-group-auth).
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="MYSQL_8_0",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                database_flags=[gcp.sql.DatabaseInstanceSettingsDatabaseFlagArgs(
+                    name="cloudsql.iam_authentication",
+                    value="on",
+                )],
+            ))
+        iam_group_user = gcp.sql.User("iam_group_user",
+            name="iam_group@example.com",
+            instance=main.name,
+            type="CLOUD_IAM_GROUP")
+        ```
+
         ## Import
 
         SQL users for MySQL databases can be imported using the `project`, `instance`, `host` and `name`, e.g.
@@ -428,6 +505,83 @@ class User(pulumi.CustomResource):
         """
         Creates a new Google SQL User on a Google SQL User Instance. For more information, see the [official documentation](https://cloud.google.com/sql/), or the [JSON API](https://cloud.google.com/sql/docs/admin-api/v1beta4/users).
 
+        ## Example Usage
+
+        Example creating a SQL User.
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="MYSQL_5_7",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+            ))
+        users = gcp.sql.User("users",
+            name="me",
+            instance=main.name,
+            host="me.com",
+            password="changeme")
+        ```
+
+        Example using [Cloud SQL IAM database authentication](https://cloud.google.com/sql/docs/mysql/authentication).
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+        import pulumi_std as std
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="POSTGRES_15",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                database_flags=[gcp.sql.DatabaseInstanceSettingsDatabaseFlagArgs(
+                    name="cloudsql.iam_authentication",
+                    value="on",
+                )],
+            ))
+        iam_user = gcp.sql.User("iam_user",
+            name="me@example.com",
+            instance=main.name,
+            type="CLOUD_IAM_USER")
+        iam_service_account_user = gcp.sql.User("iam_service_account_user",
+            name=std.trimsuffix(input=service_account["email"],
+                suffix=".gserviceaccount.com").result,
+            instance=main.name,
+            type="CLOUD_IAM_SERVICE_ACCOUNT")
+        ```
+
+        Example using [Cloud SQL IAM Group authentication](https://cloud.google.com/sql/docs/mysql/iam-authentication#iam-group-auth).
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+        import pulumi_random as random
+
+        db_name_suffix = random.RandomId("db_name_suffix", byte_length=4)
+        main = gcp.sql.DatabaseInstance("main",
+            name=db_name_suffix.hex.apply(lambda hex: f"main-instance-{hex}"),
+            database_version="MYSQL_8_0",
+            settings=gcp.sql.DatabaseInstanceSettingsArgs(
+                tier="db-f1-micro",
+                database_flags=[gcp.sql.DatabaseInstanceSettingsDatabaseFlagArgs(
+                    name="cloudsql.iam_authentication",
+                    value="on",
+                )],
+            ))
+        iam_group_user = gcp.sql.User("iam_group_user",
+            name="iam_group@example.com",
+            instance=main.name,
+            type="CLOUD_IAM_GROUP")
+        ```
+
         ## Import
 
         SQL users for MySQL databases can be imported using the `project`, `instance`, `host` and `name`, e.g.