Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

54.3. GetSecret

GET /v1/secrets/{id}

GetSecret は、その ID を持つシークレットを返します。

54.3.1. 説明
リンクのコピー

54.3.2. パラメーター
リンクのコピー

54.3.2.1. パスパラメーター
リンクのコピー

Expand
名前説明必須デフォルトPattern

id

 

X

null

 

54.3.3. 戻り値のタイプ
リンクのコピー

StorageSecret

54.3.4. コンテンツタイプ
リンクのコピー

  • application/json

54.3.5. レスポンス
リンクのコピー

Expand
表54.3 HTTP 応答コード
コードメッセージデータタイプ

200

正常な応答。

StorageSecret

0

予期しないエラーの応答です。

RuntimeError

54.3.6. サンプル
リンクのコピー

54.3.7. 共通のオブジェクト参照
リンクのコピー

54.3.7.1. ImagePullSecretRegistry
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

name

  

String

  

username

  

String

  

54.3.7.2. ProtobufAny
リンクのコピー

any には、シリアライズされたメッセージの型を記述する URL とともに、任意のシリアライズされたプロトコルバッファーメッセージが含まれます。

Protobuf ライブラリーは、パック/アンパックをサポートします。任意の値は、ユーティリティー関数の形式で、または Any タイプの追加の生成されたメソッドになります。

例 1: C++ のメッセージをパックして展開します。 

Foo foo = ...;
Any any;
any.PackFrom(foo);
...
if (any.UnpackTo(&foo)) {
  ...
}

例 2: Java でメッセージをパックして解凍します。 

Foo foo = ...;
Any any = Any.pack(foo);
...
if (any.is(Foo.class)) {
  foo = any.unpack(Foo.class);
}
// or ...
if (any.isSameTypeAs(Foo.getDefaultInstance())) {
  foo = any.unpack(Foo.getDefaultInstance());
}
 
Example 3: Pack and unpack a message in Python.
 
foo = Foo(...)
any = Any()
any.Pack(foo)
...
if any.Is(Foo.DESCRIPTOR):
  any.Unpack(foo)
  ...
 
Example 4: Pack and unpack a message in Go
 
foo := &pb.Foo{...}
any, err := anypb.New(foo)
if err != nil {
  ...
}
...
foo := &pb.Foo{}
if err := any.UnmarshalTo(foo); err != nil {
  ...
}

protobuf ライブラリーが提供するパックメソッドは、デフォルトで type.googleapis.com/full.type.name をタイプ URL として使用し、unzip メソッドは、タイプ URL の最後の//のみを使用します。たとえば、"foo.bar.com/x/y.z" のように、"foo.bar.com/x/y.z" の型名 "y.z" が生成されます。

54.3.7.2.1. JSON 表現
リンクのコピー

Any 値の JSON 表現は、デシリアライズされた埋め込みメッセージの通常の表現を使用し、タイプ URL が含まれる追加のフィールド @type を使用します。以下に例を示します。 

package google.profile;
message Person {
  string first_name = 1;
  string last_name = 2;
}
 
{
  "@type": "type.googleapis.com/google.profile.Person",
  "firstName": <string>,
  "lastName": <string>
}

埋め込みメッセージタイプがよく知られていて、カスタム JSON 表現がある場合、その表現は埋め込みされ、@type フィールドに加えてカスタム JSON を保持するフィールド 値 が追加されます。例（メッセージ [google.protobuf.Duration][] の場合）: 

{
  "@type": "type.googleapis.com/google.protobuf.Duration",
  "value": "1.212s"
}
Expand
フィールド名必須Null 許容型型説明形式

typeUrl

  

String

シリアライズされたプロトコルバッファーメッセージのタイプを一意に識別する URL/リソース名。この文字列には最低でも 1 つの \"/\" 文字を含める必要があります。URL のパスの最後のセグメントは、タイプの完全修飾名( path/google.protobuf.Durationにあるように)を表す必要があります。名前は正規の形式である必要があります（たとえば、先頭 \".\" は受け入れられません）。実際には、チームは通常、バイナリーにプリコンパイルして、任意 のコンテキストで使用することを期待しているすべてのタイプにプレコンパイルします。ただし、スキーム http、https、またはスキームを使用しない URL の場合、以下のようにタイプ URL をメッセージ定義にマップするタイプサーバーを設定できます。* スキームが指定されていない場合、https は想定されます。* URL の HTTP GET はバイナリー形式の [google.protobuf.Type][] 値を生成するか、エラーを生成する必要があります。* アプリケーションは、URL に基づいてルックアップ結果をキャッシュするか、ルックアップを回避するためにバイナリーにプリコンパイルして使用できます。したがって、タイプへの変更時にバイナリー互換性を保持する必要があります。（バージョン付けされたタイプ名を使用して、重大な変更を管理します。）注記：この機能は現在、公式の protobuf リリースでは利用できないため、type.googleapis.com で始まるタイプ URL には使用されません。2023 年 5 月時点では、広く使用されているタイプサーバー実装はもう 1 つも実装する予定はありません。http 以外のスキーム、https （または空のスキーム）は、実装固有のセマンティクスで使用できます。

 

value

  

byte[]

上記の指定されたタイプの有効なシリアライズされたプロトコルバッファーである必要があります。

byte

54.3.7.3. RuntimeError
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

error

  

String

  

code

  

Integer

 

int32

message

  

String

  

details

  

ProtobufAnyのリスト

  

54.3.7.4. StorageCert
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

サブジェクト (subject)

  

StorageCertName

  

issuer

  

StorageCertName

  

sans

  

string のリスト

  

startDate

  

Date

 

date-time

endDate

  

Date

 

date-time

algorithm

  

String

  

54.3.7.5. StorageCertName
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

commonName

  

String

  

country

  

String

  

organization

  

String

  

organizationUnit

  

String

  

locality

  

String

  

Province

  

String

  

streetAddress

  

String

  

postalCode

  

String

  

names

  

string のリスト

  

54.3.7.6. StorageImagePullSecret
リンクのコピー

Expand
フィールド名必須Null 許容型型説明形式

registries

  

List of ImagePullSecretRegistry

  

54.3.7.7. StorageSecret
リンクのコピー

Flat secret object. Any properties of an individual secret. (regardless of time, scope, or context) ////////////////////////////////////////
Expand
フィールド名必須Null 許容型型説明形式

id

  

String

  

name

  

String

  

clusterId

  

String

  

clusterName

  

String

  

namespace

  

String

  

type

  

String

  

labels

  

文字列のマップ

  

annotations

  

文字列のマップ

  

createdAt

  

Date

 

date-time

files

  

List of StorageSecretDataFile

シークレットに関するメタデータ。シークレットはファイルである必要はありませんが、任意の値になることがあります。

 

関係

  

StorageSecretRelationship

  

54.3.7.8. StorageSecretContainerRelationship
リンクのコピー

Secrets can be mounted in a path in a container. Next Tag: 3
Expand
フィールド名必須Null 許容型型説明形式

id

  

String

シークレットがマウントされるコンテナーの ID。

 

path

  

String

path は、コンテナー固有のマウントディレクトリーです。

 

54.3.7.9. StorageSecretDataFile
リンクのコピー

シークレットに関するメタデータ。証明書ファイルと imagePullSecret についての追加情報が提示されますが、ファイルも任意の値を表すことができます。

Expand
フィールド名必須Null 許容型型説明形式

name

  

String

  

type

  

StorageSecretType

 

UNDETERMINED、PUBLIC_CERTIFICATE、CERTIFICATE_REQUEST、PACY_ENHANCED_MESSAGE、OPENSSH_PRIVATE_KEY、PGP_PRIVATE_KEY、EC_PRIVATE_KEY、RSA_PRIVATE_KEY、DSA_PRIVATE_KEY、CERT_PRIVATE_KEY、ENCRYPTIONED_PRIVATE_KEY、IMAGE_PULL_SECRET、

cert

  

StorageCert

  

imagePullSecret

  

StorageImagePullSecret

  

54.3.7.10. StorageSecretDeploymentRelationship
リンクのコピー

Secrets can be used by a deployment. Next Tag: 3
Expand
フィールド名必須Null 許容型型説明形式

id

  

String

コンテナー内でシークレットを使用したデプロイメントの ID。

 

name

  

String

デプロイメントの名前。

 

54.3.7.11. StorageSecretRelationship
リンクのコピー

The combined relationships that belong to the secret. Next Tag: 6
Expand
フィールド名必須Null 許容型型説明形式

id

  

String

  

containerRelationships

  

StorageSecretContainerRelationshipのリスト

  

deploymentRelationships

  

StorageSecretDeploymentRelationshipの一覧

デプロイメント ID と関係

 

54.3.7.12. StorageSecretType
リンクのコピー

Expand
Enum 値

UNDETERMINED

PUBLIC_CERTIFICATE

CERTIFICATE_REQUEST

PRIVACY_ENHANCED_MESSAGE

OPENSSH_PRIVATE_KEY

PGP_PRIVATE_KEY

EC_PRIVATE_KEY

RSA_PRIVATE_KEY

DSA_PRIVATE_KEY

CERT_PRIVATE_KEY

ENCRYPTED_PRIVATE_KEY

IMAGE_PULL_SECRET

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hatトップに戻る