This is an archive version of the document. To get the most up-to-date information, see the current version.

Creating Folders

You can create a new folder in an Azure container.

Request

POST https://<hostname>:4443/v5/AzureResources/containers/{containerName}/folders?accountId=<accountId>&regionType=<regionType>

Request Headers

The request header must contain an authorization token of the current session.

Request Parameters

The following parameters must be specified in the URL of the request:

Parameter

Type

Description

containerName

string

Specifies the container name. For more information on how to get this parameter, see Getting Containers.

accountId

string

Specifies the identification number of a cloud account. For more information on how to get this parameter, see Getting Accounts.

regionType

string

A region type of the object storage.

Request Body

The following table lists available request properties:

Property

Type

Description

name

string

Specifies the name for a new folder.

Request Example

Request:

POST https://abc.tech.local:4443/v5/AzureResources/containers/container1/folders?accountId=d558c923068b44cfb7f98f1c50f553b1&regionType=Global

 

Request Header:

Authorization: Bearer <Access-Token>

Request Body:

{

  "name": "RESTFolder"

}

Response

The server returns the following response to the client.

Response Codes

A successfully completed operation returns a response code 201 Created.

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTPS headers.

Header

Description

Content-length

The length of the response body.

Content-type

The media type and syntax of the response body message: application/json; charset=utf-8

Response Body

The response contains the following information:

Property

Type

Description

path

string

A folder path.

name

string

A folder name.

_links

Dictionary of string [key] and Object [value]

Links to related resources (navigation property).

Response Example

Response:

201 Created

 

Response Body:

{

  "path": "Veeam/Backup365/RESTFolder/",

  "_links":    {

     "self": {"href": "https://abc.tech.local:4443/v5/AzureResources/containers/container1/folders/Folder3?accountId=db1befe9-f6cc-4e94-b473-7d6b4a52a6bf&regionType=Global"},

     "account": {"href": "https://abc.tech.local:4443/v5/accounts/db1befe9-f6cc-4e94-b473-7d6b4a52a6bf"},

     "container": {"href": "https://abc.tech.local:4443/v5/AzureResources/containers/container1?accountId=db1befe9-f6cc-4e94-b473-7d6b4a52a6bf&RegionType=Global"}

  },

  "name": "RESTFolder"

}