大网数据广告活动
Kubernetes 部署与运维

TokenRequest

· 52CE 我爱测

- **metadata** (<a href="">ObjectMeta</a>)

apiVersion: authentication.k8s.io/v1

import "k8s.io/api/authentication/v1"

TokenRequest {#TokenRequest}

TokenRequest 为给定的服务账号请求一个令牌。

<hr>

  • apiVersion: authentication.k8s.io/v1

  • kind: TokenRequest

  • metadata (<a href="">ObjectMeta</a>)

    metadata 是标准的对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • spec (<a href="">TokenRequestSpec</a>)

    spec 包含与正被评估的请求相关的信息。

  • status (<a href="">TokenRequestStatus</a>)

    status 由服务器填充,表示该令牌是否可用于身份认证。

TokenRequestSpec {#TokenRequestSpec}

TokenRequestSpec 包含客户端提供的令牌请求参数。

<hr>

  • audiences ([]string)

    原子:将在合并期间被替换

    audiences 是令牌预期的受众。 令牌的接收方必须在令牌的受众列表中用一个标识符来标识自己,否则应拒绝该令牌。 为多个受众签发的令牌可用于认证所列举的任意受众的身份,但这意味着目标受众彼此之间的信任程度较高。

  • boundObjectRef (BoundObjectReference)

    boundObjectRef 是对令牌所绑定的一个对象的引用。该令牌只有在绑定对象存在时才有效。 注:API 服务器的 TokenReview 端点将校验 boundObjectRef,但其他受众可能不用这样。 如果你想要快速撤销,请为 expirationSeconds 设一个较小的值。

    <a name="BoundObjectReference"></a> BoundObjectReference 是对令牌所绑定的一个对象的引用。

    • boundObjectRef.apiVersion (string)

      引用对象的 API 版本。

    • boundObjectRef.kind (string)

      引用对象的类别。有效的类别为 “Pod” 和 “Secret”。

    • boundObjectRef.name (string)

      引用对象的名称。

    • boundObjectRef.uid (string) 引用对象的 UID。

  • expirationSeconds (int64)

    expirationSeconds 是请求生效的持续时间。 令牌签发方可能返回一个生效期不同的令牌,因此客户端需要检查响应中的 “expiration” 字段。

TokenRequestStatus {#TokenRequestStatus}

TokenRequestStatus 是一个令牌请求的结果。

<hr>

  • expirationTimestamp (Time)

    expirationTimestamp 是已返回令牌的到期时间。

    <a name="Time"></a> Time 是 time.Time 的包装器,支持正确编组为 YAML 和 JSON。为 time 包提供的许多工厂方法提供了包装器。

  • token (string)

    token 是不透明的持有者令牌(Bearer Token)。

操作 {#Operations}

<hr>

create 创建 ServiceAccount 的令牌

HTTP 请求

POST /api/v1/namespaces/{namespace}/serviceaccounts/{name}/token

参数

  • name (路径参数): string,必需

    TokenRequest 的名称。

  • namespace (路径参数): string,必需

    <a href="">namespace</a>

  • body: <a href="">TokenRequest</a>,必需

  • dryRun (查询参数): string

    <a href="">dryRun</a>

  • fieldManager (查询参数): string

    <a href="">fieldManager</a>

  • fieldValidation (查询参数): string

    <a href="">fieldValidation</a>

  • pretty (查询参数): string

    <a href="">pretty</a>

响应

200 (<a href="">TokenRequest</a>): OK

201 (<a href="">TokenRequest</a>): Created

202 (<a href="">TokenRequest</a>): Accepted

401: Unauthorized

来源:Kubernetes 文档贡献者 · 作者与贡献记录 · CC BY 4.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
Kubernetes 文档贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。