Create Directory¶

Create a directory.

Prerequisites¶

The user must belong to the OU of the parent directory of the directory to be created.

Request Format¶

POST https://{apigw-address}/dataflow-batch-service/v2.0/directories?action=create&userId={}&orgId={}

Request Parameters (URI)¶

Name	Location (Path/Query)	Required or Not	Data Type	Description
userId	Query	true	String	User ID. How to get userId>>
orgId	Query	true	String	Organization ID which the user belongs to. How to get orgId>>

Request Parameters (Body)¶

Name	Required or Not	Data Type	Description
parentId	true	String	ID of the parent directory
dirName	true	String	Name of the directory to be created

Response Parameters¶

Name	Data Type	Description
data	DirectoryId Struct	Struct that contains the ID of the created directory. See DirectoryId Struct

DirectoryId Struct¶

Sample¶

{
  "dirId": "249a33bd419a4710b1567f5088f8955b"
}

Parameters¶

Name	Data Type	Description
dirId	String	ID of the created directory

Error Code¶

Code

Message

Description

62102

One of the following messages may be returned:

param: dirName cannot be empty
param: parentId cannot be empty
parentId not found
A directory of the same name already exists

Invalid parameter

62109

Server internal exception

Sample¶

Request Sample¶

url: https://{apigw-address}/dataflow-batch-service/v2.0/directories?action=create&userId={}&orgId={}

method: POST

requestBody:
{
  "dirName": "directory_name",
  "parentId": "249a33bd419a4710b1567f5088f8955b"
}

Return Sample¶

{
  "status": 0,
  "msg": " Success",
  "data": {
    "dirId": "62e3038840514caf9af60ad36878851e"
  }
}

Java SDK Sample¶

import com.alibaba.fastjson.JSONObject;
import com.envision.apim.poseidon.config.PConfig;
import com.envision.apim.poseidon.core.Poseidon;

public class Request extends PoseidonRequest {
    public void setQueryParam(String key, Object value){
        QueryParams().put(key, value);
    }
    public void setHeaderParam(String key, String value){
        headerParams().put(key, value);
    }
    public void setBodyParam(Map<String, Object> bodyPara){
        bodyParams().putAll(bodyPara);
    }
    public void setMethod(String method) {
        this.method = method;
    }
    private String method;
    public String baseUri() {
        return "";
    }
    public String method() {
        return method;
    }
}

@Test
public void CreateDirTest(){
        //1. Select Application Registration from the left navigation bar of EnOS Console.
        //2. Open the App Detail page to get the AccessKey and SecretKey of the application.
        String accessKey = "********************";
        String secretKey = "********************";

        //Create a request and save the required parameters in the map of the Query.
        Request request = new Request();
        HashMap<String,Object> hashMap = new HashMap<String, Object>(2);
        hashMap.put("dirName","strDIR");
        hashMap.put("parentId","**************");
        request.setQueryParam("userId","your_userId");
        request.setQueryParam("orgId","your_orgId");
        request.setBodyParam(hashMap);
        request.setMethod("POST");

        try {
            JSONObject response = Poseidon.config(PConfig.init().appKey(accessKey).appSecret(secretKey).debug())
                    .url("https://{apigw-address}/dataflow-batch-service/v2.0/directories?action=create")
                    .getResponse(request, JSONObject.class);

            System.out.println(response);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }