Manifests - Get

リファレンス

サービス:: Container Registry

API バージョン:: 2019-08-15-preview

name で識別されたマニフェストを取得し、reference がタグまたはダイジェストである可能性がある reference します。

GET {url}/v2/{name}/manifests/{reference}

URI パラメーター

名前	/	必須	型	説明
name	path	True	string	イメージの名前 (名前空間を含む)
reference	path	True	string	特定の画像を指すタグまたはダイジェスト
url	path	True	string	レジストリログイン URL

要求ヘッダー

名前	必須	型	説明
accept		string	コンマで区切られたヘッダー文字列を受け入れます。たとえば、application/vnd.docker.distribution.manifest.v2+json などです。

応答

名前	型	説明
200 OK	ManifestWrapper	要求されたマニフェストファイルを、より大きな結合されたグループで返します。
Other Status Codes	AcrErrors	操作が失敗した理由を説明する ACR エラー応答。

セキュリティ

registry_auth

型: basic

例

Get manifest

要求のサンプル

HTTP

GET acrapi.azurecr-test.io/v2/hello-world-dangling/manifests/20190628-033033z

応答のサンプル

状態コード:: 200

{
  "schemaVersion": 2,
  "mediaType": "application/vnd.docker.distribution.manifest.v2+json",
  "config": {
    "mediaType": "application/vnd.docker.container.image.v1+json",
    "size": 5824,
    "digest": "sha256:691fbc2d44fff48357bba69ab0505b9bf12b2b250a925a84a0b8e8e7eed390b2"
  },
  "layers": [
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 2014658,
      "digest": "sha256:a073c86ecf9e0f29180e80e9638d4c741970695851ea48247276c32c57e40282"
    },
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 19778035,
      "digest": "sha256:0e28711eb56d78f1e3dfde1807eba529d1346222bcd07d1cb1e436a18a0388bd"
    },
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 1074044,
      "digest": "sha256:e460dd483fddb555911f7ed188c319fd97542c60e36843dcb1c5d753f733e1fa"
    },
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 5827,
      "digest": "sha256:6aa301222093bfb8cf424ccb387f59e2c9510c3a30cca7fbcf8c954f88e6600c"
    },
    {
      "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip",
      "size": 568,
      "digest": "sha256:9c5d80083a57d565f684e0155707204d497a5ad965279f92927452f15dae17e6"
    }
  ]
}

定義

名前	説明
AcrErrorInfo	エラー情報
AcrErrors	操作が失敗した理由を説明する Acr エラー応答
Annotations	任意のメタデータを介して提供される追加情報。
Descriptor	構成とレイヤーを含む Docker V2 イメージレイヤー記述子
FsLayer	イメージレイヤー情報
History	v1 互換性のための非構造化履歴データの一覧
ImageSignature	署名されたマニフェストの署名
JWK	JSON Web 署名
JWKHeader	JSON Web キーパラメーター
ManifestListAttributes
ManifestWrapper	要求されたマニフェストファイルを返します
Platform	プラットフォームオブジェクトは、マニフェスト内のイメージが実行されるプラットフォームを表します。有効なオペレーティングシステムとアーキテクチャの値の完全な一覧は、$GOOSと$GOARCHの Go 言語ドキュメントに記載されています

AcrErrorInfo

Object

エラー情報

名前	型	説明
code	string	エラーコード
detail	object	エラーの詳細
message	string	エラーメッセージ

AcrErrors

Object

操作が失敗した理由を説明する Acr エラー応答

名前	型	説明
errors	AcrErrorInfo[]	詳細なエラーの配列

Annotations

Object

任意のメタデータを介して提供される追加情報。

名前	型	説明
org.opencontainers.image.authors	string	画像を担当するユーザーまたは組織の連絡先の詳細。
org.opencontainers.image.created	string (date-time)	イメージが作成された日付と時刻 (文字列、https://tools.ietf.org/html/rfc3339#section-5.6で定義されている日時)
org.opencontainers.image.description	string	画像にパッケージ化されたソフトウェアの人間が判読できる説明
org.opencontainers.image.documentation	string	イメージに関するドキュメントを取得するための URL。
org.opencontainers.image.licenses	string	包含ソフトウェアが SPDX ライセンス式として配布されるライセンス。
org.opencontainers.image.ref.name	string	ターゲットの参照の名前。
org.opencontainers.image.revision	string	パッケージ化されたソフトウェアのソース管理リビジョン識別子。
org.opencontainers.image.source	string	イメージをビルドするためのソースコードを取得する URL。
org.opencontainers.image.title	string	人間が判読できる画像のタイトル
org.opencontainers.image.url	string	画像に関する詳細情報を検索するための URL。
org.opencontainers.image.vendor	string	分散エンティティ、組織、または個人の名前。
org.opencontainers.image.version	string	パッケージ化されたソフトウェアのバージョン。バージョンはソースコードリポジトリ内のラベルまたはタグと一致する場合があり、セマンティックバージョン管理と互換性がある場合もあります

Descriptor

Object

構成とレイヤーを含む Docker V2 イメージレイヤー記述子

名前	型	説明
annotations	Annotations	任意のメタデータを介して提供される追加情報。
digest	string	レイヤーダイジェスト
mediaType	string	レイヤーメディアの種類
size	integer (int64)	レイヤーサイズ
urls	string[]	このオブジェクトのダウンロード元となる URI の一覧を指定します。

FsLayer

Object

イメージレイヤー情報

名前	型	説明
blobSum	string	イメージレイヤーの SHA

History

Object

v1 互換性のための非構造化履歴データの一覧

名前	型	説明
v1Compatibility	string	生の v1 互換性情報

ImageSignature

Object

署名されたマニフェストの署名

名前	型	説明
header	JWK	JSON Web 署名
protected	string	署名された保護されたヘッダー
signature	string	libtrust 秘密キーによって署名されたイメージマニフェストの署名

JWK

Object

JSON Web 署名

名前	型	説明
alg	string	JWT の署名または暗号化に使用されるアルゴリズム
jwk	JWKHeader	JSON Web キーパラメーター

JWKHeader

Object

JSON Web キーパラメーター

名前	型	説明
crv	string	crv 値
kid	string	kid value
kty	string	kty 値
x	string	x 値
y	string	y 値

ManifestListAttributes

Object

名前	型	説明
digest	string	レジストリ V2 HTTP API 仕様で定義されているコンテンツのダイジェスト
mediaType	string	参照先オブジェクトの MIME の種類。これは通常、application/vnd.docker.image.manifest.v2+json ですが、application/vnd.docker.image.manifest.v1+json でもかまいません。
platform	Platform	プラットフォームオブジェクトは、マニフェスト内のイメージが実行されるプラットフォームを表します。有効なオペレーティングシステムとアーキテクチャの値の完全な一覧は、$GOOSと$GOARCHの Go 言語ドキュメントに記載されています
size	integer (int64)	オブジェクトのサイズ (バイト単位)

ManifestWrapper

Object

要求されたマニフェストファイルを返します

名前	型	説明
annotations	Annotations	(OCI、OCIIndex)その他のメタデータ
architecture	string	(V1)CPU アーキテクチャ
config	Descriptor	(V2、OCI)イメージ構成記述子
fsLayers	FsLayer[]	(V1)レイヤー情報の一覧
history	History[]	(V1)画像履歴
layers	Descriptor[]	(V2、OCI)V2 イメージレイヤー情報の一覧
manifests	ManifestListAttributes[]	(ManifestList、OCIIndex)V2 イメージレイヤー情報の一覧
mediaType	string	このマニフェストのメディアの種類
name	string	(V1)イメージ名
schemaVersion	integer	スキーマのバージョン
signatures	ImageSignature[]	(V1)イメージ署名
tag	string	(V1)イメージタグ

Platform

Object

プラットフォームオブジェクトは、マニフェスト内のイメージが実行されるプラットフォームを表します。有効なオペレーティングシステムとアーキテクチャの値の完全な一覧は、$GOOSと$GOARCHの Go 言語ドキュメントに記載されています

名前	型	説明
architecture	string	CPU アーキテクチャ (amd64 や ppc64le など) を指定します。
features	string[]	省略可能な features フィールドは文字列の配列を指定し、それぞれが必要な CPU 機能 (例: sse4 や aes) を一覧表示します。
os	string	os フィールドは、オペレーティングシステム (Linux や Windows など) を指定します。
os.features	string[]	省略可能な os.features フィールドは、文字列の配列を指定します。各文字列には、必要な OS 機能が一覧表示されます (Windows win32k など)。
os.version	string	省略可能な os.version フィールドは、オペレーティングシステムのバージョン (10.0.10586 など) を指定します。
variant	string	オプションのバリアント型フィールドは、CPU のバリアントを指定します。たとえば、ARM CPU の特定の CPU バリアントを指定する armv6l などです。

次の方法で共有

Manifests - Get

URI パラメーター

要求ヘッダー

応答

セキュリティ

registry_auth

例

Get manifest

要求のサンプル

応答のサンプル

定義

AcrErrorInfo

AcrErrors

Annotations

Descriptor

FsLayer

History

ImageSignature

JWK

JWKHeader

ManifestListAttributes

ManifestWrapper

Platform