MENU
      Server Data
        • PDF

        Server Data

        • PDF

        기사 요약

        VPC 환경에서 이용 가능합니다.

        서버 인스턴스와 관련된 최상위 메타데이터 카테고리 목록을 조회하고, 각 카테고리의 조회 값을 확인합니다.

        참고

        Metadata v2 호출 방식에 대한 자세한 내용은 Metadata v2 사용을 참조해 주십시오.

        요청

        요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

        호출 경로설명
        /{version}/meta-data/해당 버전에서 제공하는 서버 인스턴스와 관련된 최상위 메타데이터 카테고리를 목록으로 조회
        /{version}/meta-data/{field-1}/{field-2}/..제공하는 메타데이터 중 하위 항목이 있는 경우 하위 경로로 사용하여 조회
        • 리스트 형태의 데이터는 하위 항목으로 인덱스 목록이 제공되며, 인덱스 값을 하위 경로로 사용

        예시

        예시는 다음과 같습니다.

        Metadata v1

        Metadata v1 예시는 다음과 같습니다.

        # 최상위 메타데이터 카테고리 조회
        [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
        
        # 서버 인스턴스 이름 조회 예
        [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverName/
        test-server
        
        # 서버 인스턴스 상태 조회 예
        [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/
        code
        codeName
        
        # 서버 인스턴스 상태(serverInstanceStatus)의 하위 항목인 code 조회
        [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/serverInstanceStatus/code
        RUN
        
        # 서버 인스턴스에 할당된 네트워크 인터페이스 항목 조회
        [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/
        0
        1
        
        # 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
        [root@test-server ~]# curl http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0
        ***531
        [root@test-server ~]#
        Shell

        Metadata v2

        Metadata v2 예시는 다음과 같습니다.
        예시의 두 번째 이후 요청은 첫 번째 요청에서 생성한 토큰이 만료되지 않았다는 가정하에 해당 토큰을 사용한 예입니다.

        # 최상위 메타데이터 카테고리 조회
        [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
        
        # 서버 인스턴스 이름 조회 예
        [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverName/
        test-server
        
        # 서버 인스턴스 상태 조회 예
        [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/serverInstanceStatus/
        code
        codeName
        
        # 서버 인스턴스 상태(serverInstanceStatus)의 하위 항목인 code 조회
        [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest//meta-data/serverInstanceStatus/code
        RUN
        
        # 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
        [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/
        0
        1
        
        # 네트워크 인터페이스 항목 조회(networkInterfaceNoList) 결과 값인 인덱스 번호로 네트워크 인터페이스 ID 조회
        [root@test-server ~]# curl -H "X-NCP-METADATA-TOKEN: $TOKEN" http://169.254.169.254/latest/meta-data/networkInterfaceNoList/0
        ***531
        [root@test-server ~]#
        Shell

        최상위 메타데이터 카테고리 목록

        인스턴스 메타데이터의 최상위 카테고리 목록에 대한 설명은 다음과 같습니다.
        네이버 클라우드 플랫폼에서 메타데이터 카테고리를 릴리스하면 새 카테고리에 대한 메타데이터를 기존 인스턴스에서 사용하지 못할 수 있습니다.

        최상위 카테고리설명
        serverInstanceNo서버 인스턴스 번호
        serverName서버 인스턴스 이름
        serverDescription서버 인스턴스에 대한 설명
        cpuCount서버 인스턴스의 CPU 개수
        memorySize서버 인스턴스의 메모리 크기
        platformType서버 인스턴스의 운영체제 코드 및 코드 이름
        loginKeyName로그인 키 이름
        publicIpInstanceNo할당된 공인 IP 인스턴스의 번호
        publicIp할당된 공인 IP 주소
        serverInstanceStatus서버 인스턴스 가동 상태 코드 및 코드 이름
        serverInstanceOperation서버 인스턴스 오퍼레이션 코드 및 코드 이름
        serverInstanceStatusName서버 인스턴스 가동 상태
        createDate서버 인스턴스 생성일
        uptime서버스 인스턴스 업데이트 날짜
        serverImageProductCode서버 이미지 상품 코드
        serverProductCode서버 상품 코드
        isProtectServerTermination보호 반납 여부
        zoneCode존 코드
        regionCode리전 코드
        vpcNo서버 인스턴스가 생성된 VPC 번호
        subnetNo서버 인스턴스에서 사용 중인 기본 네트워크 인터페이지의 Subnet 번호
        networkInterfaceNoList할당된 네트워크 인터페이스 리스트
        initScriptNo초기화 스크립트 번호
        serverInstanceType서버 스펙 타입 코드 및 코드 이름
        baseBlockStorageDiskType블록 스토리지 디스크 타입
        baseBlockStorageDiskDetailType블록 스토리지 디스크 타입 상세
        placementGroupNo물리 배치 그룹 번호
        placementGroupName물리 배치 그룹 번호 이름
        iam서버 인스턴스의 IAM 역할 및 보안 인증 정보

        이 문서가 도움이 되었습니까?

        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.