本文說明針對參數檔案使用範本測試工具組執行的測試。 例如,名為 azuredeploy.parameters.json的檔案。 這些範例包括測試名稱和測試通過或失敗的程式碼範例。 如需如何執行測試或如何執行特定測試的詳細資訊,請參閱 測試參數。
此工具組包含 Azure Resource Manager 範本(ARM 範本) 的測試案例 ,以及名為 azuredeploy.json 或 maintemplate.json的主要範本檔案。
使用有效的內容版本
測試名稱:DeploymentParameters 必須有 ContentVersion
contentVersion必須包含格式1.0.0.0的字串,而且只使用數位。
下列範例 失敗,因為 contentVersion 遺失。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
下列範例 會失敗 ,因為 contentVersion 不是字串。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": {},
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
下列範例 會通過。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
檔案必須包含參數
測試名稱:DeploymentParameters 必須有參數
參數檔案必須包含parameters段。
下列範例 失敗。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
}
下列範例 會通過。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
使用有效的架構版本
測試名稱:DeploymentParameters 應具有架構
參數檔案必須包含有效的架構版本。
參數檔案有兩個有效的架構版本:
https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#
下列範例 失敗。
{
"$schema": "https://schema.management.azure.com/schemas/2021-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
下列範例 會通過。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
參數必須包含值
測試名稱:DeploymentParameters 必須有值
參數必須包含 value 或 reference。 對於密碼之類的秘密,金鑰儲存庫會在參數檔案中使用 reference。 如需詳細資訊,請參閱在部署期間使用 Azure Key Vault 以傳遞安全的參數值。
下列範例 失敗 ,因為 stgAcctName 沒有 value。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {}
}
}
下列範例 會通過。
{
"$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"stgAcctName": {
"value": "demostorage01"
}
}
}
後續步驟
- 若要了解測試工具組,請參閱使用 ARM 範本測試工具組。
- 如需 ARM 範本測試,請參閱 ARM 範本的測試案例。
- 如需 createUiDefinition 測試,請參閱 createUiDefinition.json的測試案例 。
- 若要瞭解所有檔案的測試,請參閱 所有檔案的測試案例。