CreateDirectory - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

A permissão PutObject é necessária para criar um diretório.
Ao criar um diretório com o mesmo nome de um já existente, o OSS retorna 200 OK se você tiver permissão de acesso ao diretório existente. No entanto, nenhuma operação de criação é executada.
Não é possível importar dados durante a criação de um diretório. O valor de Content-Length do diretório deve ser obrigatoriamente 0.
O valor de Content-Type do diretório é restrito a application/x-directory e não pode ser modificado.
O caminho absoluto do diretório não pode conter barras consecutivas (/).

Sintaxe

POST /objectName?x-oss-dir HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Cabeçalhos da solicitação

Cabeçalho

Tipo

Obrigatório

Descrição

Authorization

String

Não

Indica que a solicitação está autorizada. Para mais informações, consulte a RFC 2616.

O cabeçalho Authorization é necessário na maioria dos casos. Contudo, se você utilizar uma URL assinada na solicitação, esse cabeçalho torna-se opcional. Para mais detalhes, veja Gerar uma URL assinada.

Valor padrão: null

Esta operação de API também requer cabeçalhos comuns, como Host e Date. Para saber mais sobre os cabeçalhos comuns de solicitação, consulte Cabeçalhos comuns de solicitação.

Cabeçalhos da resposta

Os cabeçalhos de resposta desta operação de API incluem apenas os cabeçalhos comuns. Para mais informações, consulte Cabeçalhos comuns de resposta.

Exemplos

Exemplos de solicitações

POST /desktop/oss?x-oss-dir HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 29 Apr 2021 05:21:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Exemplos de respostas de sucesso

HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
Date: Thu, 29 Apr 2021 05:21:12 GMT
Last-Modified: Wed, 24 Feb 2021 06:07:48 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS

SDKs do OSS

Use os SDKs do OSS nas linguagens de programação a seguir para chamar a operação CreateDirectory:

Código de erro

Código de erro

Código de status HTTPS

Descrição

AccessDenied

403

Possíveis causas:

Você não tem permissão para acessar o bucket especificado ao criar um diretório.
Você tentou criar um diretório com o mesmo nome de um existente, mas não tem permissão para acessar o diretório existente.

FileAlreadyExists

409

Esta mensagem de erro indica que já existe um objeto com o mesmo nome no mesmo nível de diretório. Por exemplo: se o diretório desktop contiver um objeto chamado osstest, não será possível criar um diretório com o nome osstest dentro dele.