az acr connected-registry

預覽
參考

此命令群組處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

使用 Azure Container Registries 管理已連線的登錄資源。

命令

名稱	Description	類型	狀態
az acr connected-registry create	建立 Azure Container Registry 的連線登錄。	核心	預覽
az acr connected-registry deactivate	從 Azure Container Registry 停用已連線的登錄。	核心	預覽
az acr connected-registry delete	從 Azure Container Registry 刪除已連線的登錄。	核心	預覽
az acr connected-registry get-settings	擷取啟動連線登錄所需的資訊，並建立或輪替同步令牌認證。	核心	預覽
az acr connected-registry install	協助存取安裝連線登錄的必要資訊。如需詳細資訊，請參閱 https://aka.ms/acr/connected-registry 。	核心	預覽和已淘汰
az acr connected-registry install info	擷取啟動連線登錄所需的資訊。	核心	預覽和已淘汰
az acr connected-registry install renew-credentials	擷取啟用已連線登錄所需的資訊，並更新同步令牌認證。	核心	預覽和已淘汰
az acr connected-registry list	列出目前父登錄下的所有已連線登錄。	核心	預覽
az acr connected-registry list-client-tokens	列出與特定連線登錄相關聯的所有用戶端令牌。	核心	預覽
az acr connected-registry permissions	管理多個已連線登錄的存放庫許可權。如需詳細資訊，請參閱 https://aka.ms/acr/connected-registry 。	核心	預覽
az acr connected-registry permissions show	顯示連線的登錄同步範圍對應資訊。	核心	預覽
az acr connected-registry permissions update	在所有必要的連線登錄同步範圍對應中新增和移除存放庫許可權。	核心	預覽
az acr connected-registry repo	更新所有必要的已連線登錄同步範圍對應存放庫許可權。	核心	預覽和已淘汰
az acr connected-registry show	顯示線上的登錄詳細數據。	核心	預覽
az acr connected-registry update	更新 Azure Container Registry 的已連線登錄。	核心	預覽

az acr connected-registry create

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

建立 Azure Container Registry 的連線登錄。

az acr connected-registry create --name
                                 --registry
                                 [--client-tokens]
                                 [--log-level]
                                 [--mode {ReadOnly, ReadWrite}]
                                 [--notifications]
                                 [--parent]
                                 [--repository]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-token]
                                 [--sync-window]
                                 [--yes]

範例

在登錄模式中建立連線的登錄，以存取 repos app/hello-world 和服務/mycomponent。其會建立具有正確存放庫許可權的同步令牌和範圍對應。

az acr connected-registry create --registry mycloudregistry --name myconnectedregistry \
    --repository "app/hello-world" "service/mycomponent"

建立僅具有讀取許可權的唯讀連線登錄，並傳遞同步令牌

az acr connected-registry create --registry mycloudregistry  --name myreadonlyacr \
    --mode readonly --parent myconnectedregistry --sync-token mySyncTokenName

建立具有用戶端令牌的只讀連線登錄，其每天會在 4 小時中和同步視窗同步處理。

az acr connected-registry create -r mycloudregistry -n myreadonlyacr -p myconnectedregistry \
    --repository "app/mycomponent" -m ReadOnly -s "0 12 * * *" -w PT4H \
    --client-tokens myTokenName1 myTokenName2

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--client-tokens

指定連線登錄中存放庫的用戶端存取權。其格式可以是 [TOKEN_NAME01] [TOKEN_NAME02]...

--log-level

設定記錄層級以記錄實例。接受的記錄層級為 [偵錯]、[資訊]、[警告]、[錯誤] 和 [無]。

預設值: Information

--mode -m

判斷同步處理時將具有的存取權。

接受的值: ReadOnly, ReadWrite

預設值: ReadOnly

--notifications

需要產生通知的成品模式清單。使用格式「--notifications 」[PATTERN1 PATTERN2...]”

--parent -p

父連接登錄的名稱。

--repository

指定需要同步至已連線登錄的存放庫。其格式可以是 [REPO01] [REPO02]...

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sync-message-ttl

判斷同步訊息會保留在雲端的時間長度。使用 ISO 8601 持續時間格式。

預設值: P2D

--sync-schedule -s

選擇性參數來定義同步排程。使用cron表達式來判斷排程。如果未指定，則會將實例視為一律在在線，並嘗試每分鐘同步處理一次。

預設值: * * * * *

--sync-token

指定用來與其父系同步處理已連線登錄的同步處理令牌。它最多只有存放庫許可權，以及至少其模式所需的動作。它可以包含多個存放庫的存取權。

--sync-window -w

如果存在 --sync-schedule，則為必要參數。用來判斷排程持續時間。使用 ISO 8601 持續時間格式。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry deactivate

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

從 Azure Container Registry 停用已連線的登錄。

az acr connected-registry deactivate --name
                                     --registry
                                     [--resource-group]
                                     [--yes]

範例

停用連線的登錄『myconnectedregistry』。

az acr connected-registry deactivate -r mycloudregistry -n myconnectedregistry

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry delete

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

從 Azure Container Registry 刪除已連線的登錄。

az acr connected-registry delete --name
                                 --registry
                                 [--cleanup]
                                 [--resource-group]
                                 [--yes]

範例

從父登錄 'mycloudregistry' 刪除只讀連線登錄 'myconnectedregistry'。

az acr connected-registry delete --registry mycloudregistry --name myconnectedregistry

刪除唯讀連線登錄 'myconnectedregistry'，而且它是來自父登錄 'mycloudregistry' 的同步令牌和範圍對應。

az acr connected-registry delete -r mycloudregistry -n myconnectedregistry --cleanup

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--cleanup

它會刪除同步令牌和範圍對應資源。

預設值: False

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry get-settings

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

擷取啟動連線登錄所需的資訊，並建立或輪替同步令牌認證。

az acr connected-registry get-settings --name
                                       --parent-protocol {http, https}
                                       --registry
                                       [--generate-password {1, 2}]
                                       [--resource-group]
                                       [--yes]

範例

取得在沒有密碼的情況下安裝連線登錄所需的設定資訊。

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --parent-protocol http

產生新的同步令牌密碼 1，或在密碼已經存在時輪替密碼，並取得安裝連線登錄所需的設定資訊。

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --generate-password 1 --parent-protocol https

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--parent-protocol

指定用來與其父系通訊的通訊協定。

接受的值: http, https

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--generate-password

選取您想要產生的密碼，而且需要從同步令牌擷取密碼。

接受的值: 1, 2

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--yes -y

不提示確認。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry list

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

列出目前父登錄下的所有已連線登錄。

az acr connected-registry list --registry
                               [--no-children]
                               [--parent]
                               [--resource-group]

範例

以表格格式列出『mycloudregistry』的所有已連線登錄。

az acr connected-registry list --registry mycloudregistry --output table

只列出數據表中展開窗體中 'mycloudregistry' 的輔助子系。

az acr connected-registry list --registry mycloudregistry --no-children --output table

以表格內的展開形式列出 'myconnectedregistry' 的所有後代。

az acr connected-registry list -r mycloudregistry -p myconnectedregistry --output table

必要參數

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--no-children

用來從清單中移除所有子系。

預設值: False

--parent -p

父連接登錄的名稱。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry list-client-tokens

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

列出與特定連線登錄相關聯的所有用戶端令牌。

az acr connected-registry list-client-tokens --name
                                             --registry
                                             [--resource-group]

範例

列出 'myreadonlyacr' 的所有用戶端令牌。

az acr connected-registry list-client-tokens -r mycloudregistry -n myreadonlyacr -o table

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry repo

編輯

預覽已被取代

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

此命令已被取代，並將在未來版本中移除。請改用「許可權更新」。

更新所有必要的已連線登錄同步範圍對應存放庫許可權。

az acr connected-registry repo --name
                               --registry
                               [--add]
                               [--remove]
                               [--resource-group]

範例

將許可權從 'repo1' 和 'repo2' 同步處理至連接的登錄 'myconnectedregistry' 及其上階。

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --add repo1 repo2

拿掉許可權，將映像從 'repo1' 和 'repo2' 同步處理到連線的登錄 'myconnectedregistry' 及其子代。

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --remove repo1 repo2

拿掉同步處理『repo1』映像的許可權，並新增『repo2』映像的許可權。

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --remove repo1 --add repo2

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--add

要新增至目標連線登錄的存放庫許可權，以及其上階同步範圍對應。使用每個旗標的格式 --add[REPO1 REPO2 ...]“。有效的動作為 ['content/delete'、'content/read'、'content/write'、'metadata/read'、'metadata/write']。

--remove

要從目標連線登錄中移除的存放庫許可權，而且是同步處理範圍對應。使用每個旗標的格式 --remove[REPO1 REPO2 ...]“。有效的動作為 ['content/delete'、'content/read'、'content/write'、'metadata/read'、'metadata/write']。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry show

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

顯示線上的登錄詳細數據。

az acr connected-registry show --name
                               --registry
                               [--resource-group]

範例

以表格形式顯示『myreadonlyacr』登錄的所有詳細數據。

az acr connected-registry show --registry mycloudregistry --name myreadonlyacr --output table

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az acr connected-registry update

編輯

預覽

命令群組 'acr connected-registry' 處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

更新 Azure Container Registry 的已連線登錄。

az acr connected-registry update --name
                                 --registry
                                 [--add-client-tokens]
                                 [--add-notifications]
                                 [--log-level]
                                 [--remove-client-tokens]
                                 [--remove-notifications]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-window]

範例

更新連線的登錄用戶端令牌。

az acr connected-registry update --registry mycloudregistry --name myconnectedregistry \
    --remove-client-tokens myTokenName1 --add-client-tokens myTokenName2 myTokenName3

更新已連線登錄的同步處理和時段時間。

az acr connected-registry update --registry mycloudregistry --name myreadonlyacr \
    --sync-schedule "0 12 * * *" --sync-window PT4H

必要參數

--name -n

已連線登錄的名稱。名稱長度必須介於 5 到 40 個字元之間，以字母開頭，且只包含英數位元（包括 '_' 或 '-'）。名稱在 Cloud ACR 階層下必須是唯一的。

--registry -r

Cloud ACR 登錄的登入伺服器。必須是 FQDN 才能同時支援 Azure Stack。

選擇性參數

--add-client-tokens

要新增的用戶端令牌。使用每個令牌標識碼的格式 “--add-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]”。

--add-notifications

要新增至通知清單的成品模式清單。使用格式 “--add-notifications [PATTERN1 PATTERN2 ...]”。

--log-level

設定記錄層級以記錄實例。接受的記錄層級為 [偵錯]、[資訊]、[警告]、[錯誤] 和 [無]。

--remove-client-tokens

要移除的用戶端令牌。使用每個令牌標識碼的格式 “--remove-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]”。

--remove-notifications

要從通知清單中移除的成品模式清單。使用格式 “--remove-notifications [PATTERN1 PATTERN2 ...]”。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--sync-message-ttl

判斷同步訊息會保留在雲端的時間長度。使用 ISO 8601 持續時間格式。

--sync-schedule -s

選擇性參數來定義同步排程。使用cron表達式來判斷排程。如果未指定，則會將實例視為一律在在線，並嘗試每分鐘同步處理一次。

--sync-window -w

用來判斷排程持續時間。使用 ISO 8601 持續時間格式。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az acr connected-registry

命令

az acr connected-registry create

範例

必要參數

選擇性參數

az acr connected-registry deactivate

範例

必要參數

選擇性參數

az acr connected-registry delete

範例

必要參數

選擇性參數

az acr connected-registry get-settings

範例

必要參數

選擇性參數

az acr connected-registry list

範例

必要參數

選擇性參數

az acr connected-registry list-client-tokens

範例

必要參數

選擇性參數

az acr connected-registry repo

範例

必要參數

選擇性參數

az acr connected-registry show

範例

必要參數

選擇性參數

az acr connected-registry update

範例

必要參數

選擇性參數

其他資源