CreateDirectory - Object Storage Service - Centre de documentation Alibaba Cloud

Notes

Pour créer un répertoire, vous devez disposer de l'autorisation PutObject.
Lors de la création d'un répertoire, OSS renvoie le code 200 OK si le répertoire cible porte le même nom qu'un répertoire existant et que vous disposez des autorisations nécessaires pour accéder à ce dernier. Toutefois, OSS n'effectue aucune opération de création.
Il est impossible d'importer des données lors de la création d'un répertoire. La valeur Content-Length du répertoire doit être définie sur 0.
La valeur Content-Type du répertoire doit être définie sur application/x-directory et ne peut pas être modifiée.
Le chemin absolu du répertoire ne doit pas contenir de barres obliques (/) consécutives lors de sa création.

Syntaxe

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

En-têtes de requête

Header

Type

Required

Description

Authorization

String

No

Indique que la requête est autorisée. Pour plus d'informations, consultez la norme RFC 2616.

L'en-tête Authorization est requis dans la plupart des cas. Toutefois, si vous utilisez une URL signée dans votre requête, cet en-tête n'est pas nécessaire. Pour plus d'informations, consultez la rubrique Générer une URL signée.

Valeur par défaut : null

Cette opération API doit également inclure les en-têtes de requête communs, tels que Host et Date. Pour plus d'informations sur les en-têtes de requête communs, consultez la rubrique En-têtes de requête communs.

En-têtes de réponse

Les en-têtes de réponse associés à cette opération API sont exclusivement des en-têtes de réponse communs. Pour plus d'informations, consultez la rubrique En-têtes de réponse communs.

Exemples

Exemple de requête

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

Exemple de réponse réussie

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

SDK OSS

Vous pouvez utiliser les SDK OSS pour les langages de programmation suivants afin d'appeler l'opération CreateDirectory :

Code d'erreur

Error code

HTTP status code

Description

AccessDenied

403

Causes possibles :

Lors de la création d'un répertoire, vous ne disposez pas des autorisations nécessaires pour accéder au bucket spécifié.
Lors de la création d'un répertoire, le répertoire cible porte le même nom qu'un répertoire existant, mais vous ne disposez pas des autorisations nécessaires pour accéder à ce dernier.

FileAlreadyExists

409

Ce message d'erreur indique qu'un objet existant situé au même niveau de répertoire porte déjà le même nom. Par exemple : le répertoire desktop contient un objet nommé osstest. Vous ne pouvez pas créer un répertoire nommé osstest dans le répertoire desktop.