post

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

어카운트, 컨테이너(버킷) 또는 오브젝트의 메타데이터를 변경합니다. 컨테이너가 존재하지 않는 경우, 자동으로 생성됩니다.

구문

post 구문은 다음과 같습니다.

어카운트

swift post \
    [--meta <name:value>] \
    [--header <header:value>]

컨테이너

swift post \
    <container> \
    [--read-acl <acl>] \
    [--write-acl <acl>] \
    [--meta <name:value>] \
    [--header <header:value>]

오브젝트

swift post \
    <container> <object> \
    [--meta <name:value>] \
    [--header <header:value>]

post 실행 시 지정할 수 있는 옵션을 설명합니다.

post의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`<container>`	String	Conditional	컨테이너 이름 미입력 시 어카운트의 메타데이터 변경 존재하지 않는 컨테이너를 입력하면 자동 생성 `<object>` 입력 시 필수 입력

post의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션	타입	필수 여부	설명
`<object>`	String	Optional	오브젝트 이름 `<container>`와 함께 입력
`--read-acl`	String	Optional	컨테이너의 읽기 ACL 예시: `.r:`, `.r:-.example.com`, `.r:www.example.com`, `account1:`, `account2:user2` 콜론(:) 없이 계정명만 단독 입력하는 `account1` 형식은 v1.0 인증 API에서만 사용 가능 전체 ACL 구문은 OpenStack Swift CLI 문서 참조
`--write-acl`	String	Optional	컨테이너의 쓰기 ACL 예시: `account1:*`, `account2:user2` 콜론(:) 없이 계정명만 단독 입력하는 `account1` 형식은 v1.0 인증 API에서만 사용 가능 전체 ACL 구문은 OpenStack Swift CLI 문서 참조
`--meta`	String	Optional	메타데이터 항목 `name:value` 형식으로 입력 다중 메타데이터 설정 가능 (예시: `--meta name1:value1 --meta name2:value2`)
`--header`	String	Optional	요청에 사용할 표준 HTTP 헤더 및 사용자 정의 메타데이터 표준 HTTP 헤더의 경우 `header:value` 형식으로 입력 사용자 정의 메타데이터의 경우 `X-Object-Meta-{header}:value` 형식으로 입력 반복 입력 가능 (예시: `--header Content-Type:text/plain --header X-Object-Meta-header:value`)

swift 명령에서 공통으로 사용하는 옵션에 대한 정보는 Archive Storage 옵션을 참조해 주십시오.

post 명령으로 컨테이너를 생성하거나 메타데이터를 설정하는 예시입니다.

컨테이너를 생성하는 명령 예시는 다음과 같습니다.

swift post test-container-01

컨테이너에 메타데이터를 설정하는 명령 예시는 다음과 같습니다.

swift post test-container-01 --meta Purpose:Documentation

요청이 성공하면 출력되는 내용이 없습니다. 변경된 메타데이터는 stat으로 확인할 수 있습니다.