개요
어카운트에 메타데이터를 설정 및 변경합니다.
구문
POST /v1/AUTH_{project_id}
메타데이터 헤더에 빈값을 입력하면 삭제 요청을 할 수 있지만, 헤더에 빈값 입력을 허용하지 않는 툴이 있을 수 있습니다.
이러한 경우 X-Account-Meta-name으로 빈값을 요청하는 대신, X-Remove-Account-Meta-name으로 요청하면 됩니다.
| 요청 헤더 | 결과 |
|---|---|
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키는 이미 존재하는 경우 | API는 해당 메타데이터 아이템 삭제 |
| 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키가 존재 하지 않는 경우 | API는 해당 메타데이터 키를 무시함 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 이미 존재하는 경우 | API는 해당 메타데이터를 업데이트함 |
| 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 존재 하지 않는 경우 | API는 해당 메타데이터 추가 |
| 요청 헤더에 어카운트 메타데이터들이 생략되어 있고, 어카운트에는 이미 메타데이터들이 존재하는 경우 | API는 이미 존재하는 메타데이터를 변경하지 않음 |
메타데이터 키는 대소문자를 구분하지 않으며, ASCII 7-bit 문자들로 구성이 가능합니다. (ASCII 0-31 문자, DEL 문자 등 제외) underscore 문자(_)는 hyphen 문자(-)로 변환됩니다.
자세한 내용은 해당 문서 참조 : HTTP/1.1
메타데이터 값은 UTF-8로 인코딩 한 다음 URL 인코딩 해야 합니다. 이는 HTTP/1.1 기본 룰입니다.
요청
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| project_id | path | string | 프로젝트 ID 입력 |
| X-Auth-Token (Optional) | header | string | 발급한 Token 값 입력 |
| X-Account-Meta-Temp-URL-Key (Optional) | header | string | temporary URL을 위한 Secret Key 값 입력 |
| X-Account-Meta-Temp-URL-Key-2 (Optional) | header | string | temporary URL을 위한 두번째 Secret Key 값 입력 |
X-Account-Meta-name (Optional) |
header | string | 어카운트의 메타데이터 설정 헤더명의 name 부분이 메타데이터의 키 역할을 함 |
X-Remove-Account-name (Optional) |
header | string | 어카운트의 메타데이터 삭제 헤더명의 name 부분이 메타데이터의 키 역할을 함 |
응답
| 명칭 | In | 타입 | 설명 |
|---|---|---|---|
| Date | header | string | 해당 요청의 응답 시간 (UTC) |
| Content-Length | header | string | 응답 결과의 길이 (해당 요청은 Response Body의 내용이 없으므로, 요청 성공 시 0) |
| Content-Type (Optional) | header | string | 응답 결과의 MIME 타입 |
| X-Trans-Id | header | string | 해당 요청의 트랜젝션 ID |
| X-Openstack-Request-Id | header | string | 해당 요청의 트랜젝션 ID (X-Trans-Id와 동일) |
예시
요청 예시(메타데이터 생성)
curl -i -X POST -H "X-Auth-Token: $token" -H "X-Account-Meta-Book: ncloud-test-book" -H "X-Account-Meta-Subject: ncloud-test-subject" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
응답 예시
HTTP/1.1 204 No Content
Content-Length: 0
Content-Type: text/html; charset=UTF-8
X-Trans-Id: txad3702ae436640d1a9897-005b975c51
X-Openstack-Request-Id: txad3702ae436640d1a9897-005b975c51
Date: Tue, 11 Sep 2018 06:10:25 GMT
요청 예시(메타데이터 수정)
curl -i -X POST -H "X-Auth-Token: $token" -H "X-Account-Meta-Subject: ncloud-test-sconedSubject" https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}
응답 예시
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
요청 예시(메타데이터 삭제)
curl -i -X POST -H "X-Auth-Token: $token" -H "X-Remove-Account-Meta-Subject: x" https://kr.archive.gov-ncloudstorage.com/v1/AUTH_{project_id}
응답 예시
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
요청이 성공하게 되면 No Content (204) 상태 코드를 응답합니다.