PostAccount
    • PDF

    PostAccount

    • PDF

    기사 요약

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

    어카운트에 메타데이터를 설정하거나 변경합니다.

    요청

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

    메서드URI
    POST/v1/AUTH_{project_id}

    요청 헤더

    헤더를 소개합니다.

    필드타입필수 여부설명
    X-Auth-TokenStringRequired발급한 토큰(Token) 값
    X-Account-Meta-Temp-URL-KeyStringOptionaltemporary URL을 위한 Secret Key 값
    X-Account-Meta-Temp-URL-Key-2StringOptionaltemporary URL을 위한 두 번째 Secret Key 값
    X-Account-Meta-nameStringOptional어카운트의 메타데이터 설정
    • 헤더명의 name 부분이 메타데이터의 키 역할을 함
    X-Remove-Account-nameStringOptional어카운트의 메타데이터 삭제
    • 헤더명의 name 부분이 메타데이터의 키 역할을 함
    참고

    메타데이터 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_idStringRequired프로젝트 ID

    요청 예시

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

    메타데이터 생성 요청

    메타데이터를 생성하는 요청 예시는 다음과 같습니다.

    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
    

    이 문서가 도움이 되었습니까?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.