操作场景

弹性云主机元数据包含了弹性云主机在云平台的基本信息，例如云服务ID、主机名、网络信息等。弹性云主机元数据支持两种风格，可以分别通过兼容Openstack和兼容EC2的API获取，如表 61所示。对于支持的元数据类型，本节详细介绍了其URI和使用方法。

使用须知

如果元数据中包含了敏感数据，您应当采取适当的措施来保护敏感数据，比如限制访问范围、加密等。

防火墙配置示例如下所示：

Windows

如果您不希望管理员之外的用户访问自定义用户数据，请以管理员身份开启防火墙后，在PowerShell 中执行下面的命令，阻止非管理员用户访问自定义用户数据：

PS C:\>$RejectPrincipal = New-Object -TypeName System.Security.Principal.NTAccount ("Everyone")

PS C:\>$RejectPrincipalSID = $RejectPrincipal.Translate([System.Security.Principal.SecurityIdentifier]).Value

PS C:\>$ExceptPrincipal = New-Object -TypeName System.Security.Principal.NTAccount ("Administrator")

PS C:\>$ExceptPrincipalSID = $ExceptPrincipal.Translate([System.Security.Principal.SecurityIdentifier]).Value

PS C:\>$PrincipalSDDL = "O:LSD:(D;;CC;;;$ExceptPrincipalSID)(A;;CC;;;$RejectPrincipalSID)"

PS C:\>New-NetFirewallRule -DisplayName "Reject metadata service for $($RejectPrincipal.Value), exception: $($ExceptPrincipal.Value)" -Action block -Direction out -Protocol TCP -RemoteAddress 169.254.169.254 -LocalUser $PrincipalSDDL

Linux

如果您不希望root之外的用户访问自定义用户数据，请以root用户权限执行下面的命令，阻止非root用户访问自定义用户数据：

iptables --append OUTPUT --proto tcp --destination 169.254.169.254 --match owner ! --uid-owner root --jump REJECT

弹性云主机元数据类别支持列表

表弹性云主机元数据类别支持列表

元数据类型	实例元数据项	约束说明
OpenStack类型	/meta_data.json	查询弹性云主机的元数据信息。元数据的关键字段请参见表 metadata 关键字段。
OpenStack类型	/password	查询弹性云主机的密码。Windows系统使用keypairs创建弹性云主机初始化时cloudbase-init用于保存密文密码。
OpenStack类型	/user_data	查询弹性云主机的用户数据。用户根据需要自行指定脚本和配置文件用于弹性云主机初始化，详细操作请参考用户数据注入。若linux虚拟化使用密码方式，则保存注入密码的脚本。
OpenStack类型	/network_data.json	查询弹性云主机的网络信息。
OpenStack类型	/securitykey	获取临时的AK、SK。对弹性云主机获取临时的AK、SK，需要在IAM上对op_svc_ecs帐户授权，并对相应的弹性云主机资源进行授权委托管理。
兼容EC2类型	/meta-data/hostname	查询弹性云主机的主机名称。请参考以下链接为弹性云主机去掉后缀.novalocal:弹性云主机的主机名带后缀novalocal，这正常吗？
兼容EC2类型	/meta-data/instance-type	查询弹性云主机的规格名称。
兼容EC2类型	/meta-data/local-ipv4	查询弹性云主机的固定IP地址。多网卡情况下，只显示主网卡的地址。
兼容EC2类型	/meta-data/placement/availability-zone	查询弹性云主机的AZ信息。
兼容EC2类型	/meta-data/public-ipv4	查询弹性云主机的弹性公网IP地址。多网卡情况下，只显示主网卡的弹性公网IP地址。
兼容EC2类型	/meta-data/public-keys/0/openssh-key	查询弹性云主机的公钥。
兼容EC2类型	/user-data	查询弹性云主机的用户数据。
兼容EC2类型	/meta-data/security-groups	查询弹性云主机所使用的安全组名称。

表 metadata关键字段

参数	参数类型	描述
uuid	String	弹性云主机的ID。
availability_zone	String	弹性云主机所在可用区。
meta	Dict	元数据信息，包括镜像名称、镜像ID、VPC ID等信息。
hostname	String	弹性云主机主机名。请参考以下链接为弹性云主机去掉后缀.novalocal:弹性云主机的主机名带后缀novalocal，这正常吗？

前提条件

已登录弹性云主机。
请确保安全组出方向规则满足如下要求，否则访问元数据请求失败：

− 协议：TCP

− 端口范围：80

− 远端地址：169.254.0.0/16


                    说明
                    如果您使用的是默认安全组出方向规则，则已经包括了如上要求，可以正常访问元数据。默认安全组出方向规则为：
协议：ANY
端口范围：ANY
远端地址：0.0.0.0/0

Metadata（OpenStack元数据API）

用于查询弹性云主机的元数据。

URI

/169.254.169.254/openstack/latest/meta_data.json
方法

支持GET请求。
示例：

Linux操作系统：以使用cURL工具为例，介绍查询弹性云主机元数据的方法。

curl http://169.254.169.254/openstack/latest/meta_data.json

Winodows操作系统：以使用Invoke-RestMethod工具为例，介绍查询弹性云主机元数据的方法。

Invoke-RestMethod http://169.254.169.254/openstack/latest/meta_data.json | ConvertTo-Json

{
"random_seed": "rEocCViRS+dNwlYdGIxJHUp+00poeUsAdBFkbPbYQTmpNwpoEb43k9z+96TyrekNKS+iLYDdRNy4kKGoNPEVBCc05Hg1TcDblAPfJwgJS1okqEtlcofUhKmL3K0fto+5KXEDU3GNuGwyZXjdVb9HQWU+E1jztAJjjqsahnU+g/tawABTVySLBKlAT8fMGax1mTGgArucn/WzDcy19DGioKPE7F8ILtSQ4Ww3VClK5VYB/h0x+4r7IVHrPmYX/bi1Yhm3Dc4rRYNaTjdOV5gUOsbO3oAeQkmKwQ/NO0N8qw5Ya4l8ZUW4tMav4mOsRySOOB35v0bvaJc6p+50DTbWNeX5A2MLiEhTP3vsPrmvk4LRF7CLz2J2TGIM14OoVBw7LARwmv9cz532zHki/c8tlhRzLmOTXh/wL36zFW10DeuReUGmxth7IGNmRMQKV6+miI78jm/KMPpgAdK3vwYF/GcelOFJD2HghMUUCeMbwYnvijLTejuBpwhJMNiHA/NvlEsxJDxqBCoss/Jfe+yCmUFyxovJ+L8oNkTzkmtCNzw3Ra0hiKchGhqK3BIeToV/kVx5DdF081xrEA+qyoM6CVyfJtEoz1zlRRyoo9bJ65Eg6JJd8dj1UCVsDqRY1pIjgzE/Mzsw6AaaCVhaMJL7u7YMVdyKzA6z65Xtvujz0Vo=",
"uuid": "ca9e8b7c-f2be-4b6d-a639-f10b4d994d04",
"availability_zone": "lt-test-1c",
"hostname": "ecs-ddd4-l00349281.novalocal",
"launch_index": 0,
"meta": {
"metering.image_id": "3a64bd37-955e-40cd-ab9e-129db56bc05d",
"metering.imagetype": "gold",
"metering.resourcespeccode": "s3.medium.1.linux",
"image_name": "CentOS 7.6 64bit",
"os_bit": "64",
"vpc_id": "3b6c201f-aeb3-4bce-b841-64756e66cb49",
"metering.resourcetype": "1",
"cascaded.instance_extrainfo": "pcibridge:2",
"os_type": "Linux",
"charging_mode": "0"
},
"project_id": "6e8b0c94265645f39c5abbe63c4113c6",
"name": "ecs-ddd4-l00349281"
}

User data（OpenStack元数据API）

用于查询弹性云主机的用户数据。该值仅在创建弹性云主机时指定，不支持修改。

URI

/169.254.169.254/openstack/latest/user_data
方法

支持GET请求。
示例

Linux操作系统：

curl http://169.254.169.254/openstack/latest/user_data

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/openstack/latest/user_data

ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==


                    说明
                    如果创建弹性云主机时未注入用户数据，此时，该接口的查询结果是404。

如下图所示，图 404 Not Found

Network data（OpenStack元数据API）

查询弹性云主机的网络信息

URI

/openstack/latest/network_data.json
方法

支持GET请求
示例


                    说明
                    instance_max_bandwidth、instance_min_bandwidth的单位是Mbps，如果取值为-1，说明对带宽大小无限制。

Linux操作系统：

curl http://169.254.169.254/openstack/latest/network_data.json

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/openstack/latest/network_data.json | ConvertTo-Json

{
"services": [{
"type": "dns",
"address": "xxx.xx.x.x"
},
{
"type": "dns",
"address": "100.1
25.21.250"
}],
"networks": [{
"network_id": "67dc10ce-441f-4592-9a80-cc709f6436e7",
"type": "i
pv4_dhcp",
"link": "tap68a9272d-71",
"id": "network0"
}],
"links": [{
"type": "cascading",
"vi
f_id": "68a9272d-7152-4ae7-a138-3ef53af669e7",
"ethernet_mac_address": "fa:16:3e:f7:c1:47",
"id": "tap68a9272d-71",
"mtu": null
}],
"qos":{
"instance_max_bandwidth": 1200,
"instance_min_bandwidth": 4000
}
}

Security Key（OpenStack元数据API）

获取临时的AK、SK。


                    说明
                    您如果需要在弹性云主机获取临时的AK、SK，需要在IAM对弹性云主机进行云服务委托授权，并对相应的弹性云主机资源进行授权委托管理。
临时的AK、SK有效期一个小时。临时AK、SK更新时间早于失效时间10分钟，10分钟内新旧临时AK、SK均可用。
使用临时AK、SK时，需要在消息的header中增加'X-Security-Token':{securitytoken}。其中，securitytoken就是调用接口返回的值。

URI

/openstack/latest/securitykey
方法

支持GET请求
示例
- Linux操作系统：curl http://169.254.169.254/openstack/latest/securitykey
- Windows操作系统：Invoke-RestMethod http://169.254.169.254/openstack/latest/securitykey

User data（EC2-兼容的API）

用于查询弹性云主机的用户数据。该值仅在创建弹性云主机时指定，不支持修改。

URI

/169.254.169.254/latest/user-data
方法

支持GET请求。

示例

Linux操作系统：

curl http://169.254.169.254/latest/user-data

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/user-data

ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==

Hostname（EC2-兼容的API）

用于查询弹性云主机的主机名称，后面会追加.novalocal后缀。

URI

/169.254.169.254/latest/meta-data/hostname
方法

支持GET请求
示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/hostname

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/hostname
```
vm-test.novalocal
```

Instance Type（EC2-兼容的API）

用于查询弹性云主机的规格名称。

URI
/169.254.169.254/latest/meta-data/instance-type
方法

支持GET请求。
示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/instance-type

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/instance-type
```
s3.medium.1
```

Local IPv4（EC2-兼容的API）

用于查询弹性云主机的固定IP地址。多网卡情况下，只显示主网卡的地址。

URI

/169.254.169.254/latest/meta-data/local-ipv4
方法

支持GET请求。
示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/local-ipv4

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/local-ipv4
```
192.1.1.2
```

Availability Zone（EC2-兼容的API）

用于查询弹性云主机的AZ信息。

URI

/169.254.169.254/latest/meta-data/placement/availability-zone
方法

支持GET请求。
示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/placement/availability-zone

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/placement/availability-zone
```
az1.dc1
```

Public IPv4（EC2-兼容的API）

用于查询弹性云主机的弹性公网IP地址。多网卡情况下，只显示主网卡的弹性公网IP地址。

/169.254.169.254/latest/meta-data/public-ipv4

方法

支持GET请求。

示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/public-ipv4

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/public-ipv4
```
46.1.1.2
```

Public Keys（EC2-兼容的API）

用于查询弹性云主机的公钥。

URI
/169.254.169.254/latest/meta-data/public-keys/0/openssh-key
方法

支持GET请求。

示例

Linux操作系统：

curl http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key

Windows操作系统：

Invoke-RestMethod http://169.254.169.254/latest/meta-data/public-keys/0/openssh-key

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDI5Fw5k8Fgzajn1zJwLoV3+wMP+6CyvsSiIc/hioggSnYu/AD0Yqm8vVO0kWlun1rFbdO+QUZKyVr/OPUjQSw4SRh4qsTKf/+eFoWTjplFvd1WCBZzS/WRenxIwR00KkczHSJro763+wYcwKieb4eKRxaQoQvoFgVjLBULXAjH4eKoKTVNtMXAvPP9aMy2SLgsJNtMb9ArfziAiblQynq7UIfLnN3VclzPeiWrqtzjyOp6CPUXnL0lVPTvbLe8sUteBsJZwlL6K4i+Y0lf3ryqnmQgC21yW4Dzu+kwk8FVT2MgWkCwiZd8gQ/+uJzrJFyMfUOBIklOBfuUENIJUhAB Generated-by-Nova

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

弹性云主机

弹性云主机

操作场景

使用须知

弹性云主机元数据类别支持列表

前提条件

Metadata（OpenStack元数据API）

User data（OpenStack元数据API）

Network data（OpenStack元数据API）

Security Key（OpenStack元数据API）

User data（EC2-兼容的API）

Hostname（EC2-兼容的API）

Instance Type（EC2-兼容的API）

Local IPv4（EC2-兼容的API）

Availability Zone（EC2-兼容的API）

Public IPv4（EC2-兼容的API）

Public Keys（EC2-兼容的API）

活动

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

弹性云主机

弹性云主机

操作场景

使用须知

弹性云主机元数据类别支持列表

前提条件

Metadata（OpenStack元数据API）

User data（OpenStack元数据API）

Network data（OpenStack元数据API）

Security Key（OpenStack元数据API）

User data（EC2-兼容的API）

Hostname（EC2-兼容的API）

Instance Type（EC2-兼容的API）

Local IPv4（EC2-兼容的API）

Availability Zone（EC2-兼容的API）

Public IPv4（EC2-兼容的API）

Public Keys（EC2-兼容的API）