Classic/VPC 환경에서 이용 가능합니다.
어카운트에 메타데이터를 설정하거나 변경합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|---|
| POST | /v1/AUTH_{project_id} |
요청 헤더
요청 헤더에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
X-Auth-Token |
String | Required | 발급한 토큰(Token) 값 |
X-Account-Meta-Temp-URL-Key |
String | Optional | temporary URL을 위한 Secret Key 값 |
X-Account-Meta-Temp-URL-Key-2 |
String | Optional | temporary URL을 위한 두 번째 Secret Key 값 |
X-Account-Meta-name |
String | Optional | 어카운트의 메타데이터 설정
|
X-Remove-Account-name |
String | Optional | 어카운트의 메타데이터 삭제
|
참고
X-Account-Meta-name헤더에 빈 값을 입력하면 해당 메타데이터를 삭제합니다.- 빈 값 헤더를 보내지 못하는 도구에서는
X-Remove-Account-Meta-name헤더로 삭제해 주십시오.
요청 헤더 설정 값에 따른 요청 결과는 다음과 같습니다.
| 요청 헤더 | 결과 |
|---|---|
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키는 이미 존재하는 경우 | API는 해당 메타데이터 아이템 삭제 |
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 키 무시 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 이미 존재하는 경우 | API는 해당 메타데이터 업데이트 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 추가 |
| 요청 헤더에 어카운트 메타데이터들이 생략되어 있고, 어카운트에는 이미 메타데이터들이 존재하는 경우 | API는 이미 존재하는 메타데이터 변경하지 않음 |
참고
- 메타데이터 키는 대소문자를 구분하지 않으며, ASCII 7비트 문자로 구성합니다. ASCII 0~31 문자와 DEL 문자는 쓸 수 없습니다.
- 밑줄(_)은 하이픈(-)으로 바뀝니다.
- 자세한 내용은 HTTP/1.1을 참조해 주십시오.
- 메타데이터 값은 UTF-8로 인코딩한 뒤 URL 인코딩해서 입력합니다. 이는 HTTP/1.1 기본 룰입니다.
요청 경로 파라미터
요청 경로 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
project_id |
String | Required | 프로젝트 ID
|
bulk-delete |
String | Optional | 여러 오브젝트 및 빈 컨테이너를 한 번에 삭제
|
요청 예시
요청 예시는 다음과 같습니다.
메타데이터 생성 요청
메타데이터를 생성하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
-H "X-Account-Meta-{name}: $account-metadata-string"
메타데이터 수정 요청
메타데이터를 수정하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
-H "X-Account-Meta-{name}: $account-metadata-string"
메타데이터 삭제 요청
메타데이터를 삭제하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}"
-H "X-Auth-Token: $token"
-H "X-Remove-Account-Meta-{name}: $account-metadata-string"
응답
응답 형식을 설명합니다.
응답 헤더
Archive Storage API에서 공통으로 사용하는 응답 헤더에 대한 자세한 내용은 Archive Storage 공통 응답 헤더를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
메타데이터 생성을 요청한 경우의 응답
메타데이터 생성을 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 204 No Content
Content-Type: text/html; charset=UTF-8
Content-Length: 0
X-Trans-Id: txad3702ae436640d1a9897-005b975c51
X-Openstack-Request-Id: txad3702ae436640d1a9897-005b975c51
Date: Tue, 11 Sep 2018 06:10:25 GMT
메타데이터 수정을 요청한 경우의 응답
메타데이터 수정을 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txc5a65e1d20074023912c6-005b975c97
X-Openstack-Request-Id: txc5a65e1d20074023912c6-005b975c97
Date: Tue, 11 Sep 2018 06:11:35 GMT
메타데이터 삭제를 요청한 경우의 응답
메타데이터 삭제를 요청했을 때의 응답 예시는 다음과 같습니다.
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txf2874df785bd470eaf3b8-005b975d40
X-Openstack-Request-Id: txf2874df785bd470eaf3b8-005b975d40
Date: Tue, 11 Sep 2018 06:14:24 GMT