doc-exports/docs/obs/tool-obsutil/obs_11_0050.html

Creating a Folder

Function

You can use this command to create a folder in a specified bucket or local file system.

No error is returned if a folder with the same name as an existing one is created, and the content of the existing folder remains unchanged.

Command Line Structure

• Windows
  • Creating a folder in a specified bucket

    obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] 

  • Creating a folder in the local file system

    obsutil mkdir folder_url [-config=xxx] 

• macOS or Linux
  • Creating a folder in a specified bucket

    ./obsutil mkdir obs://bucket/folder[/subfolder1/subfolder2] [-config=xxx] 

  • Creating a folder in the local file system

    ./obsutil mkdir folder_url [-config=xxx] 

Examples

• In Windows, run obsutil mkdir obs://bucket-test/folder1/folder2 to create a folder in the bucket.

  obsutil mkdir obs://bucket-test/folder1/folder2
  
  The bucket [bucket-test] does not support POSIX, create folder(s) step by step
  Create folder [obs://bucket-test/folder1/] successfully, request id [0000016979E1D23C860BB3D8E4577C5E]
  Create folder [obs://bucket-test/folder1/folder2] successfully, request id [0000016979E1D2B2860BB5181229C72C]

Parameter Description

Parameter	Optional or Mandatory	Description
bucket	Mandatory when creating a folder in a specified bucket	The bucket name
folder	Mandatory when creating a folder in a specified bucket	The folder path in the bucket. This value can contain multi-level folders. Separate each level with a slash (/).
folder_url	Mandatory when creating a folder in the local file system	The folder path in the local file system. The value can be an absolute path or a relative path.
bucket-cname	Optional (additional parameter)	The user-defined domain name bound to the bucket NOTE: This parameter is only supported by obsutil 5.7.9 and later.
config	Optional (additional parameter)	The user-defined configuration file for executing the current command. For details about parameters that can be configured, see Configuration Parameters.
payer	Optional (additional parameter)	Specifies that requester pays is enabled. Range: requester

Parent topic: Object Commands