StartMigrationJob

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

마이그레이션 작업을 시작합니다.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /migration-api/v1/policy/{title}/start

요청 헤더

Object Migration API에서 공통으로 사용하는 헤더에 대한 정보는 Object Migration 요청 헤더를 참조해 주십시오.

요청 경로 파라미터

요청 경로 파라미터에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
title String Required 마이그레이션 정책 이름

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://objectmigration.apigw.ntruss.com/migration-api/v1/policy/migrationpolicy/start' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
title String - 마이그레이션 정책 이름
sourceBucketName String - 원본 버킷 이름
sourceRegionName String - 원본 리전 코드
sourceCspType String - 원본 CSP 유형
  • AWS | Azure
sourceEndpoint String - 원본 엔드 포인트
sourcePrefix String - 원본 데이터 접두어
  • 버킷 내 상세 경로 및 구분자
targetBucketName String - 타깃 버킷 이름
targetRegionName String - 타깃 리전 코드
targetEndpoint String - 타깃 엔드 포인트
targetPrefix String - 접두어
  • 버킷 내 상세 경로 및 구분자
jobState String - 작업 상태
  • INITIALIZED | STARTED | PAUSED | DELETED | DONE | ERROR
    • INITIALIZED: 준비됨
    • STARTED: 이관 중
    • PAUSED: 정지
    • DELETED: 삭제
    • DONE: 완료
    • ERROR: 오류
createTime String - 정책 생성 일시
  • ISO 8601 형식
updateTime String - 정책 업데이트 일시
  • ISO 8601 형식
estimatedDone Boolean - 원본 오브젝트 리스팅 완료 여부
  • true | false
    • true: 완료
    • false: 미완료
estimatedSize Number - 원본 데이터 전체 용량
migratedSize Number - 이관된 데이터 용량
skippedSize Integer - 이관되지 않은 데이터 용량
estimatedObjectNum Integer - 원본 오브젝트 수
migratedObjectNum Integer - 이관된 오브젝트 수
skippedObjectNum Integer - 이관되지 않은 오브젝트 수

응답 상태 코드

Object Migration API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Object Migration 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "title": "migrationpolicy",
    "sourceBucketName": "migration135",
    "sourceRegionName": "ap-southeast-2",
    "sourceCspType": "AWS",
    "sourceEndpoint": "https://s3.ap-southeast-2.amazonaws.com",
    "sourcePrefix": "",
    "targetBucketName": "migrationbucket",
    "targetRegionName": "KR",
    "targetEndpoint": "https://kr.object.ncloudstorage.com",
    "targetPrefix": "data/",
    "jobState": "STARTED",
    "createTime": "2025-07-15T00:32:36.480+00:00",
    "updateTime": "2025-07-15T01:30:06.179+00:00",
    "estimatedDone": true,
    "estimatedSize": 5402293,
    "migratedSize": 0,
    "skippedSize": 0,
    "estimatedObjectNum": 10,
    "migratedObjectNum": 0,
    "skippedObjectNum": 0
}