PostAccount
    • PDF

    PostAccount

    • PDF

    기사 요약

    개요

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

    구문

    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_idpathstring프로젝트 ID 입력
    X-Auth-Token (Optional)headerstring발급한 Token 값 입력
    X-Account-Meta-Temp-URL-Key (Optional)headerstringtemporary URL을 위한 Secret Key 값 입력
    X-Account-Meta-Temp-URL-Key-2 (Optional)headerstringtemporary URL을 위한 두번째 Secret Key 값 입력
    X-Account-Meta-name (Optional)headerstring어카운트의 메타데이터 설정
    헤더명의 name 부분이 메타데이터의 키 역할을 함
    X-Remove-Account-name (Optional)headerstring어카운트의 메타데이터 삭제
    헤더명의 name 부분이 메타데이터의 키 역할을 함

    응답

    명칭In타입설명
    Dateheaderstring해당 요청의 응답 시간 (UTC)
    Content-Lengthheaderstring응답 결과의 길이 (해당 요청은 Response Body의 내용이 없으므로, 요청 성공 시 0)
    Content-Type (Optional)headerstring응답 결과의 MIME 타입
    X-Trans-Idheaderstring해당 요청의 트랜젝션 ID
    X-Openstack-Request-Idheaderstring해당 요청의 트랜젝션 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) 상태 코드를 응답합니다.


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

    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.