--- title: "PostAccount " slug: "storage-archivestorage-postaccount" tags: ["Archive Storage"] updated: 2026-10-22T10:47:58Z published: 2026-10-22T10:47:58Z canonical: "api-gov.ncloud-docs.com/storage-archivestorage-postaccount" --- > ## Documentation Index > Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # PostAccount 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 | 어카운트의 메타데이터 설정 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 | | `X-Remove-Account-name` | String | Optional | 어카운트의 메타데이터 삭제 - 헤더명의 `name` 부분이 메타데이터의 키 역할을 함 | 참고 메타데이터 `X-Account-Meta-name` 헤더에 빈값을 입력해 삭제를 요청할 수 있지만, 헤더에 빈값 입력을 허용하지 않는 툴이 있을 수 있습니다. 이러한 경우 `X-Remove-Account-Meta-name`으로 요청해 주십시오. 요청 헤더 설정 값에 따른 요청 결과는 다음과 같습니다. | 요청 헤더 | 결과 | | --- | --- | | 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키는 이미 존재하는 경우 | API는 해당 메타데이터 아이템 삭제 | | 요청 헤더에 어카운트 메타데이터의 값이 없고 키만 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 키 무시 | | 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 이미 존재하는 경우 | API는 해당 메타데이터 업데이트 | | 요청 헤더에 어카운트 메타데이터의 키와 값이 모두 존재하며, 어카운트에 키가 존재하지 않는 경우 | API는 해당 메타데이터 추가 | | 요청 헤더에 어카운트 메타데이터들이 생략되어 있고, 어카운트에는 이미 메타데이터들이 존재하는 경우 | API는 이미 존재하는 메타데이터 변경하지 않음 | 참고 - 메타데이터 키는 대소문자를 구분하지 않으며, ASCII 7-bit 문자들로 구성이 가능합니다. 단, ASCII 0-31 문자, DEL 문자 등은 제외합니다. - 메타데이터 값은 UTF-8로 인코딩한 다음 URL 인코딩해야 합니다. 이는 HTTP/1.1 기본 룰입니다. ### 요청 경로 파라미터 요청 경로 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `project_id` | String | Required | 프로젝트 ID - 프로젝트 ID 확인 방법은 [Archive Storage 개요](/docs/storage-archivestorage#%EC%9D%B8%EC%A6%9D) 참조 | ### 요청 예시 요청 예시는 다음과 같습니다. #### 메타데이터 생성 요청 메타데이터를 생성하는 요청 예시는 다음과 같습니다. ``` 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 공통 응답 헤더](/docs/storage-archivestorage#%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. #### 메타데이터 생성을 요청한 경우의 응답 메타데이터 생성을 요청했을 때의 응답 예시는 다음과 같습니다. ``` 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 ```