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-bit 문자들로 구성이 가능합니다. 단, ASCII 0-31 문자, DEL 문자 등은 제외합니다.
- 언더스코어 문자(_)는 하이픈 문자(-)로 변환됩니다.
- 자세한 내용은 [HTTP/1.1](https://www.w3.org/Protocols/rfc2616/rfc2616.html){target="_blank"}를 참조해 주십시오.
- 메타데이터 값은 UTF-8로 인코딩한 다음 URL 인코딩해야 합니다. 이는 HTTP/1.1 기본 룰입니다.
요청 경로 파라미터
요청 경로 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
project_id |
String | Required | 프로젝트 ID
|
요청 예시
요청 예시는 다음과 같습니다.
메타데이터 생성 요청
메타데이터를 생성하는 요청 예시는 다음과 같습니다.
curl -X POST "https://kr.archive.gov-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.gov-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.gov-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