create
    • PDF

    create

    • PDF

    Article summary

    Available in VPC

    Generates a Data Forest account.

    Requests

    Request parameters

    Parameter nameRequirement statusTypeRestrictionsDescription
    nameYESString- Enter 2 to 16 characters.
    - Include lowercase English alphabets, numbers and hyphens (-)
    Data Forest account name
    passwordYESString- Enter 8 to 20 characters.
    - It should include at least one English uppercase and lowercase letter, special character, and number to be set.
    - Special characters of single quotation mark ('), double quotation mark ("), KRW currency symbol (₩), slash (/), ampersand (&), circumflex (`), and space can't be included.
    Data Forest account Password

    Request headers

    See common guide.

    Request Bodies

    • JSON
      {
          "name": "string",
          "password": "string"
      }
      
    • XML
      <?xml version="1.0" encoding="UTF-8"?>
      <CreateAccountRequest>
        <name>string</name>
        <password>string</password>
      </CreateAccountRequest>
      

    Responses

    Response bodies

    • JSON
      {
        "id": "string",
        "message": "string",
        "success": true
      }
      
    • XML
      <?xml version="1.0" encoding="UTF-8"?>
      <CreateAccountResponse>
        <id>string</id>
        <message>string</message>
        <success>true</success>
      </CreateAccountResponse>
      

    Errors

    See DataForest overview

    Examples

    Request examples

    • HTTP

      POST https://df.apigw.ntruss.com/api/v2/accounts/create
      HOST: df.apigw.ntruss.com
      Content-Type: application/json
      x-ncp-apigw-signature-v2: Azm1WBMWDgEONUCUbsVkB4tRIpc053uOHU8bitbQRtU=
      x-ncp-apigw-timestamp: 1658898041497
      x-ncp-iam-access-key: 17F9A6E9F72BD92ED94B
      
      {
        "name": "cloud1",
        "password": "8ghmuu8x"
      }
      
    • BASH

      curl -X POST "https://df.apigw.ntruss.com/api/v2/accounts/create" \
      -H "accept: application/json" \
      -H "Content-Type: application/json" \
      -H "x-ncp-apigw-timestamp:1505290625682" \
      -H "x-ncp-iam-access-key:D78BB444D6D3C84CA38A" \
      -H "x-ncp-apigw-signature-v2:WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=" \
      -d '{ "name": "cloud1", "password": "8ghmuu8x"}'\
      

    Response examples

    • HTTP

      HTTP StatusDescription
      200OK
    • BASH

      {
       "success": true,
      "id": "axE7wU9ERm8fTc7e17vNvu"
      }
      
      {
      "success": false,
       "message": "Data Forest can only create and use one account per user."
       }
      

    Errors examples

    • HTTP

      HTTP StatusDescription
      400invalid request parameters
    • BASH

      {
      "message": "invalid request parameter (password, 'qaZ123@'). 
      Please enter a valid password, which must be at least 8 characters in length and contain a combination of at least three types of the following: lowercase letters, uppercase letters, special characters and numbers.",
      "success": false
      }
      

    Was this article helpful?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.