Autogenerate BigQuery dataset (#348)

Signed-off-by: Modular Magician <magic-modules@google.com>

plugins/modules/gcp_bigquery_dataset_info.py

@@ -66,7 +66,7 @@ resources:
       type: str
     access:
       description:
-      - Access controls on the bucket.
+      - An array of objects that define dataset access for one or more entities.
       returned: success
       type: complex
       contains:
@@ -84,12 +84,19 @@ resources:
         role:
           description:
           - Describes the rights granted to the user specified by the other member
-            of the access object .
+            of the access object. Primitive, Predefined and custom roles are supported.
+            Predefined roles that have equivalent primitive roles are swapped by the
+            API to their Primitive counterparts, and will show a diff post-create.
+            See [official docs](U(https://cloud.google.com/bigquery/docs/access-control)).
           returned: success
           type: str
         specialGroup:
           description:
           - A special group to grant access to.
+          - 'Possible values include: * `projectOwners`: Owners of the enclosing project.'
+          - "* `projectReaders`: Readers of the enclosing project."
+          - "* `projectWriters`: Writers of the enclosing project."
+          - "* `allAuthenticatedUsers`: All authenticated BigQuery users. ."
           returned: success
           type: str
         userByEmail:
@@ -148,7 +155,33 @@ resources:
           type: str
     defaultTableExpirationMs:
       description:
-      - The default lifetime of all tables in the dataset, in milliseconds .
+      - The default lifetime of all tables in the dataset, in milliseconds.
+      - The minimum value is 3600000 milliseconds (one hour).
+      - Once this property is set, all newly-created tables in the dataset will have
+        an `expirationTime` property set to the creation time plus the value in this
+        property, and changing the value will only affect new tables, not existing
+        ones. When the `expirationTime` for a given table is reached, that table will
+        be deleted automatically.
+      - If a table's `expirationTime` is modified or removed before the table expires,
+        or if you provide an explicit `expirationTime` when creating a table, that
+        value takes precedence over the default expiration time indicated by this
+        property.
+      returned: success
+      type: int
+    defaultPartitionExpirationMs:
+      description:
+      - The default partition expiration for all partitioned tables in the dataset,
+        in milliseconds.
+      - Once this property is set, all newly-created partitioned tables in the dataset
+        will have an `expirationMs` property in the `timePartitioning` settings set
+        to this value, and changing the value will only affect new tables, not existing
+        ones. The storage in a partition will have an expiration time of its partition
+        time plus this value.
+      - 'Setting this property overrides the use of `defaultTableExpirationMs` for
+        partitioned tables: only one of `defaultTableExpirationMs` and `defaultPartitionExpirationMs`
+        will be used for any new partitioned table. If you provide an explicit `timePartitioning.expirationMs`
+        when creating or updating a partitioned table, that value takes precedence
+        over the default partition expiration time indicated by this property.'
       returned: success
       type: int
     description:
@@ -156,6 +189,11 @@ resources:
       - A user-friendly description of the dataset.
       returned: success
       type: str
+    etag:
+      description:
+      - A hash of the resource.
+      returned: success
+      type: str
     friendlyName:
       description:
       - A descriptive name for the dataset.
@@ -182,8 +220,17 @@ resources:
       type: int
     location:
       description:
-      - The geographic location where the dataset should reside. Possible values include
-        EU and US. The default value is US.
+      - The geographic location where the dataset should reside.
+      - See [official docs](U(https://cloud.google.com/bigquery/docs/dataset-locations)).
+      - There are two types of locations, regional or multi-regional. A regional location
+        is a specific geographic place, such as Tokyo, and a multi-regional location
+        is a large geographic area, such as the United States, that contains at least
+        two geographic places.
+      - 'Possible regional values include: `asia-east1`, `asia-northeast1`, `asia-southeast1`,
+        `australia-southeast1`, `europe-north1`, `europe-west2` and `us-east4`.'
+      - 'Possible multi-regional values: `EU` and `US`.'
+      - The default value is multi-regional location `US`.
+      - Changing this forces a new resource to be created.
       returned: success
       type: str
 '''