pulumi-gcp 8.38.0__py3-none-any.whl → 8.39.0__py3-none-any.whl

pulumi_gcp/firebase/hosting_site.py

@@ -88,7 +88,8 @@ class _HostingSiteState:
                  default_url: Optional[pulumi.Input[builtins.str]] = None,
                  name: Optional[pulumi.Input[builtins.str]] = None,
                  project: Optional[pulumi.Input[builtins.str]] = None,
-                 site_id: Optional[pulumi.Input[builtins.str]] = None):
+                 site_id: Optional[pulumi.Input[builtins.str]] = None,
+                 type: Optional[pulumi.Input[builtins.str]] = None):
         """
         Input properties used for looking up and filtering HostingSite resources.
         :param pulumi.Input[builtins.str] app_id: Optional. The [ID of a Web App](https://firebase.google.com/docs/reference/firebase-management/rest/v1beta1/projects.webApps#WebApp.FIELDS.app_id)
@@ -106,6 +107,7 @@ class _HostingSiteState:
         :param pulumi.Input[builtins.str] site_id: Required. Immutable. A globally unique identifier for the Hosting site. This identifier is
                used to construct the Firebase-provisioned subdomains for the site, so it must also be a valid
                domain name label.
+        :param pulumi.Input[builtins.str] type: The type of Hosting site, either 'DEFAULT_SITE' or `USER_SITE`
         """
         if app_id is not None:
             pulumi.set(__self__, "app_id", app_id)
@@ -117,6 +119,8 @@ class _HostingSiteState:
             pulumi.set(__self__, "project", project)
         if site_id is not None:
             pulumi.set(__self__, "site_id", site_id)
+        if type is not None:
+            pulumi.set(__self__, "type", type)
 
     @property
     @pulumi.getter(name="appId")
@@ -188,6 +192,18 @@ class _HostingSiteState:
     def site_id(self, value: Optional[pulumi.Input[builtins.str]]):
         pulumi.set(self, "site_id", value)
 
+    @property
+    @pulumi.getter
+    def type(self) -> Optional[pulumi.Input[builtins.str]]:
+        """
+        The type of Hosting site, either 'DEFAULT_SITE' or `USER_SITE`
+        """
+        return pulumi.get(self, "type")
+
+    @type.setter
+    def type(self, value: Optional[pulumi.Input[builtins.str]]):
+        pulumi.set(self, "type", value)
+
 
 @pulumi.type_token("gcp:firebase/hostingSite:HostingSite")
 class HostingSite(pulumi.CustomResource):
@@ -226,6 +242,16 @@ class HostingSite(pulumi.CustomResource):
             site_id="site-with-app",
             app_id=default.app_id)
         ```
+        ### Firebasehosting Site Default
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        default = gcp.firebase.HostingSite("default",
+            project="my-project-name",
+            site_id="my-project-name")
+        ```
 
         ## Import
 
@@ -300,6 +326,16 @@ class HostingSite(pulumi.CustomResource):
             site_id="site-with-app",
             app_id=default.app_id)
         ```
+        ### Firebasehosting Site Default
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        default = gcp.firebase.HostingSite("default",
+            project="my-project-name",
+            site_id="my-project-name")
+        ```
 
         ## Import
 
@@ -363,6 +399,7 @@ class HostingSite(pulumi.CustomResource):
             __props__.__dict__["site_id"] = site_id
             __props__.__dict__["default_url"] = None
             __props__.__dict__["name"] = None
+            __props__.__dict__["type"] = None
         super(HostingSite, __self__).__init__(
             'gcp:firebase/hostingSite:HostingSite',
             resource_name,
@@ -377,7 +414,8 @@ class HostingSite(pulumi.CustomResource):
             default_url: Optional[pulumi.Input[builtins.str]] = None,
             name: Optional[pulumi.Input[builtins.str]] = None,
             project: Optional[pulumi.Input[builtins.str]] = None,
-            site_id: Optional[pulumi.Input[builtins.str]] = None) -> 'HostingSite':
+            site_id: Optional[pulumi.Input[builtins.str]] = None,
+            type: Optional[pulumi.Input[builtins.str]] = None) -> 'HostingSite':
         """
         Get an existing HostingSite resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -400,6 +438,7 @@ class HostingSite(pulumi.CustomResource):
         :param pulumi.Input[builtins.str] site_id: Required. Immutable. A globally unique identifier for the Hosting site. This identifier is
                used to construct the Firebase-provisioned subdomains for the site, so it must also be a valid
                domain name label.
+        :param pulumi.Input[builtins.str] type: The type of Hosting site, either 'DEFAULT_SITE' or `USER_SITE`
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -410,6 +449,7 @@ class HostingSite(pulumi.CustomResource):
         __props__.__dict__["name"] = name
         __props__.__dict__["project"] = project
         __props__.__dict__["site_id"] = site_id
+        __props__.__dict__["type"] = type
         return HostingSite(resource_name, opts=opts, __props__=__props__)
 
     @property
@@ -462,3 +502,11 @@ class HostingSite(pulumi.CustomResource):
         """
         return pulumi.get(self, "site_id")
 
+    @property
+    @pulumi.getter
+    def type(self) -> pulumi.Output[builtins.str]:
+        """
+        The type of Hosting site, either 'DEFAULT_SITE' or `USER_SITE`
+        """
+        return pulumi.get(self, "type")
+

pulumi_gcp/firestore/__init__.py

@@ -10,6 +10,7 @@ from .backup_schedule import *
 from .database import *
 from .document import *
 from .field import *
+from .get_document import *
 from .index import *
 from ._inputs import *
 from . import outputs

pulumi_gcp/firestore/database.py

@@ -32,7 +32,8 @@ class DatabaseArgs:
                  deletion_policy: Optional[pulumi.Input[builtins.str]] = None,
                  name: Optional[pulumi.Input[builtins.str]] = None,
                  point_in_time_recovery_enablement: Optional[pulumi.Input[builtins.str]] = None,
-                 project: Optional[pulumi.Input[builtins.str]] = None):
+                 project: Optional[pulumi.Input[builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None):
         """
         The set of arguments for constructing a Database resource.
         :param pulumi.Input[builtins.str] location_id: The location of the database. Available locations are listed at
@@ -66,6 +67,12 @@ class DatabaseArgs:
                Possible values are: `POINT_IN_TIME_RECOVERY_ENABLED`, `POINT_IN_TIME_RECOVERY_DISABLED`.
         :param pulumi.Input[builtins.str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] tags: Input only. A map of resource manager tags. Resource manager tag keys
+               and values have the same definition as resource manager tags.
+               Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+               The field is ignored when empty. The field is immutable and causes
+               resource replacement when mutated. To apply tags to an existing resource, see
+               the `tags.TagValue` resource.
         """
         pulumi.set(__self__, "location_id", location_id)
         pulumi.set(__self__, "type", type)
@@ -87,6 +94,8 @@ class DatabaseArgs:
             pulumi.set(__self__, "point_in_time_recovery_enablement", point_in_time_recovery_enablement)
         if project is not None:
             pulumi.set(__self__, "project", project)
+        if tags is not None:
+            pulumi.set(__self__, "tags", tags)
 
     @property
     @pulumi.getter(name="locationId")
@@ -236,6 +245,23 @@ class DatabaseArgs:
     def project(self, value: Optional[pulumi.Input[builtins.str]]):
         pulumi.set(self, "project", value)
 
+    @property
+    @pulumi.getter
+    def tags(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]:
+        """
+        Input only. A map of resource manager tags. Resource manager tag keys
+        and values have the same definition as resource manager tags.
+        Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+        The field is ignored when empty. The field is immutable and causes
+        resource replacement when mutated. To apply tags to an existing resource, see
+        the `tags.TagValue` resource.
+        """
+        return pulumi.get(self, "tags")
+
+    @tags.setter
+    def tags(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]):
+        pulumi.set(self, "tags", value)
+
 
 @pulumi.input_type
 class _DatabaseState:
@@ -254,6 +280,7 @@ class _DatabaseState:
                  name: Optional[pulumi.Input[builtins.str]] = None,
                  point_in_time_recovery_enablement: Optional[pulumi.Input[builtins.str]] = None,
                  project: Optional[pulumi.Input[builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None,
                  type: Optional[pulumi.Input[builtins.str]] = None,
                  uid: Optional[pulumi.Input[builtins.str]] = None,
                  update_time: Optional[pulumi.Input[builtins.str]] = None,
@@ -298,6 +325,12 @@ class _DatabaseState:
                Possible values are: `POINT_IN_TIME_RECOVERY_ENABLED`, `POINT_IN_TIME_RECOVERY_DISABLED`.
         :param pulumi.Input[builtins.str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] tags: Input only. A map of resource manager tags. Resource manager tag keys
+               and values have the same definition as resource manager tags.
+               Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+               The field is ignored when empty. The field is immutable and causes
+               resource replacement when mutated. To apply tags to an existing resource, see
+               the `tags.TagValue` resource.
         :param pulumi.Input[builtins.str] type: The type of the database.
                See https://cloud.google.com/datastore/docs/firestore-or-datastore
                for information about how to choose.
@@ -337,6 +370,8 @@ class _DatabaseState:
             pulumi.set(__self__, "point_in_time_recovery_enablement", point_in_time_recovery_enablement)
         if project is not None:
             pulumi.set(__self__, "project", project)
+        if tags is not None:
+            pulumi.set(__self__, "tags", tags)
         if type is not None:
             pulumi.set(__self__, "type", type)
         if uid is not None:
@@ -534,6 +569,23 @@ class _DatabaseState:
     def project(self, value: Optional[pulumi.Input[builtins.str]]):
         pulumi.set(self, "project", value)
 
+    @property
+    @pulumi.getter
+    def tags(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]:
+        """
+        Input only. A map of resource manager tags. Resource manager tag keys
+        and values have the same definition as resource manager tags.
+        Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+        The field is ignored when empty. The field is immutable and causes
+        resource replacement when mutated. To apply tags to an existing resource, see
+        the `tags.TagValue` resource.
+        """
+        return pulumi.get(self, "tags")
+
+    @tags.setter
+    def tags(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]]):
+        pulumi.set(self, "tags", value)
+
     @property
     @pulumi.getter
     def type(self) -> Optional[pulumi.Input[builtins.str]]:
@@ -605,6 +657,7 @@ class Database(pulumi.CustomResource):
                  name: Optional[pulumi.Input[builtins.str]] = None,
                  point_in_time_recovery_enablement: Optional[pulumi.Input[builtins.str]] = None,
                  project: Optional[pulumi.Input[builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None,
                  type: Optional[pulumi.Input[builtins.str]] = None,
                  __props__=None):
         """
@@ -653,6 +706,23 @@ class Database(pulumi.CustomResource):
             delete_protection_state="DELETE_PROTECTION_ENABLED",
             deletion_policy="DELETE")
         ```
+        ### Firestore Database With Tags
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        database = gcp.firestore.Database("database",
+            project="my-project-name",
+            name="database-with-tags-id",
+            location_id="nam5",
+            type="FIRESTORE_NATIVE",
+            delete_protection_state="DELETE_PROTECTION_ENABLED",
+            deletion_policy="DELETE",
+            tags={
+                "keyname": "valuename",
+            })
+        ```
         ### Firestore Cmek Database
 
         ```python
@@ -816,6 +886,12 @@ class Database(pulumi.CustomResource):
                Possible values are: `POINT_IN_TIME_RECOVERY_ENABLED`, `POINT_IN_TIME_RECOVERY_DISABLED`.
         :param pulumi.Input[builtins.str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] tags: Input only. A map of resource manager tags. Resource manager tag keys
+               and values have the same definition as resource manager tags.
+               Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+               The field is ignored when empty. The field is immutable and causes
+               resource replacement when mutated. To apply tags to an existing resource, see
+               the `tags.TagValue` resource.
         :param pulumi.Input[builtins.str] type: The type of the database.
                See https://cloud.google.com/datastore/docs/firestore-or-datastore
                for information about how to choose.
@@ -873,6 +949,23 @@ class Database(pulumi.CustomResource):
             delete_protection_state="DELETE_PROTECTION_ENABLED",
             deletion_policy="DELETE")
         ```
+        ### Firestore Database With Tags
+
+        ```python
+        import pulumi
+        import pulumi_gcp as gcp
+
+        database = gcp.firestore.Database("database",
+            project="my-project-name",
+            name="database-with-tags-id",
+            location_id="nam5",
+            type="FIRESTORE_NATIVE",
+            delete_protection_state="DELETE_PROTECTION_ENABLED",
+            deletion_policy="DELETE",
+            tags={
+                "keyname": "valuename",
+            })
+        ```
         ### Firestore Cmek Database
 
         ```python
@@ -1032,6 +1125,7 @@ class Database(pulumi.CustomResource):
                  name: Optional[pulumi.Input[builtins.str]] = None,
                  point_in_time_recovery_enablement: Optional[pulumi.Input[builtins.str]] = None,
                  project: Optional[pulumi.Input[builtins.str]] = None,
+                 tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None,
                  type: Optional[pulumi.Input[builtins.str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -1054,6 +1148,7 @@ class Database(pulumi.CustomResource):
             __props__.__dict__["name"] = name
             __props__.__dict__["point_in_time_recovery_enablement"] = point_in_time_recovery_enablement
             __props__.__dict__["project"] = project
+            __props__.__dict__["tags"] = tags
             if type is None and not opts.urn:
                 raise TypeError("Missing required property 'type'")
             __props__.__dict__["type"] = type
@@ -1088,6 +1183,7 @@ class Database(pulumi.CustomResource):
             name: Optional[pulumi.Input[builtins.str]] = None,
             point_in_time_recovery_enablement: Optional[pulumi.Input[builtins.str]] = None,
             project: Optional[pulumi.Input[builtins.str]] = None,
+            tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]]] = None,
             type: Optional[pulumi.Input[builtins.str]] = None,
             uid: Optional[pulumi.Input[builtins.str]] = None,
             update_time: Optional[pulumi.Input[builtins.str]] = None,
@@ -1137,6 +1233,12 @@ class Database(pulumi.CustomResource):
                Possible values are: `POINT_IN_TIME_RECOVERY_ENABLED`, `POINT_IN_TIME_RECOVERY_DISABLED`.
         :param pulumi.Input[builtins.str] project: The ID of the project in which the resource belongs.
                If it is not provided, the provider project is used.
+        :param pulumi.Input[Mapping[str, pulumi.Input[builtins.str]]] tags: Input only. A map of resource manager tags. Resource manager tag keys
+               and values have the same definition as resource manager tags.
+               Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+               The field is ignored when empty. The field is immutable and causes
+               resource replacement when mutated. To apply tags to an existing resource, see
+               the `tags.TagValue` resource.
         :param pulumi.Input[builtins.str] type: The type of the database.
                See https://cloud.google.com/datastore/docs/firestore-or-datastore
                for information about how to choose.
@@ -1166,6 +1268,7 @@ class Database(pulumi.CustomResource):
         __props__.__dict__["name"] = name
         __props__.__dict__["point_in_time_recovery_enablement"] = point_in_time_recovery_enablement
         __props__.__dict__["project"] = project
+        __props__.__dict__["tags"] = tags
         __props__.__dict__["type"] = type
         __props__.__dict__["uid"] = uid
         __props__.__dict__["update_time"] = update_time
@@ -1304,6 +1407,19 @@ class Database(pulumi.CustomResource):
         """
         return pulumi.get(self, "project")
 
+    @property
+    @pulumi.getter
+    def tags(self) -> pulumi.Output[Optional[Mapping[str, builtins.str]]]:
+        """
+        Input only. A map of resource manager tags. Resource manager tag keys
+        and values have the same definition as resource manager tags.
+        Keys must be in the format tagKeys/{tag_key_id}, and values are in the format tagValues/456.
+        The field is ignored when empty. The field is immutable and causes
+        resource replacement when mutated. To apply tags to an existing resource, see
+        the `tags.TagValue` resource.
+        """
+        return pulumi.get(self, "tags")
+
     @property
     @pulumi.getter
     def type(self) -> pulumi.Output[builtins.str]:

pulumi_gcp/firestore/get_document.py

@@ -0,0 +1,234 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins
+import copy
+import warnings
+import sys
+import pulumi
+import pulumi.runtime
+from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
+from .. import _utilities
+
+__all__ = [
+    'GetDocumentResult',
+    'AwaitableGetDocumentResult',
+    'get_document',
+    'get_document_output',
+]
+
+@pulumi.output_type
+class GetDocumentResult:
+    """
+    A collection of values returned by getDocument.
+    """
+    def __init__(__self__, collection=None, create_time=None, database=None, document_id=None, fields=None, id=None, name=None, path=None, project=None, update_time=None):
+        if collection and not isinstance(collection, str):
+            raise TypeError("Expected argument 'collection' to be a str")
+        pulumi.set(__self__, "collection", collection)
+        if create_time and not isinstance(create_time, str):
+            raise TypeError("Expected argument 'create_time' to be a str")
+        pulumi.set(__self__, "create_time", create_time)
+        if database and not isinstance(database, str):
+            raise TypeError("Expected argument 'database' to be a str")
+        pulumi.set(__self__, "database", database)
+        if document_id and not isinstance(document_id, str):
+            raise TypeError("Expected argument 'document_id' to be a str")
+        pulumi.set(__self__, "document_id", document_id)
+        if fields and not isinstance(fields, str):
+            raise TypeError("Expected argument 'fields' to be a str")
+        pulumi.set(__self__, "fields", fields)
+        if id and not isinstance(id, str):
+            raise TypeError("Expected argument 'id' to be a str")
+        pulumi.set(__self__, "id", id)
+        if name and not isinstance(name, str):
+            raise TypeError("Expected argument 'name' to be a str")
+        pulumi.set(__self__, "name", name)
+        if path and not isinstance(path, str):
+            raise TypeError("Expected argument 'path' to be a str")
+        pulumi.set(__self__, "path", path)
+        if project and not isinstance(project, str):
+            raise TypeError("Expected argument 'project' to be a str")
+        pulumi.set(__self__, "project", project)
+        if update_time and not isinstance(update_time, str):
+            raise TypeError("Expected argument 'update_time' to be a str")
+        pulumi.set(__self__, "update_time", update_time)
+
+    @property
+    @pulumi.getter
+    def collection(self) -> builtins.str:
+        return pulumi.get(self, "collection")
+
+    @property
+    @pulumi.getter(name="createTime")
+    def create_time(self) -> builtins.str:
+        return pulumi.get(self, "create_time")
+
+    @property
+    @pulumi.getter
+    def database(self) -> builtins.str:
+        return pulumi.get(self, "database")
+
+    @property
+    @pulumi.getter(name="documentId")
+    def document_id(self) -> builtins.str:
+        return pulumi.get(self, "document_id")
+
+    @property
+    @pulumi.getter
+    def fields(self) -> builtins.str:
+        return pulumi.get(self, "fields")
+
+    @property
+    @pulumi.getter
+    def id(self) -> builtins.str:
+        """
+        The provider-assigned unique ID for this managed resource.
+        """
+        return pulumi.get(self, "id")
+
+    @property
+    @pulumi.getter
+    def name(self) -> builtins.str:
+        return pulumi.get(self, "name")
+
+    @property
+    @pulumi.getter
+    def path(self) -> builtins.str:
+        return pulumi.get(self, "path")
+
+    @property
+    @pulumi.getter
+    def project(self) -> Optional[builtins.str]:
+        return pulumi.get(self, "project")
+
+    @property
+    @pulumi.getter(name="updateTime")
+    def update_time(self) -> builtins.str:
+        return pulumi.get(self, "update_time")
+
+
+class AwaitableGetDocumentResult(GetDocumentResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return GetDocumentResult(
+            collection=self.collection,
+            create_time=self.create_time,
+            database=self.database,
+            document_id=self.document_id,
+            fields=self.fields,
+            id=self.id,
+            name=self.name,
+            path=self.path,
+            project=self.project,
+            update_time=self.update_time)
+
+
+def get_document(collection: Optional[builtins.str] = None,
+                 database: Optional[builtins.str] = None,
+                 document_id: Optional[builtins.str] = None,
+                 project: Optional[builtins.str] = None,
+                 opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDocumentResult:
+    """
+    Reads a document from a Firestore database.
+    See [the official documentation](https://cloud.google.com/firestore/native/docs/)
+    and
+    [API](https://cloud.google.com/firestore/docs/reference/rest/v1/projects.databases.documents/get/).
+
+    ## Example Usage
+
+    Retrieve a document from the Firestore database.
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+    mydoc = gcp.firestore.Document("mydoc",
+        project=database["project"],
+        database=database["name"],
+        collection="somenewcollection",
+        document_id="my-doc-id")
+    ```
+
+
+    :param builtins.str collection: The name of the collection of documents.
+    :param builtins.str database: The name of the Firestore database.
+    :param builtins.str document_id: The id of the document to get.
+    :param builtins.str project: The project in which the database resides.
+    """
+    __args__ = dict()
+    __args__['collection'] = collection
+    __args__['database'] = database
+    __args__['documentId'] = document_id
+    __args__['project'] = project
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('gcp:firestore/getDocument:getDocument', __args__, opts=opts, typ=GetDocumentResult).value
+
+    return AwaitableGetDocumentResult(
+        collection=pulumi.get(__ret__, 'collection'),
+        create_time=pulumi.get(__ret__, 'create_time'),
+        database=pulumi.get(__ret__, 'database'),
+        document_id=pulumi.get(__ret__, 'document_id'),
+        fields=pulumi.get(__ret__, 'fields'),
+        id=pulumi.get(__ret__, 'id'),
+        name=pulumi.get(__ret__, 'name'),
+        path=pulumi.get(__ret__, 'path'),
+        project=pulumi.get(__ret__, 'project'),
+        update_time=pulumi.get(__ret__, 'update_time'))
+def get_document_output(collection: Optional[pulumi.Input[builtins.str]] = None,
+                        database: Optional[pulumi.Input[builtins.str]] = None,
+                        document_id: Optional[pulumi.Input[builtins.str]] = None,
+                        project: Optional[pulumi.Input[Optional[builtins.str]]] = None,
+                        opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetDocumentResult]:
+    """
+    Reads a document from a Firestore database.
+    See [the official documentation](https://cloud.google.com/firestore/native/docs/)
+    and
+    [API](https://cloud.google.com/firestore/docs/reference/rest/v1/projects.databases.documents/get/).
+
+    ## Example Usage
+
+    Retrieve a document from the Firestore database.
+
+    ```python
+    import pulumi
+    import pulumi_gcp as gcp
+
+    mydoc = gcp.firestore.Document("mydoc",
+        project=database["project"],
+        database=database["name"],
+        collection="somenewcollection",
+        document_id="my-doc-id")
+    ```
+
+
+    :param builtins.str collection: The name of the collection of documents.
+    :param builtins.str database: The name of the Firestore database.
+    :param builtins.str document_id: The id of the document to get.
+    :param builtins.str project: The project in which the database resides.
+    """
+    __args__ = dict()
+    __args__['collection'] = collection
+    __args__['database'] = database
+    __args__['documentId'] = document_id
+    __args__['project'] = project
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('gcp:firestore/getDocument:getDocument', __args__, opts=opts, typ=GetDocumentResult)
+    return __ret__.apply(lambda __response__: GetDocumentResult(
+        collection=pulumi.get(__response__, 'collection'),
+        create_time=pulumi.get(__response__, 'create_time'),
+        database=pulumi.get(__response__, 'database'),
+        document_id=pulumi.get(__response__, 'document_id'),
+        fields=pulumi.get(__response__, 'fields'),
+        id=pulumi.get(__response__, 'id'),
+        name=pulumi.get(__response__, 'name'),
+        path=pulumi.get(__response__, 'path'),
+        project=pulumi.get(__response__, 'project'),
+        update_time=pulumi.get(__response__, 'update_time')))

pulumi_gcp/gkeonprem/vmware_admin_cluster.py

@@ -943,6 +943,12 @@ class VmwareAdminCluster(pulumi.CustomResource):
                  vcenter: Optional[pulumi.Input[Union['VmwareAdminClusterVcenterArgs', 'VmwareAdminClusterVcenterArgsDict']]] = None,
                  __props__=None):
         """
+        A Google VMware Admin Cluster.
+
+        To get more information about VmwareAdminCluster, see:
+
+        * [API documentation](https://cloud.google.com/kubernetes-engine/distributed-cloud/reference/on-prem-api/rest/v1/projects.locations.vmwareAdminClusters)
+
         ## Example Usage
 
         ### Gkeonprem Vmware Admin Cluster Basic
@@ -1215,6 +1221,12 @@ class VmwareAdminCluster(pulumi.CustomResource):
                  args: VmwareAdminClusterArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        A Google VMware Admin Cluster.
+
+        To get more information about VmwareAdminCluster, see:
+
+        * [API documentation](https://cloud.google.com/kubernetes-engine/distributed-cloud/reference/on-prem-api/rest/v1/projects.locations.vmwareAdminClusters)
+
         ## Example Usage
 
         ### Gkeonprem Vmware Admin Cluster Basic

pulumi_gcp/networksecurity/backend_authentication_config.py

@@ -407,6 +407,12 @@ class BackendAuthenticationConfig(pulumi.CustomResource):
                  well_known_roots: Optional[pulumi.Input[builtins.str]] = None,
                  __props__=None):
         """
+        BackendAuthenticationConfig groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to the backend.
+
+        To get more information about BackendAuthenticationConfig, see:
+        * How-to Guides
+            * [Backend mTLS](https://cloud.google.com/load-balancing/docs/backend-authenticated-tls-backend-mtls#backend-authentication-config)
+
         ## Example Usage
 
         ### Network Security Backend Authentication Config Basic
@@ -551,6 +557,12 @@ class BackendAuthenticationConfig(pulumi.CustomResource):
                  args: Optional[BackendAuthenticationConfigArgs] = None,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
+        BackendAuthenticationConfig groups the TrustConfig together with other settings that control how the load balancer authenticates, and expresses its identity to the backend.
+
+        To get more information about BackendAuthenticationConfig, see:
+        * How-to Guides
+            * [Backend mTLS](https://cloud.google.com/load-balancing/docs/backend-authenticated-tls-backend-mtls#backend-authentication-config)
+
         ## Example Usage
 
         ### Network Security Backend Authentication Config Basic

pulumi_gcp/pulumi-plugin.json

@@ -1,5 +1,5 @@
 {
   "resource": true,
   "name": "gcp",
-  "version": "8.38.0"
+  "version": "8.39.0"
 }