MENU
      create

        create


        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"
          }
          JSON
        • XML
          <?xml version="1.0" encoding="UTF-8"?>
          <CreateAccountRequest>
            <name>string</name>
            <password>string</password>
          </CreateAccountRequest>
          XML

        Responses

        Response bodies

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

        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"
          }
          HTTP
        • 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"}'\
          Bash

        Response examples

        • HTTP

          HTTP StatusDescription
          200OK
        • BASH

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

        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
          }
          JSON

        Was this article helpful?

        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.