pulumi-gcp 6.68.0a1698127103__py3-none-any.whl → 6.68.0a1698199636__py3-none-any.whl

pulumi_gcp/storage/insights_report_config.py

@@ -48,13 +48,27 @@ class InsightsReportConfigArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             csv_options: pulumi.Input['InsightsReportConfigCsvOptionsArgs'],
-             location: pulumi.Input[str],
+             csv_options: Optional[pulumi.Input['InsightsReportConfigCsvOptionsArgs']] = None,
+             location: Optional[pulumi.Input[str]] = None,
              display_name: Optional[pulumi.Input[str]] = None,
              frequency_options: Optional[pulumi.Input['InsightsReportConfigFrequencyOptionsArgs']] = None,
              object_metadata_report_options: Optional[pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsArgs']] = None,
              project: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if csv_options is None and 'csvOptions' in kwargs:
+            csv_options = kwargs['csvOptions']
+        if csv_options is None:
+            raise TypeError("Missing 'csv_options' argument")
+        if location is None:
+            raise TypeError("Missing 'location' argument")
+        if display_name is None and 'displayName' in kwargs:
+            display_name = kwargs['displayName']
+        if frequency_options is None and 'frequencyOptions' in kwargs:
+            frequency_options = kwargs['frequencyOptions']
+        if object_metadata_report_options is None and 'objectMetadataReportOptions' in kwargs:
+            object_metadata_report_options = kwargs['objectMetadataReportOptions']
+
         _setter("csv_options", csv_options)
         _setter("location", location)
         if display_name is not None:
@@ -189,7 +203,17 @@ class _InsightsReportConfigState:
              name: Optional[pulumi.Input[str]] = None,
              object_metadata_report_options: Optional[pulumi.Input['InsightsReportConfigObjectMetadataReportOptionsArgs']] = None,
              project: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if csv_options is None and 'csvOptions' in kwargs:
+            csv_options = kwargs['csvOptions']
+        if display_name is None and 'displayName' in kwargs:
+            display_name = kwargs['displayName']
+        if frequency_options is None and 'frequencyOptions' in kwargs:
+            frequency_options = kwargs['frequencyOptions']
+        if object_metadata_report_options is None and 'objectMetadataReportOptions' in kwargs:
+            object_metadata_report_options = kwargs['objectMetadataReportOptions']
+
         if csv_options is not None:
             _setter("csv_options", csv_options)
         if display_name is not None:
@@ -317,57 +341,6 @@ class InsightsReportConfig(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/insights/using-storage-insights)
 
         ## Example Usage
-        ### Storage Insights Report Config
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        project = gcp.organizations.get_project()
-        report_bucket = gcp.storage.Bucket("reportBucket",
-            location="us-central1",
-            force_destroy=True,
-            uniform_bucket_level_access=True)
-        config = gcp.storage.InsightsReportConfig("config",
-            display_name="Test Report Config",
-            location="us-central1",
-            frequency_options=gcp.storage.InsightsReportConfigFrequencyOptionsArgs(
-                frequency="WEEKLY",
-                start_date=gcp.storage.InsightsReportConfigFrequencyOptionsStartDateArgs(
-                    day=15,
-                    month=3,
-                    year=2050,
-                ),
-                end_date=gcp.storage.InsightsReportConfigFrequencyOptionsEndDateArgs(
-                    day=15,
-                    month=4,
-                    year=2050,
-                ),
-            ),
-            csv_options=gcp.storage.InsightsReportConfigCsvOptionsArgs(
-                record_separator="\\n",
-                delimiter=",",
-                header_required=False,
-            ),
-            object_metadata_report_options=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsArgs(
-                metadata_fields=[
-                    "bucket",
-                    "name",
-                    "project",
-                ],
-                storage_filters=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs(
-                    bucket=report_bucket.name,
-                ),
-                storage_destination_options=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsStorageDestinationOptionsArgs(
-                    bucket=report_bucket.name,
-                    destination_path="test-insights-reports",
-                ),
-            ))
-        admin = gcp.storage.BucketIAMMember("admin",
-            bucket=report_bucket.name,
-            role="roles/storage.admin",
-            member=f"serviceAccount:service-{project.number}@gcp-sa-storageinsights.iam.gserviceaccount.com")
-        ```
 
         ## Import
 
@@ -415,57 +388,6 @@ class InsightsReportConfig(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/insights/using-storage-insights)
 
         ## Example Usage
-        ### Storage Insights Report Config
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        project = gcp.organizations.get_project()
-        report_bucket = gcp.storage.Bucket("reportBucket",
-            location="us-central1",
-            force_destroy=True,
-            uniform_bucket_level_access=True)
-        config = gcp.storage.InsightsReportConfig("config",
-            display_name="Test Report Config",
-            location="us-central1",
-            frequency_options=gcp.storage.InsightsReportConfigFrequencyOptionsArgs(
-                frequency="WEEKLY",
-                start_date=gcp.storage.InsightsReportConfigFrequencyOptionsStartDateArgs(
-                    day=15,
-                    month=3,
-                    year=2050,
-                ),
-                end_date=gcp.storage.InsightsReportConfigFrequencyOptionsEndDateArgs(
-                    day=15,
-                    month=4,
-                    year=2050,
-                ),
-            ),
-            csv_options=gcp.storage.InsightsReportConfigCsvOptionsArgs(
-                record_separator="\\n",
-                delimiter=",",
-                header_required=False,
-            ),
-            object_metadata_report_options=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsArgs(
-                metadata_fields=[
-                    "bucket",
-                    "name",
-                    "project",
-                ],
-                storage_filters=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsStorageFiltersArgs(
-                    bucket=report_bucket.name,
-                ),
-                storage_destination_options=gcp.storage.InsightsReportConfigObjectMetadataReportOptionsStorageDestinationOptionsArgs(
-                    bucket=report_bucket.name,
-                    destination_path="test-insights-reports",
-                ),
-            ))
-        admin = gcp.storage.BucketIAMMember("admin",
-            bucket=report_bucket.name,
-            role="roles/storage.admin",
-            member=f"serviceAccount:service-{project.number}@gcp-sa-storageinsights.iam.gserviceaccount.com")
-        ```
 
         ## Import
 
@@ -517,29 +439,17 @@ class InsightsReportConfig(pulumi.CustomResource):
                 raise TypeError('__props__ is only valid when passed in combination with a valid opts.id to get an existing resource')
             __props__ = InsightsReportConfigArgs.__new__(InsightsReportConfigArgs)
 
-            if csv_options is not None and not isinstance(csv_options, InsightsReportConfigCsvOptionsArgs):
-                csv_options = csv_options or {}
-                def _setter(key, value):
-                    csv_options[key] = value
-                InsightsReportConfigCsvOptionsArgs._configure(_setter, **csv_options)
+            csv_options = _utilities.configure(csv_options, InsightsReportConfigCsvOptionsArgs, True)
             if csv_options is None and not opts.urn:
                 raise TypeError("Missing required property 'csv_options'")
             __props__.__dict__["csv_options"] = csv_options
             __props__.__dict__["display_name"] = display_name
-            if frequency_options is not None and not isinstance(frequency_options, InsightsReportConfigFrequencyOptionsArgs):
-                frequency_options = frequency_options or {}
-                def _setter(key, value):
-                    frequency_options[key] = value
-                InsightsReportConfigFrequencyOptionsArgs._configure(_setter, **frequency_options)
+            frequency_options = _utilities.configure(frequency_options, InsightsReportConfigFrequencyOptionsArgs, True)
             __props__.__dict__["frequency_options"] = frequency_options
             if location is None and not opts.urn:
                 raise TypeError("Missing required property 'location'")
             __props__.__dict__["location"] = location
-            if object_metadata_report_options is not None and not isinstance(object_metadata_report_options, InsightsReportConfigObjectMetadataReportOptionsArgs):
-                object_metadata_report_options = object_metadata_report_options or {}
-                def _setter(key, value):
-                    object_metadata_report_options[key] = value
-                InsightsReportConfigObjectMetadataReportOptionsArgs._configure(_setter, **object_metadata_report_options)
+            object_metadata_report_options = _utilities.configure(object_metadata_report_options, InsightsReportConfigObjectMetadataReportOptionsArgs, True)
             __props__.__dict__["object_metadata_report_options"] = object_metadata_report_options
             __props__.__dict__["project"] = project
             __props__.__dict__["name"] = None

pulumi_gcp/storage/notification.py

@@ -46,13 +46,29 @@ class NotificationArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             bucket: pulumi.Input[str],
-             payload_format: pulumi.Input[str],
-             topic: pulumi.Input[str],
+             bucket: Optional[pulumi.Input[str]] = None,
+             payload_format: Optional[pulumi.Input[str]] = None,
+             topic: Optional[pulumi.Input[str]] = None,
              custom_attributes: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
              event_types: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
              object_name_prefix: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if bucket is None:
+            raise TypeError("Missing 'bucket' argument")
+        if payload_format is None and 'payloadFormat' in kwargs:
+            payload_format = kwargs['payloadFormat']
+        if payload_format is None:
+            raise TypeError("Missing 'payload_format' argument")
+        if topic is None:
+            raise TypeError("Missing 'topic' argument")
+        if custom_attributes is None and 'customAttributes' in kwargs:
+            custom_attributes = kwargs['customAttributes']
+        if event_types is None and 'eventTypes' in kwargs:
+            event_types = kwargs['eventTypes']
+        if object_name_prefix is None and 'objectNamePrefix' in kwargs:
+            object_name_prefix = kwargs['objectNamePrefix']
+
         _setter("bucket", bucket)
         _setter("payload_format", payload_format)
         _setter("topic", topic)
@@ -190,7 +206,21 @@ class _NotificationState:
              payload_format: Optional[pulumi.Input[str]] = None,
              self_link: Optional[pulumi.Input[str]] = None,
              topic: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if custom_attributes is None and 'customAttributes' in kwargs:
+            custom_attributes = kwargs['customAttributes']
+        if event_types is None and 'eventTypes' in kwargs:
+            event_types = kwargs['eventTypes']
+        if notification_id is None and 'notificationId' in kwargs:
+            notification_id = kwargs['notificationId']
+        if object_name_prefix is None and 'objectNamePrefix' in kwargs:
+            object_name_prefix = kwargs['objectNamePrefix']
+        if payload_format is None and 'payloadFormat' in kwargs:
+            payload_format = kwargs['payloadFormat']
+        if self_link is None and 'selfLink' in kwargs:
+            self_link = kwargs['selfLink']
+
         if bucket is not None:
             _setter("bucket", bucket)
         if custom_attributes is not None:
@@ -340,35 +370,6 @@ class Notification(pulumi.CustomResource):
         > **NOTE**: This resource can affect your storage IAM policy. If you are using this in the same config as your storage IAM policy resources, consider
         making this resource dependent on those IAM resources via `depends_on`. This will safeguard against errors due to IAM race conditions.
 
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        gcs_account = gcp.storage.get_project_service_account()
-        topic = gcp.pubsub.Topic("topic")
-        binding = gcp.pubsub.TopicIAMBinding("binding",
-            topic=topic.id,
-            role="roles/pubsub.publisher",
-            members=[f"serviceAccount:{gcs_account.email_address}"])
-        # End enabling notifications
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        notification = gcp.storage.Notification("notification",
-            bucket=bucket.name,
-            payload_format="JSON_API_V1",
-            topic=topic.id,
-            event_types=[
-                "OBJECT_FINALIZE",
-                "OBJECT_METADATA_UPDATE",
-            ],
-            custom_attributes={
-                "new-attribute": "new-attribute-value",
-            },
-            opts=pulumi.ResourceOptions(depends_on=[binding]))
-        # Enable notifications by giving the correct IAM permission to the unique service account.
-        ```
-
         ## Import
 
         Storage notifications can be imported using the notification `id` in the format `<bucket_name>/notificationConfigs/<id>` e.g.
@@ -415,35 +416,6 @@ class Notification(pulumi.CustomResource):
         > **NOTE**: This resource can affect your storage IAM policy. If you are using this in the same config as your storage IAM policy resources, consider
         making this resource dependent on those IAM resources via `depends_on`. This will safeguard against errors due to IAM race conditions.
 
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        gcs_account = gcp.storage.get_project_service_account()
-        topic = gcp.pubsub.Topic("topic")
-        binding = gcp.pubsub.TopicIAMBinding("binding",
-            topic=topic.id,
-            role="roles/pubsub.publisher",
-            members=[f"serviceAccount:{gcs_account.email_address}"])
-        # End enabling notifications
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        notification = gcp.storage.Notification("notification",
-            bucket=bucket.name,
-            payload_format="JSON_API_V1",
-            topic=topic.id,
-            event_types=[
-                "OBJECT_FINALIZE",
-                "OBJECT_METADATA_UPDATE",
-            ],
-            custom_attributes={
-                "new-attribute": "new-attribute-value",
-            },
-            opts=pulumi.ResourceOptions(depends_on=[binding]))
-        # Enable notifications by giving the correct IAM permission to the unique service account.
-        ```
-
         ## Import
 
         Storage notifications can be imported using the notification `id` in the format `<bucket_name>/notificationConfigs/<id>` e.g.

pulumi_gcp/storage/object_access_control.py

@@ -49,11 +49,21 @@ class ObjectAccessControlArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             bucket: pulumi.Input[str],
-             entity: pulumi.Input[str],
-             object: pulumi.Input[str],
-             role: pulumi.Input[str],
-             opts: Optional[pulumi.ResourceOptions]=None):
+             bucket: Optional[pulumi.Input[str]] = None,
+             entity: Optional[pulumi.Input[str]] = None,
+             object: Optional[pulumi.Input[str]] = None,
+             role: Optional[pulumi.Input[str]] = None,
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if bucket is None:
+            raise TypeError("Missing 'bucket' argument")
+        if entity is None:
+            raise TypeError("Missing 'entity' argument")
+        if object is None:
+            raise TypeError("Missing 'object' argument")
+        if role is None:
+            raise TypeError("Missing 'role' argument")
+
         _setter("bucket", bucket)
         _setter("entity", entity)
         _setter("object", object)
@@ -181,7 +191,13 @@ class _ObjectAccessControlState:
              object: Optional[pulumi.Input[str]] = None,
              project_teams: Optional[pulumi.Input[Sequence[pulumi.Input['ObjectAccessControlProjectTeamArgs']]]] = None,
              role: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if entity_id is None and 'entityId' in kwargs:
+            entity_id = kwargs['entityId']
+        if project_teams is None and 'projectTeams' in kwargs:
+            project_teams = kwargs['projectTeams']
+
         if bucket is not None:
             _setter("bucket", bucket)
         if domain is not None:
@@ -354,22 +370,6 @@ class ObjectAccessControl(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/access-control/create-manage-lists)
 
         ## Example Usage
-        ### Storage Object Access Control Public Object
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        object = gcp.storage.BucketObject("object",
-            bucket=bucket.name,
-            source=pulumi.FileAsset("../static/img/header-logo.png"))
-        public_rule = gcp.storage.ObjectAccessControl("publicRule",
-            object=object.output_name,
-            bucket=bucket.name,
-            role="READER",
-            entity="allUsers")
-        ```
 
         ## Import
 
@@ -425,22 +425,6 @@ class ObjectAccessControl(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/access-control/create-manage-lists)
 
         ## Example Usage
-        ### Storage Object Access Control Public Object
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        object = gcp.storage.BucketObject("object",
-            bucket=bucket.name,
-            source=pulumi.FileAsset("../static/img/header-logo.png"))
-        public_rule = gcp.storage.ObjectAccessControl("publicRule",
-            object=object.output_name,
-            bucket=bucket.name,
-            role="READER",
-            entity="allUsers")
-        ```
 
         ## Import
 

pulumi_gcp/storage/object_acl.py

@@ -38,11 +38,21 @@ class ObjectACLArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             bucket: pulumi.Input[str],
-             object: pulumi.Input[str],
+             bucket: Optional[pulumi.Input[str]] = None,
+             object: Optional[pulumi.Input[str]] = None,
              predefined_acl: Optional[pulumi.Input[str]] = None,
              role_entities: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if bucket is None:
+            raise TypeError("Missing 'bucket' argument")
+        if object is None:
+            raise TypeError("Missing 'object' argument")
+        if predefined_acl is None and 'predefinedAcl' in kwargs:
+            predefined_acl = kwargs['predefinedAcl']
+        if role_entities is None and 'roleEntities' in kwargs:
+            role_entities = kwargs['roleEntities']
+
         _setter("bucket", bucket)
         _setter("object", object)
         if predefined_acl is not None:
@@ -133,7 +143,13 @@ class _ObjectACLState:
              object: Optional[pulumi.Input[str]] = None,
              predefined_acl: Optional[pulumi.Input[str]] = None,
              role_entities: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if predefined_acl is None and 'predefinedAcl' in kwargs:
+            predefined_acl = kwargs['predefinedAcl']
+        if role_entities is None and 'roleEntities' in kwargs:
+            role_entities = kwargs['roleEntities']
+
         if bucket is not None:
             _setter("bucket", bucket)
         if object is not None:
@@ -218,27 +234,6 @@ class ObjectACL(pulumi.CustomResource):
         > Want fine-grained control over object ACLs? Use `storage.ObjectAccessControl` to control individual
         role entity pairs.
 
-        ## Example Usage
-
-        Create an object ACL with one owner and one reader.
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        image_store = gcp.storage.Bucket("image-store", location="EU")
-        image = gcp.storage.BucketObject("image",
-            bucket=image_store.name,
-            source=pulumi.FileAsset("image1.jpg"))
-        image_store_acl = gcp.storage.ObjectACL("image-store-acl",
-            bucket=image_store.name,
-            object=image.output_name,
-            role_entities=[
-                "OWNER:user-my.email@gmail.com",
-                "READER:group-mygroup",
-            ])
-        ```
-
         ## Import
 
         This resource does not support import.
@@ -272,27 +267,6 @@ class ObjectACL(pulumi.CustomResource):
         > Want fine-grained control over object ACLs? Use `storage.ObjectAccessControl` to control individual
         role entity pairs.
 
-        ## Example Usage
-
-        Create an object ACL with one owner and one reader.
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        image_store = gcp.storage.Bucket("image-store", location="EU")
-        image = gcp.storage.BucketObject("image",
-            bucket=image_store.name,
-            source=pulumi.FileAsset("image1.jpg"))
-        image_store_acl = gcp.storage.ObjectACL("image-store-acl",
-            bucket=image_store.name,
-            object=image.output_name,
-            role_entities=[
-                "OWNER:user-my.email@gmail.com",
-                "READER:group-mygroup",
-            ])
-        ```
-
         ## Import
 
         This resource does not support import.