Add a method to delete GCS objects

libcloudforensics/providers/gcp/internal/storage.py

@@ -159,3 +159,17 @@ def ListBucketObjects(self, bucket: str) -> List[Dict[str, Any]]:
     request = gcs_objects.list(bucket=bucket)
     objects = request.execute()  # type: Dict[str, Any]
     return objects.get('items', [])
+
+  def DeleteObject(self, gcs_path: str) -> None:
+    """Deletes an object in a Google Cloud Storage bucket.
+
+    Args:
+      gcs_path (str): Full path to the object (ie: gs://bucket/dir1/dir1/obj)
+    """
+
+    if not gcs_path.startswith('gs://'):
+      gcs_path = 'gs://' + gcs_path
+    bucket, object_path = SplitGcsPath(gcs_path)
+    gcs_objects = self.GcsApi().objects()
+    request = gcs_objects.delete(bucket=bucket, object=object_path)
+    request.execute()  # type: Dict[str, Any]

tools/cli.py

@@ -52,7 +52,8 @@
         'bucketacls': gcp_cli.GetBucketACLs,
         'objectmetadata': gcp_cli.GetGCSObjectMetadata,
         'listbuckets': gcp_cli.ListBuckets,
-        'listobjects': gcp_cli.ListBucketObjects
+        'listobjects': gcp_cli.ListBucketObjects,
+        'deleteobject': gcp_cli.DeleteObject
     }
 }
 
@@ -351,6 +352,10 @@ def Main() -> None:
             args=[
                 ('path', 'Path to bucket.', None),
             ])
+  AddParser('gcp', gcp_subparsers, 'deleteobject', 'Deletes a GCS object',
+            args=[
+                ('path', 'Path to GCS object.', None),
+            ])
 
   if len(sys.argv) == 1:
     parser.print_help()

tools/gcp_cli.py

@@ -273,3 +273,15 @@ def ListBucketObjects(args: 'argparse.Namespace') -> None:
     logger.info('{0:s} {1:s}b [{2:s}]'.format(
         obj.get('id', 'ID not found'), obj.get('size', 'Unknown size'),
         obj.get('contentType', 'Unknown Content-Type')))
+
+
+def DeleteObject(args: 'argparse.Namespace') -> None:
+  """Deletes an object in GCS.
+
+  Args:
+    args (argparse.Namespace): Arguments from ArgumentParser.
+  """
+  gcs = gcp_storage.GoogleCloudStorage(args.project)
+  gcs.DeleteObject(args.path)
+
+  print('Object deleted.')