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のサンプルコードは次の通りです。
    サンプルコードの2番目以降のリクエストは、最初のリクエストで生成したトークンの有効期限が切れていないと仮定して、そのトークンを使用した例です。

    # 最上位メタデータカテゴリの照会
    [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 ~]#
    

    最上位メタデータカテゴリリスト

    インスタンスメタデータの最上位カテゴリリストの説明は次の通りです。
    NAVERクラウドプラットフォームでメタデータカテゴリをリリースすると、新しいカテゴリのメタデータを既存のインスタンスで使用できない場合があります。

    最上位カテゴリ説明
    serverInstanceNoサーバインスタンス番号
    serverNameサーバインスタンス名
    serverDescriptionサーバインスタンスの説明
    cpuCountサーバインスタンスの CPU数
    memorySizeサーバインスタンスのメモリ容量
    platformTypeサーバインスタンスの OSコードとコード名
    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.