DeleteBucket

Documentación: DeleteBucket

Descripción

La operación DeleteBucket elimina el bucket especificado. Un bucket debe estar vacío antes de que pueda ser eliminado.

Solicitud

Método: DELETE

URI:

  • Estilo virtual-host: https://{bucket-name}.s3.latam-scl-x.datageneral.cl/

  • Estilo path: https://s3.latam-scl-x.datageneral.cl/{bucket-name}

Encabezados:

  • Host: Requerido. Especifica el nombre del bucket (para virtual-host) o el host del servicio (para path-style).

  • Date: Requerido. Fecha y hora de la solicitud.

  • Authorization: Requerido. Contiene la firma de la solicitud para la autenticación.

Cuerpo de la solicitud:

  • Vacío. No se requiere un cuerpo de solicitud para eliminar un bucket.

Respuesta

Códigos de estado:

  • 204 No Content: El bucket se eliminó exitosamente.

  • 400 Bad Request: La solicitud no se pudo procesar debido a un error del cliente.

  • 403 Forbidden: El cliente no tiene permiso para eliminar el bucket.

  • 404 Not Found: El bucket no existe.

  • 409 Conflict: El bucket no está vacío. Debe eliminar todos los objetos del bucket antes de eliminar el bucket.

  • Otros códigos de error: Pueden aplicar códigos de error específicos del servicio S3.

Encabezados de la respuesta:

  • Date: Fecha y hora de la respuesta.

  • x-amz-request-id: Un identificador único para la solicitud.

  • x-amz-id-2: Un identificador único extendido para la solicitud.

  • Server: Información sobre el servidor que procesó la solicitud.

Cuerpo de la respuesta:

  • Vacío. No hay contenido en el cuerpo de la respuesta.

Ejemplos

Ejemplo de solicitud (usando estilo virtual-host):

DELETE / HTTP/1.1
Host: my-bucket.s3.latam-scl-x.datageneral.cl
Date: Mon, 26 Jul 2024 13:00:00 GMT
Authorization: AWS AKIAIOSFODNN7EXAMPLE:QWxhZGVpbjEgXA==

Ejemplo de respuesta exitosa:

HTTP/1.1 204 No Content
Date: Mon, 26 Jul 2024 13:00:01 GMT
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server

Ejemplo de respuesta de error (el bucket no está vacío):

HTTP/1.1 409 Conflict
Date: Mon, 26 Jul 2024 13:00:01 GMT
Content-Type: application/xml
x-amz-request-id: 65423A7B884B82F1
Server: MyS3Server

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>BucketNotEmpty</Code>
  <Message>The bucket you tried to delete is not empty. You must delete all files in the bucket.</Message>
  <BucketName>my-bucket</BucketName>
  <RequestId>65423A7B884B82F1</RequestId>
  <HostId>xxxxxxxxxxxxxxxxxxxxx</HostId>
</Error>

Última actualización