UpdateMigrationJob

Prev Next

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

마이그레이션 정책 내용을 수정합니다. 입력한 내용을 바탕으로 기존 정책에 덮어쓰기가 됩니다.

요청

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

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

요청 헤더

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

요청 경로 파라미터

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

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

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
title String Required 마이그레이션 정책 이름
  • 100Byte 이내로 입력
  • 특수 문자 '.', '-', '_'를 허용
source Object Required 원본 정보
source.sourceCspType String Required 원본 CSP 유형
  • AWS | Azure
source.regionName String Required 원본 리전 코드
source.bucketName String Required 원본 버킷 이름
source.prefix String Optional 원본 데이터 접두어
  • 특정 파일 그룹만 이관할 경우, 입력
source.accessKey String Required 원본 CSP 정보
  • AWS: 계정 Access Key
  • Azure: 스토리지 계정 이름
source.secretKey String Required 원본 CSP 정보
  • AWS: 계정 Secret Key
  • Azure: 계정 Access Key
target Object Required 타깃 정보
target.bucketName String Required 타깃 버킷 이름
target.prefix String Optional 접두어
  • 특정 경로에 이관할 경우, 입력

요청 예시

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

curl --location --request PUT 'https://objectmigration.apigw.ntruss.com/migration-api/v1/policy/mypolicy' \
--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' \
--header 'Content-Type: application/json' \
--data '{
            "title": "migrationpolicy",
            "source": {
                "sourceCspType": "AWS",
                "regionName": "ap-southeast-2",
                "bucketName": "testformigration135",
                "prefix": "",
                "accessKey": "****************",
                "secretKey": "****************************"
            },
            "target": {
                "bucketName": "migrationbucket",
                "prefix": "data/"
            }
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드 타입 필수 여부 설명
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": "INITIALIZED",
    "createTime": "2025-07-15T00:32:36.480+00:00",
    "updateTime": "2025-07-15T00:32:36.480+00:00",
    "estimatedDone": false,
    "estimatedSize": 0,
    "migratedSize": 0,
    "skippedSize": 0,
    "estimatedObjectNum": 0,
    "migratedObjectNum": 0,
    "skippedObjectNum": 0
}