pulumi-gcp 7.12.0a1709102105__py3-none-any.whl → 7.12.0a1709149267__py3-none-any.whl

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.

pulumi_gcp/storage/bucket.py

@@ -833,8 +833,16 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         static_site = gcp.storage.Bucket("static-site",
+            name="image-store.com",
+            location="EU",
+            force_destroy=True,
+            uniform_bucket_level_access=True,
+            website=gcp.storage.BucketWebsiteArgs(
+                main_page_suffix="index.html",
+                not_found_page="404.html",
+            ),
             cors=[gcp.storage.BucketCorArgs(
-                max_age_seconds=3600,
+                origins=["http://image-store.com"],
                 methods=[
                     "GET",
                     "HEAD",
@@ -842,16 +850,9 @@ class Bucket(pulumi.CustomResource):
                     "POST",
                     "DELETE",
                 ],
-                origins=["http://image-store.com"],
                 response_headers=["*"],
-            )],
-            force_destroy=True,
-            location="EU",
-            uniform_bucket_level_access=True,
-            website=gcp.storage.BucketWebsiteArgs(
-                main_page_suffix="index.html",
-                not_found_page="404.html",
-            ))
+                max_age_seconds=3600,
+            )])
         ```
         ### Life Cycle Settings For Storage Bucket Objects
 
@@ -860,26 +861,27 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         auto_expire = gcp.storage.Bucket("auto-expire",
+            name="auto-expiring-bucket",
+            location="US",
             force_destroy=True,
             lifecycle_rules=[
                 gcp.storage.BucketLifecycleRuleArgs(
-                    action=gcp.storage.BucketLifecycleRuleActionArgs(
-                        type="Delete",
-                    ),
                     condition=gcp.storage.BucketLifecycleRuleConditionArgs(
                         age=3,
                     ),
-                ),
-                gcp.storage.BucketLifecycleRuleArgs(
                     action=gcp.storage.BucketLifecycleRuleActionArgs(
-                        type="AbortIncompleteMultipartUpload",
+                        type="Delete",
                     ),
+                ),
+                gcp.storage.BucketLifecycleRuleArgs(
                     condition=gcp.storage.BucketLifecycleRuleConditionArgs(
                         age=1,
                     ),
+                    action=gcp.storage.BucketLifecycleRuleActionArgs(
+                        type="AbortIncompleteMultipartUpload",
+                    ),
                 ),
-            ],
-            location="US")
+            ])
         ```
         ### Enabling Public Access Prevention
 
@@ -888,8 +890,9 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         auto_expire = gcp.storage.Bucket("auto-expire",
-            force_destroy=True,
+            name="no-public-access-bucket",
             location="US",
+            force_destroy=True,
             public_access_prevention="enforced")
         ```
 
@@ -980,8 +983,16 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         static_site = gcp.storage.Bucket("static-site",
+            name="image-store.com",
+            location="EU",
+            force_destroy=True,
+            uniform_bucket_level_access=True,
+            website=gcp.storage.BucketWebsiteArgs(
+                main_page_suffix="index.html",
+                not_found_page="404.html",
+            ),
             cors=[gcp.storage.BucketCorArgs(
-                max_age_seconds=3600,
+                origins=["http://image-store.com"],
                 methods=[
                     "GET",
                     "HEAD",
@@ -989,16 +1000,9 @@ class Bucket(pulumi.CustomResource):
                     "POST",
                     "DELETE",
                 ],
-                origins=["http://image-store.com"],
                 response_headers=["*"],
-            )],
-            force_destroy=True,
-            location="EU",
-            uniform_bucket_level_access=True,
-            website=gcp.storage.BucketWebsiteArgs(
-                main_page_suffix="index.html",
-                not_found_page="404.html",
-            ))
+                max_age_seconds=3600,
+            )])
         ```
         ### Life Cycle Settings For Storage Bucket Objects
 
@@ -1007,26 +1011,27 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         auto_expire = gcp.storage.Bucket("auto-expire",
+            name="auto-expiring-bucket",
+            location="US",
             force_destroy=True,
             lifecycle_rules=[
                 gcp.storage.BucketLifecycleRuleArgs(
-                    action=gcp.storage.BucketLifecycleRuleActionArgs(
-                        type="Delete",
-                    ),
                     condition=gcp.storage.BucketLifecycleRuleConditionArgs(
                         age=3,
                     ),
-                ),
-                gcp.storage.BucketLifecycleRuleArgs(
                     action=gcp.storage.BucketLifecycleRuleActionArgs(
-                        type="AbortIncompleteMultipartUpload",
+                        type="Delete",
                     ),
+                ),
+                gcp.storage.BucketLifecycleRuleArgs(
                     condition=gcp.storage.BucketLifecycleRuleConditionArgs(
                         age=1,
                     ),
+                    action=gcp.storage.BucketLifecycleRuleActionArgs(
+                        type="AbortIncompleteMultipartUpload",
+                    ),
                 ),
-            ],
-            location="US")
+            ])
         ```
         ### Enabling Public Access Prevention
 
@@ -1035,8 +1040,9 @@ class Bucket(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         auto_expire = gcp.storage.Bucket("auto-expire",
-            force_destroy=True,
+            name="no-public-access-bucket",
             location="US",
+            force_destroy=True,
             public_access_prevention="enforced")
         ```
 

pulumi_gcp/storage/bucket_access_control.py

@@ -265,8 +265,10 @@ class BucketAccessControl(pulumi.CustomResource):
         import pulumi
         import pulumi_gcp as gcp
 
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        public_rule = gcp.storage.BucketAccessControl("publicRule",
+        bucket = gcp.storage.Bucket("bucket",
+            name="static-content-bucket",
+            location="US")
+        public_rule = gcp.storage.BucketAccessControl("public_rule",
             bucket=bucket.name,
             role="READER",
             entity="allUsers")
@@ -345,8 +347,10 @@ class BucketAccessControl(pulumi.CustomResource):
         import pulumi
         import pulumi_gcp as gcp
 
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        public_rule = gcp.storage.BucketAccessControl("publicRule",
+        bucket = gcp.storage.Bucket("bucket",
+            name="static-content-bucket",
+            location="US")
+        public_rule = gcp.storage.BucketAccessControl("public_rule",
             bucket=bucket.name,
             role="READER",
             entity="allUsers")

pulumi_gcp/storage/bucket_acl.py

@@ -192,7 +192,9 @@ class BucketACL(pulumi.CustomResource):
         import pulumi
         import pulumi_gcp as gcp
 
-        image_store = gcp.storage.Bucket("image-store", location="EU")
+        image_store = gcp.storage.Bucket("image-store",
+            name="image-store-bucket",
+            location="EU")
         image_store_acl = gcp.storage.BucketACL("image-store-acl",
             bucket=image_store.name,
             role_entities=[
@@ -240,7 +242,9 @@ class BucketACL(pulumi.CustomResource):
         import pulumi
         import pulumi_gcp as gcp
 
-        image_store = gcp.storage.Bucket("image-store", location="EU")
+        image_store = gcp.storage.Bucket("image-store",
+            name="image-store-bucket",
+            location="EU")
         image_store_acl = gcp.storage.BucketACL("image-store-acl",
             bucket=image_store.name,
             role_entities=[

pulumi_gcp/storage/bucket_iam_binding.py

@@ -260,7 +260,7 @@ class BucketIAMBinding(pulumi.CustomResource):
             members=["user:jane@example.com"],
         )])
         policy = gcp.storage.BucketIAMPolicy("policy",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             policy_data=admin.policy_data)
         ```
 
@@ -280,7 +280,7 @@ class BucketIAMBinding(pulumi.CustomResource):
             ),
         )])
         policy = gcp.storage.BucketIAMPolicy("policy",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             policy_data=admin.policy_data)
         ```
         ## google\\_storage\\_bucket\\_iam\\_binding
@@ -290,7 +290,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         binding = gcp.storage.BucketIAMBinding("binding",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             members=["user:jane@example.com"])
         ```
@@ -302,7 +302,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         binding = gcp.storage.BucketIAMBinding("binding",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             members=["user:jane@example.com"],
             condition=gcp.storage.BucketIAMBindingConditionArgs(
@@ -318,7 +318,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         member = gcp.storage.BucketIAMMember("member",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             member="user:jane@example.com")
         ```
@@ -330,7 +330,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         member = gcp.storage.BucketIAMMember("member",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             member="user:jane@example.com",
             condition=gcp.storage.BucketIAMMemberConditionArgs(
@@ -429,7 +429,7 @@ class BucketIAMBinding(pulumi.CustomResource):
             members=["user:jane@example.com"],
         )])
         policy = gcp.storage.BucketIAMPolicy("policy",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             policy_data=admin.policy_data)
         ```
 
@@ -449,7 +449,7 @@ class BucketIAMBinding(pulumi.CustomResource):
             ),
         )])
         policy = gcp.storage.BucketIAMPolicy("policy",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             policy_data=admin.policy_data)
         ```
         ## google\\_storage\\_bucket\\_iam\\_binding
@@ -459,7 +459,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         binding = gcp.storage.BucketIAMBinding("binding",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             members=["user:jane@example.com"])
         ```
@@ -471,7 +471,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         binding = gcp.storage.BucketIAMBinding("binding",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             members=["user:jane@example.com"],
             condition=gcp.storage.BucketIAMBindingConditionArgs(
@@ -487,7 +487,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         member = gcp.storage.BucketIAMMember("member",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             member="user:jane@example.com")
         ```
@@ -499,7 +499,7 @@ class BucketIAMBinding(pulumi.CustomResource):
         import pulumi_gcp as gcp
 
         member = gcp.storage.BucketIAMMember("member",
-            bucket=google_storage_bucket["default"]["name"],
+            bucket=default["name"],
             role="roles/storage.admin",
             member="user:jane@example.com",
             condition=gcp.storage.BucketIAMMemberConditionArgs(