共用方式為

az appconfig snapshot

  • 參考

管理與應用程式組態存放區相關聯的快照集。

命令

名稱 Description 類型 狀態
az appconfig snapshot archive

封存快照集。

 核心 GA
az appconfig snapshot create

建立應用程式設定快照集。

 核心 GA
az appconfig snapshot list

列出快照集。

 核心 GA
az appconfig snapshot recover

復原封存的快照集。

 核心 GA
az appconfig snapshot show

顯示應用程式組態快照集的所有屬性。

 核心 GA

az appconfig snapshot archive

編輯

封存快照集。

az appconfig snapshot archive --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

範例

在組態存放區 MyAppConfiguration 中封存快照集 MySnapshot。

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

必要參數

--snapshot-name -s

應用程式組態 快照集的名稱。

選擇性參數

--auth-mode

這個參數可用來指出數據作業的授權方式。 如果驗證模式為「金鑰」，請提供 連接字串 或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供 --endpoint 或 --name ，且您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態 存放區存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供 應用程式組態 存放區的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

應用程式組態 存放區的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<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 appconfig snapshot create

編輯

建立應用程式設定快照集。

az appconfig snapshot create --filters
                             --snapshot-name
                             [--auth-mode {key, login}]
                             [--composition-type {key, key_label}]
                             [--connection-string]
                             [--endpoint]
                             [--name]
                             [--retention-period]
                             [--tags]

範例

在組態存放區 MyAppConfiguration 中，從 'Test' 開始，建立所有密鑰的快照集 MySnapshot。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\"}'

從 'abc' 開始，建立所有密鑰的快照集 MySnapshot，並保留期間為 1 小時。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"abc*\"}' --retention-period 3600

建立所有索引鍵的快照集，開頭為 『app/』 且沒有預設標籤，然後如果索引鍵存在，請使用索引鍵來覆寫索引鍵/值。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"app/*\"}' '{\"key\":\"app/*\", \"label\":\"prod\"}' --composition-type 'key'

必要參數

--filters

逸出 JSON 物件的空格分隔清單，這些物件代表用來建置 應用程式組態 快照集的索引鍵和標籤篩選。

--snapshot-name -s

應用程式組態 快照集的名稱。

選擇性參數

--auth-mode

這個參數可用來指出數據作業的授權方式。 如果驗證模式為「金鑰」，請提供 連接字串 或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供 --endpoint 或 --name ，且您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--composition-type

建置 應用程式組態 快照集時所使用的組合類型。 如果未指定，則預設為索引鍵。

接受的值: key, key_label
--connection-string

應用程式組態 存放區存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供 應用程式組態 存放區的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

應用程式組態 存放區的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name>。

--retention-period

快照集在到期前可以保持封存的持續時間，以秒為單位。 免費層存放區的快照集最多可以封存 7 天 （604,800s），標準層存放區最多 90 天 （7,776,000s）。 如果指定，保留期限必須至少為1小時 （3600s）。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。

全域參數
--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 appconfig snapshot list

編輯

列出快照集。

az appconfig snapshot list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]
                           [--snapshot-name]
                           [--status {archived, failed, provisioning, ready}]
                           [--top]

範例

列出名稱開頭為 『abc』 的所有快照集。

az appconfig snapshot list -s abc* -n MyAppConfiguration

列出所有封存的快照集。

az appconfig snapshot list --status archived -n MyAppConfiguration

列出名稱開頭為 『app』 的所有布建快照集。

az appconfig snapshot list -s app* --status provisioning -n MyAppConfiguration

列出所有失敗和布建快照集。

az appconfig snapshot list --status failed provisioning -n MyAppConfiguration

選擇性參數

--all

列出所有專案。

--auth-mode

這個參數可用來指出數據作業的授權方式。 如果驗證模式為「金鑰」，請提供 連接字串 或儲存名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供 --endpoint 或 --name ，且您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態 存放區存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供 應用程式組態 存放區的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint>。

--fields

自訂快照集的輸出欄位。

接受的值: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

應用程式組態 存放區的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<name>。

--snapshot-name -s

如果未指定任何名稱，則預設會傳回所有快照集。 支援星號作為篩選條件，例如 abc* 表示具有 abc 作為名稱前置詞的快照集。

預設值: *
--status

依其狀態篩選快照集。 如果未指定狀態，則預設會傳回所有快照集。

接受的值: archived, failed, provisioning, ready
--top -t

要傳回的項目數目上限。 必須是正整數。 預設為 100。

全域參數
--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 appconfig snapshot recover

編輯

復原封存的快照集。

az appconfig snapshot recover --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

範例

在組態存放區 MyAppConfiguration 中復原快照集 MySnapshot。

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

必要參數

--snapshot-name -s

應用程式組態 快照集的名稱。

選擇性參數

--auth-mode

這個參數可用來指出數據作業的授權方式。 如果驗證模式為「金鑰」，請提供 連接字串 或存放區名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供 --endpoint 或 --name ，且您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態 存放區存取金鑰和端點的組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供 應用程式組態 存放區的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint>。

--name -n

應用程式組態 存放區的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<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 appconfig snapshot show

編輯

顯示應用程式組態快照集的所有屬性。

az appconfig snapshot show --snapshot-name
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]

範例

在組態存放區 MyAppConfiguration 中顯示名稱為 MySnapshot 的應用程式設定快照集。

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

必要參數

--snapshot-name -s

應用程式組態 快照集的名稱。

選擇性參數

--auth-mode

這個參數可用來指出數據作業的授權方式。 如果驗證模式為「金鑰」，請提供 連接字串 或存放區名稱，而您的帳戶存取金鑰將會擷取以進行授權。 如果驗證模式為 「login」，請提供 --endpoint 或 --name ，且您的 「az login」 認證將用於授權。 您可以使用 來設定預設驗證模式 az configure --defaults appconfig_auth_mode=<auth_mode>。 如需詳細資訊，請參閱https://docs.microsoft.com/azure/azure-app-configuration/concept-enable-rbac。

接受的值: key, login
預設值: key
--connection-string

應用程式組態 存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用 az configure --defaults appconfig_connection_string=<connection_string> 或環境變數來預設名稱為 AZURE_APPCONFIG_CONNECTION_STRING。

--endpoint

如果驗證模式為「登入」，請提供 應用程式組態 存放區的端點 URL。 您可以使用 「az appconfig show」 命令來擷取端點。 您可以使用 來設定預設端點 az configure --defaults appconfig_endpoint=<endpoint>。

--fields

自訂快照集的輸出欄位。

接受的值: composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags
--name -n

應用程式組態 存放區的名稱。 您可以使用 來設定預設名稱 az configure --defaults app_configuration_store=<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 來取得完整偵錯記錄。