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

pulumi_gcp/storage/default_object_access_control.py

@@ -49,11 +49,19 @@ class DefaultObjectAccessControlArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             bucket: pulumi.Input[str],
-             entity: pulumi.Input[str],
-             role: pulumi.Input[str],
+             bucket: Optional[pulumi.Input[str]] = None,
+             entity: Optional[pulumi.Input[str]] = None,
+             role: Optional[pulumi.Input[str]] = None,
              object: 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 entity is None:
+            raise TypeError("Missing 'entity' argument")
+        if role is None:
+            raise TypeError("Missing 'role' argument")
+
         _setter("bucket", bucket)
         _setter("entity", entity)
         _setter("role", role)
@@ -182,7 +190,13 @@ class _DefaultObjectAccessControlState:
              object: Optional[pulumi.Input[str]] = None,
              project_teams: Optional[pulumi.Input[Sequence[pulumi.Input['DefaultObjectAccessControlProjectTeamArgs']]]] = 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:
@@ -356,18 +370,6 @@ class DefaultObjectAccessControl(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/access-control/create-manage-lists)
 
         ## Example Usage
-        ### Storage Default Object Access Control Public
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        public_rule = gcp.storage.DefaultObjectAccessControl("publicRule",
-            bucket=bucket.name,
-            role="READER",
-            entity="allUsers")
-        ```
 
         ## Import
 
@@ -424,18 +426,6 @@ class DefaultObjectAccessControl(pulumi.CustomResource):
             * [Official Documentation](https://cloud.google.com/storage/docs/access-control/create-manage-lists)
 
         ## Example Usage
-        ### Storage Default Object Access Control Public
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        bucket = gcp.storage.Bucket("bucket", location="US")
-        public_rule = gcp.storage.DefaultObjectAccessControl("publicRule",
-            bucket=bucket.name,
-            role="READER",
-            entity="allUsers")
-        ```
 
         ## Import
 

pulumi_gcp/storage/default_object_acl.py

@@ -31,9 +31,15 @@ class DefaultObjectACLArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             bucket: pulumi.Input[str],
+             bucket: 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 role_entities is None and 'roleEntities' in kwargs:
+            role_entities = kwargs['roleEntities']
+
         _setter("bucket", bucket)
         if role_entities is not None:
             _setter("role_entities", role_entities)
@@ -87,7 +93,11 @@ class _DefaultObjectACLState:
              _setter: Callable[[Any, Any], None],
              bucket: 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 role_entities is None and 'roleEntities' in kwargs:
+            role_entities = kwargs['roleEntities']
+
         if bucket is not None:
             _setter("bucket", bucket)
         if role_entities is not None:
@@ -143,23 +153,6 @@ class DefaultObjectACL(pulumi.CustomResource):
         > Want fine-grained control over default object ACLs? Use `storage.DefaultObjectAccessControl`
         to control individual role entity pairs.
 
-        ## Example Usage
-
-        Example creating a default object ACL on a bucket with one owner, and one reader.
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        image_store = gcp.storage.Bucket("image-store", location="EU")
-        image_store_default_acl = gcp.storage.DefaultObjectACL("image-store-default-acl",
-            bucket=image_store.name,
-            role_entities=[
-                "OWNER:user-my.email@gmail.com",
-                "READER:group-mygroup",
-            ])
-        ```
-
         ## Import
 
         This resource does not support import.
@@ -192,23 +185,6 @@ class DefaultObjectACL(pulumi.CustomResource):
         > Want fine-grained control over default object ACLs? Use `storage.DefaultObjectAccessControl`
         to control individual role entity pairs.
 
-        ## Example Usage
-
-        Example creating a default object ACL on a bucket with one owner, and one reader.
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        image_store = gcp.storage.Bucket("image-store", location="EU")
-        image_store_default_acl = gcp.storage.DefaultObjectACL("image-store-default-acl",
-            bucket=image_store.name,
-            role_entities=[
-                "OWNER:user-my.email@gmail.com",
-                "READER:group-mygroup",
-            ])
-        ```
-
         ## Import
 
         This resource does not support import.

pulumi_gcp/storage/get_bucket.py

@@ -242,15 +242,6 @@ def get_bucket(name: Optional[str] = None,
     and
     [API](https://cloud.google.com/storage/docs/json_api/v1/buckets).
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    my_bucket = gcp.storage.get_bucket(name="my-bucket")
-    ```
-
 
     :param str name: The name of the bucket.
     """
@@ -293,15 +284,6 @@ def get_bucket_output(name: Optional[pulumi.Input[str]] = None,
     and
     [API](https://cloud.google.com/storage/docs/json_api/v1/buckets).
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    my_bucket = gcp.storage.get_bucket(name="my-bucket")
-    ```
-
 
     :param str name: The name of the bucket.
     """

pulumi_gcp/storage/get_bucket_iam_policy.py

@@ -83,15 +83,6 @@ def get_bucket_iam_policy(bucket: Optional[str] = None,
     """
     Retrieves the current IAM policy data for bucket
 
-    ## example
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    policy = gcp.storage.get_bucket_iam_policy(bucket=google_storage_bucket["default"]["name"])
-    ```
-
 
     :param str bucket: Used to find the parent resource to bind the IAM policy to
     """
@@ -113,15 +104,6 @@ def get_bucket_iam_policy_output(bucket: Optional[pulumi.Input[str]] = None,
     """
     Retrieves the current IAM policy data for bucket
 
-    ## example
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    policy = gcp.storage.get_bucket_iam_policy(bucket=google_storage_bucket["default"]["name"])
-    ```
-
 
     :param str bucket: Used to find the parent resource to bind the IAM policy to
     """

pulumi_gcp/storage/get_bucket_object.py

@@ -282,18 +282,6 @@ def get_bucket_object(bucket: Optional[str] = None,
     and
     [API](https://cloud.google.com/storage/docs/json_api/v1/objects).
 
-    ## Example Usage
-
-    Example picture stored within a folder.
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    picture = gcp.storage.get_bucket_object(bucket="image-store",
-        name="folder/butterfly01.jpg")
-    ```
-
 
     :param str bucket: The name of the containing bucket.
     :param str name: The name of the object.
@@ -339,18 +327,6 @@ def get_bucket_object_output(bucket: Optional[pulumi.Input[Optional[str]]] = Non
     and
     [API](https://cloud.google.com/storage/docs/json_api/v1/objects).
 
-    ## Example Usage
-
-    Example picture stored within a folder.
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    picture = gcp.storage.get_bucket_object(bucket="image-store",
-        name="folder/butterfly01.jpg")
-    ```
-
 
     :param str bucket: The name of the containing bucket.
     :param str name: The name of the object.

pulumi_gcp/storage/get_bucket_object_content.py

@@ -249,19 +249,6 @@ def get_bucket_object_content(bucket: Optional[str] = None,
 
     > **Warning:** The object content will be saved in the state, and visiable to everyone who has access to the state file.
 
-    ## Example Usage
-
-    Example file object  stored within a folder.
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    key = gcp.storage.get_bucket_object_content(name="encryptedkey",
-        bucket="keystore")
-    pulumi.export("encrypted", key.content)
-    ```
-
 
     :param str bucket: The name of the containing bucket.
     :param str content: (Computed) [Content-Language](https://tools.ietf.org/html/rfc7231#section-3.1.3.2) of the object content.
@@ -312,19 +299,6 @@ def get_bucket_object_content_output(bucket: Optional[pulumi.Input[str]] = None,
 
     > **Warning:** The object content will be saved in the state, and visiable to everyone who has access to the state file.
 
-    ## Example Usage
-
-    Example file object  stored within a folder.
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    key = gcp.storage.get_bucket_object_content(name="encryptedkey",
-        bucket="keystore")
-    pulumi.export("encrypted", key.content)
-    ```
-
 
     :param str bucket: The name of the containing bucket.
     :param str content: (Computed) [Content-Language](https://tools.ietf.org/html/rfc7231#section-3.1.3.2) of the object content.

pulumi_gcp/storage/get_object_signed_url.py

@@ -142,33 +142,6 @@ def get_object_signed_url(bucket: Optional[str] = None,
 
     For more info about signed URL's is available [here](https://cloud.google.com/storage/docs/access-control/signed-urls).
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    artifact = gcp.storage.get_object_signed_url(bucket="install_binaries",
-        path="path/to/install_file.bin")
-    vm = gcp.compute.Instance("vm")
-    ```
-    ## Full Example
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    get_url = gcp.storage.get_object_signed_url(bucket="fried_chicken",
-        path="path/to/file",
-        content_md5="pRviqwS4c4OTJRTe03FD1w==",
-        content_type="text/plain",
-        duration="2d",
-        credentials=(lambda path: open(path).read())("path/to/credentials.json"),
-        extension_headers={
-            "x-goog-if-generation-match": "1",
-        })
-    ```
-
 
     :param str bucket: The name of the bucket to read the object from
     :param str content_md5: The [MD5 digest](https://cloud.google.com/storage/docs/hashes-etags#_MD5) value in Base64.
@@ -226,33 +199,6 @@ def get_object_signed_url_output(bucket: Optional[pulumi.Input[str]] = None,
 
     For more info about signed URL's is available [here](https://cloud.google.com/storage/docs/access-control/signed-urls).
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    artifact = gcp.storage.get_object_signed_url(bucket="install_binaries",
-        path="path/to/install_file.bin")
-    vm = gcp.compute.Instance("vm")
-    ```
-    ## Full Example
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    get_url = gcp.storage.get_object_signed_url(bucket="fried_chicken",
-        path="path/to/file",
-        content_md5="pRviqwS4c4OTJRTe03FD1w==",
-        content_type="text/plain",
-        duration="2d",
-        credentials=(lambda path: open(path).read())("path/to/credentials.json"),
-        extension_headers={
-            "x-goog-if-generation-match": "1",
-        })
-    ```
-
 
     :param str bucket: The name of the bucket to read the object from
     :param str content_md5: The [MD5 digest](https://cloud.google.com/storage/docs/hashes-etags#_MD5) value in Base64.

pulumi_gcp/storage/get_project_service_account.py

@@ -125,36 +125,6 @@ def get_project_service_account(project: Optional[str] = None,
     [the API reference](https://cloud.google.com/storage/docs/json_api/v1/projects/serviceAccount).
 
     ## Example Usage
-    ### Pub/Sub Notifications
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    gcs_account = gcp.storage.get_project_service_account()
-    binding = gcp.pubsub.TopicIAMBinding("binding",
-        topic=google_pubsub_topic["topic"]["name"],
-        role="roles/pubsub.publisher",
-        members=[f"serviceAccount:{gcs_account.email_address}"])
-    ```
-    ### Cloud KMS Keys
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    gcs_account = gcp.storage.get_project_service_account()
-    binding = gcp.kms.CryptoKeyIAMBinding("binding",
-        crypto_key_id="your-crypto-key-id",
-        role="roles/cloudkms.cryptoKeyEncrypterDecrypter",
-        members=[f"serviceAccount:{gcs_account.email_address}"])
-    bucket = gcp.storage.Bucket("bucket",
-        location="US",
-        encryption=gcp.storage.BucketEncryptionArgs(
-            default_kms_key_name="your-crypto-key-id",
-        ),
-        opts=pulumi.ResourceOptions(depends_on=[binding]))
-    ```
 
 
     :param str project: The project the unique service account was created for. If it is not provided, the provider project is used.
@@ -214,36 +184,6 @@ def get_project_service_account_output(project: Optional[pulumi.Input[Optional[s
     [the API reference](https://cloud.google.com/storage/docs/json_api/v1/projects/serviceAccount).
 
     ## Example Usage
-    ### Pub/Sub Notifications
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    gcs_account = gcp.storage.get_project_service_account()
-    binding = gcp.pubsub.TopicIAMBinding("binding",
-        topic=google_pubsub_topic["topic"]["name"],
-        role="roles/pubsub.publisher",
-        members=[f"serviceAccount:{gcs_account.email_address}"])
-    ```
-    ### Cloud KMS Keys
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    gcs_account = gcp.storage.get_project_service_account()
-    binding = gcp.kms.CryptoKeyIAMBinding("binding",
-        crypto_key_id="your-crypto-key-id",
-        role="roles/cloudkms.cryptoKeyEncrypterDecrypter",
-        members=[f"serviceAccount:{gcs_account.email_address}"])
-    bucket = gcp.storage.Bucket("bucket",
-        location="US",
-        encryption=gcp.storage.BucketEncryptionArgs(
-            default_kms_key_name="your-crypto-key-id",
-        ),
-        opts=pulumi.ResourceOptions(depends_on=[binding]))
-    ```
 
 
     :param str project: The project the unique service account was created for. If it is not provided, the provider project is used.

pulumi_gcp/storage/get_transfer_project_service_account.py

@@ -94,16 +94,6 @@ def get_transfer_project_service_account(project: Optional[str] = None,
     """
     Use this data source to retrieve Storage Transfer service account for this project
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    default = gcp.storage.get_transfer_project_service_account()
-    pulumi.export("defaultAccount", default.email)
-    ```
-
 
     :param str project: The project ID. If it is not provided, the provider project is used.
     """
@@ -126,16 +116,6 @@ def get_transfer_project_service_account_output(project: Optional[pulumi.Input[O
     """
     Use this data source to retrieve Storage Transfer service account for this project
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    default = gcp.storage.get_transfer_project_service_account()
-    pulumi.export("defaultAccount", default.email)
-    ```
-
 
     :param str project: The project ID. If it is not provided, the provider project is used.
     """

pulumi_gcp/storage/get_transfer_project_servie_account.py

@@ -96,16 +96,6 @@ def get_transfer_project_servie_account(project: Optional[str] = None,
     """
     Use this data source to retrieve Storage Transfer service account for this project
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    default = gcp.storage.get_transfer_project_service_account()
-    pulumi.export("defaultAccount", default.email)
-    ```
-
 
     :param str project: The project ID. If it is not provided, the provider project is used.
     """
@@ -129,16 +119,6 @@ def get_transfer_project_servie_account_output(project: Optional[pulumi.Input[Op
     """
     Use this data source to retrieve Storage Transfer service account for this project
 
-    ## Example Usage
-
-    ```python
-    import pulumi
-    import pulumi_gcp as gcp
-
-    default = gcp.storage.get_transfer_project_service_account()
-    pulumi.export("defaultAccount", default.email)
-    ```
-
 
     :param str project: The project ID. If it is not provided, the provider project is used.
     """

pulumi_gcp/storage/hmac_key.py

@@ -38,10 +38,16 @@ class HmacKeyArgs:
     @staticmethod
     def _configure(
              _setter: Callable[[Any, Any], None],
-             service_account_email: pulumi.Input[str],
+             service_account_email: Optional[pulumi.Input[str]] = None,
              project: Optional[pulumi.Input[str]] = None,
              state: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if service_account_email is None and 'serviceAccountEmail' in kwargs:
+            service_account_email = kwargs['serviceAccountEmail']
+        if service_account_email is None:
+            raise TypeError("Missing 'service_account_email' argument")
+
         _setter("service_account_email", service_account_email)
         if project is not None:
             _setter("project", project)
@@ -138,7 +144,15 @@ class _HmacKeyState:
              state: Optional[pulumi.Input[str]] = None,
              time_created: Optional[pulumi.Input[str]] = None,
              updated: Optional[pulumi.Input[str]] = None,
-             opts: Optional[pulumi.ResourceOptions]=None):
+             opts: Optional[pulumi.ResourceOptions] = None,
+             **kwargs):
+        if access_id is None and 'accessId' in kwargs:
+            access_id = kwargs['accessId']
+        if service_account_email is None and 'serviceAccountEmail' in kwargs:
+            service_account_email = kwargs['serviceAccountEmail']
+        if time_created is None and 'timeCreated' in kwargs:
+            time_created = kwargs['timeCreated']
+
         if access_id is not None:
             _setter("access_id", access_id)
         if project is not None:
@@ -273,17 +287,6 @@ class HmacKey(pulumi.CustomResource):
         state as plain-text.
 
         ## Example Usage
-        ### Storage Hmac Key
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        # Create a new service account
-        service_account = gcp.service_account.Account("serviceAccount", account_id="my-svc-acc")
-        #Create the HMAC key for the associated service account
-        key = gcp.storage.HmacKey("key", service_account_email=service_account.email)
-        ```
 
         ## Import
 
@@ -337,17 +340,6 @@ class HmacKey(pulumi.CustomResource):
         state as plain-text.
 
         ## Example Usage
-        ### Storage Hmac Key
-
-        ```python
-        import pulumi
-        import pulumi_gcp as gcp
-
-        # Create a new service account
-        service_account = gcp.service_account.Account("serviceAccount", account_id="my-svc-acc")
-        #Create the HMAC key for the associated service account
-        key = gcp.storage.HmacKey("key", service_account_email=service_account.email)
-        ```
 
         ## Import