参数文件的测试用例

本文介绍了使用参数文件的模板测试工具包运行的测试。 例如，名为 azuredeploy.parameters.json的文件 . 这些示例包括测试名称以及通过或未通过测试的代码示例 。 有关如何运行测试或如何运行特定测试的详细信息，请参阅测试参数。

该工具包包括测试用例，以及名为 Azure 资源管理器 azuredeploy.json 或 maintemplate.json 的主模板文件。

使用有效的 contentVersion

测试名称：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"
    }
  }
}

文件必须包含参数

测试名称：部署参数应具有参数

参数文件必须包含该 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"
    }
  }
}

使用有效的 Schema 版本

测试名称：DeploymentParameters 应具有架构

参数文件必须包含有效的架构版本。

参数文件有两个有效的 schema 版本：

• 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 应具有值

参数必须包含 a value 或 a reference。 对于密码等机密，密钥保管库在参数文件中使用 a reference 。 有关详细信息，请参阅在部署过程中使用 Azure 密钥保管库 传递安全参数值。

以下示例 失败 ，因为 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 的测试用例。
• 若要了解所有文件的测试，请参阅所有文件的测试用例。