amazon.aws.aws_account_attribute 查询 – 查询 AWS 账户属性
注意
此查询插件是 amazon.aws 集合 (版本 9.0.0) 的一部分。
如果您使用的是 ansible 包，则您可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。
要安装它，请使用：ansible-galaxy collection install amazon.aws。要使用此查询插件，您需要其他要求，请参阅 要求 了解详情。
要在剧本中使用它，请指定：amazon.aws.aws_account_attribute。
概要
描述您的 AWS 账户的属性。您可以指定列出的属性选择之一，也可以省略它以查看所有属性。
要求
以下要求是在执行此查询的本地控制器节点上需要的。
python >= 3.6
boto3 >= 1.28.0
botocore >= 1.31.0
关键字参数
这描述了查询的关键字参数。这些是在以下示例中的值 key1=value1，key2=value2 等：lookup('amazon.aws.aws_account_attribute', key1=value1, key2=value2, ...) 和 query('amazon.aws.aws_account_attribute', key1=value1, key2=value2, ...)
参数 |
注释 |
|---|---|
AWS 访问密钥 ID。 有关访问令牌的更多信息，请参阅 AWS 文档 https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys。 aws_access_key 和 profile 选项是互斥的。 为与 AWS botocore SDK 保持一致，在 5.1.0 版本中添加了 aws_access_key_id 别名。 ec2_access_key 别名已弃用，并将在 2024-12-01 之后的一个版本中删除。 配置
|
|
要获取其值(s)的属性。 选项
|
|
用于身份验证的命名 AWS 配置文件。 有关命名配置文件的更多信息，请参阅 AWS 文档 https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html。 profile 选项与 aws_access_key、aws_secret_key 和 security_token 选项互斥。 boto_profile 别名已弃用，并将在 2024-12-01 之后的一个版本中删除。 配置
|
|
要使用的 AWS 区域。 有关更多信息，请参阅 Amazon AWS 文档 http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region。 配置
|
|
AWS 密钥访问密钥。 有关访问令牌的更多信息，请参阅 AWS 文档 https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys。 secret_key 和 profile 选项是互斥的。 为与 AWS botocore SDK 保持一致，在 5.1.0 版本中添加了 aws_secret_access_key 别名。 别名ec2_secret_key已弃用，将在2024-12-01之后的发行版中移除。 配置
|
|
用于临时凭证的AWS STS会话令牌。 有关访问令牌的更多信息，请参阅 AWS 文档 https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys。 security_token和profile选项是互斥的。 别名aws_session_token和session_token在3.2.0版本中添加，参数名称在6.0.0版本中从security_token更改为session_token。 别名security_token、aws_security_token和access_token已弃用，将在2024-12-01之后的发行版中移除。 配置
|
备注
注意
注意：对于模块，环境变量和配置文件是从Ansible的“主机”上下文而不是“控制器”上下文读取的。因此，可能需要将文件显式复制到“主机”。对于查找和连接插件，环境变量和配置文件是从Ansible的“控制器”上下文而不是“主机”上下文读取的。
Ansible使用的AWS SDK (boto3)也可能从Ansible“主机”上下文中的配置文件（通常为
~/.aws/credentials）读取凭据和其他设置（例如区域）的默认值。更多信息，请参见https://boto3.amazonaws.com/v1/documentation/api/latest/guide/credentials.html。
示例
vars:
has_ec2_classic: "{{ lookup('aws_account_attribute', attribute='has-ec2-classic') }}"
# true | false
default_vpc_id: "{{ lookup('aws_account_attribute', attribute='default-vpc') }}"
# vpc-xxxxxxxx | none
account_details: "{{ lookup('aws_account_attribute', wantlist='true') }}"
# {'default-vpc': ['vpc-xxxxxxxx'], 'max-elastic-ips': ['5'], 'max-instances': ['20'],
# 'supported-platforms': ['VPC', 'EC2'], 'vpc-max-elastic-ips': ['5'], 'vpc-max-security-groups-per-interface': ['5']}
返回值
键 |
描述 |
|---|---|
当attribute为check_ec2_classic时返回布尔值。否则返回属性的值（如果没有指定，则返回所有属性的值）。 返回：success |