Fn::GetAtt
Fn::GetAtt 内部函数返回模板中的资源的属性值。
声明
JSON
{ "Fn::GetAtt" : [ "logicalNameOfResource", "attributeName" ] }
YAML
完整函数名称的语法：
Fn::GetAtt: [logicalNameOfResource,attributeName]
短格式的语法：
!GetAttlogicalNameOfResource.attributeName
参数
logicalNameOfResource-
包含所需属性的资源的逻辑名称 (也称为逻辑 ID)。
attributeName-
您想要获得其值的资源特定属性名称。有关该资源类型之可用属性的详细信息，请参阅资源的引用页面。
返回值
属性值。
示例
此示例代码段返回的字符串包含逻辑名称为 myELB 的负载均衡器的 DNS 名称。
JSON
"Fn::GetAtt" : [ "myELB" , "DNSName" ]
YAML
!GetAtt myELB.DNSName
以下示例模板将返回逻辑名称为 myELB 的负载均衡器 SourceSecurityGroup.OwnerAlias 和 SourceSecurityGroup.GroupName。
JSON
{ "AWSTemplateFormatVersion": "2010-09-09", "Resources": { "myELB": { "Type": "AWS::ElasticLoadBalancing::LoadBalancer", "Properties": { "AvailabilityZones": [ "eu-west-1a" ], "Listeners": [ { "LoadBalancerPort": "80", "InstancePort": "80", "Protocol": "HTTP" } ] } }, "myELBIngressGroup": { "Type": "AWS::EC2::SecurityGroup", "Properties": { "GroupDescription": "ELB ingress group", "SecurityGroupIngress": [ { "IpProtocol": "tcp", "FromPort": "80", "ToPort": "80", "SourceSecurityGroupOwnerId": { "Fn::GetAtt": [ "myELB", "SourceSecurityGroup", "OwnerAlias" ] }, "SourceSecurityGroupName": { "Fn::GetAtt": [ "myELB", "SourceSecurityGroup", "GroupName" ] } } ] } } } }
YAML
AWSTemplateFormatVersion: 2010-09-09 Resources: myELB: Type: 'AWS::ElasticLoadBalancing::LoadBalancer' Properties: AvailabilityZones: - eu-west-1a Listeners: - LoadBalancerPort: '80' InstancePort: '80' Protocol: HTTP myELBIngressGroup: Type: 'AWS::EC2::SecurityGroup' Properties: GroupDescription: ELB ingress group SecurityGroupIngress: - IpProtocol: tcp FromPort: '80' ToPort: '80' SourceSecurityGroupOwnerId: !GetAtt myELB.SourceSecurityGroup.OwnerAlias SourceSecurityGroupName: !GetAtt myELB.SourceSecurityGroup.GroupName
支持的函数
对于 Fn::GetAtt 逻辑资源名称，不能使用函数。必须指定作为资源逻辑 ID 的字符串。
对于 Fn::GetAtt 属性名称，可以使用 Ref 函数。
属性
您可以使用 Fn::GetAtt 检索以下属性：
| 资源类型名称 | 属性 | 说明 |
|---|---|---|
|
|
映射到自定义域名的 Amazon CloudFront 分配域名。 示例： |
|
|
|
示例： |
|
|
|
AWS Cloud9 开发环境的 Amazon 资源名称 (ARN)。 示例： |
|
|
|
AWS Cloud9 开发环境的名称。 示例： |
|
|
|
JSON 格式的字符串，包含指定等待条件的等待条件信号中的 具有两个信号的等待条件示例：
|
|
|
|
您指定的嵌套堆栈的输出值，其中， |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
与 CloudTrail 跟踪关联的 Amazon SNS 主题的 Amazon 资源名称 (ARN)。 示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
AWS::DirectoryService::MicrosoftAD 和 AWS::DirectoryService::SimpleAD |
|
目录的别名。 示例： |
|
AWS::DirectoryService::MicrosoftAD 和 AWS::DirectoryService::SimpleAD |
|
目录的 DNS 服务器的 IP 地址。 示例： |
|
|
示例： |
|
|
|
DynamoDB 表流的 Amazon 资源名称 (ARN)。要使用该属性，必须指定 DynamoDB Table 示例： |
|
|
|
AWS 分配的 ID，用于表示与 Amazon VPC 配合使用的地址的分配。该值仅针对 VPC 弹性 IP 地址返回。 示例： |
|
|
|
启动您指定的实例时所在的可用区。 示例： |
|
|
|
您指定的实例的私有 DNS 名称。 示例： |
|
|
|
您指定的实例的公有 DNS 名称。 示例： |
|
|
|
您指定的实例的私有 IP 地址。 示例： |
|
|
|
您指定的实例的公有 IP 地址。 示例： |
|
|
|
您指定的网络接口的主要私有 IP 地址。 示例： |
|
|
|
您指定的网络接口的辅助私有 IP 地址。 示例： |
|
|
|
指定安全组的组 ID。 示例： |
|
|
|
子网的可用区。 示例： |
|
|
|
与子网关联的 IPv6 CIDR 块的列表。 示例： |
|
|
|
与子网的 VPC 关联的网络 ACL 的 ID。 示例： |
|
|
|
子网 VPC 的 ID。 示例： |
|
|
|
附加到子网的 |
|
|
|
用于 VPC 的一组 IP 地址。 示例： |
|
|
|
VPC 的 IPv4 CIDR 块关联 ID 的列表。 示例： |
|
|
|
与 VPC 关联的默认网络 ACL ID，在您创建 VPC 时由 AWS 创建。 示例： |
|
|
|
与 VPC 关联的默认安全组 ID，在您创建 VPC 时由 AWS 创建。 示例： |
|
|
|
与 VPC 关联的 IPv6 CIDR 块的列表。 示例： |
|
|
|
示例： |
|
|
|
Amazon Elastic Container Service 服务的名称。 示例： |
|
|
|
Memcached 缓存群集的配置终端节点的 DNS 地址。 示例： |
|
|
|
Memcached 缓存群集的配置终端节点的端口号。 |
|
|
|
Redis 缓存群集的配置终端节点的 DNS 地址。 示例： |
|
|
|
Redis 缓存群集的配置终端节点的端口号。 |
|
|
|
缓存节点的 DNS 主机名。 |
|
|
|
缓存引擎正在侦听的端口号。 |
|
|
|
主要读/写缓存节点的 DNS 地址。 |
|
|
|
主要读/写缓存引擎正在侦听的端口号。 |
|
|
|
包含只读副本的终端节点列表的字符串。地址顺序从 示例： |
|
|
|
包含只读副本的端口列表的字符串。端口顺序从 示例： |
|
|
|
只读副本的终端节点的列表。 示例： |
|
|
|
只读副本的端口的列表。 示例： |
|
|
|
此环境的负载均衡器的 URL。 示例： |
|
|
|
与负载均衡器关联的 Route 53 托管区域的名称。 示例： |
|
|
|
与负载均衡器关联的 Route 53 托管区域名称的 ID。 示例： |
|
|
|
负载均衡器的 DNS 名称。 示例： |
|
|
|
您可以将其作为负载均衡器后端 Amazon EC2 应用程序实例入站规则的一部分使用的安全组。 示例： |
|
|
|
源安全组的所有者。 示例： |
|
|
|
应用程序负载均衡器的 DNS 名称。 示例： |
|
|
|
与负载均衡器关联的 Amazon Route 53 托管区域名称的 ID。 示例： |
|
|
|
应用程序负载均衡器的全名。 示例： |
|
|
|
应用程序负载均衡器的名称。 示例： |
|
|
|
应用程序负载均衡器的安全组的 ID。 示例： |
|
|
|
将流量路由至此目标组的负载均衡器的 Amazon 资源名称 (ARN)。 示例： |
|
|
|
目标组的全名。
示例： |
|
|
|
目标组的名称。
示例： |
|
|
|
域的 Amazon 资源名称 (ARN)。 示例： |
|
|
|
用于向 Amazon Elasticsearch Service 域提交索引、搜索和数据上传请求的特定于域的终端节点。 示例： |
|
|
|
主节点（实例）的公有 DNS 名称。 示例： |
|
|
|
示例： |
|
|
|
指定 示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
Arn |
示例：arn:aws-cn:iot:ap-southeast-2:123456789012:cert/a1234567b89c012d3e4fg567hij8k9l01mno1p23q45678901rs234567890t1u2 |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
Lambda 函数版本。 示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
AWS OpsWorks 实例的可用区。 示例： |
|
|
|
AWS OpsWorks 实例的私有 DNS 名称。 |
|
|
|
AWS OpsWorks 实例的私有 IP 地址。 |
|
|
|
AWS OpsWorks 实例的公有 DNS 名称。 |
|
|
|
AWS OpsWorks 实例的公有 IP 地址。 注意 要使用此属性，AWS OpsWorks 实例必须位于自动分配公有 IP 地址的 AWS OpsWorks 层。 示例： |
|
|
|
AWS OpsWorks 实例的 SSH 用户名称。 |
|
|
|
集群的连接终端节点。 示例： |
|
|
|
集群的连接端口。 示例： |
|
| AWS::RDS::DBCluster |
|
数据库群集的连接终端节点。 示例： |
|
|
数据库群集用于接受连接的端口号。 示例： |
|
|
|
数据库集群的读取器终端节点。 示例： |
|
|
|
数据库的连接终端节点。 示例： |
|
|
|
数据库实例接受连接的端口编号。 示例： |
|
|
|
特定托管区域的名称服务器集。 示例： 私有托管区域不支持该属性。 |
|
|
|
示例： |
|
|
|
指定存储段的 DNS 名称。 示例： |
|
|
|
指定存储桶的 IPv6 DNS 名称。 示例： |
|
|
|
指定存储桶的 Amazon S3 网站终端节点。 示例： |
|
|
无属性。 |
|
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
|
|
示例： |
|
| AWS::SNS::Topic | TopicName |
Amazon SNS 主题的名称。 示例： |
| AWS::StepFunctions::Activity | Name |
AWS Step Functions 活动的名称。 |
| AWS::StepFunctions::StateMachine | Name |
Step Functions 状态机的名称。 |
|
|
示例： |
|
|
|
Amazon SQS 队列的名称。 示例： |