SyncDeploymentJob - AWS RoboMaker
Request SyntaxURI 요청 파라미터요청 본문응답 구문Response ElementsErrors참고

지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을 참조하세요.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

SyncDeploymentJob

이 작업은 사용 중단되었습니다.

중요

지원 종료 알림: 는 2025 AWS 년 9월 10일에 에 대한 지원을 중단합니다 AWS RoboMaker. 2025년 9월 10일 이후에는 AWS RoboMaker 콘솔 또는 AWS RoboMaker 리소스에 더 이상 액세스할 수 없습니다. 컨테이너화된 시뮬레이션 실행을 돕기 AWS Batch 위해 로 전환하는 방법에 대한 자세한 내용은 이 블로그 게시물을 참조하세요.

중요

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.

Pattern: [a-zA-Z0-9_\-=]*

필수 여부: 예

fleet

동기화를 위한 대상 플릿입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1224입니다.

Pattern: 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"
}

Response Elements

작업이 성공하면 서비스가 HTTP 200개의 응답을 다시 보냅니다.

다음 데이터는 서비스에서 JSON 형식으로 반환됩니다.

arn

동기화 요청의 Amazon 리소스 이름(ARN)입니다.

유형: 문자열

길이 제약: 최소 길이 1. 최대 길이는 1224입니다.

패턴: arn:.*

createdAt

플릿이 생성된 epoch 이후 경과 시간(밀리초)입니다.

유형: 타임스탬프

deploymentApplicationConfigs

배포 애플리케이션 구성에 대한 정보입니다.

유형: DeploymentApplicationConfig객체 어레이

배열 멤버: 고정된 항목 수는 1개입니다.

deploymentConfig

배포 구성에 대한 정보입니다.

유형: DeploymentConfig 객체

failureCode

작업 실패 시 오류 코드:

InternalServiceError

내부 서비스 오류.

RobotApplicationCrash

로봇 애플리케이션이 비정상적으로 종료되었습니다.

SimulationApplicationCrash

시뮬레이션 애플리케이션이 비정상적으로 종료되었습니다.

BadPermissionsRobotApplication

로봇 애플리케이션 번들을 다운로드할 수 없습니다.

BadPermissionsSimulationApplication

시뮬레이션 애플리케이션 번들을 다운로드할 수 없습니다.

BadPermissionsS3Output

출력을 고객이 제공한 S3 버킷에 게시할 수 없습니다.

BadPermissionsCloudwatchLogs

고객이 제공한 Logs 리소스에 CloudWatch 로그를 게시할 수 없습니다.

SubnetIpLimitExceeded

서브넷 IP 제한을 초과했습니다.

ENILimitExceeded

ENI 한도를 초과했습니다.

BadPermissionsUserCredentials

제공된 역할을 사용할 수 없습니다.

InvalidBundleRobotApplication

로봇 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).

InvalidBundleSimulationApplication

시뮬레이션 번들을 추출할 수 없습니다(잘못된 형식, 번들링 오류 또는 기타 문제).

RobotApplicationVersionMismatchedEtag

버전 생성 중 에 대한 태그 RobotApplication 가 값과 일치하지 않습니다.

SimulationApplicationVersionMismatchedEtag

버전 생성 중 에 대한 태그 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

AWS RoboMaker 서비스 문제가 발생했습니다. 호출을 다시 시도하세요.

HTTP 상태 코드: 500

InvalidParameterException

요청에 지정된 파라미터는 유효하지 않거나, 지원되지 않거나, 사용할 수 없습니다. 반환된 메시지는 오류 값에 대한 설명을 제공합니다.

HTTP 상태 코드: 400

LimitExceededException

요청된 리소스가 허용된 최대 수를 초과하거나 동시 스트림 요청 수가 허용된 최대 수를 초과합니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 400

ThrottlingException

AWS RoboMaker 가 일시적으로 요청을 처리할 수 없습니다. 호출을 다시 시도하세요.

HTTP 상태 코드: 400

참고

언어별 중 하나API에서 이를 사용하는 방법에 대한 자세한 내용은 다음을 AWS SDKs참조하세요.