Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

准备Amazon IoT工作

Amazon IoT Device ManagementSoftware Package Catalog 通过替换参数以及与Amazon IoT舰队索引、动态事物组和Amazon IoT事物的保留名为 shadow 的集成来扩展Amazon IoT任务。

Amazon IoT任务的替代参数

您可以在Amazon IoT工作文档中使用替代参数作为占位符。当任务服务遇到替代参数时，它会将任务指向指定软件版本的属性以获取参数值。您可以使用此过程创建单个任务文档，并通过通用属性将元数据传递到任务中。例如，您可以通过程序包版本属性，将 Amazon Simple Storage Service（Amazon S3）URL、软件包 Amazon 资源名称（ARN）或签名传递到任务文档中。

在任务文档中，替代参数的格式应如下所示：

在以下示例中，有一个名为 samplePackage 的软件包，它有一个名为 2.1.5 的程序包版本，该版本具有以下属性：

对于 s3URL，任务文档参数编写如下：

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
}

对于 signature，任务文档参数编写如下：

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
}

完整的任务文档编写如下：

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
      },
    ],
    "signature": [
      "samplePackage" : "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
    ]
  }
}

完成替换后，将以下任务文档部署到设备上：

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile"
      },
    ],
    "signature": [
      "samplePackage" : "aaaaabbbbbcccccdddddeeeeefffffggggghhhhhiiiiijjjj"
    ]
  }
}

替代参数（之前和之后的视图）

替代参数使用各种标志（例如，对默认程序包版本使用 $default）简化任务文档的创建。这样就无需为每个任务部署手动输入特定的程序包版本元数据，因为这些标志会自动填充特定程序包版本中引用的元数据。有关程序包版本属性（例如代表默认程序包版本的 $default）的更多信息，请参阅 准备任务文档和程序包版本以进行部署。

在中Amazon Web Services 管理控制台，在任务部署包版本期间，切换部署指令文件编辑器窗口中的预览替换按钮，以查看带有和不带替换参数的作业文档。

使用DescribeJob和中的 “替换之前” 参数 GetJobDocument APIs，您可以查看移除替换参数之前和之后的 API 响应。请参考以下带有DescribeJob和的示例 GetJobDocument APIs：

有关Amazon IoT作业、创建作业文档和部署作业的更多信息，请参阅作业。

准备任务文档和程序包版本以进行部署

创建程序包版本时，它处于 draft 状态，表示正准备部署。要准备好程序包版本进行部署，您必须创建任务文档，将文档保存到任务可以访问的位置（例如 Amazon S3），确认程序包版本具有您希望任务文档使用的属性值。（注意：仅当程序包版本处于 draft 状态时，您才可以更新其属性。）

在为单包部署创建 Job 或 Job 模板时，您可以使用以下选项自定义任务文档：Amazon IoT

部署指令文件 (recipe)

Artifact 版本属性

程序包版本

如果您对软件包版本感到满意，请通过Amazon IoT控制台中的软件包详细信息页面或发出 UpdatePackageVersionAPI 操作进行发布。然后，您可以在创建任务时通过Amazon IoT控制台或发出 CreateJobAPI 操作来引用软件包版本。

部署时指定软件包和版本

要将程序包版本部署到设备，请确认任务文档中引用的软件包和程序包版本与 CreateJob API 操作的 destinationPackageVersions 参数中所述的软件包和程序包版本相匹配。如果它们不匹配，您将收到一条错误消息，提示您确保两个引用匹配。有关软件包目录错误消息的更多信息，请参阅 一般错误消息疑难解答。

除了任务文档中引用的软件包和程序包版本外，您还可以在 CreateJob API 操作的 destinationPackageVersions 参数中包含任务文档中未引用的其他软件包和程序包版本。确保任务文档中包含必要的安装信息，以便设备正确安装其他程序包版本。有关 CreateJob API 操作的更多信息，请参阅CreateJob。

通过Amazon IoT动态事物组定位工作

软件包目录与实例集索引、Amazon IoT 任务和 Amazon IoT 动态事物组配合使用来筛选和定位实例集中的设备，以选择要部署到设备上的程序包版本。您可以根据设备当前的包裹信息运行舰队索引查询，并将这些内容定位到Amazon IoT任务中。您也可以发布软件更新，但只能发布到符合条件的目标设备。例如，您可以指定只想将配置部署到当前运行 iot-device-client 1.5.09 的设备。有关更多信息，请参阅创建动态事物组。

预留命名影子和程序包版本

如果已配置，则Amazon IoT任务可以在任务成功完成时更新名为 shadow ($package) 的事物的保留内容。如果这样做，则无需手动将程序包版本与事物的预留命名影子相关联。

在以下情况下，您可以选择手动将程序包版本关联或更新到事物的预留命名影子：

您可以通过控制台或 UpdateThingShadow API 操作，将程序包版本添加到或更新为预留命名影子 ($package)。有关更多信息，请参阅将包版本与Amazon IoT事物关联。

卸载软件包及其程序包版本

$null是一个保留的占位符，它会提示Amazon IoT作业服务从设备的预留名为 shadow $package 的软件包中删除现有的软件包和软件包版本。有关更多信息，请参阅预留命名影子。

要使用此功能，请将 destinationPackageVersionAmazon 资源名称 (ARN) 末尾的版本名称替换为。$null之后，您必须指示您的服务从设备中删除该软件。

授权的 ARN 使用以下格式：

arn:aws:iot:<regionCode>:111122223333:package/<packageName>/version/$null

例如，

$ aws iot create-job \
    ... \
    --destinationPackageVersions ["arn:aws:iot:us-east-1:111122223333:package/samplePackage/version/$null"]