change-box-infra

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

Box 인프라를 수정합니다. 인프라 변경 작업에 일정 시간이 소요되므로 비동기 방식으로 처리됩니다.

요청

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

메서드	URI
POST	/api/v1/box/change-box-infra

요청 헤더

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

요청 바디

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

필드	타입	필수 여부	설명
`fenceId`	Integer	Required	Datafence 번호 get-datafence 참조
`updateBoxInfo`	Object	Required	Box 수정 정보
`updateBoxInfo.boxId`	Integer	Required	Box 번호 get-box-list 참조
`updateBoxInfo.description`	String	Optional	Box에 대한 설명
`updateBoxInfo.connectServerList`	Array	Optional	Connect 서버 목록 최소 1대, 최대 4대 설정
`updateBoxInfo.linuxServerList`	Array	Optional	Linux 서버 목록 최소 1대, 최대 4대 설정
`updateBoxInfo.windowsServerList`	Array	Optional	Windows 서버 목록 최소 0대, 최대 4대 설정
`updateBoxInfo.boxNasList`	Array	Optional	NAS 목록 최소 1대 설정
`updateBoxInfo.hadoopList`	Array	Optional	Hadoop 클러스터 목록 최대 2개 클러스터 설정
`updateBoxInfo.tensorFlowCpuServerList`	Array	Optional	Tensorflow CPU 서버 목록 최대 4대 설정
`updateBoxInfo.tensorFlowGpuServerList`	Array	Optional	Tensorflow GPU 서버 목록 최대 2대 설정

`connectServerList`

connectServerList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`serverInstanceNo`	String	Conditional	Connect 서버 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`blockStorageInstanceNo`	String	Conditional	Connect 서버 블록 스토리지 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`specCode`	String	Conditional	Connect 서버 스펙 코드 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 get-product-spec 참조
`storageSize`	Integer	Conditional	Connect 서버 블록 스토리지 크기(GB) `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 10~2000 10GB 단위로 설정
`userPassword1`	String	Conditional	Connect 서버 ncp1 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백
`userPassword2`	String	Conditional	Connect 서버 ncp2 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

`linuxServerList`

linuxServerList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`serverInstanceNo`	String	Conditional	Linux 서버 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`blockStorageInstanceNo`	String	Conditional	Linux 서버 블록 스토리지 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`specCode`	String	Conditional	Linux 서버 스펙 코드 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 get-product-spec 참조
`softwareCode`	String	Conditional	Linux 서버 소프트웨어 코드 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`storageSize`	Integer	Conditional	Linux 서버 블록 스토리지 크기(GB) `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 10~2000 10GB 단위로 설정
`userPassword`	String	Conditional	Linux 서버 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

`windowsServerList`

windowsServerList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`serverInstanceNo`	String	Conditional	Windows 서버 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`blockStorageInstanceNo`	String	Conditional	Windows 서버 블록 스토리지 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`specCode`	String	Conditional	Windows 서버 스펙 코드 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 get-product-spec 참조
`softwareCode`	String	Conditional	Windows 서버 소프트웨어 코드 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`storageSize`	Integer	Conditional	Windows 서버 블록 스토리지 크기(GB) `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 10~2000 10GB 단위로 설정
`userPassword`	String	Conditional	Windows 서버 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

`boxNasList`

boxNasList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `DELETE` `CREATE`: 생성 `DELETE`: 반납
`nasInstanceNo`	String	Conditional	NAS 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `DELETE`인 경우, 필수 입력
`nasSize`	Integer	Conditional	NAS 볼륨 크기(GB) 500~10000 100GB 단위로 설정
`count`	Integer	Conditional	NAS 개수 `actionType`이 `CREATE`인 경우, 필수 입력

`hadoopList`

hadoopList에 대한 설명은 다음과 같습니다.

참고

Hadoop 클러스터의 하드웨어 스펙 혹은 워커(데이터) 노드 개수를 변경할 경우, 기존 클러스터의 정보와 변경할 정보를 함께 입력해야 합니다. 자세한 사항은 요청 예시의 주석을 참조해 주십시오.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`hadoopClusterNo`	String	Conditional	Hadoop 클러스터 번호 get-box-infra-list 참조 `infraType`이 `HD`인 인프라의 `instanceNo` 입력 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`edgeNodeSpecCode`	String	Conditional	엣지 노드 스펙 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`masterNodeSpecCode`	String	Conditional	마스터 노드 스펙 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`masterNodeStorageSize`	Integer	Conditional	마스터 노드 블록스토리지 크기(GB) `actionType`이 `CREATE`인 경우, 필수 입력 100~2000 10GB 단위로 설정 4000GB, 6000GB도 사용 가능
`workerNodeSpecCode`	String	Conditional	워커 노드 스펙 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`workerNodeStorageSize`	Integer	Conditional	워커 노드 블록스토리지 크기(GB) `actionType`이 `CREATE`인 경우, 필수 입력 100~2000 10GB 단위로 설정 4000GB, 6000GB도 사용 가능
`workerNodeCount`	Integer	Conditional	워커 노드 개수 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`userPassword`	String	Conditional	Hadoop 클러스터 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

`tensorFlowCpuServerList`

tensorFlowCpuServerList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`serverInstanceNo`	String	Conditional	Tensorflow CPU 서버 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`blockStorageInstanceNo`	String	Conditional	Tensorflow CPU 서버 블록 스토리지 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`specCode`	String	Conditional	Tensorflow CPU 서버 스펙 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`softwareCode`	String	Conditional	Tensorflow CPU 서버 소프트웨어 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`storageSize`	Integer	Conditional	Tensorflow CPU 서버 블록 스토리지 크기(GB) `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 100~2000 10GB 단위로 설정
`userPassword`	String	Conditional	Tensorflow CPU 서버 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

`tensorFlowGpuServerList`

tensorFlowGpuServerList에 대한 설명은 다음과 같습니다.

필드	타입	필수 여부	설명
`actionType`	String	Required	처리 유형 `CREATE` \| `UPDATE` \| `DELETE` `CREATE`: 생성 `UPDATE`: 수정 `DELETE`: 반납
`serverInstanceNo`	String	Conditional	Tensorflow GPU 서버 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`blockStorageInstanceNo`	String	Conditional	Tensorflow GPU 서버 블록 스토리지 인스턴스 번호 get-box-infra-list 참조 `actionType`이 `UPDATE` 또는 `DELETE`인 경우, 필수 입력
`specCode`	String	Conditional	Tensorflow GPU 서버 스펙 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`softwareCode`	String	Conditional	Tensorflow GPU 서버 소프트웨어 코드 get-product-spec 참조 `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력
`storageSize`	Integer	Conditional	Tensorflow GPU 서버 블록 스토리지 크기(GB) `actionType`이 `CREATE` 또는 `UPDATE`인 경우, 필수 입력 100~2000 10GB 단위로 설정
`userPassword`	String	Conditional	Tensorflow GPU 서버 계정 비밀번호 영문 대문자, 소문자, 숫자, 특수 문자를 각각 1자 이상 조합하여 8~14자 이내로 입력 사용 불가 특수 문자: ', ", `, ₩, /, &, $, 공백

요청 예시

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

curl --location --request POST 'https://datafence.apigw.ntruss.com/api/v1/box/change-box-infra' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--data '{
  "fenceId": 1,
  "boxId": 1,
  "connectServerList": [
    {
      "actionType": "UPDATE",
      "serverInstanceNo": *********,
      "specCode": "SVR.VSVR.STAND.C004.M016.NET.SSD.B100.G002",
      "storageSize": 500
    }
  ],
  "hadoopList": [
      {
        "actionType": "UPDATE",
        "hadoopClusterNo": *********,
        "edgeNodeSpecCode": "SVR.VCHDP.EDGND.HICPU.C008.M016.NET.HDD.B050.G002",      // 변경할 스펙 코드 입력
        "masterNodeSpecCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",    // 기존 스펙 코드 입력
        "dataNodeSpecCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002",      // 기존 스펙 코드 입력
        "dataNodeCount": 2                                                            // 기존 개수 입력
      }
    ]
}'

응답

응답 형식을 설명합니다.

응답 바디

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

필드	타입	필수 여부	설명
`message`	String	-	API 처리 결과 메시지

응답 상태 코드

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

응답 예시

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

{
  "message": "Box modification requested."
}