CreateDirectory - Object Storage Service - Centro de documentación de Alibaba Cloud

Esta operación permite crear un directorio. Solo se aplica a buckets que tienen habilitada la función de espacio de nombres jerárquico.

Notas

Para crear un directorio, debe contar con el permiso PutObject.
Al crear un directorio, OSS devuelve 200 OK si el directorio que desea crear tiene el mismo nombre que uno existente y usted cuenta con los permisos para acceder a dicho directorio. Sin embargo, OSS no ejecuta ninguna operación de creación.
No es posible importar datos al crear un directorio. El valor Content-Length del directorio solo puede establecerse en 0.
El valor Content-Type del directorio solo puede establecerse en application/x-directory y no es modificable.
La ruta absoluta del directorio no debe contener barras diagonales (/) consecutivas durante su creación.

Sintaxis

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

Encabezados de solicitud

Encabezado

Tipo

Obligatorio

Descripción

Authorization

String

Indica que la solicitud está autorizada. Para obtener más información, consulte RFC 2616.

El encabezado Authorization es obligatorio en la mayoría de los casos. Sin embargo, si utiliza una URL firmada en la solicitud, este encabezado no es necesario. Para obtener más información, consulte Generate a signed URL.

Valor predeterminado: null

Esta operación de API también debe incluir encabezados de solicitud comunes como Host y Date. Para obtener más información sobre los encabezados de solicitud comunes, consulte Common request headers.

Encabezados de respuesta

Los encabezados de respuesta de esta operación de API contienen únicamente encabezados de respuesta comunes. Para obtener más información, consulte Common response headers.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 de OSS

Puede usar los SDK de OSS para los siguientes lenguajes de programación con el fin de invocar la operación CreateDirectory:

Código de error

Código de error

Código de estado HTTP

Descripción

AccessDenied

403

Posibles causas:

No cuenta con los permisos necesarios para acceder al bucket especificado al intentar crear un directorio.
El directorio que intenta crear tiene el mismo nombre que uno existente, pero carece de los permisos para acceder a dicho directorio.

FileAlreadyExists

409

Este mensaje de error se devuelve porque ya existe un objeto con el mismo nombre en el mismo nivel de directorio. Por ejemplo: si el directorio desktop contiene un objeto llamado osstest, no es posible crear un directorio con el nombre osstest dentro de desktop.