View a markdown version of this page

CreateBucket (API de SOAP) - Amazon Simple Storage Service

CreateBucket (API de SOAP)

nota

Las API de SOAP para Amazon S3 no están disponibles para nuevos clientes y se acercan al fin de la vida útil (EOL) el 31 de agosto de 2025. Le recomendamos que utilice la API de REST o los SDK de AWS.

La operación CreateBucket crea un bucket. No todas las cadenas tienen nombres de bucket aceptables. Para obtener información sobre las restricciones de nombres de los buckets, consulte Cómo trabajar con buckets de Amazon S3.

nota

Para determinar si existe un nombre de bucket, utilice ListBucket y establezca MaxKeys en 0. Una respuesta de NoSuchBucket indica que el bucket está disponible, una respuesta de AccessDenied indica que otra persona es propietaria del bucket y una respuesta de éxito indica que usted posee el bucket o que tiene permiso para acceder a él.

ejemplo Creación de un bucket llamado “quotes”

Sample Request

<CreateBucket xmlns="https://doc.s3.amazonaws.com/2006-03-01"> <Bucket>quotes</Bucket> <AWSAccessKeyId>AKIAIOSFODNN7EXAMPLE</AWSAccessKeyId> <Timestamp>2006-03-01T12:00:00.183Z</Timestamp> <Signature>Iuyz3d3P0aTou39dzbqaEXAMPLE=</Signature> </CreateBucket>

Sample Response

<CreateBucketResponse xmlns="https://s3.amazonaws.com/doc/2006-03-01"> <CreateBucketResponse> <Bucket>quotes</Bucket> </CreateBucketResponse> </CreateBucketResponse>

Elementos

  • Bucket: el nombre del bucket que está intentando crear.

  • AccessControlList: la lista de control de acceso para el bucket nuevo. Este elemento es opcional. Si no se proporciona, el bucket se crea con una política de acceso que otorga acceso de FULL_CONTROL al solicitante.

Control de acceso

Debe autenticarse con un ID de clave de acceso de AWS válido. Nunca se permite que las solicitudes anónimas creen buckets.

Activos relacionados