共用方式為


參數檔案的測試案例

本文說明針對參數檔案使用範本測試工具組執行的測試。 例如,名為 azuredeploy.parameters.json的檔案。 這些範例包括測試名稱和測試通過失敗的程式碼範例。 如需如何執行測試或如何執行特定測試的詳細資訊,請參閱 測試參數

此工具組包含 Azure Resource Manager 範本(ARM 範本) 的測試案例 ,以及名為 azuredeploy.jsonmaintemplate.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 必須有值

參數必須包含 valuereference。 對於密碼之類的秘密,金鑰儲存庫會在參數檔案中使用 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"
    }
  }
}

後續步驟