AWS实例元数据URL结构与EC2命令过滤器详解
立即解锁
发布时间: 2025-08-26 00:57:21 阅读量: 2 订阅数: 3 


AWS PowerShell实战:云基础设施自动化管理
### AWS实例元数据URL结构与EC2命令过滤器详解
#### 1. 元数据URL结构概述
元数据URL路径可用于访问实例的常见信息。以下是部分重要元数据URL路径及其描述:
| Path | Description |
| --- | --- |
| ami - id | 用于启动实例的AMI ID。 |
| ami - launch - index | 若同时启动多个实例,此值指示实例的启动顺序,第一个启动的实例值为0。 |
| ami - manifest - path | AMI在Amazon S3中的清单文件路径。若使用EBS支持的AMI启动实例,返回结果未知。 |
| ancestor - ami - ids | 用于创建此AMI的任何重新打包实例的AMI ID。仅当AMI清单文件包含ancestor - amis键时存在此值。 |
| block - device - mapping/ami | 包含根/引导文件系统的虚拟设备。 |
| block - device - mapping/ebsN | 与Amazon EBS卷关联的虚拟设备(若有)。仅在启动时存在此值,N表示Amazon EBS卷的索引(如ebs1或ebs2)。 |
| block - device - mapping/ephemeralN | 与临时设备关联的虚拟设备(若有),N表示临时卷的索引。 |
| block - device - mapping/root | 与根设备或虚拟设备上的分区关联的虚拟设备或分区,根(/或C:)文件系统与给定实例关联。 |
| block - device - mapping/swap | 与交换空间关联的虚拟设备,并非总是存在。 |
#### 2. 更多元数据URL路径
| Path | Description |
| --- | --- |
| hostname | 实例的私有主机名。若存在多个网络接口,指eth0设备(设备编号为0的设备)。 |
| iam/info | 返回实例配置文件最后更新的信息,包括实例的LastUpdated日期、InstanceProfileArn和InstanceProfileId。 |
| iam/security - credentials/role - name | role - name是与实例关联的IAM角色名称,返回与该IAM角色关联的临时安全凭证(AccessKeyId、SecretAccessKey、SessionToken和Expiration)。 |
| instance - action | 通知实例应重新启动以准备打包。有效值:none \| shutdown \| bundle - pending。 |
| instance - id | 此实例的ID。 |
| instance - type | 实例的类型。 |
| kernel - id | 与此实例一起启动的内核ID(若适用)。 |
| local - hostname | 实例的私有DNS主机名。若存在多个网络接口,指eth0设备。 |
| local - ipv4 | 实例的私有IP地址。若存在多个网络接口,指eth0设备。 |
| mac | 实例的媒体访问控制(MAC)地址。若存在多个网络接口,指eth0设备。 |
| network/interfaces/macs/mac/device - number | 与该接口关联的设备编号。每个接口必须有唯一的设备编号,设备编号用于实例中的设备命名提示,如eth2设备的设备编号为2。 |
| network/interfaces/macs/mac/ipv4 - associations/public - ip | 与每个公共IP地址关联并分配给该接口的私有IPv4地址。 |
| network/interfaces/macs/mac/local - hostname | 接口的本地主机名。 |
| network/interfaces/macs/mac/local - ipv4s | 与接口关联的私有IP地址。 |
| network/interfaces/macs/mac/mac | 实例的媒体访问控制(MAC)地址。 |
| network/interfaces/macs/mac/owner - id | 网络接口所有者的ID。在多接口环境中,接口可由第三方(如Elastic Load Balancing)附加,接口上的流量始终向接口所有者计费。 |
| network/interfaces/macs/mac/public - hostname | 接口的公共DNS。若实例在VPC中,仅当enableDnsHostnames属性设置为true时返回此类别。 |
#### 3. 网络相关元数据URL路径
| Path | Description |
| --- | --- |
| network/interfaces/macs/mac/public - ipv4s | 与接口关联的弹性IP地址,实例上可能有多个IP地址。 |
| network/interfaces/macs/mac/security - groups | 网络接口所属的安全组,仅适用于在VPC中启动的EC2实例。 |
| network/interfaces/macs/mac/security - group - ids | 网络接口所属安全组的ID,仅适用于在VPC中启动的EC2实例。 |
| network/interfaces/macs/mac/subnet - id | 接口所在子网的ID,仅适用于在VPC中启动的EC2实例。 |
| network/interfaces/macs/mac/subnet - ipv4 - cidr - block | 接口所在子网的CIDR块,仅适用于在VPC中启动的EC2实例。 |
| network/interfaces/macs/mac/vpc - id | 接口所在VPC的ID,仅适用于在VPC中启动的EC2实例。 |
| network/interfaces/macs/mac/vpc - ipv4 - cidr - block | 接口所在VPC的CIDR块,仅适用于在VPC中启动的EC2实例。 |
| placement/availability - zone | 实例启动所在的可用区。 |
| product - codes | 与实例关联的产品代码(若有)。 |
| public - hostname | 实例的公共DNS。若实例在VPC中,仅当enableDnsHostnames属性设置为true时返回此类别。 |
| public - ipv4 | 公共IP地址。若实例关联了弹性IP地址,返回的是弹性IP地址。 |
| public - keys/0/openssh - key | 公钥,仅在实例启动时提供时可用。 |
| ramdisk - id | 启动时指定的RAM磁盘ID(若适用)。 |
| reservation - id | 预留ID。 |
| security - groups | 应用于实例的安全组名称。 |
#### 4. EC2 “Get” 命令过滤器概述
EC2 “Get” 命令的过滤器在PowerShell帮助文件中未包含,但非常有用。以下是部分命令及对应过滤器的介绍。
#### 5. Get - EC2Address过滤器
| Filter | Description | Type |
| --- | --- | --- |
| domain | 指示地址是否用于VPC。有效值:standard \| vpc。 | String |
| instance - id | 地址关联的实例(若有)。 | String |
| public - ip | 弹性IP地址。 | String |
| allocation - id | 地址的分配ID(仅适用于VPC)。 | String |
| association - id | 地址的关联ID(仅适用于VPC)。 | String |
| network - interface - id | 地址关联的网络接口(若有,仅适用于VPC)。 | String |
| network - interface - owner - id | 所有者ID。 | String |
| private - ip - address | 与弹性IP地址关联的私有IP地址(仅适用于VPC)。 | String |
#### 6. Get - EC2AvailabilityZone过滤器
| Filter | Description | Type |
| --- | --- | --- |
| message | 有关可用区的信息。 | String |
| region - name | 可用区所在的区域(如us - east - 1)。 | String |
| state | 可用区的状态。有效值:available \| impaired \| unavailable。 | String |
| zone - name | 区域的名称。 | String |
#### 7. Get - EC2BundleTask过滤器
| Filter | Description | Type |
| --- | --- | --- |
| bundle - id | 捆绑任务的ID。 | String |
| error -
0
0
复制全文
相关推荐










