The following command deletes an object named my-object from
the bucket my-bucket:
gdcloud storage rm s3://my-bucket/my-object
The following command deletes all objects directly within the directory
my-dir, but no objects within subdirectories:
gdcloud storage rm s3://my-bucket/my-dir/*
The following command deletes all objects and subdirectories within the
directory my-dir:
gdcloud storage rm s3://my-bucket/my-dir/**
Note that for buckets that contain versioned objects, the previous
command only affects live versions. Use the --recursive flag instead to
delete all versions.
The following command deletes all versions of all resources in my-bucket
and then deletes the bucket.
gdcloud storage rm --recursive s3://my-bucket/
The following command deletes all text files in the top-level of my-bucket,
but not text files in subdirectories:
gdcloud storage rm -recursive s3://my-bucket/*.txt
OPTIONAL FLAGS
-a, --all-versions Delete all versions of an object.
-c, --continue-on-error If any operations are unsuccessful, the command will exit with a non-zero
exit status after completing the remaining operations. This flag takes
effect only in sequential execution mode (i.e. processor and thread count
are set to 1). Parallelism is default.
--log-http Log all HTTP server requests and responses to stderr.
-r, --recursive Recursively delete the contents of buckets or directories that match
the path expression. If the path is set to a bucket, the bucket is also
deleted. This option implies the --all-versions option. If you want to
delete only live object versions, use the ** wildcard instead.
--verbosity string Override the default verbosity for this command. VERBOSITY must be one of:
debug, info, warning, error, critical, none. (default "warning")
GDCLOUD WIDE FLAGS
These flags are available to all commands: --configuration, --format, --help, --project, --quiet.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# gdcloud storage rm\n\nNAME\n----\n\ngdcloud storage rm - Delete objects and buckets.\n\nSYNOPSIS\n--------\n\n gdcloud storage rm [URLS ...]\n [--all-versions, -a]\n [--continue-on-error]\n [--recursive, -r]\n [--format=FORMAT]\n [--log-http]\n [--verbosity=VERBOSITY] [flags]\n\n### EXAMPLES\n\n The following command deletes an object named my-object from\n the bucket my-bucket:\n\n gdcloud storage rm s3://my-bucket/my-object\n\n The following command deletes all objects directly within the directory\n my-dir, but no objects within subdirectories:\n\n gdcloud storage rm s3://my-bucket/my-dir/*\n\n The following command deletes all objects and subdirectories within the\n directory my-dir:\n\n gdcloud storage rm s3://my-bucket/my-dir/**\n\n Note that for buckets that contain versioned objects, the previous\n command only affects live versions. Use the --recursive flag instead to\n delete all versions.\n\n The following command deletes all versions of all resources in my-bucket\n and then deletes the bucket.\n\n gdcloud storage rm --recursive s3://my-bucket/\n\n The following command deletes all text files in the top-level of my-bucket,\n but not text files in subdirectories:\n\n gdcloud storage rm -recursive s3://my-bucket/*.txt\n\n### OPTIONAL FLAGS\n\n -a, --all-versions Delete all versions of an object.\n -c, --continue-on-error If any operations are unsuccessful, the command will exit with a non-zero\n exit status after completing the remaining operations. This flag takes\n effect only in sequential execution mode (i.e. processor and thread count\n are set to 1). Parallelism is default.\n --log-http Log all HTTP server requests and responses to stderr.\n -r, --recursive Recursively delete the contents of buckets or directories that match\n the path expression. If the path is set to a bucket, the bucket is also\n deleted. This option implies the --all-versions option. If you want to\n delete only live object versions, use the ** wildcard instead.\n --verbosity string Override the default verbosity for this command. VERBOSITY must be one of:\n debug, info, warning, error, critical, none. (default \"warning\")\n\n### GDCLOUD WIDE FLAGS\n\nThese flags are available to all commands: `--configuration`, `--format`, `--help`, `--project`, `--quiet`.\n\nFor more information, see the [gdcloud CLI reference overview](/distributed-cloud/hosted/docs/latest/appliance/resources/gdcloud-reference/gdcloud) page."]]