如何通过.NET获取GCP Secret Manager中所有密钥版本别名？

问题根源 #

你用GetSecretAsync获取的Secret对象里的VersionAliases，其实只包含指向当前最新版本的别名（比如默认的latest），并不是该Secret下所有版本的别名集合。别名是绑定到具体Secret版本的属性，而非Secret元数据本身的全局属性，所以直接读Secret对象拿不到全量别名。

正确获取所有版本别名的方法 #

要拿到所有版本的别名，需要先列出该Secret的所有版本，再逐个读取每个版本的元数据，从中提取别名。示例代码如下：

var versions = client.ListSecretVersionsAsync(secretName);
await foreach (var version in versions)
{
    // 跳过已销毁或禁用的版本
    if (version.State != SecretVersion.Types.State.Enabled)
        continue;

    // 读取当前版本的所有别名
    foreach (var alias in version.VersionAliases)
    {
        var value = await ReadAsync(client, secretName, alias);
        if (value != null)
            result.Add(alias, value);
    }
}

其他非整数版本访问密钥的方法 #

如果不想用整数版本ID，除了别名，还可以：

• 使用版本的名称字符串（格式为projects/{project}/secrets/{secret}/versions/{version_id}）直接读取，本质虽依赖版本ID，但可以把名称存在配置里替代硬编码整数。
• 给目标版本绑定专属别名，之后直接用别名调用ReadAsync，这种方式最直观，只要确保别名和版本的绑定关系在控制台或通过API配置正确。

内容的提问来源于stack exchange，提问作者André Moura