Developer Network

Documentação

Informações e instruções das APIs dos produtos Locaweb.

Operações com Bucket

Seguem as operações que podem ser realizadas com os Buckets.

1. Criando um Bucket

Para criar um bucket, você deve ter um ID de usuário e uma chave de acesso. Não é permitido criar buckets com um usuário anônimo.

1
2
3
4
5
PUT /{bucket} HTTP/1.1
Host: cname.domain.com
x-amz-acl: <span class="code-keyword">public</span>-read-write

Authorization: AWS {access-key}:{hash-of-header-and-secret}
2. Deletando um Bucket

A deleção de um Bucket, pode ser feita através do exemplo abaixo:

1
2
3
4
DELETE /{bucket} HTTP/1.1
Host: cname.domain.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}
3. Listando os objetos do Bucket

O exemplo de código abaixo, retorna uma lista de objetos dentro do bucket.

1
2
GET /{bucket}?max-keys=25 HTTP/1.1
Host: cname.domain.com
4. Listando as ACL do Bucket

ACLs são extremamente importantes na gestão de acesso de um Bucket.

O exemplo abaixo, exibe uma lista de controle de acesso a um determinado bucket.

1
2
3
4
GET /{bucket}?acl HTTP/1.1
Host: cname.domain.com

Authorization: AWS {access-key}:{hash-of-header-and-secret}
5. Alterando a ACL do Bucket

Também é possível redefinir um acesso a um bucket já existente.

1
PUT /{bucket}?acl HTTP/1.1
6. Adicionando um objeto a um Bucket

Através da API, é possível inserir um arquivo/pasta dentro de um bucket.

1
PUT /{bucket}/{object} HTTP/1.1
7. Copiando um objeto

Para copiar um objeto entre buckets, deve-se utilizar PUT, conforme o exemplo abaixo.

1
2
PUT /{dest-bucket}/{dest-object} HTTP/1.1
x-amz-copy-source: {source-bucket}/{source-object}
8. Removendo um objeto

Remove um objeto. Requer permissão de gravação definido no balde contendo.

1
DELETE /{bucket}/{object} HTTP/1.1
9. Obtendo um objeto

Utilizado para obter um objeto que está dentro de um bucket

1
GET /{bucket}/{object} HTTP/1.1
10. Listando informações de um objeto

Retorna informações sobre um objeto. Esta requisição irá retornar as mesmas informações de cabeçalho, entretanto irá incluir somente os metadados, e não a carga de dados do objeto.

1
HEAD /{bucket}/{object} HTTP/1.1