Informações e instruções das APIs dos produtos Locaweb.
Seguem as operações que podem ser realizadas com os Buckets.
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}
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}
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
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}
Também é possível redefinir um acesso a um bucket já existente.
1
PUT /{bucket}?acl HTTP/1.1
Através da API, é possível inserir um arquivo/pasta dentro de um bucket.
1
PUT /{bucket}/{object} HTTP/1.1
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}
Remove um objeto. Requer permissão de gravação definido no balde contendo.
1
DELETE /{bucket}/{object} HTTP/1.1
Utilizado para obter um objeto que está dentro de um bucket
1
GET /{bucket}/{object} HTTP/1.1
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