过滤 secret 和 secret 版本列表

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本页介绍了在 Secret Manager 中过滤 secret 和 secret 版本的过程。 在包含大量 secret 的环境中，过滤功能有助于快速识别特定 secret 或版本，而无需手动滚动浏览整个列表。您可以根据标签、创建日期或密钥名称中的特定模式等条件进行过滤，从而有针对性地管理特定组的密钥。

在 Secret Manager 中，您可以使用 Google Cloud 控制台中的过滤选项或在 API 调用中指定过滤条件来过滤密钥和密钥版本。在 Google Cloud CLI 中，您可以在列出密文时添加 filter 字符串，以过滤密文和密文版本。

过滤 Secret

如需过滤 Secret，请使用以下方法之一：

gcloud secrets list --filter="FILTER"

gcloud secrets list --filter="FILTER"

gcloud secrets list --filter="FILTER"

GET https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets?filter=FILTER

{}

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets?filter=FILTER"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://secretmanager.googleapis.com/v1/projects/PROJECT_ID/secrets?filter=FILTER" | Select-Object -Expand Content

{
  "secrets": [
    {
      "name": "projects/PROJECT_ID/locations/LOCATION/secrets/SECRET_ID",
      "createTime": "2024-09-02T07:14:00.281541Z",
      "etag": "\"16211dd90b37e7\""
    }
  ]
}

过滤 Secret 版本

如需过滤 Secret 版本，请执行以下操作：

• 在 Google Cloud 控制台中，选择要访问其版本的密钥，然后使用版本表中的过滤条件选项。

• 如果您使用的是 Google Cloud CLI 或 Secret Manager API，请在列出 Secret 版本时添加 filter 字符串。

过滤条件示例

过滤器语法

过滤器语法由要过滤的对象的一个或多个字段上的表达式组成。

您可以使用以下表达式运算符。

与 Cloud Search API 一致，除非使用圆括号明确定义其他顺序，否则 OR 操作会在 AND 操作之前进行求值。

过滤 time 值时，请将时间编码为 RFC 3399 格式的字符串，例如 2020-10-15T01:30:15Z。

访问子字段时，请使用点式语法。例如，Secret 资源可能包含 labels 字段，其值为键值对 map。如果使用 color 标签，您可以按子字段 labels.color 过滤 Secret 结果，如下所示：

labels.color=red

如果您只想列出设置了 color 标签的密文，请使用通配符：

labels.color:*

用英文引号引起来的一个字符串会被解释为单个值，而不是一系列值。

过滤字段

您可以按 Secret 或 SecretVersion 对象的任何字段进行过滤。

结果总数

后续步骤

• 了解如何修改 Secret。
• 了解如何为密钥设置到期日期。