如何使用.NET在运行时检索Amazon EC2实例设置的标签

所需NuGet包 #

你当前项目已经引用的包完全覆盖需求，不需要额外安装新包：

• 核心依赖：已安装的AWSSDK.EC2（3.7.x为当前官方稳定维护版本，原生支持标签查询全量能力）
• 已安装的AWSSDK.Core为SDK基础运行依赖，无需额外调整版本

前置权限要求：需要给运行代码的EC2实例绑定的IAM角色授予ec2:DescribeInstances权限，否则API调用会返回权限拒绝错误。

实现逻辑 #

不需要硬编码实例ID，也不需要调用WorkSpaces专属服务接口：

1. 程序运行在EC2实例内部时，可通过SDK封装的元数据服务能力直接获取当前实例ID
2. 调用EC2标准接口查询实例详情，即可直接拿到和控制台展示完全一致的全量标签键值对

现代代码示例（基于AWS SDK for .NET 3.7版本） #

using Amazon.EC2;
using Amazon.EC2.Model;
using Amazon.Util;

// SDK会自动加载当前EC2实例关联角色的凭证，无需手动配置AccessKey/SecretKey
using var ec2Client = new AmazonEC2Client();

// 自动获取当前运行环境的EC2实例ID
var currentInstanceId = EC2InstanceMetadata.InstanceId;
if (string.IsNullOrWhiteSpace(currentInstanceId))
{
    throw new InvalidOperationException("程序未运行在EC2实例环境中，无法读取实例元数据");
}

// 构造实例查询请求
var queryRequest = new DescribeInstancesRequest
{
    InstanceIds = new List<string> { currentInstanceId }
};

var queryResponse = await ec2Client.DescribeInstancesAsync(queryRequest);
var targetInstance = queryResponse.Reservations.FirstOrDefault()?.Instances.FirstOrDefault();
if (targetInstance == null)
{
    throw new InvalidOperationException("查询实例信息失败，请检查IAM权限配置");
}

// 提取所有标签为键值对字典，和控制台展示的标签完全一致
var instanceTags = targetInstance.Tags.ToDictionary(t => t.Key, t => t.Value);

// 按需使用标签即可，示例：遍历打印所有标签
foreach (var (tagKey, tagValue) in instanceTags)
{
    Console.WriteLine($"标签名：{tagKey}，标签值：{tagValue}");
}

补充说明 #

• 如果你在项目中使用.NET Core/.NET 5+的依赖注入模式（配合官方AWSSDK.Extensions.NETCore.Setup包使用），直接通过DI注入IAmazonEC2实例替换上述代码中手动初始化的客户端即可，业务逻辑无需修改。
• 你找到的7年前的旧示例基于远古版本SDK编写，使用了已废弃的API签名和过时的元数据调用逻辑，上述代码基于当前官方稳定版SDK编写，不存在兼容问题。
• WorkSpaces底层关联的EC2实例标签与EC2控制台、WorkSpaces控制台展示的标签完全同步，通过EC2接口查询的结果不存在数据不一致问题。

内容的提问来源于stack exchange，提问作者Kevin MacDonald