匯入或匯出設定資料
Azure 應用程式設定支援資料匯入和匯出作業。 使用這些作業處理大量的設定資料,或交換應用程式設定存放區和程式碼專案間的資料。 例如,您可以設定一個應用程式設定存放區來提供測試,另一個用於生產。 您可以複製兩者間的應用程式設定,而不必輸入資料兩次。
本文提供使用 Azure 入口網站 或 Azure CLI (部分機器翻譯) 匯入和匯出資料的指南。 如果您已採用設定即程式碼,並管理 GitHub 或 Azure Devops 中的設定,即可以使用 GitHub Actions 或使用 Azure Pipeline Push 工作來設定進行中的設定檔匯入。
匯入資料
匯入會將設定資料從現有來源帶入應用程式設定存放區。 使用匯入函式移轉資料至應用程式設定存放區,或彙總多個來源的資料。
本指南說明如何匯入應用程式組態資料:
從組態檔匯入資料
請遵循下列步驟,從檔案匯入金鑰值。
注意
不支援從檔案匯入功能旗標。 如果組態檔包含功能旗標,會自動匯入為一般金鑰值。
在 Azure 入口網站中執行下列步驟:
瀏覽至應用程式設定存放區,然後從 [作業] 功能表選取 [匯入/匯出]。
在 [匯入] 索引標籤上,選取 [來源服務] 下的 [設定檔]。
在表單中填寫下列參數:
參數 |
描述 |
範例 |
針對語言 |
在 .NET、JAVA (Spring) 和其他之間,選擇匯入檔案的語言。 |
.NET |
檔案類型 |
在 YAML、Properties 或 JSON 之間選取匯入檔案的類型。 |
Json |
選取資料夾圖示,並瀏覽至要匯入的檔案。
填寫表單的下一部分:
參數 |
描述 |
範例 |
分隔符號 |
分隔符號是匯入設定檔中剖析的字元,可以分隔要新增至設定存放區的金鑰值。 選取下列其中一個選項:.、,、:、;、/、-、_、—。 |
; |
Prefix |
選擇性。 索引鍵前置詞是索引鍵/值「key」屬性的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 輸入的前置詞會附加至您從這個檔案所匯入每個索引鍵/值「key」屬性的前面, |
TestApp: |
標籤 |
選擇性。 選取現有的標籤,或輸入新標籤並指派給匯入的索引鍵值。 |
prod |
內容類型 |
選擇性。 指出您要匯入 JSON 檔案或 Key Vault 參考。 如需金鑰保存庫參考的詳細資訊,請移至使用 ASP.NET Core 應用程式中的金鑰保存庫參考。 |
JSON (application/json) |
選取 [套用] 繼續匯入。
您已從 JSON 檔案匯入金鑰值,並為其指派標籤「prod」和前置詞「TestApp」。 中間會使用分隔符號「:」加以分隔,而您所匯入所有索引鍵/值的內容類型都會設為「JSON」。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯入命令 az appconfig kv import
並新增下列參數:
參數 |
描述 |
範例 |
--name |
輸入您要匯入資料到其中的應用程式組態存放區名稱。 |
my-app-config-store |
--source |
輸入 file 以指出您要從檔案匯入應用程式組態資料。 |
file |
--path |
輸入包含您要匯入之資料的檔案本機路徑。 |
C:/Users/john/Downloads/data.json |
--format |
輸入 yaml、properties 或 json,以指出您要匯入的檔案格式。 |
json |
您也可以選擇性地新增下列參數:
參數 |
描述 |
範例 |
--separator |
選擇性。 分隔符號是將金鑰值扁平化為 Json/Yaml 的分隔符號。 匯出階層式結構時需要這個項目,而且會忽略屬性檔案和功能旗標。 選取下列其中一個選項:. 、, 、: 、; 、/ 、- 、_ 、— 。 |
; |
--prefix |
選擇性。 索引鍵前置詞是索引鍵的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 這個前置詞會附加至您所匯入每個索引鍵/值「key」屬性的前面。 |
TestApp: |
--label |
選擇性。 輸入將指派給您的匯入金鑰值的標籤。 |
prod |
--content-type |
選擇性。 輸入 appconfig/kvset 或 application/json 以指出匯入的內容是由 Key Vault 參考或 JSON 檔案所組成。 |
application/json |
範例:從 JSON 檔案匯入所有索引鍵/值和功能旗標、套用標籤「prod」,並附加前置詞「TestApp」。 新增「application/json」內容類型。
az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
命令列會顯示即將進行的變更清單。 選取 y
來確認匯入。
您已從 JSON 檔案匯入金鑰值,並為其指派標籤「prod」和前置詞「TestApp:」。 中間會使用分隔符號「:」加以分隔,而您所匯入所有索引鍵/值的內容類型都會設為「JSON」。
如需更多選擇性參數和範例,請移至 az appconfig kv import。
從應用程式組態存放區匯入資料
您可以將值從一個應用程式組態存放區匯入到另一個應用程式組態存放區,也可以將值從一個應用程式組態存放區匯入至相同的應用程式組態存放區,以便複製其值並套用不同的參數,例如新的標籤或內容類型。
請遵循下列步驟,從 Azure 應用程式組態存放區匯入金鑰值和功能旗標。
在 Azure 入口網站中執行下列步驟:
瀏覽至應用程式設定存放區,然後從 [作業] 功能表選取 [匯入/匯出]。
在 [匯入] 索引標籤上,選取 [來源服務] 下的 [應用程式組態]。
選取 [選取資源],以下列參數填入表單,然後選取 [套用]:
參數 |
描述 |
範例 |
訂用帳戶 |
預設會選取您目前的訂用帳戶。 |
my-subscription |
資源群組 |
選取包含應用程式組態存放區 (具有要匯入的組態) 的資源群組。 預設會選取您目前的資源群組。 |
my-resource-group |
資源 |
選取包含您要匯入之組態的應用程式組態存放區。 |
my-other-app-config-store |
注意
「成功擷取存取金鑰」訊息表示與應用程式組態存放區的連線成功。
填寫表單的下一部分:
參數 |
描述 |
範例 |
From 標籤 |
選取至少一個標籤以匯入具有對應標籤的值。 [全選] 會匯入具有任何標籤的索引鍵/值,[(無標籤)] 會將匯入項目限制於沒有標籤的索引鍵/值。 |
prod |
在特定時間 |
選擇性。 填寫並從指定的時間點匯入金鑰值。 這是所選設定存放區中索引鍵/值的時間點。 格式:「YYYY-MM-DDThh:mm:ssZ」。 如果留空,這個欄位會預設為索引鍵/值目前的時間點。 |
2022 年 7 月 28 日上午 12:00:00 |
覆寫預設金鑰值標籤 |
選擇性。 根據預設,匯入的項目會使用其目前的標籤。 核取方塊並輸入標籤,以自訂標籤覆寫這些預設值。 |
new |
覆寫預設金鑰值內容類型 |
選擇性。 根據預設,匯入的項目會使用其目前的內容類型。 核取此方塊,然後選取 [內容類型] 底下的 [Key Vault 參考] 或 [JSON (應用程式/json)],以指出匯入的內容包含 Key Vault 參考或 JSON 檔案。 只能覆寫匯入金鑰值的內容類型。 功能旗標的預設內容類型是「application/vnd.microsoft.appconfig.ff+json;charset=utf-8」,而且不會由此參數更新。 |
JSON (application/json) |
選取 [套用] 繼續匯入。
您已在 2021 年 1 月 28 日上午 12 點從應用程式組態存放區匯入具有「prod」標籤的索引鍵/值和功能旗標,並已為其指派「new」標籤。 您匯入的所有索引鍵/值,其內容類型均設為「JSON」。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯入命令 az appconfig kv import
並輸入下列參數:
參數 |
描述 |
範例 |
--name |
輸入您要匯入資料到其中的應用程式組態存放區名稱 |
my-app-config-store |
--source |
輸入 appconfig 以指出您要從應用程式組態存放區匯入資料。 |
appconfig |
--src-name |
輸入您要從其中匯入資料的應用程式組態存放區名稱。 |
my-source-app-config |
--src-label |
將您的匯入項目限制於具有特定標籤的索引鍵/值。 如果您未使用此參數,則只會匯入具有 Null 標籤的索引鍵/值。 支援星號作為篩選條件:針對所有標籤輸入 * ;針對具有 abc 作為前置詞的所有標籤輸入 abc* 。 |
prod |
您可以選擇性地新增下列參數:
參數 |
描述 |
範例 |
--label |
選擇性。 輸入將指派給您的匯入金鑰值的標籤。 |
new |
--content-type |
選擇性。 輸入 appconfig/kvset 或 application/json 以指出匯入的內容是由 Key Vault 參考或 JSON 檔案所組成。 只能覆寫匯入金鑰值的內容類型。 根據預設,功能旗標的預設內容類型是「application/vnd.microsoft.appconfig.ff+json;charset=utf-8」,而且不會由此參數更新。 |
application/json |
範例:從另一個應用程式組態匯入具有「prod」標籤的索引鍵/值和功能旗標,並為其指派「new」標籤。 新增「application/json」內容類型。
az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
命令列會顯示即將進行的變更清單。 選取 y
來確認匯入。
您已從應用程式組態存放區匯入具有「prod」標籤的索引鍵/值,並為其指派「new」標籤。 您匯入的所有索引鍵/值,其內容類型均設為「JSON」。
如需更多選擇性參數和範例,請移至 az appconfig kv import。
從 Azure App Service 匯入資料
請遵循下列步驟,從 Azure App Service 匯入金鑰值。
注意
App Service 目前不支援功能旗標。 匯入至 App Service 的所有功能旗標都會自動轉換成金鑰值。 您的 App Service 資源只能包含金鑰值。
從 Azure 入口網站:
瀏覽至應用程式設定存放區,然後從 [作業] 功能表選取 [匯入/匯出]。
在 [匯入] 索引標籤上,選取 [來源服務] 底下的 [App Services]。
選取 [選取資源],以下列參數填入表單,然後選取 [套用]:
參數 |
描述 |
範例 |
訂用帳戶 |
預設會選取您目前的訂用帳戶。 |
my-subscription |
資源群組 |
選取包含 App Service (具有要匯入的組態) 的資源群組。 |
my-resource-group |
資源 |
選取包含您要匯入之組態的 App Service。 |
my-app-service |
注意
畫面上會隨即顯示訊息,指出已從來源 App Service 資源成功擷取的索引鍵/值數目。
填寫表單的下一部分:
參數 |
描述 |
範例 |
Prefix |
選擇性。 索引鍵前置詞是索引鍵/值「key」屬性的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 這個前置詞會附加至您所匯入每個索引鍵/值「key」屬性的前面。 |
TestApp: |
標籤 |
選擇性。 選取現有的標籤,或輸入新標籤並指派給匯入的索引鍵值。 |
prod |
內容類型 |
選擇性。 指出匯入的檔案是否為金鑰保存庫參考或 JSON 檔案。 如需金鑰保存庫參考的詳細資訊,請移至使用 ASP.NET Core 應用程式中的金鑰保存庫參考。 |
JSON (application/json) |
選取 [套用] 繼續匯入。
您已從 App Service 匯入所有應用程式設定作為金鑰值,並為其指派標籤「prod」和前置詞「TestApp」。 您匯入的所有索引鍵/值,其內容類型均設為「JSON」。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯入命令 az appconfig kv import
並新增下列參數:
參數 |
描述 |
範例 |
--name |
輸入您要匯入資料到其中的應用程式組態存放區名稱。 |
my-app-config-store |
--source |
輸入 appservice 以指出您要從 Azure App Service 匯入應用程式組態資料。 |
appservice |
--appservice-account |
如果 App Service 與應用程式組態位於相同的訂用帳戶和資源群組中,輸入 App Service 的 ARM 識別碼或使用 App Service 的名稱。 |
/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service 或 my-app-service |
您也可以選擇性地新增下列參數:
參數 |
描述 |
範例 |
--prefix |
選擇性。 索引鍵前置詞是索引鍵/值「key」屬性的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 這個前置詞會附加至您所匯入每個索引鍵/值「key」屬性的前面。 |
TestApp: |
--label |
選擇性。 輸入將指派給您的匯入金鑰值的標籤。 如果您未指定標籤,則會將 Null 標籤指派給金鑰值。 |
prod |
--content-type |
選擇性。 輸入 appconfig/kvset 或 application/json,以指出匯入的內容是由 Key Vault 參考或 JSON 檔案所組成。 |
application/json |
若要取得 --appservice-account
的值,請使用命令 az webapp show --resource-group <resource-group> --name <resource-name>
。
範例:將所有應用程式設定從您的 App Service 匯入至應用程式組態存放區作為具有「prod」標籤的金鑰值,並新增「TestApp:」前置詞。
az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
命令列會顯示即將進行的變更清單。 選取 y
來確認匯入。
您已從 App Service 匯入所有應用程式設定作為金鑰值、為其指派「prod」標籤,並新增「TestApp:」前置詞。 您匯入的所有索引鍵/值,其內容類型均設為「JSON」。
如需更多選擇性參數和範例,請移至 az appconfig kv import。
匯出資料
匯出會將應用程式設定中儲存的設定資料寫入另一個目的地。 例如,部署期間使用匯出函式,將資料從應用程式設定存放區儲存至可內嵌在應用程式程式碼的檔案。
本指南說明如何匯出應用程式組態資料:
將資料匯出至組態檔
請遵循下列步驟,將組態資料從應用程式組態存放區匯出至 JSON、YAML 或 Properties 檔案。
注意
目前僅在 CLI 中支援將功能旗標從應用程式組態存放區匯出至組態檔。
在 Azure 入口網站中,執行下列步驟:
瀏覽至應用程式設定存放區,然後選取 [匯入/匯出]。
在 [匯出] 索引標籤上,選取 [目標服務] 下的 [組態檔]。
在表單中填寫下列參數:
參數 |
描述 |
範例 |
Prefix |
選擇性。 這個前置詞會從每個索引鍵/值的「key」屬性中裁掉。 索引鍵前置詞是索引鍵的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 |
TestApp: |
From 標籤 |
選取現有的標籤,將匯出限制為包含特定標籤的索引鍵值。 如果您未選取標籤,預設只會匯出具有「無標籤」標籤的金鑰值。 請參閱下列注意事項。 |
prod |
在特定時間 |
選擇性。 填寫並從指定的時間點匯入金鑰值。 這是所選設定存放區中索引鍵/值的時間點。 格式:「YYYY-MM-DDThh:mm:ssZ」。 如果留空,這個欄位會預設為索引鍵/值目前的時間點。 |
2022 年 7 月 28 日上午 12:00:00 |
檔案類型 |
在 YAML、Properties 或 JSON 之間,選取匯出檔案的類型。 |
JSON |
分隔符號 |
分隔符號是將金鑰值扁平化為 Json/Yaml 的分隔符號。 支援組態的階層式結構,不適用於屬性檔案和功能旗標。 選取下列其中一個選項:.、,、:、;、/、-、_、— 或 (沒有分隔符號)。 |
; |
重要
如果您未選取「From」標籤,則只會匯出沒有任何標籤的索引鍵/值。 若要使用標籤匯出索引鍵值,請選取標籤。 請注意,在入口網站中,您只能為每個匯出選取一個標籤,如果您想要匯出具有所有指定標籤的金鑰值,請使用 CLI。
選取 [匯出] 完成匯出。
您已在 2021 年 7 月 28 日上午 12:00:00 從組態檔匯出具有「prod」標籤的金鑰值,並已修剪前置詞「TestApp」。 在檔案中值會以「;」分隔。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯出命令 az appconfig kv export
並新增下列參數:
參數 |
描述 |
範例 |
--name |
輸入包含您要匯出之金鑰值的應用程式組態存放區名稱。 |
my-app-config-store |
--destination |
輸入 file 以指出您要將資料匯出至檔案。 |
file |
--path |
輸入您要儲存檔案的路徑。 |
C:/Users/john/Downloads/data.json |
--format |
輸入 yaml 、properties 或 json ,以指出您要匯出的檔案格式。 |
json |
--label |
輸入標籤,以匯出具有此標籤的索引鍵/值和功能旗標。 如果您未指定標籤,則在預設情形下,只會匯出沒有任何標籤的索引鍵/值和功能旗標。 您可以輸入一個標籤、輸入數個標籤並且使用 , 分隔,或使用 * 來擷取帳戶中的所有標籤。 |
prod |
重要
如果您未選取標籤,則只會匯出沒有任何標籤的索引鍵/值。 若要使用標籤匯出索引鍵值,請選取標籤。
您也可以選擇性地新增下列參數:
參數 |
描述 |
範例 |
--separator |
選擇性。 分隔符號是將金鑰值扁平化為 Json/Yaml 的分隔符號。 匯出階層式結構時需要這個項目,而且會忽略屬性檔案和功能旗標。 選取下列其中一個選項:. 、, 、: 、; 、/ 、- 、_ 、— 。 |
; |
--prefix |
選擇性。 前置詞會從每個索引鍵/值的「key」屬性中裁掉。 索引鍵前置詞是索引鍵的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 針對功能旗標忽略前置詞。 |
TestApp: |
範例:將具有「prod」標籤的所有索引鍵/值和功能旗標匯出至 JSON 檔案。
az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
命令列會顯示匯出至檔案的金鑰值清單。 選取 y
來確認匯出。
您已將具有「prod」標籤的金鑰值和功能旗標匯出至組態檔,並修剪前置詞「TestApp」。 在檔案中值會以「;」分隔。
如需更多選擇性參數和範例,請移至 az appconfig kv export。
將資料匯出至應用程式組態存放區
請遵循下列步驟,將金鑰值和功能旗標匯出至 Azure 應用程式組態存放區。
您可以將值從一個應用程式組態存放區匯出到另一個應用程式組態存放區,也可以將值從一個應用程式組態存放區匯出至相同的應用程式組態存放區,以便複製其值並套用不同的參數,例如新的標籤或內容類型。
在 Azure 入口網站中執行下列步驟:
瀏覽至包含您要匯出之資料的應用程式組態存放區,然後從 [作業] 功能表選取 [匯入/匯出]。
在 [匯出] 索引標籤上,選取 [目標服務] 下的 [應用程式組態]。
選取 [選取資源],以下列參數填入表單,然後選取 [套用]:
參數 |
描述 |
範例 |
訂用帳戶 |
預設會選取您目前的訂用帳戶。 |
my-subscription |
資源群組 |
選取包含應用程式組態存放區 (具有要匯入的組態) 的資源群組。 |
my-resource-group |
資源 |
選取包含您要匯入之組態的應用程式組態存放區。 |
my-app-config-store |
此頁面現在會顯示選取的目標服務和資源識別碼。 選取資源動作可讓您切換至另一個來源應用程式組態存放區。
注意
畫面上會顯示訊息,指出已成功擷取索引鍵/值。
填寫表單的下一部分:
參數 |
描述 |
範例 |
From 標籤 |
選取至少一個標籤以匯出具有對應標籤的值。 [全選] 會匯出具有任何標籤的索引鍵/值,[(無標籤)] 會將匯出項目限制於沒有標籤的索引鍵/值。 |
prod |
在特定時間 |
選擇性。 填寫並從指定的時間點匯入金鑰值。 這是所選設定存放區中索引鍵/值的時間點。 格式:「YYYY-MM-DDThh:mm:ssZ」。 如果留空,這個欄位會預設為索引鍵/值目前的時間點。 |
2022 年 7 月 28 日上午 12:00:00 |
覆寫預設金鑰值標籤 |
選擇性。 根據預設,匯入的項目會使用其目前的標籤。 核取方塊並輸入標籤,以自訂標籤覆寫這些預設值。 |
new |
選取 [套用] 繼續匯出。
您已從 2022 年 7 月 28 日上午 12:00:00 從應用程式組態存放區匯出金鑰值和功能旗標,並且已為其指派「new」標籤。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯出命令 az appconfig kv export
並輸入下列參數:
參數 |
描述 |
範例 |
--name |
輸入包含您要匯出之金鑰值的應用程式組態存放區名稱。 |
my-app-config-store |
--destination |
輸入 appconfig 以指出您要將資料匯出至應用程式組態存放區。 |
appconfig |
--dest-name |
輸入您要匯出資料到其中的應用程式組態存放區名稱。 |
my-other-app-config-store |
--label |
輸入標籤,以匯出具有此標籤的索引鍵/值和功能旗標。 如果您未指定標籤,則在預設情形下,只會匯出沒有任何標籤的索引鍵/值和功能旗標。 您可以輸入一個標籤、輸入數個標籤並且使用 , 分隔,或使用 * 來擷取帳戶中的所有標籤。 |
prod |
重要
如果您要匯出的索引鍵/值具有標籤,您必須使用 --label
命令並輸入對應的標籤。 如果您未選取標籤,則只會匯出沒有任何標籤的索引鍵/值。 使用逗號 (,
) 選取數個標籤,或使用 *
來包含所有標籤,包括 Null 標籤 (無標籤)。
您也可以選擇性地新增下列參數:
參數 |
描述 |
範例 |
--dest-label |
選擇性。 輸入目的地標籤,以將此標籤指派給匯出的金鑰值。 |
new |
範例:將具有「prod」標籤的索引鍵/值和功能旗標匯出至另一個應用程式組態存放區,並新增目的地標籤「new」。
az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
命令列會顯示匯出至檔案的金鑰值清單。 選取 y
來確認匯出。
您已從應用程式組態存放區匯出金鑰值和功能旗標,並且已為其指派「new」標籤。
如需更多選擇性參數和範例,請移至 az appconfig kv import。
將資料匯出至 Azure App Service
請遵循下列步驟,將金鑰值匯出至 Azure App Service。
注意
目前不支援將功能旗標匯出至 App Service。
在 Azure 入口網站中執行下列步驟:
瀏覽至應用程式設定存放區,然後從 [作業] 功能表選取 [匯入/匯出]。
在 [匯出] 索引標籤上,選取 [目標服務] 底下的 [App Service]。
選取 [選取資源],以下列參數填入表單,然後選取 [套用]:
參數 |
描述 |
範例 |
訂用帳戶 |
預設會選取您目前的訂用帳戶。 |
my-subscription |
資源群組 |
選取包含 App Service (具有要匯出的組態) 的資源群組。 |
my-resource-group |
資源 |
選取包含您要匯出之組態的 App Service。 |
my-app-service |
此頁面現在會顯示選取的目標服務和資源識別碼。 選取資源動作可讓您切換至另一個目標 App Service 資源。
選擇性填寫表單的下一部分:
參數 |
描述 |
範例 |
Prefix |
選擇性。 這個前置詞會從每個已匯出索引鍵/值的「key」屬性中裁掉。 索引鍵前置詞是索引鍵的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 針對功能旗標忽略前置詞。 |
TestApp: |
匯出作為參考 |
選擇性。 檢查是否將索引鍵/值匯出至 App Service,作為應用程式組態參考。 深入了解 |
|
在特定時間 |
選擇性。 填寫並從指定的時間點匯出索引鍵值。 這是所選設定存放區中索引鍵/值的時間點。 格式:「YYYY-MM-DDThh:mm:ssZ」。 如果留空,這個欄位會預設為索引鍵/值目前的時間點。 |
2022 年 7 月 28 日上午 12:00:00 |
From 標籤 |
選擇性。 選取現有的標籤,將匯出限制為包含特定標籤的索引鍵值。 如果您未選取標籤,只會匯出具有「無標籤」標籤的金鑰值。 |
prod |
選取 [套用] 繼續匯出。
您已在 2021 年 7 月 28 日上午 12:00:00 從 App Service 資源匯出具有「prod」標籤的金鑰值,並已修剪前置詞「TestApp」。 索引鍵/值已經以 JSON 格式的內容類型匯出。
如果您勾選方塊,將索引鍵/值匯出作為參考,在 App Service 資源組態設定的「Source」資料行中,就會顯示已匯出的索引鍵/值為應用程式組態的參考。
從 Azure CLI,遵循下列步驟。 如果本機未安裝 Azure CLI,您可以選擇使用 Azure Cloud Shell。
輸入匯出命令 az appconfig kv export
並輸入下列參數:
參數 |
描述 |
範例 |
--name |
輸入包含您要匯出之金鑰值的應用程式組態存放區名稱。 |
my-app-config-store |
--destination |
輸入 appservice 以指出您要將資料匯出至 App Service。 |
appservice |
--appservice-account |
如果 App Service 與應用程式組態位於相同的訂用帳戶和資源群組中,輸入 App Service 的 ARM 識別碼或使用 App Service 的名稱。 |
/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service 或 my-app-service |
--label |
選擇性。 輸入標籤,以匯出具有此標籤的索引鍵/值和功能旗標。 如果您未指定標籤,則在預設情形下,只將會匯出沒有任何標籤的索引鍵/值和功能旗標。 |
prod |
若要取得 --appservice-account
的值,請使用命令 az webapp show --resource-group <resource-group> --name <resource-name>
。
選擇性地新增前置詞:
參數 |
描述 |
範例 |
--prefix |
選擇性。 前置詞會從已匯出索引鍵/值的「key」屬性中裁掉。 索引鍵前置詞是索引鍵的開頭部分。 前置詞可用於管理組態存放區中的索引鍵/值群組。 |
TestApp: |
範例:將標籤為「prod」的所有金鑰值匯出至 App Service 應用程式,並修剪前置詞「TestApp」。
az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
命令列會顯示匯出至 App Service 資源的索引鍵/值清單。 選取 y
來確認匯出。
您已將具有「prod」標籤的所有索引鍵/值匯出至 Azure App Service 資源,並裁掉前置詞「TestApp:」。
選擇是否指定要匯出為應用程式組態參考的旗標。
參數 |
描述 |
--export-as-reference -r |
選擇性。 指定索引鍵/值是否匯出至 App Service,作為應用程式組態參考。 深入了解。 |
範例:匯出所有具備「prod」標籤的索引鍵/值,作為 App Service 應用程式的應用程式組態參考。
az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
命令列會顯示索引鍵/值清單,這些索引鍵/值會匯出至 App Service 資源,作為應用程式組態參考。 選取 y
來確認匯出。
您已將具有「prod」標籤的所有索引鍵/值匯出至 Azure App Service 資源,作為應用程式組態參考。 在您的 App Service 資源中,「Source」資料行會顯示所匯入的索引鍵/值為應用程式組態參考。
如需更多選擇性參數和範例,請移至 az appconfig kv export。
錯誤訊息
匯入或匯出應用程式組態的索引鍵/值時,畫面上可能會出現下列錯誤訊息:
- 選取的檔案必須介於 1 到 2097152 個位元組之間。:您的檔案太大。 選取較小的檔案。
- 您的存放區已停用公用存取,或您從不在存放區私人端點組態中的私人端點進行存取。 如要從應用程式組態存放區匯入索引鍵/值,您需擁有該存放區的存取權限。 如有必要,請啟用來源存放區的公用存取,或從核准的私人端點進行存取。 如果您剛啟用公用存取,請等候最多 5 分鐘,讓快取重新整理。
下一步