共用方式為


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 來取得完整偵錯記錄。