閱讀英文

共用方式為


az appconfig snapshot

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

命令

名稱 Description 類型 狀態
az appconfig snapshot archive

封存快照集。

核心 加語
az appconfig snapshot create

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

核心 加語
az appconfig snapshot list

列出快照集。

核心 加語
az appconfig snapshot recover

復原封存的快照集。

核心 加語
az appconfig snapshot show

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

核心 加語

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://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac

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

應用程式組態存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用名稱AZURE_APPCONFIG_CONNECTION_STRING az configure --defaults appconfig_connection_string=<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://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac

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

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

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

應用程式組態存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用名稱AZURE_APPCONFIG_CONNECTION_STRING az configure --defaults appconfig_connection_string=<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,000 個)。 如果指定,保留期限必須至少為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://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac

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

應用程式組態存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用名稱AZURE_APPCONFIG_CONNECTION_STRING az configure --defaults appconfig_connection_string=<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://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac

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

應用程式組態存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用名稱AZURE_APPCONFIG_CONNECTION_STRING az configure --defaults appconfig_connection_string=<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://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbac

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

應用程式組態存放區的存取金鑰和端點組合。 您可以使用 'az appconfig credential list' 找到。 用戶可以使用名稱AZURE_APPCONFIG_CONNECTION_STRING az configure --defaults appconfig_connection_string=<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。