--- title: "Server Data" slug: "compute-vmetadata-serverdata" updated: 2026-09-17T10:05:57Z published: 2026-09-17T10:05:57Z canonical: "api.ncloud-docs.com/compute-vmetadata-serverdata" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Server Data Available in VPC View the list of top-level metadata categories associated with a server instance, and view the query value for each category. Note See [Using Metadata v2](/docs/en/compute-vmetadata-metadatav2) for more information on how Metadata v2 is called. ## Request The following describes the request format for the endpoint. The request format is as follows: | Call path | Description | | --- | --- | | /{version}/meta-data/ | View the [list of top-level metadata categories](/docs/en/compute-vmetadata-serverdata#%EC%B5%9C%EC%83%81%EC%9C%84%EB%A9%94%ED%83%80%EB%8D%B0%EC%9D%B4%ED%84%B0%EC%B9%B4%ED%85%8C%EA%B3%A0%EB%A6%AC%EB%AA%A9%EB%A1%9D) associated with a server instance provided in the applicable version | | /{version}/meta-data/{field-1}/{field-2}/.. | If any of the provided metadata has sub items, use them as sub paths to query - List of indices are provided as a subsection to the list type data, and you can use the index value as a sub path | ## Examples See below for an example. ### Metadata v1 The following is an example of Metadata v1. ``` # View the top-level metadata category [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/ serverInstanceNo serverName serverDescription cpuCount memorySize platformType loginKeyName publicIpInstanceNo publicIp serverInstanceStatus serverInstanceOperation serverInstanceStatusName createDate uptime serverImageProductCode serverProductCode isProtectServerTermination zoneCode regionCode vpcNo subnetNo networkInterfaceNoList initScriptNo serverInstanceType baseBlockStorageDiskType baseBlockStorageDiskDetailType placementGroupNo placementGroupName iam # Server instance name query example [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverName/ test-server # Server instance status query example [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/ code codeName # View code, a sub item of server instance status (serverInstanceStatus) [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/code RUN # View network interface items assigned to a server instance [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/ 0 1 # View network interface ID by the index number that is the result of a network interface entry query (networkInterfaceNoList) [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0 ***531 [root@test-server ~]# ``` ### Metadata v2 The following is an example of Metadata v2. The second and subsequent requests in the example use the token generated by the first request, assuming it hasn't expired. ``` # View the top-level metadata category [root@test-server ~]# TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-NCP-METADATA-TOKEN-TTL-SECONDS: 21600"` \ && curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/ serverInstanceNo serverName serverDescription cpuCount memorySize platformType loginKeyName publicIpInstanceNo publicIp serverInstanceStatus serverInstanceOperation serverInstanceStatusName createDate uptime serverImageProductCode serverProductCode isProtectServerTermination zoneCode regionCode vpcNo subnetNo networkInterfaceNoList initScriptNo serverInstanceType baseBlockStorageDiskType baseBlockStorageDiskDetailType placementGroupNo placementGroupName iam # Server instance name query example [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverName/ test-server # Server instance status query example [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverInstanceStatus/ code codeName # View code, a sub item of server instance status (serverInstanceStatus) [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest//meta-data/serverInstanceStatus/code RUN # View network interface ID by the index number that is the result of a network interface entry query (networkInterfaceNoList) [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/ 0 1 # View network interface ID by the index number that is the result of a network interface entry query (networkInterfaceNoList) [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0 ***531 [root@test-server ~]# ``` ## List of top-level metadata categories The following describes the list of top-level categories of instance metadata. If you release a metadata category in NAVER Cloud Platform, metadata for the new category may not be available on existing instances. | Top-level category | Description | | --- | --- | | serverInstanceNo | Server instance number | | serverName | Server instance name | | serverDescription | Description of the server instance | | cpuCount | Number of CPUs for the server instance | | memorySize | Memory size of the server instance | | platformType | Operating system code and code name of the server instance | | loginKeyName | Login key name | | publicIpInstanceNo | Assigned public IP instance number | | publicIp | Assigned public IP address | | serverInstanceStatus | Operation status code and code name of the server instance | | serverInstanceOperation | Operation code and code name of the server instance | | serverInstanceStatusName | Server instance operation status | | createDate | Server instance creation date | | uptime | Server instance update date | | serverImageProductCode | Server image product code | | serverProductCode | Server product code | | isProtectServerTermination | Termination protection status | | zoneCode | Zone code | | regionCode | Region code | | vpcNo | Number of VPC in which the server instance is created | | subnetNo | Subnet number of the primary network interface being used by the server instance | | networkInterfaceNoList | List of assigned network interfaces | | initScriptNo | Initialization script number | | serverInstanceType | Server specification type code and code name | | baseBlockStorageDiskType | Block storage disk type | | baseBlockStorageDiskDetailType | Block storage disk type details | | placementGroupNo | Physical placement group number | | placementGroupName | Physical placement group number name | | iam | IAM role and security credentials for the server instance |