ec2-metadata 2.13.0

account_id: str

当前AWS账户ID，例如'123456789012'。

ami_id: str

启动实例使用的AMI的ID，例如'ami-123456'。

autoscaling_target_lifecycle_state: str | None

未缓存。实例正在过渡到的目标自动扩展生命周期状态，或者如果实例不在自动扩展组中则为None。请参阅AWS文档页面通过实例元数据检索目标生命周期状态。

availability_zone: str

当前可用区的名称，例如'eu-west-1a'。

availability_zone_id: str | None

当前可用区的唯一、跨账户ID，例如'use1-az6'。请参阅AWS文档页面AWS资源的AZ ID。

ami_launch_index: int

实例在启动请求中的索引，基于零，例如0。

ami_manifest_path: str

Amazon S3中AMI清单文件的路径，或者对于基于EBS的AMI为'(unknown)'。

clear_all() -> None

清除类上的所有缓存的属性，这意味着它们下一次访问将重新从元数据API获取数据。这包括清除用于与该服务进行身份验证的令牌。

domain: str

区域AWS资源的域名。例如，对于标准AWS区域和GovCloud (US)为'amazonaws.com'，对于中国为'amazonaws.com.cn'。

iam_info: IamInfoDict | None

实例附加的 IAM 角色的数据字典，或者如果没有附加角色则为 None。该字典类型基于元数据服务返回的内容。

class IamInfoDict(TypedDict):
    InstanceProfileArn: str
    InstanceProfileId: str
    LastUpdated: str

iam_security_credentials: IamSecurityCredentialsDict | None

与实例附加的 IAM 角色关联的安全凭证的数据字典，或者如果没有附加角色则为 None。有关详细信息，请参阅AWS 文档中“从实例元数据检索安全凭证”部分。该字典类型基于该文档。

class IamSecurityCredentialsDict(TypedDict):
    LastUpdated: str
    Type: str
    AccessKeyId: str
    SecretAccessKey: str
    Token: str
    Expiration: str

instance_action: str

未缓存。一个表示实例将重启以准备打包的状态。请参阅AWS 文档中“实例元数据类别”部分以获取有效值。

instance_id: str

当前实例的 ID，例如 'i-123456'

instance_identity_document: InstanceIdentityDocumentDict

关于实例的动态数据字典。请参阅AWS 文档中“实例身份证明文件”页面以了解内容解释。该字典类型基于该文档。

class InstanceIdentityDocumentDict(TypedDict):
    accountId: str
    architecture: Literal["i386", "x86_64", "arm64"]
    availabilityZone: str
    billingProducts: list[str] | None
    marketplaceProductCodes: list[str] | None
    imageId: str
    instanceId: str
    instanceType: str
    kernelId: str | None
    pendingTime: str
    privateIp: str
    ramdiskId: str | None
    region: str
    version: str

instance_profile_arn: str | None

实例附加的 IAM 角色或实例配置文件的 ARN，取自 iam_info，或者如果没有附加角色则为 None。

instance_profile_id: str | None

实例附加的 IAM 角色或实例配置文件的 ID，取自 iam_info，或者如果没有附加角色则为 None。

instance_profile_name: str | None

实例配置文件名称，从 instance_profile_arn 中提取，或者如果没有附加角色则为 None。

instance_type: str

当前实例的类型，例如 't2.nano'

kernel_id: str | None

当前实例的内核 ID，如果没有则为 None，例如 'aki-dc9ed9af'。

mac: str

实例的 MAC 地址，例如 '0a:d2:ae:4d:f3:12'

network_interfaces: dict[str, NetworkInterface]

一个从 MAC 地址到 NetworkInterface 的字典，表示网络接口上的数据 - 请见下文。例如 {'01:23:45:67:89:ab': NetworkInterface('01:23:45:67:89:ab')}}

partition: str

实例正在运行的 AWS 分区。例如，对于标准 AWS 区域为 'aws'，对于美国政府云为 'aws-us-gov'，对于中国为 'aws-cn'。

private_hostname: str

实例的私有 IPv4 DNS 主机名，例如 'ip-172-30-0-0.eu-west-1.compute.internal'。

private_ipv4: str

实例的私有 IPv4 地址，例如 '172.30.0.0'。

public_hostname: str | None

实例的公共 DNS 主机名，如果实例不是公共的则为 None，例如 'ec2-1-2-3-4.compute-1.amazonaws.com'。

public_ipv4: str | None

实例的公共 IPv4 地址，如果实例不是公共的则为 None，例如 '1.2.3.4'。

region: str

实例正在运行的区域，例如 'eu-west-1'。

reservation_id: str

用于启动实例的预订ID，例如 'r-12345678901234567'。

security_groups : 列表[str]

按名称列出的安全组列表，例如 ['ssh-access', 'custom-sg-1']。

spot_instance_action: SpotInstanceAction | None

未缓存。 描述即将对该spot实例执行的操作的对象。如果实例不是spot实例，或者未标记为终止，则返回 None。

SpotInstanceAction对象有两个属性

• action: str - 即将执行的操作，可以是 "hibernate"、"stop" 或 "terminate" 之一。

• time: datetime - 动作发生的UTC时间的大致日期和时间。

有关更多信息，请参阅AWS文档部分。

tags: InstanceTags

实例标签的类似字典映射（如下所述）。这需要您为实例显式启用功能。如果未启用此功能，访问此属性将引发错误。

（似乎还有一个错误，如果启用了该功能然后又禁用，元数据服务会返回一个空响应。这无法与“没有标签”区分开来，所以请注意，在这种情况下，InstanceTags 将仅看起来像一个空映射。）

user_data: bytes | None

分配给实例的原始用户数据（非base64编码），如果没有则返回 None。

device_number: int

与该接口关联的唯一设备号，例如 0。

interface_id: str

用于识别弹性网络接口的唯一ID，例如 'eni-12345'。

ipv4_associations: dict[str, list[str]]

将接口上的公共IP地址映射到与该公共IP关联的私有IP地址列表的字典，对于与接口关联的每个公共IP，例如 {'54.0.0.1': ['172.30.0.0']}。

ipv6s: list[str]

与接口关联的IPv6地址，例如 ['2001:db8:abcd:ef00::1234']。

mac: str

接口的MAC地址，例如 '01:23:45:67:89:ab'。

owner_id: str

网络接口所有者的AWS账户ID，例如：'123456789012'。

private_hostname: str

接口的本地/私有主机名，例如：'ip-172-30-0-0.eu-west-1.compute.internal'。

private_ipv4s: list[str]

与接口关联的私有IPv4地址，例如：['172.30.0.0']。

public_hostname: str | None

接口的公共DNS（IPv4），例如：'ec2-54-0-0-0.compute-1.amazonaws.com'。

public_ipv4s: list[str]

与接口关联的弹性IP地址，例如：['54.0.0.0']。

security_groups: list[str]

网络接口所属的安全组名称，例如：['ssh-access', 'custom-sg-1']。

security_group_ids: list[str]

网络接口所属的安全组名称，例如：['sg-12345678', 'sg-12345679']。

subnet_id: str

接口所在的子网ID，例如：'subnet-12345678'。

subnet_ipv4_cidr_block: str | None

接口所在的子网的IPv4 CIDR块，如果没有则为None，例如：'172.30.0.0/24'。

subnet_ipv6_cidr_blocks: list[str]

接口所在的子网的IPv6 CIDR块列表，例如：['2001:db8:abcd:ef00::/64']。如果子网没有IPv6 CIDR块或实例不在VPC中，列表将为空，例如：[]。

vpc_id: str

接口所在的VPC ID，例如：'vpc-12345678'。

vpc_ipv4_cidr_block: str | None

VPC的IPv4 CIDR块，如果实例不在VPC中则为None，例如：'172.30.0.0/16'。

vpc_ipv4_cidr_blocks: list[str]

IPv4 CIDR块列表，例如：['172.30.0.0/16']。如果接口没有此类CIDR块，列表将为空。

vpc_ipv6_cidr_blocks: list[str]

接口所在的VPC的IPv6 CIDR块列表，例如：['2001:db8:abcd:ef00::/56']。如果VPC没有IPv6 CIDR块或实例不在VPC中，列表将为空，例如：[]。