Delete a map item

If you do not have the AWS CLI yet, install and configure it.

In the terminal, run the aws s3api delete-object command:

aws s3api delete-object \
  --endpoint-url https://storage.yandexcloud.net \
  --bucket <bucket_name> \
  --key <object_key>

Where:

• --bucket: Name of your bucket
• --key: Object key

To delete multiple objects at once, provide the keys of these objects in the --delete parameter:

• Bash:

  aws s3api delete-objects \
    --endpoint-url=https://storage.yandexcloud.net \
    --bucket <bucket_name> \
    --delete '{"Objects":[{"Key":"<object_1_key>"},{"Key":"<object_2_key>"},...,{"Key":"<object_n_key>"}]}'
  

• PowerShell:

  aws s3api delete-objects `
    --endpoint-url=https://storage.yandexcloud.net `
    --bucket <bucket_name> `
    --delete '{\"Objects\":[{\"Key\":\"<object_1_key>\"},{\"Key\":\"<object_2_key>\"},...,{\"Key\":\"<object_n_key>\"}]}'
  

Where:

• --bucket: Bucket name
• <object_1_key>, <object_2_key>, <object_n_key>: Keys of the objects to be deleted

Result:

{
  "Deleted": [
      {
          "Key": "<object_1_key>",
          "VersionId": "null"
      },
      {
          "Key": "<object_2_key>",
          "VersionId": "null"
      }
      ...
      {
          "Key": "<object_n_key>",
          "VersionId": "null"
      }
  ]
}

You can specify objects for deletion using a query template in JMESPath format. To delete objects using a query template, run the following command:

• Bash:

  aws s3api list-objects \
    --endpoint-url https://storage.yandexcloud.net \
    --bucket <bucket_name> \
    --query '<query>' \
    --output text | xargs -I {} aws s3api delete-object --endpoint-url https://storage.yandexcloud.net --bucket <bucket_name> --key {}
  

  Where:

  • --bucket: Bucket name
  • --query: Query in JMESPath format

  Here is an example of the command that deletes from sample-bucket all objects located in the screenshots folder whose filenames start with 20231002:

  aws s3api list-objects \
    --endpoint-url https://storage.yandexcloud.net \
    --bucket sample-bucket \
    --query 'Contents[?starts_with(Key, `screenshots/20231002`) == `true`].[Key]' \
    --output text | xargs -I {} aws s3api delete-object --endpoint-url https://storage.yandexcloud.net --bucket sample-bucket --key {}
  

• PowerShell:

  Foreach($x in (aws s3api list-objects `
    --endpoint-url https://storage.yandexcloud.net `
    --bucket <bucket_name> `
    --query '<query>' `
    --output text)) `
    {aws s3api delete-object --endpoint-url https://storage.yandexcloud.net --bucket <bucket_name> --key $x}
  

  Where:

  • --bucket: Bucket name
  • --query: Query in JMESPath format

  Here is an example of the command that deletes from sample-bucket all objects located in the screenshots folder whose filenames start with 20231002:

  Foreach($x in (aws s3api list-objects `
    --endpoint-url https://storage.yandexcloud.net `
    --bucket sample-bucket `
    --query 'Contents[?starts_with(Key, `screenshots/20231002`) == `true`].[Key]' `
    --output text)) `
    {aws s3api delete-object --endpoint-url https://storage.yandexcloud.net --bucket sample-bucket --key $x}
  

Terraform allows you to quickly create a cloud infrastructure in Yandex Cloud and manage it using configuration files. Configuration files store the infrastructure description in the HashiCorp Configuration Language (HCL). Terraform and its providers are distributed under the Business Source License.

For more information about the provider resources, see the documentation on the Terraform website or the mirror.

If you change the configuration files, Terraform automatically detects which part of your configuration is already deployed, and what should be added or removed.

If you don't have Terraform, install it and configure the Yandex Cloud provider.

To delete an object created with Terraform from a bucket:

1. Open the Terraform configuration file and delete the fragment with the object description.

   Example object description in a Terraform configuration

   ...
   resource "yandex_storage_object" "cute-cat-picture" {
     access_key = "YCAJEX9Aw2ge********-w-lJ"
     secret_key = "YCONxG7rSdzVF9UMxLA_NRy5VbKzKlqZ********"
     bucket     = "cat-pictures"
     key        = "cute-cat"
     source     = "/images/cats/cute-cat.jpg"
   }
   ...
   

2. In the command line, go to the directory with the Terraform configuration file.

3. Check the configuration using this command:

   terraform validate
   

   If the configuration is correct, you will get this message:

   Success! The configuration is valid.
   

4. Run this command:

   terraform plan
   

   The terminal will display a list of resources with parameters. No changes will be made at this step. If the configuration contains any errors, Terraform will point them out.

5. Apply the configuration changes:

   terraform apply
   

6. Confirm the changes: type yes into the terminal and press Enter.

   You can check the changes in the management console.

Use the delete S3 API method.

1. To get the details of the lock applied to an object version, use the getObjectRetention (retention) and getObjectLegalHold (legal hold) S3 API methods.
2. If you only have the GOVERNANCE retention set and you have the storage.admin role, delete the object version using the delete S3 API method. In your request, specify the version ID and the X-Amz-Bypass-Governance-Retention header to confirm lock bypass.