checkAvailableName
    • PDF

    checkAvailableName

    • PDF

    Article summary

    Available in VPC

    View the name of the account that can be created when creating a Data Forest account.

    Requests

    Request parameters

    Parameter nameRequirement statusTypeRestrictionsDescription
    nameYESString- Enter 2 to 16 characters
    - Include lowercase English alphabets, numbers and hyphens (-)
    Name of the account that can be created when creating a Data Forest account

    Request header

    See common guide.

    Request body

    • JSON

      {
        "name": "string"
      }
      
    • XML

      <?xml version="1.0" encoding="UTF-8"?>
      <CheckAccountAvailableNameRequest>
        <name>string</name>
      </CheckAccountAvailableNameRequest>
      

    Responses

    Response bodies

    • JSON

        {
            "success": true,
            "availableName": true
        }
      
    • XML

      <?xml version="1.0" encoding="UTF-8"?>
        <CheckAccountAvailableNameResponse>
            <success>true</success>
            <message/>
            <availableName>true</availableName>
        </CheckAccountAvailableNameResponse>
      

    Errors

    See DataForest overview.

    Examples

    Request examples

    • HTTP
      POST https://df.apigw.ntruss.com/api/v2/accounts/checkAvailableName
      HOST: df.apigw.ntruss.com
      Content-Type: application/json
      x-ncp-apigw-timestamp: 1505290625682
      x-ncp-iam-access-key: D78BB444D6D3C84CA38A
      x-ncp-apigw-signature-v2: WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=
      {
        "name": "cloud1"
      }
      
    • BASH
      curl -X POST https://df.apigw.ntruss.com/api/v2/accounts/checkAvailableName \
      -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"}"
      

    Response examples

    • HTTP

      HTTP StatusDescription
      200OK
    • BASH

        {
            "success": true,
            "availableName": true
        }
      
      {
          "success": true,
          "message": "This account name is already in use.",
          "availableName": false
      }
      

    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.