云主机的元数据（metadata）是描述云主机信息的数据，包含了天翼云系统中的默认元数据信息与用户自定义的元数据信息。在云主机内部，通过内网可以方便地查看该部分信息，并基于元数据信息配置或管理云主机。

云主机默认元数据

云主机创建过后，天翼云云主机会含有默认的元数据，以下为多可用区类型资源池下默认的元数据：

云主机自定义元数据

除了上述云主机元数据项，用户也可以增加相应的自定义元数据项。在云主机openapi元数据管理中，api对云主机操作的就是该部分元数据内容。

元数据的使用

查看默认元数据

通过console云主机列表界面选择对应云主机进行远程登录。

请求查询元数据的内网地址为 169.254.169.254。

我们可以根据上述默认元数据的表格，对所需元数据进行查看，对于Windows操作系统，使用网页http访问；对于Linux操作系统，我们可以使用curl命令进行查看，命令组成为：curl 169.254.169.254/{元数据项}。

示例shell脚本：

#!/usr/bin/bash
echo "======================instance metadata======================"
echo "instance owner account id: " $(curl -s 169.254.169.254/meta-data/owner-account-id)
echo "instance id: " $(curl -s 169.254.169.254/meta-data/instance-id)
echo "instance id: " $(curl -s 169.254.169.254/meta-data/instance-id)

效果：

云主机元数据OpenAPI的使用

目前，天翼云提供的元数据openapi提供对云主机自定义元数据进行操作与查看的能力，主要分为创建、更新、查询和删除。通过python示例文档 与openapi对应的文档，可以写出对应的openapi请求。

1. 创建自定义元数据

   首先，我们通过openapi创建元数据openapi文档来创建自定义元数据（{”test1“: "123", "test2": "abc"}）。

   # 按照创建云数据的openapi文档填写相关参数
   create_metadata_params = {
       "regionID": huadong1_region_id,
       "azName": huadong1_az1,
       "instanceID": huadong1_instance,
       "metadata": {
           "test1": "123",
           "test2": "abc"
       }
   }
   
   # 这里省略post方法的定义，该方法的实现请参考天翼云官网文档中的
   url = "https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/create"
   res_metadata_create = post(url, params=create_metadata_params)

   调用结果：

   {
       "returnObj": {
           "instanceID": "c44de03e-300b-7237-1827-b51aeaff3ccd",
           "metadata": {
               "test1": "123",
               "test2": "abc"
           }
       },
       "details": "",
       "message": "SUCCESS",
       "description": "成功",
       "statusCode": 800
   }

   通过之前的方式，使用自定义元数据项来查询自定义的元数据信息（test2.sh脚本如下）：

   #!/usr/bin/bash
   echo "======================instance metadata======================"
   echo "user-defined metadata: " $(curl -s 169.254.169.254/spec-meta-data)
   echo "test1: " $(curl -s 169.254.169.254/meta-data/instance/specs/test1)
   echo "test2: " $(curl -s 169.254.169.254/meta-data/instance/specs/test2)

   结果：

   

2. 查询自定义元数据

   同时，我们也可以调用openapi接口来查询自定义元数据。

   res_metadata_details = get("https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/details", params=dict(regionID=huadong1_region_id, azName=huadong1_az1, instanceID=huadong1_instance))

   调用结果：

   {
       "returnObj": {
           "metadata": {
               "test1": "123",
               "test2": "abc"
           }
       },
       "message": "SUCCESS",
       "description": "成功",
       "statusCode": 800
   }

3. 更新自定义元数据

   调用更新元数据接口：

   # 按照创建云数据的openapi文档填写相关参数
   update_metadata_params = {
       "regionID": huadong1_region_id,
       "azName": huadong1_az1,
       "instanceID": huadong1_instance,
       "metadata": {
           "test1": "789"
       }
   }
   
   # 这里省略post方法的定义，该方法的实现请参考天翼云官网文档中的
   url = "https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/update"
   res_metadata_update = post(url, params=update_metadata_params)

   在云主机内部进行curl查看情况：

   

   *覆盖方式更新（isForce=true）

   # 按照创建云数据的openapi文档填写相关参数
   update_metadata_params = {
       "regionID": huadong1_region_id,
       "azName": huadong1_az1,
       "instanceID": huadong1_instance,
       "isForce": True,
       "metadata": {
           "test3": "IGs9"
       }
   }
   
   # 这里省略post方法的定义，该方法的实现请参考天翼云官网文档中的
   url = "https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/update"
   res_metadata_update = post(url, params=update_metadata_params)

   在云主机内部进行curl查看情况：

   

4. 删除自定义元数据

   调用删除接口：

   res_metadata_delete = post("https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/delete", params=dict(regionID=huadong1_region_id, azName=huadong1_az1, instanceID=huadong1_instance))

   在云主机内部进行curl查看情况：

   

   示例：通过元数据配置云主机的python环境

   场景：在使用python过程中，我们经常需要安装很多依赖包，并且每个包之间互相有版本限制（比如在深度学习框架中，Keras与TensorFlow之间需要版本对应）。此时我们可以通过创建元数据，来记录该云主机所需要的python包环境的版本信息。

   首先，console界面远程登录云主机，进入远程界面后，查看当前python包信息：

   

   我们需要将关键的包的版本信息写入。

   这里我们以部分包为例，执行openapi创建云主机的自定义元数据：

   # 按照创建云数据的openapi文档填写相关参数
   create_metadata_params = {
       "regionID": huadong1_region_id,
       "azName": huadong1_az1,
       "instanceID": huadong1_instance,
       "metadta": {
           "requeirements": {
               "requests": "2.27.1"，
               "numpy": "1.16.6",
               "matplotlib": "2.2.5"
           }
       }
   }
   
   # 这里省略post方法的定义，该方法的实现请参考天翼云官网文档中的[python示例文档](https://www.ctyun.cn/document/10026730/10044097)
   url = "https://ctecs-global.ctapi.ctyun.cn/v4/ecs/metadata/create"
   res_metadata_create = post(url, params=create_metadata_params)

   执行结果：

   {
       "returnObj": {
           "instanceID": "c44de03e-300b-7237-1827-b51aeaff3ccd",
           "metadata": {
               "requeirements": {
                   "requests": "2.27.1",
                   "numpy": "1.16.6",
                   "matplotlib": "2.2.5"
               }
           }
       },
       "details": "",
       "message": "SUCCESS",
       "description": "成功",
       "statusCode": 800
   }

   在创建过元数据后，我们可以在云主机内使用相关脚本，对python进行相应的配置。

   python示例脚本（test.py）：

   import json
   import subprocess
   
   HOST = "169.254.169.254"
   URL = HOST + "/spec-meta-data"
   FILE_REQUEIRE = "requirements.txt"
   
   def send_command(command):
       command_ls = command.split()
       process = subprocess.Popen(command_ls, stdout=subprocess.PIPE)
       output, err = process.communicate()
       return output.decode("utf-8")
   
   if __name__ == "__main__":
       res = send_command("curl -s %s" % URL)
     
       metadata = json.loads(res)
       requeire_info = metadata.get("requeirements")
   
       with open(FILE_REQUEIRE, "w") as f:
           for k, v in requeire_info.items():
               write_info = "%s==%s" % (str(k), str(v))
               f.writelines(write_line)
       tsinghua_image = "https://pypi.tuna.tsinghua.edu.cn/simple" # 清华镜像站
       send_command("pip install -r %s -i %s" % (FILE_REQUEIRE, tsinghua_image))

   执行结果：

   

   可以看到，云主机的python环境中已经下载了对应的python包。在云主机出现问题时，后续也可以根据对应的python包信息进行相应的再次部署。