Add table gcp_storage_object. Closes #459

Author: karanpopat

docs/tables/gcp_storage_object.md

@@ -0,0 +1,75 @@
+# Table: gcp_storage_object
+
+Storage buckets are the basic containers that hold data. Everything that you store in cloud Storage must be contained in a bucket.
+
+## Examples
+
+### Basic info
+  
+```sql
+select
+  id,
+  name,
+  bucket,
+  content_type,
+  generation,
+  size,
+  storage_class,
+  time_created,
+  owner
+from
+  gcp_storage_object;
+```
+
+### List storage objects encrypted with customer managed keys
+
+```sql
+select
+  id,
+  name,
+  bucket
+from
+  gcp_storage_object
+where
+  not kms_key_name is not null;
+```
+
+### Get total objects and size of each bucket
+
+```sql
+select
+  bucket,
+  count(*) as total_objects,
+  sum(size) as total_size_bytes
+from
+  gcp_storage_object
+group by
+  bucket;
+```
+
+### List of members and their associated iam roles for each objects
+
+```sql
+select
+  bucket,
+  name,
+  p -> 'members' as member,
+  p ->> 'role' as role,
+  p ->> 'version' as version
+from
+  gcp_storage_object,
+  jsonb_array_elements(iam_policy -> 'bindings') as p;
+```
+
+### List of storage objects whose retention period is less than 7 days
+
+```sql
+select
+  bucket,
+  name,
+  extract(epoch from (retention_expiration_time - current_timestamp)) as retention_period_secs
+from
+  gcp_storage_object
+where
+  extract(epoch from (retention_expiration_time - current_timestamp)) < 604800;
+```

gcp/plugin.go

@@ -119,6 +119,7 @@ func Plugin(ctx context.Context) *plugin.Plugin {
 			"gcp_sql_database_instance_metric_cpu_utilization_daily":  tableGcpSQLDatabaseInstanceMetricCpuUtilizationDaily(ctx),
 			"gcp_sql_database_instance_metric_cpu_utilization_hourly": tableGcpSQLDatabaseInstanceMetricCpuUtilizationHourly(ctx),
 			"gcp_storage_bucket":                                      tableGcpStorageBucket(ctx),
+			"gcp_storage_object":                                      tableGcpStorageObject(ctx),
 			/*
 				https://github.com/turbot/steampipe/issues/108
 				"gcp_compute_route":                   tableGcpComputeRoute(ctx),