11.4. ImageStreamImage [image.openshift.io/v1]
- Description
- ImageStreamImage は、ImageStream からイメージ名で取得されるイメージを表します。エンドユーザーはイメージリソースに直接アクセスできないため、ユーザーインターフェイスと通常のユーザーは、このリソースを使用して、イメージストリーム履歴内のタグ付きイメージのメタデータの詳細にアクセスして表示できます。そのようなイメージが ImageStream 内のタグによって参照されていない場合、notfound エラーが返されます。イメージは、外部レジストリー内のイメージを表すスペックタグがイメージストリームに設定されている場合、統合レジストリーにプッシュする場合、または既存のイメージをあるイメージストリームから別のイメージストリームにタグ付けする場合に作成されます。イメージストリームイメージの名前は <STREAM>@<DIGEST> の形式です。ここで、ダイジェストはイメージのコンテンツアドレス指定可能な識別子 (sha256:xxxxx…) です。ImageStreamImages をイメージストリームスペックタグの from.kind として使用して、イメージを正確に参照できます。imagestreamimage エンドポイントでサポートされている操作は、イメージの取得のみです。
- タイプ
-
object
- 必須
-
image
-
11.4.1. 仕様 リンクのコピーリンクがクリップボードにコピーされました!
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
|
11.4.1.1. .image リンクのコピーリンクがクリップボードにコピーされました!
- Description
- イメージは、ある時点でのコンテナーイメージとメタデータの不変の表現です。イメージは、そのコンテンツ (メタデータとコンテンツ) のハッシュを使用して名前が付けられ、形式、コンテンツ、またはメタデータを変更すると、新しい名前になります。イメージリソースは、主にクラスター管理者およびクラスターイメージレジストリーなどの統合で使用されます。エンドユーザーは、代わりに imagestreamtags または imagestreamimages リソースを介してイメージにアクセスします。イメージメタデータは API に保存されますが、コンテナーイメージレジストリー API を実装する統合では、生のマニフェストデータ、イメージ設定、およびレイヤーコンテンツ用に独自のストレージを提供する必要があります。
- タイプ
-
object
- 必須
-
dockerImageLayers
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| DockerImageConfig は、ランタイムがコンテナーをセットアップするために使用する JSONBLOB です。これはマニフェストスキーマ v2 の一部です。 |
|
| DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。 |
|
| ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。 |
|
| DockerImageManifest は、マニフェストの生の JSON です |
|
| DockerImageManifestMediaType は、マニフェストの mediaType を指定します。これはマニフェストスキーマ v2 の一部です。 |
| DockerImageMetadata には、このイメージに関するメタデータが含まれています | |
|
| DockerImageMetadataVersion は、オブジェクトのバージョンを伝達します。空の場合、デフォルトは 1.0 です。 |
|
| DockerImageReference は、このイメージをプルするために使用できる文字列です。 |
|
| DockerImageSignatures は、署名を不透明なブロブとして提供します。これはマニフェストスキーマ v1 の一部です。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名は、イメージのすべての署名を保持します。 |
|
| ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。 |
11.4.1.2. .image.dockerImageLayers リンクのコピーリンクがクリップボードにコピーされました!
- Description
- DockerImageLayers は、イメージ内のレイヤーを表します。イメージがそのデータを定義していない場合は設定されない可能性があります。
- タイプ
-
array
11.4.1.3. .image.dockerImageLayers[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageLayer は、イメージの単一のレイヤーを表します。一部のイメージには複数のレイヤーが含まれる場合があります。ないものもあります。
- タイプ
-
object
- 必須
-
name
-
size
-
mediaType
-
プロパティー | タイプ | Description |
---|---|---|
|
| 参照されるオブジェクトの MediaType。 |
|
| 基になるストアによって定義されたレイヤーの名前。 |
|
| 基になるストアによって定義されたレイヤーのサイズ (バイト単位)。 |
11.4.1.4. .image.signatures リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 署名は、イメージのすべての署名を保持します。
- タイプ
-
array
11.4.1.5. .image.signatures[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- ImageSignature は、イメージの署名を保持します。署名が信頼されている限り、イメージの ID やその他の主張を検証できます。この情報に基づいて、実行可能なイメージをクラスター全体のポリシーに一致するイメージに制限することができます。必須フィールドは、イメージ検証を行うクライアントが解析する必要があります。その他は、サーバーによって署名のコンテンツから解析されます。それらは単なる有益な目的を果たします。
- タイプ
-
object
- 必須
-
type
-
content
-
プロパティー | タイプ | 説明 |
---|---|---|
|
| APIVersion はオブジェクトのこの表現のバージョンスキーマを定義します。サーバーは認識されたスキーマを最新の内部値に変換し、認識されない値は拒否することがあります。詳細は、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources を参照してください。 |
|
| 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。 |
|
| SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。 |
|
| 必須: イメージの署名である不透明なバイナリー文字列。 |
| 指定した場合、それは署名の作成時です。 | |
|
| イメージのアイデンティティを表す人間が読める文字列。製品名とバージョン、またはイメージプルスペック (例:registry.access.redhat.com/rhel7/rhel:7.2) の場合があります。 |
|
| SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。 |
|
| SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。 |
|
| kind はこのオブジェクトが表す REST リソースを表す文字列の値です。サーバーはクライアントが要求を送信するエンドポイントからこれを推測できることがあります。これを更新することはできません。CamelCase詳細については、https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds を参照してください。 |
| ||
|
| 署名からのクレームが含まれています。 |
|
| 必須: 保存されている BLOB のタイプを記述します。 |
11.4.1.6. .image.signatures[].conditions リンクのコピーリンクがクリップボードにコピーされました!
- Description
- 条件は、シグニチャの現在の状態について利用可能な最新の観測値を表します。
- タイプ
-
array
11.4.1.7. .image.signatures[].conditions[] リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureCondition は、特定のプローブ時間における特定の種類のイメージ署名条件を記述します。
- タイプ
-
object
- 必須
-
type
-
status
-
11.4.1.8. .image.signatures[].issuedBy リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureIssuer は、署名証明書またはキーの発行者に関する情報を保持しています。
- タイプ
-
object
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
11.4.1.9. .image.signatures[].issuedTo リンクのコピーリンクがクリップボードにコピーされました!
- Description
- SignatureSubject は、署名を作成した個人またはエンティティーに関する情報を保持します。
- タイプ
-
object
- 必須
-
publicKeyID
-
プロパティー | タイプ | Description |
---|---|---|
|
| 一般名 (例:openshift-signing-service)。 |
|
| 組織名 |
|
| 存在する場合、それはイメージの署名を検証するために使用されるサブジェクトに属する公開鍵の人間が読める形式の鍵 ID です。公開鍵のフィンガープリントの下位 64 ビット以上が含まれている必要があります (例:0x685ebe62bf278440)。 |
11.4.2. API エンドポイント リンクのコピーリンクがクリップボードにコピーされました!
以下の API エンドポイントを利用できます。
/apis/image.openshift.io/v1/namespaces/{namespace}/imagestreamimages/{name}
-
GET
: 指定された ImageStreamImage を読み取ります
-
11.4.2.1. /apis/image.openshift.io/v1/namespaces/{namespace}/imagestreamimages/{name} リンクのコピーリンクがクリップボードにコピーされました!
パラメーター | タイプ | 説明 |
---|---|---|
|
| ImageStreamImage の名前 |
|
| チームやプロジェクトなどのオブジェクト名と認証スコープ |
パラメーター | タイプ | 説明 |
---|---|---|
|
| 'true' の場合、出力はきれいに印刷されます。 |
- HTTP メソッド
-
GET
- Description
- 指定された ImageStreamImage を読み取ります
HTTP コード | レスポンス本文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空白 |