Manifests - Create

參考

服務:: Container Registry

API 版本:: 2019-08-15-preview

放置 name 所識別的指令清單，並 reference 其中 reference 可以是標記或摘要。

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

URI 參數

名稱	位於	必要	類型	Description
name	path	True	string	映像名稱（包括命名空間）
reference	path	True	string	標記或摘要，指向特定影像
url	path	True	string	登錄登入 URL

要求本文

Media Types: "application/vnd.docker.distribution.manifest.v2+json"

要求主體可以是下列其中一項：

名稱	Description
ManifestList	傳回要求的 Docker 多 arch-manifest 檔案
OCIIndex	傳回要求的 OCI 索引檔案
OCIManifest	傳回要求的 OCI 指令清單檔案
V1Manifest	傳回要求的 V1 指令清單檔
V2Manifest	傳回要求的 Docker V2 指令清單檔案

ManifestList

傳回要求的 Docker 多 arch-manifest 檔案

名稱	類型	Description
manifests	ManifestListAttributes[]	V2 影像層信息的清單
mediaType	string	此指令清單的媒體類型
schemaVersion	integer	架構版本

OCIIndex

傳回要求的 OCI 索引檔案

名稱	類型	Description
annotations	Annotations	透過任意元數據提供的其他資訊。
manifests	ManifestListAttributes[]	OCI 影像圖層信息的清單
schemaVersion	integer	架構版本

OCIManifest

傳回要求的 OCI 指令清單檔案

名稱	類型	Description
annotations	Annotations	透過任意元數據提供的其他資訊。
config	Descriptor	V2 映像設定描述元
layers	Descriptor[]	V2 影像層信息的清單
schemaVersion	integer	架構版本

V1Manifest

傳回要求的 V1 指令清單檔

名稱	類型	Description
architecture	string	CPU 架構
fsLayers	FsLayer[]	層次資訊清單
history	History[]	影像歷程記錄
name	string	映射名稱
schemaVersion	integer	架構版本
signatures	ImageSignature[]	影像簽章
tag	string	影像標籤

V2Manifest

傳回要求的 Docker V2 指令清單檔案

名稱	類型	Description
config	Descriptor	V2 映像設定描述元
layers	Descriptor[]	V2 影像層信息的清單
mediaType	string	此指令清單的媒體類型
schemaVersion	integer	架構版本

回應

名稱	類型	Description
201 Created		指令清單已更新標題 Docker-Content-Digest: string Location: string Content-Length: integer
Other Status Codes	AcrErrors	描述作業失敗原因的 ACR 錯誤回應。

名稱

類型

Description

201 Created

指令清單已更新

標題

Docker-Content-Digest: string
Location: string
Content-Length: integer

Other Status Codes

AcrErrors

描述作業失敗原因的 ACR 錯誤回應。

安全性

registry_auth

類型: basic

範例

Put manifest

範例要求

HTTP

PUT acrapi.azurecr-test.io/v2/hello-world/manifests/a20190628-081044z

"{\"schemaVersion\":2,\"mediaType\":\"application/vnd.docker.distribution.manifest.v2+json\",\"config\":{\"mediaType\":\"application/vnd.docker.container.image.v1+json\",\"size\":1512,\"digest\":\"sha256:6d1ef012b5674ad8a127ecfa9b5e6f5178d171b90ee462846974177fd9bdd39f\"},\"layers\":[{\"mediaType\":\"application/vnd.docker.image.rootfs.diff.tar.gzip\",\"size\":2107098,\"digest\":\"sha256:5d20c808ce198565ff70b3ed23a991dd49afac45dece63474b27ce6ed036adc6\"}]}"

範例回覆

狀態碼:: 201

Docker-Content-Digest: sha256:15685c48490175b7dde62e6bfcfb54d9420c6495ea6404776e2facca3da93cd8
Location: /v2/hello-world/manifests/sha256:15685c48490175b7dde62e6bfcfb54d9420c6495ea6404776e2facca3da93cd8
Content-Length: 0

{}

定義

名稱	Description
AcrErrorInfo	錯誤資訊
AcrErrors	描述作業失敗原因的 Acr 錯誤回應
Annotations	透過任意元數據提供的其他資訊。
Descriptor	Docker V2 映射層描述元，包括設定和層次
FsLayer	影像圖層資訊
History	v1 相容性的非結構化歷程記錄數據清單
ImageSignature	已簽署指令清單的簽章
JWK	JSON Web 簽章
JWKHeader	JSON Web 金鑰參數
Manifest	傳回要求的指令清單檔
ManifestList	傳回要求的 Docker 多 arch-manifest 檔案
ManifestListAttributes
OCIIndex	傳回要求的 OCI 索引檔案
OCIManifest	傳回要求的 OCI 指令清單檔案
Platform	平台物件描述指令清單中映像執行所在的平臺。 $GOOS和$GOARCH Go 語言文件中會列出有效作系統和架構值的完整清單
V1Manifest	傳回要求的 V1 指令清單檔
V2Manifest	傳回要求的 Docker V2 指令清單檔案

AcrErrorInfo

Object

錯誤資訊

名稱	類型	Description
code	string	錯誤碼
detail	object	錯誤詳細數據
message	string	錯誤訊息

AcrErrors

Object

描述作業失敗原因的 Acr 錯誤回應

名稱	類型	Description
errors	AcrErrorInfo[]	詳細的錯誤陣列

Annotations

Object

透過任意元數據提供的其他資訊。

名稱	類型	Description
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	授權（s）以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 映射層描述元，包括設定和層次

名稱	類型	Description
annotations	Annotations	透過任意元數據提供的其他資訊。
digest	string	層次摘要
mediaType	string	層次媒體類型
size	integer (int64)	層次大小
urls	string[]	指定可從中下載此物件的 URI 清單。

FsLayer

Object

影像圖層資訊

名稱	類型	Description
blobSum	string	影像圖層的SHA

History

Object

v1 相容性的非結構化歷程記錄數據清單

名稱	類型	Description
v1Compatibility	string	原始 v1 兼容性資訊

ImageSignature

Object

已簽署指令清單的簽章

名稱	類型	Description
header	JWK	JSON Web 簽章
protected	string	已簽署的受保護標頭
signature	string	映射指令清單的簽章，由 libtrust 私鑰簽署

JWK

Object

JSON Web 簽章

名稱	類型	Description
alg	string	用來簽署或加密 JWT 的演算法
jwk	JWKHeader	JSON Web 金鑰參數

JWKHeader

Object

JSON Web 金鑰參數

名稱	類型	Description
crv	string	crv 值
kid	string	kid value
kty	string	kty 值
x	string	x 值
y	string	y 值

Manifest

Object

傳回要求的指令清單檔

名稱	類型	Description
schemaVersion	integer	架構版本

ManifestList

Object

傳回要求的 Docker 多 arch-manifest 檔案

名稱	類型	Description
manifests	ManifestListAttributes[]	V2 影像層信息的清單
mediaType	string	此指令清單的媒體類型
schemaVersion	integer	架構版本

ManifestListAttributes

Object

名稱	類型	Description
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)	以位元組為單位的物件大小

OCIIndex

Object

傳回要求的 OCI 索引檔案

名稱	類型	Description
annotations	Annotations	透過任意元數據提供的其他資訊。
manifests	ManifestListAttributes[]	OCI 影像圖層信息的清單
schemaVersion	integer	架構版本

OCIManifest

Object

傳回要求的 OCI 指令清單檔案

名稱	類型	Description
annotations	Annotations	透過任意元數據提供的其他資訊。
config	Descriptor	V2 映像設定描述元
layers	Descriptor[]	V2 影像層信息的清單
schemaVersion	integer	架構版本

Platform

Object

平台物件描述指令清單中映像執行所在的平臺。 $GOOS和$GOARCH Go 語言文件中會列出有效作系統和架構值的完整清單

名稱	類型	Description
architecture	string	指定 CPU 架構，例如 amd64 或 ppc64le。
features	string[]	選擇性功能欄位會指定字串數位，每個字串都會列出必要的 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 的變體，例如 armv6l 來指定 ARM CPU 的特定 CPU 變體。

V1Manifest

Object

傳回要求的 V1 指令清單檔

名稱	類型	Description
architecture	string	CPU 架構
fsLayers	FsLayer[]	層次資訊清單
history	History[]	影像歷程記錄
name	string	映射名稱
schemaVersion	integer	架構版本
signatures	ImageSignature[]	影像簽章
tag	string	影像標籤

V2Manifest

Object

傳回要求的 Docker V2 指令清單檔案

名稱	類型	Description
config	Descriptor	V2 映像設定描述元
layers	Descriptor[]	V2 影像層信息的清單
mediaType	string	此指令清單的媒體類型
schemaVersion	integer	架構版本

共用方式為

Manifests - Create

URI 參數

要求本文

ManifestList

OCIIndex

OCIManifest

V1Manifest

V2Manifest

回應

安全性

registry_auth

範例

Put manifest

範例要求

範例回覆

定義

AcrErrorInfo

AcrErrors

Annotations

Descriptor

FsLayer

History

ImageSignature

JWK

JWKHeader

Manifest

ManifestList

ManifestListAttributes

OCIIndex

OCIManifest

Platform

V1Manifest

V2Manifest