终止支持通知：2025 年 9 月 10 日， AWS
将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
SyncDeploymentJob
此操作已弃用。
重要
终止支持通知：2025 年 9 月 10 日， AWS
将停止对的支持。 AWS RoboMaker2025 年 9 月 10 日之后，您将无法再访问 AWS RoboMaker 控制台或 AWS RoboMaker 资源。有关过渡 AWS Batch 到以帮助运行容器化仿真的更多信息，请访问此博客文章。
重要
API不再支持此功能。有关更多信息，请参阅 Support 政策页面 2022 年 5 月 2 日更新的内容。
将实例集中的机器人同步到最新部署。如果在部署后添加了机器人会很有帮助。
请求语法
POST /syncDeploymentJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"fleet": "string"
}URI请求参数
该请求不使用任何URI参数。
请求正文
该请求接受以下JSON格式的数据。
- clientRequestToken
-
用于确保请求的幂等性而提供的唯一、区分大小写的标识符。
类型：字符串
长度限制：长度下限为 1。长度上限为 64。
模式：
[a-zA-Z0-9_\-=]*必需：是
- fleet
-
同步所需目标实例集。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.*必需：是
响应语法
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"
}响应元素
如果操作成功，服务将发回 HTTP 200 响应。
以下数据由服务以JSON格式返回。
- arn
-
同步请求的 Amazon 资源名称 (ARN)。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.* - createdAt
-
创建实例集的时间，用从纪元开始的毫秒数表示。
类型：时间戳
- deploymentApplicationConfigs
-
有关部署应用程序配置的信息。
类型：DeploymentApplicationConfig 对象数组
数组成员：固定数量为 1 项。
- deploymentConfig
-
有关部署配置的信息。
类型：DeploymentConfig 对象
- failureCode
-
作业失败时的失败代码：
- InternalServiceError
-
内部服务错误。
- RobotApplicationCrash
-
机器人应用程序异常退出。
- SimulationApplicationCrash
-
模拟应用程序异常退出。
- BadPermissionsRobotApplication
-
无法下载机器人应用程序包。
- BadPermissionsSimulationApplication
-
无法下载模拟应用程序包。
- BadPermissionsS3Output
-
无法将输出发布到客户提供的 S3 存储桶。
- BadPermissionsCloudwatchLogs
-
无法将日志发布到客户提供的 CloudWatch 日志资源。
- SubnetIpLimitExceeded
-
已超出子网 IP 限制。
- ENILimitExceeded
-
ENI已超出限制。
- BadPermissionsUserCredentials
-
无法使用提供的角色。
- InvalidBundleRobotApplication
-
无法提取机器人捆绑包（格式无效、捆绑错误或其他问题）。
- InvalidBundleSimulationApplication
-
无法提取模拟捆绑包（格式无效、捆绑错误或其他问题）。
- RobotApplicationVersionMismatchedEtag
-
Etag for 在版本创建期间与值 RobotApplication 不匹配。
- SimulationApplicationVersionMismatchedEtag
-
Etag for 在版本创建期间与值 SimulationApplication 不匹配。
类型：字符串
有效值：
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
-
舰队的亚马逊资源名称 (ARN)。
类型：字符串
长度限制：长度下限为 1。最大长度为 1224。
模式：
arn:.* - status
-
同步作业的状态。
类型：字符串
有效值：
Pending | Preparing | InProgress | Failed | Succeeded | Canceled
错误
有关所有操作的常见错误信息，请参阅常见错误。
- 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，请参阅以下内容：
