CreateDeploymentJob - AWS RoboMaker
请求语法URI请求参数请求正文响应语法响应元素错误另请参阅

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。

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

CreateDeploymentJob

此操作已弃用。

重要

终止支持通知：2025 年 9 月 10 日， AWS 将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。

重要

不再支持API此功能，如果使用会引发错误。有关更多信息，请参阅 Support 政策页面 2022 年 1 月 31 日更新的内容。

将特定版本的机器人应用程序部署到实例集中的机器人。

考虑到一致性原因，机器人应用程序必须具有编号的 applicationVersion。要创建新版本，请使用 CreateRobotApplicationVersion 或参阅创建机器人应用程序版本。

注意

90 天之后，部署任务将过期并删除。这些任务无法再访问。

请求语法

POST /createDeploymentJob HTTP/1.1
Content-type: application/json

{
   "clientRequestToken": "string",
   "deploymentApplicationConfigs": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "postLaunchFile": "string",
            "preLaunchFile": "string"
         }
      }
   ],
   "deploymentConfig": { 
      "concurrentDeploymentPercentage": number,
      "downloadConditionFile": { 
         "bucket": "string",
         "etag": "string",
         "key": "string"
      },
      "failureThresholdPercentage": number,
      "robotDeploymentTimeoutInSeconds": number
   },
   "fleet": "string",
   "tags": { 
      "string" : "string" 
   }
}

URI请求参数

该请求不使用任何URI参数。

请求正文

该请求接受以下JSON格式的数据。

clientRequestToken

用于确保请求的幂等性而提供的唯一、区分大小写的标识符。

类型：字符串

长度限制：长度下限为 1。长度上限为 64。

模式：[a-zA-Z0-9_\-=]*

必需：是

deploymentApplicationConfigs

部署应用程序配置。

类型：DeploymentApplicationConfig 对象数组

数组成员：固定数量为 1 项。

必需：是

deploymentConfig

请求的部署配置。

类型：DeploymentConfig 对象

必需：否

fleet

要部署的队列的 Amazon 资源名称 (ARN)。

类型：字符串

长度限制：长度下限为 1。最大长度为 1224。

模式：arn:.*

必需：是

tags

包含附加到部署作业的标签键和标签值的映射。

类型：字符串到字符串映射

映射条目：最低 0 项。最多 50 项。

密钥长度限制：最小长度为 1。长度上限为 128。

键模式：[a-zA-Z0-9 _.\-\/+=:]*

值长度限制：最小长度为 0。最大长度为 256。

价值模式：[a-zA-Z0-9 _.\-\/+=:]*

必需：否

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "createdAt": number,
   "deploymentApplicationConfigs": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "postLaunchFile": "string",
            "preLaunchFile": "string"
         }
      }
   ],
   "deploymentConfig": { 
      "concurrentDeploymentPercentage": number,
      "downloadConditionFile": { 
         "bucket": "string",
         "etag": "string",
         "key": "string"
      },
      "failureThresholdPercentage": number,
      "robotDeploymentTimeoutInSeconds": number
   },
   "failureCode": "string",
   "failureReason": "string",
   "fleet": "string",
   "status": "string",
   "tags": { 
      "string" : "string" 
   }
}

响应元素

如果操作成功，服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

arn

部署任务的 Amazon 资源名称 (ARN)。

类型：字符串

长度限制：长度下限为 1。最大长度为 1224。

模式：arn:.*

createdAt

创建实例集的时间，用从纪元开始的毫秒数表示。

类型：时间戳

deploymentApplicationConfigs

部署应用程序配置。

类型：DeploymentApplicationConfig 对象数组

数组成员：固定数量为 1 项。

deploymentConfig

部署配置。

类型：DeploymentConfig 对象

failureCode

模拟作业失败时的失败代码：

BadPermissionError

AWSGreengrass 需要服务级别角色权限才能访问其他服务。该角色必须包括AWSGreengrassResourceAccessRolePolicy 托管策略。

ExtractingBundleFailure

无法从捆绑包中提取机器人应用程序。

FailureThresholdBreached

无法更新的机器人百分比超过了为部署设置的百分比。

GreengrassDeploymentFailed

无法将机器人应用程序部署到机器人。

GreengrassGroupVersionDoesNotExist

缺少与AWS机器人关联的 Greengrass 群组或版本。

InternalServerError

出现内部错误。请重试您的请求，但如果问题仍然存在，请联系我们并提供详细信息。

MissingRobotApplicationArchitecture

机器人应用程序没有与机器人架构相匹配的源。

MissingRobotDeploymentResource

缺少为机器人应用程序指定的一个或多个资源。例如，机器人应用程序是否有正确的启动包和启动文件？

PostLaunchFileFailure

启动后脚本失败。

PreLaunchFileFailure

启动前脚本失败。

ResourceNotFound

缺少一个或多个部署资源。例如，机器人应用程序源代码包还存在吗？

RobotDeploymentNoResponse

机器人没有回应。它可能未开机或未连接到互联网。

类型：字符串

有效值：ResourceNotFound | EnvironmentSetupError | EtagMismatch | FailureThresholdBreached | RobotDeploymentAborted | RobotDeploymentNoResponse | RobotAgentConnectionTimeout | GreengrassDeploymentFailed | InvalidGreengrassGroup | MissingRobotArchitecture | MissingRobotApplicationArchitecture | MissingRobotDeploymentResource | GreengrassGroupVersionDoesNotExist | LambdaDeleted | ExtractingBundleFailure | PreLaunchFileFailure | PostLaunchFileFailure | BadPermissionError | DownloadConditionFailed | BadLambdaAssociated | InternalServerError | RobotApplicationDoesNotExist | DeploymentFleetDoesNotExist | FleetDeploymentTimeout

failureReason

部署任务失败时的失败原因。

类型：字符串

长度约束：最小长度为 0。最大长度为 1024。

模式：.*

fleet

部署任务的目标实例集。

类型：字符串

长度限制：长度下限为 1。最大长度为 1224。

模式：arn:.*

status

部署作业的状态。

类型：字符串

有效值：Pending | Preparing | InProgress | Failed | Succeeded | Canceled

tags

添加到部署作业的所有标签列表。

类型：字符串到字符串映射

映射条目：最低 0 项。最多 50 项。

密钥长度限制：最小长度为 1。长度上限为 128。

键模式：[a-zA-Z0-9 _.\-\/+=:]*

值长度限制：最小长度为 0。最大长度为 256。

价值模式：[a-zA-Z0-9 _.\-\/+=:]*

错误

有关所有操作的常见错误信息，请参阅常见错误。

ConcurrentDeploymentException

已达到失败百分比阈值百分比。

HTTP状态码：400

IdempotentParameterMismatchException

此请求使用的客户端令牌与之前不完全相同的请求使用的相同。除非请求相同，否则请勿将客户端令牌重复用于不同的请求。

HTTP状态码：400

InternalServerException

AWS RoboMaker 遇到了服务问题。重新尝试您的调用。

HTTP状态码：500

InvalidParameterException

在请求中指定的参数无效、不受支持，或无法使用。请求的消息解释错误值。

HTTP状态码：400

LimitExceededException

请求的资源超过了允许的最大数量，或者并发流请求的数量超过了允许的最大数量。

HTTP状态码：400

ResourceNotFoundException

指定的资源不存在。

HTTP状态码：400

ThrottlingException

AWS RoboMaker 暂时无法处理请求。重新尝试您的调用。

HTTP状态码：400

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs，请参阅以下内容：