列出隧道证书

get /v1/organizations/tunnels/{tunnel_id}/certificates

列出隧道上注册的证书。

除非设置 include_archived，否则已归档的证书将被排除。

路径参数

• tunnel_id: string

  隧道的 ID。

查询参数

• include_archived: optional boolean

  在结果中包含已归档的证书。默认情况下排除已归档的证书。

• limit: optional number

  返回的最大证书数量。

• page: optional string

  一个隧道最多有两个活跃证书，因此此列表不分页。

请求头参数

• "anthropic-beta": array of "mcp-tunnels-2026-05-19"

  所有隧道端点都需要此参数。

  • "mcp-tunnels-2026-05-19"

返回值

• data: array of object { id, archived_at, created_at, 4 more }

  • id: string

    隧道证书的 ID。

  • archived_at: string

    RFC 3339 日期时间字符串，表示证书被归档的时间，如果未归档则为 null。

  • created_at: string

    RFC 3339 日期时间字符串，表示证书的注册时间。

  • expires_at: string

    RFC 3339 日期时间字符串，表示证书的过期时间，如果不过期则为 null。

  • fingerprint: string

    证书的 SHA-256 指纹，以小写十六进制字符串表示。

  • tunnel_id: string

    该证书注册所属隧道的 ID。

  • type: "tunnel_certificate"

    对象类型。隧道证书始终为 tunnel_certificate。

    • "tunnel_certificate"

• next_page: string

  下一页的不透明游标，如果没有更多结果则为 null。

示例

curl https://api.anthropic.com/v1/organizations/tunnels/$TUNNEL_ID/certificates \
    -H 'anthropic-version: 2023-06-01' \
    -H "Authorization: Bearer $ANTHROPIC_WIF_BEARER_TOKEN"

响应

{
  "data": [
    {
      "id": "tcrt_01JmWq4ZxnBvR7tKpY2sLdH9",
      "archived_at": "2024-11-01T23:59:27.427722Z",
      "created_at": "2024-10-30T23:58:27.427722Z",
      "expires_at": "2024-10-30T23:58:27.427722Z",
      "fingerprint": "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
      "tunnel_id": "tnl_01Hx9Kp2RtQvMn3sWbYdLcF8",
      "type": "tunnel_certificate"
    }
  ],
  "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
}