6.8. TokenRequest [authentication.k8s.io/v1]


Description
TokenRequest は、指定のサービスアカウントのトークンを要求します。
タイプ
object
必須
  • spec

6.8.1. 仕様

Expand
プロパティータイプ説明

apiVersion

string

APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。

kind

string

kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。

metadata

ObjectMeta

標準オブジェクトのメタデータ。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata を参照してください。

spec

object

TokenRequestSpec には、トークンリクエストのクライアント提供パラメーターが含まれています。

status

object

TokenRequestStatus は、トークンリクエストの結果です。

6.8.1.1. .spec

Description
TokenRequestSpec には、トークンリクエストのクライアント提供パラメーターが含まれています。
タイプ
object
必須
  • audiences
Expand
プロパティータイプDescription

audiences

array (string)

オーディエンスは、トークンの意図されたオーディエンスです。トークンの受信者は、トークンのオーディエンスのリストにある識別子を使用して自分自身を識別する必要があります。そうでない場合は、トークンを拒否する必要があります。複数のオーディエンスに対して発行されたトークンは、リストされているオーディエンスのいずれかに対して認証するために使用できますが、ターゲットオーディエンス間の高度な信頼を意味します。

boundObjectRef

object

BoundObjectReference は、トークンがバインドされているオブジェクトへの参照です。

expirationSeconds

integer

ExpirationSeconds は、リクエストされた要求の有効期間です。トークン発行者は、有効期間が異なるトークンを返す可能性があるため、クライアントは応答の有効期限フィールドを確認する必要があります。

6.8.1.2. .spec.boundObjectRef

Description
BoundObjectReference は、トークンがバインドされているオブジェクトへの参照です。
タイプ
object
Expand
プロパティータイプ説明

apiVersion

string

参照先の API バージョン。

kind

string

参照先の種類。有効な種類は Pod とシークレットです。

name

string

参照先の名前。

uid

string

参照先の UID。

6.8.1.3. .status

Description
TokenRequestStatus は、トークンリクエストの結果です。
タイプ
object
必須
  • token
  • expirationTimestamp
Expand
プロパティータイプDescription

expirationTimestamp

時間

ExpirationTimestamp は、返されたトークンの有効期限です。

token

string

トークンは不透明なベアラトークンです。

6.8.2. API エンドポイント

以下の API エンドポイントを利用できます。

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

    • POST:ServiceAccount のトークンを作成します

6.8.2.1. /api/v1/namespaces/{namespace}/serviceaccounts/{name}/token

Expand
表6.23 グローバルパスパラメーター
パラメータータイプ説明

name

string

TokenRequest の名前

namespace

string

チームやプロジェクトなどのオブジェクト名と認証スコープ

Expand
表6.24 グローバルクエリーパラメーター
パラメータータイプ説明

dryRun

string

これがある場合、変更を永続化してはならないことを示します。無効または認識されない dryRun ディレクティブは、エラーレスポンスを引き起こし、リクエストをそれ以上処理しません。有効な値: - All: すべてのドライランステージが処理されます。

fieldManager

string

fieldManager は、これらの変更を行っているアクターまたはエンティティーに関連付けられた名前です。値は 128 文字未満である必要があり、https://golang.org/pkg/unicode/#IsPrint で定義されているように、印刷可能な文字のみが含まれている必要があります。

pretty

string

'true' の場合、出力はきれいに印刷されます。

HTTP メソッド
POST
Description
ServiceAccount のトークンを作成します
Expand
表6.25 ボディパラメーター
パラメータータイプ説明

ボディー

TokenRequest スキーマ

 
Expand
表6.26 HTTP 応答
HTTP コードレスポンス本文

200 - OK

TokenRequest スキーマ

201 - Created

TokenRequest スキーマ

202 - Accepted

TokenRequest スキーマ

401 - Unauthorized

空白

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat