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 ~]#
    

    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 ~]#
    

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

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

    최상위 카테고리설명
    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.