기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
SyncDeploymentJob
이 작업은 사용 중단되었습니다.
중요
해당 API는 더 이상 지원되지 않습니다. 자세한 내용은 지원 정책 페이지에서 2022년 5월 2일 업데이트를 참조하세요.
플릿의 로봇을 최신 배포와 동기화합니다. 이는 배포 후 로봇을 추가한 경우에 유용합니다.
Request Syntax
POST /syncDeploymentJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"fleet": "string"
}URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- clientRequestToken
-
요청 멱등성을 보장하기 위해 제공하는 고유한 대소문자 구분 식별자입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴:
[a-zA-Z0-9_\-=]*필수 사항 여부: Yes
- 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
-
플릿이 생성된 epoch 이후 경과 시간(밀리초)입니다.
유형: 타임스탬프
- deploymentApplicationConfigs
-
배포 애플리케이션 구성에 대한 정보입니다.
유형: DeploymentApplicationConfig객체 어레이
배열 멤버: 고정된 항목 수는 1개입니다.
- deploymentConfig
-
배포 구성에 대한 정보입니다.
유형: DeploymentConfig객체
- failureCode
-
작업 실패 시 오류 코드:
- InternalServiceError
-
내부 서비스 오류.
- RobotApplicationCrash
-
로봇 애플리케이션이 비정상적으로 종료되었습니다.
- SimulationApplicationCrash
-
시뮬레이션 애플리케이션이 비정상적으로 종료되었습니다.
- BadPermissionsRobotApplication
-
로봇 애플리케이션 번들을 다운로드할 수 없습니다.
- BadPermissionsSimulationApplication
-
시뮬레이션 애플리케이션 번들을 다운로드할 수 없습니다.
- BadPermissionsS3 출력
-
출력을 고객이 제공한 S3 버킷에 게시할 수 없습니다.
- BadPermissionsCloudwatchLogs
-
고객이 CloudWatch 제공한 Logs 리소스에 로그를 게시할 수 없습니다.
- SubnetIpLimitExceeded
-
서브넷 IP 제한을 초과했습니다.
- ENI LimitExceeded
-
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
-
플릿의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 1224입니다.
패턴:
arn:.* - status
-
동기화 작업의 상태입니다.
타입: 문자열
유효 값:
Pending | Preparing | InProgress | Failed | Succeeded | Canceled
Errors
모든 작업에서 일반적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- ConcurrentDeploymentException
-
실패율 임계값 백분율이 충족되었습니다.
HTTP 상태 코드: 400
- IdempotentParameterMismatchException
-
요청은 이전 요청과 동일한 클라이언트 토큰을 사용하지만, 동일하지는 않습니다. 요청이 동일하지 않는 한, 다른 요청에 클라이언트 토큰을 재사용하지 마세요.
HTTP 상태 코드: 400
- InternalServerException
-
RoboMaker AWS에서 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 500
- InvalidParameterException
-
요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.
HTTP 상태 코드: 400
- LimitExceededException
-
요청된 리소스가 허용된 최대 수를 초과하거나 동시 스트림 요청 수가 허용된 최대 수를 초과합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
지정한 리소스가 존재하지 않습니다.
HTTP 상태 코드: 400
- ThrottlingException
-
RoboMaker AWS는 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.
HTTP 상태 코드: 400
참고
언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.
