createNasVolumeInstance

Available in Classic

Create a NAS volume instance.

Requests

The following describes the request format for the endpoint. The request format is as follows.

Method	URI
GET, POST	/createNasVolumeInstance

Request headers

For headers common to all NAS APIs, see NAS common headers.

Request query parameters

The following describes the parameters.

Field	Type	Required	Description
`volumeName`	String	Required	NAS volume name 3 to 20 characters; only English letter and numbers are allowed It is granted automatically if not entered Entered name is prefixed with "nMemberID_"for customer identification
`volumeSize`	Long	Required	Volume size 500 - 10,000 Enter in increments of 100 GB
`volumeAllotmentProtocolTypeCode`	String	Required	Volume allocation protocol type code `NFS` \| `CIFS` `NFS`: It can be mounted on Linux servers such as CentOS and Ubuntu `CIFS`: It can be mounted on Windows Servers
`accessControlRuleList.N.serverInstanceNo`	String	Conditional	Number of server instance to set with access control Check through the getServerInstanceList action Only either `serverInstanceNo` or `customIp` can be entered in a single rule `serverInstanceNo` or `customIp` is required when entering `accessControlRuleList.N.writeAccess`
`accessControlRuleList.N.customIp`	String	Conditional	Custom IP to set with access control Check through the getServerInstanceList action Public IPs can't be set; only private IPs can be set Only either `serverInstanceNo` or `customIp` can be entered in a single rule `serverInstanceNo` or `customIp` is required when entering `accessControlRuleList.N.writeAccess`
`accessControlRuleList.N.writeAccess`	Boolean	Optional	Set writing permissions `true` (default) \| `false` `true`: set `false`: not set
`cifsUserName`	String	Conditional	CIFS username Required when creating a CIFS-type volume for the first time It can't be changed after setup Enter 6 to 19 characters with a combination of English letters and numbers
`cifsUserPassword`	String	Conditional	CIFS user password Required when creating a CIFS-type volume for the first time Enter 8 to 14 characters with a combination of letters, numbers, and special characters (!@^&*) Passwords similar to the CIFS username are not allowed
`nasVolumeDescription`	String	Optional	Description of the volume (bytes) 0 - 1000
`regionNo`	String	Optional	Region code where the NAS volume instance will be created 1 - 5 (default: `1` (KR)) Check through the getRegionList action
`zoneNo`	String	Optional	Zone number where the NAS volume instance will be created Check through the getZoneList action (default: `3` (KR-2))
`isReturnProtection`	Boolean	Optional	Set termination protection `true` \| `false` (default) `true`: set `false`: not set
`isAsync`	Boolean	Optional	Set async `true` \| `false` (default) `true`: set `false`: not set

Request example

The following is a sample request.

curl --location --request GET 'https://ncloud.apigw.ntruss.com/server/v2/createNasVolumeInstance?volumeName=volume05&volumeSize=500&volumeAllotmentProtocolTypeCode=CIFS&accessControlRuleList.1.serverInstanceNo=23500000&accessControlRuleList.1.writeAccess=true&cifsUserName=user******&cifsUserPassword=*********&nasVolumeDescription=test&regionNo=1&zoneNo=3&isReturnProtection=false&isAsync=true' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Sub Account Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}'

Responses

The following describes the response format.

Response body

See NasVolumeInstance for the response body.

Response status codes

For response status codes common to NAVER Cloud Platform, see Ncloud API response status codes.

Response example

The following is a sample response.

{
    "createNasVolumeInstanceResponse": {
        "totalRows": 1,
        "nasVolumeInstanceList": [
            {
                "nasVolumeInstanceNo": "23500000",
                "nasVolumeInstanceStatus": {
                    "code": "INIT",
                    "codeName": "NAS INIT state"
                },
                "nasVolumeInstanceOperation": {
                    "code": "CREAT",
                    "codeName": "NAS CREAT OP"
                },
                "nasVolumeInstanceStatusName": "creating",
                "createDate": "2024-04-08T11:40:50+0900",
                "nasVolumeDescription": "test",
                "mountInformation": "\\\\10.250.00.00\\n2768364_volume05",
                "volumeAllotmentProtocolType": {
                    "code": "CIFS",
                    "codeName": "CIFS"
                },
                "volumeName": "n2768364_volume05",
                "volumeTotalSize": 536870912000,
                "volumeSize": 536870912000,
                "snapshotVolumeConfigurationRatio": 0.0,
                "snapshotVolumeSize": 0,
                "isSnapshotConfiguration": false,
                "isEventConfiguration": false,
                "region": {
                    "regionNo": "1",
                    "regionCode": "KR",
                    "regionName": "Korea"
                },
                "zone": {
                    "zoneNo": "3",
                    "zoneName": "KR-2",
                    "zoneCode": "KR-2",
                    "zoneDescription": "Pyeongchon zone",
                    "regionNo": "1"
                },
                "isReturnProtection": false,
                "nasVolumeInstanceCustomIpList": [],
                "nasVolumeServerInstanceList": []
            }
        ],
        "requestId": "",
        "returnCode": "0",
        "returnMessage": "success"
    }
}