IAM 인증

IAM 인증을 사용하는 경우, 일부 명령어를 사용하려면 클라이언트에 인스턴스 ID를 설정해야 합니다. 서비스 인스턴스 만들기에 대한 자세한 내용은 서비스 인스턴스 만들기를 참조하세요. 인스턴스 ID를 확인하려면 ibmcloud resource service-instance <INSTANCE_NAME> --id 을 입력하고, <INSTANCE_NAME> 을 서비스 인스턴스에 할당한 고유한 별칭으로 대체하면 됩니다. 다음 예시에서 ‘ 8f275e7b-c076-49e2-b9c5-f985704cf678 ’ 값은 예시 인스턴스 ID입니다.

먼저 인스턴스의 이름으로 CRN및 ID를 검색하십시오. 인스턴스 이름에 따옴표 (') 를 사용하고 IBM Cloud에 로그인했는지 확인하십시오. CRN의 마지막 부분 ( :: 뒤에 있는 부분) 만 필요합니다.

$ ibmcloud resource service-instance 'My Awesome Cloud Object Storage'  --id
Retrieving service instance My Awesome Cloud Object Storage in all resource groups under account IBM as ibmuser@us.ibm.com...
crn:v1:bluemix:public:cloud-object-storage:global:a/94400e98c553415c9599db39b9be9219:3b7d66c8-9fdf-4f81-b7e6-08d187f07288:: 8f275e7b-c076-49e2-b9c5-f985704cf678

ibmcloud cos config crn 명령으로 CRN을 설정하십시오. 겹쳐쓰기에 대해 경고할 수 있습니다. CRN을 대화식으로 제공하지 않으려면 --crn 플래그를 사용하여 동일한 명령에서 이를 제공할 수 있습니다.

$ ibmcloud cos config crn
Resource Instance ID CRN:  ()> 8f275e7b-c076-49e2-b9c5-f985704cf678
Saving new Service Instance ID...
OK
Successfully stored your service instance ID.

구성을 검증하십시오.

$ ibmcloud cos config crn --list
Key   Value
CRN   8f275e7b-c076-49e2-b9c5-f985704cf678

또는 웹 기반 콘솔을 열고 사이드바에서 서비스 인증 정보를 선택하고 새 인증 정보 세트를 작성할 수 있습니다(또는 이미 작성한 기존 인증 정보 파일 보기).

HMAC 인증 정보

선호하는 경우 서비스 ID의 HMAC 인증 정보를 API 키 대신 사용할 수 있습니다. ibmcloud cos config hmac를 실행하여 HMAC 인증 정보를 입력한 다음, ibmcloud cos config auth를 사용하여 인증 방법을 전환하십시오.

고유 API 키를 사용하여 토큰 인증을 사용하도록 선택한 경우 프로그램이 자동으로 사용자를 인증하므로 인증 정보를 제공하지 않아도 됩니다.

언제든지 HMAC및 IAM 인증 간에 전환하기 위해 ibmcloud cos config auth 를 입력할 수 있습니다. IBM Cloud의 인증 및 권한 부여에 대한 자세한 정보는 Identity and Access Management 문서 를 참조하십시오.

다음 방법을 사용하여 개체를 다운로드합니다. Aspera

• 작업: Aspera 고속 전송 기능을 사용하여 버킷에서 객체를 다운로드합니다.
• 사용법: ibmcloud cos aspera-download --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [OUTFILE]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 다운로드할 객체의 KEY입니다.
    • 플래그: --key KEY
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • 선택 사항 : 다운로드한 파일이 저장된 로컬 경로. 별도로 지정하지 않으면, 파일은 기본 다운로드 위치에 객체 키의 파일 이름으로 저장됩니다.
    • 인수: OUTFILE

예:

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-download --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

다음 방법을 사용하여 파일이나 디렉터리를 업로드합니다. Aspera

• 작업: Aspera 의 고속 전송 기능을 사용하여 파일이나 디렉터리를 버킷에 업로드합니다.
• 사용법: ibmcloud cos aspera-upload --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [SRCFILE]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 버킷 내의 KEY(대상 객체 이름).
    • 플래그: --key KEY
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • 선택 사항 : 업로드할 파일 또는 디렉터리의 로컬 경로.
    • 인수: SRCFILE

예:

export IBMCLOUD_API_KEY=<your-api-key>
ibmcloud cos aspera-upload --bucket my-bucket --key videos/demo.mp4 /tmp/demo.mp4

버킷에 대한 수명 주기 구성 설정

• 작업: 버킷에 라이프사이클 구성을 설정합니다.
• 사용법: ibmcloud cos bucket-lifecycle-configuration-put --bucket BUCKET_NAME --lifecycle-configuration STRUCTURE [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • JSON 구문을 사용하는 구조. file:// 접두사를 사용하면 --lifecycle-configuration file://<filename.json> 와 같은 파일에서 JSON 구조를 불러올 수 있습니다.

    • 플래그: --lifecycle-configuration STRUCTURE

      	{
      	  "Rules": [
      	    {
      	      "ID": "string",
      	      "Status": "Enabled"|"Disabled",
      	      "Filter": {
      	        "Prefix": "string"
      	      },
      	      "Expiration": {
      	        "Days": integer,
      	        "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	        "ExpiredObjectDeleteMarker": true|false
      	      },
      	      "Transitions": [
      	        {
      	          "Days": integer,
      	          "Date": "YYYY-MM-DDTHH:mm:ssZ",
      	          "StorageClass": "string"
      	        }
      	      ],
      	      "NoncurrentVersionExpiration": {
      	        "NoncurrentDays": integer
      	      },
      	      "AbortIncompleteMultipartUpload": {
      	        "DaysAfterInitiation": integer
      	      }
      	    }
      	  ]
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.

    • 플래그: --region REGION

  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.

    • 플래그: --output FORMAT

예시 — 파일을 사용하는 경우:

ibmcloud cos bucket-lifecycle-configuration-put --bucket my-bucket --lifecycle-configuration file://lifecycle.json

예시 — 인라인:

ibmcloud cos bucket-lifecycle-configuration-put \
  --bucket my-bucket \
  --lifecycle-configuration '{
    "Rules": [
      {
        "ID": "expire-noncurrent-versions",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "NoncurrentVersionExpiration": {
          "NoncurrentDays": 30
        }
      },
      {
        "ID": "clean-delete-markers",
        "Status": "Enabled",
        "Filter": { "Prefix": "" },
        "Expiration": {
          "ExpiredObjectDeleteMarker": true
        }
      }
    ]
  }' \
  --region us-south

버킷의 수명 주기 구성 가져오기

• 작업: 버킷의 라이프사이클 구성을 가져옵니다.
• 사용법: ibmcloud cos bucket-lifecycle-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-lifecycle-configuration-get --bucket my-bucket

버킷에서 수명 주기 구성 삭제

• 작업: 버킷에서 라이프사이클 구성을 삭제합니다.
• 사용법: ibmcloud cos bucket-lifecycle-configuration-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-lifecycle-configuration-delete --bucket my-bucket

버킷 복제 넣기

• 작업: 버킷에 대한 복제 구성을 설정합니다.
• 사용법: ibmcloud cos bucket-replication-put --bucket BUCKET_NAME --replication-configuration STRUCTURE [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • JSON 구문을 사용하는 구조.

    • 플래그: --replication-configuration STRUCTURE

      	{
      		"Rules": [
      			{
      				"Status": "Enabled",
      				"Priority": 1,
      				"Filter" : { "Prefix": ""},
      				"DeleteMarkerReplication": {
      					"Status": "Disabled"
      				},
      				"Destination": {
      					"Bucket": "DEST-BUCKET-CRN"
      				}
      			}
      		]
      	}
      

예시 — 파일을 사용하는 경우:

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME --replication-configuration file://replication.json

예시 — 인라인:

ibmcloud cos bucket-replication-put --bucket SOURCE-BUCKET-NAME \
  --replication-configuration '{
    "Rules": [
      {
        "Status": "Enabled",
        "Priority": 1,
        "Filter": {},
        "DeleteMarkerReplication": { "Status": "Disabled" },
        "Destination": { "Bucket": "DEST-BUCKET-CRN" }
      }
    ]
  }' \
  --region us-south

버킷 복제 가져오기

• 작업: 버킷의 복제 구성을 가져옵니다.
• 사용법: ibmcloud cos bucket-replication-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-replication-get --bucket SOURCE-BUCKET-NAME

버킷 복제 삭제

• 작업: 버킷에서 복제 구성을 삭제합니다.
• 사용법: ibmcloud cos bucket-replication-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-replication-delete --bucket SOURCE-BUCKET-NAME

버킷의 리플리케이션 실패 내역 나열

• 작업: 버킷의 복제 실패 내역을 나열합니다.
• 사용법: ibmcloud cos bucket-replication-failures --bucket BUCKET_NAME [--starting-token TOKEN] [--encoding-type METHOD] [--first-sync-attempted-before TIMESTAMP] [--max-keys NUMBER] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 결과의 다음 페이지를 어디서부터 시작할지 지정하는 데 사용되는 TOKEN입니다.
    • 플래그: --starting-token TOKEN
  • 선택 사항 : 응답에 포함된 객체 키를 인코딩하도록 요청하며, 사용할 인코딩 방법을 지정합니다.
    • 플래그: --encoding-type METHOD
  • 선택 사항 : 지정된 TIMESTAMP(ISO 8601 형식) 이전에 첫 번째 동기화가 시도된 실패 사례만 포함하도록 결과를 필터링합니다.
    • 플래그: --first-sync-attempted-before TIMESTAMP
  • 선택 사항 : 반환할 키의 최대 개수.
    • 플래그: --max-keys NUMBER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-replication-failures --bucket my-bucket

버킷 내 실패한 객체에 대해 복제를 다시 시도합니다

• 조치: 버킷 내 실패한 개체에 대해 복제를 다시 시도합니다.
• 사용법: ibmcloud cos bucket-replication-reattempt --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-replication-reattempt --bucket my-bucket

버킷에 버전화 구성 설정

• 작업: 버킷에 버전 관리 구성을 설정합니다.
• 사용법: ibmcloud cos bucket-versioning-put --bucket BUCKET_NAME --versioning-configuration STRUCTURE [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • 버전 관리 상태를 지정하는 JSON 구문을 사용하는 구조체. Status 의 유효한 값은 Enabled 및 Suspended 입니다.

    • 플래그: --versioning-configuration STRUCTURE

      	{
      	  "Status": "Enabled"|"Suspended"
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.

    • 플래그: --region REGION

  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.

    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-versioning-put --bucket my-bucket --versioning-configuration '{"Status": "Enabled"}'

버킷에 대한 버전화 구성 가져오기

• 작업: 버킷의 버전 관리 구성을 가져옵니다.
• 사용법: ibmcloud cos bucket-versioning-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos bucket-versioning-get --bucket my-bucket

다음을 사용하여 새 버킷을 만듭니다. Key Protect

• 작업: IBM Cloud Object Storage 인스턴스 내에서 Key Protect 를 사용하여 버킷을 생성합니다.
• 사용법: ibmcloud cos bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
  • IAM 인증을 사용하는 경우 CRN을 제공해야 합니다. 이는 ibmcloud cos config crn 명령을 사용하여 설정할 수 있습니다.
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 데이터 암호화를 위해 버킷에 연결할 KMS 루트 키의 CUSTOMERROOTKEYCRN.
    • 플래그: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • 선택 사항 : 키 보호 기능을 통해 저장된 암호화 키와 함께 사용할 ALGORITHM 및 SIZE.
    • 플래그: --kms-encryption-algorithm ALGORITHM
  • 선택사항: 클래스의 이름입니다.
    • 플래그: --class CLASS_NAME
  • 선택 사항 : 요청에 ‘ IBM ’ 서비스 인스턴스 ID를 설정합니다.
    • 플래그: --ibm-service-instance-id ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • (사용 중단): 결과가 원시 JSON 형식으로 반환됩니다.
    • 플래그: --json

예:

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:staging:public:kms:us-south:a/9978e0xxxxxxxxxxxxxxxxxxxxxx8654:dfdxxxxx-xxxx-xxxx-xxxx-xxxxxxba6eb0:key:7cea005e-75d4-4a08-ad2f-5e56141f6a96 --kms-encryption-algorithm AES256

Hyper Protect Crypto Services 를 사용하여 새 버킷 작성

• 조치: Hyper Protect Crypto Services를 사용하여 새 버킷을 작성하십시오.
• 사용법: ibmcloud cos bucket-create --bucket BUCKET_NAME [--ibm-service-instance-id ID] [--class CLASS_NAME] [--region REGION] --kms-root-key-crn CUSTOMERROOTKEYCRN --kms-encryption-algorithm ALGORITHM [--output FORMAT] [--json]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 데이터 암호화를 위해 버킷에 연결할 KMS 루트 키의 CUSTOMERROOTKEYCRN.
    • 플래그: --kms-root-key-crn CUSTOMERROOTKEYCRN
  • 선택 사항 : 키 보호 기능을 통해 저장된 암호화 키와 함께 사용할 ALGORITHM 및 SIZE.
    • 플래그: --kms-encryption-algorithm ALGORITHM
  • 선택사항: 클래스의 이름입니다.
    • 플래그: --class CLASS_NAME
  • 선택 사항 : 요청에 ‘ IBM ’ 서비스 인스턴스 ID를 설정합니다.
    • 플래그: --ibm-service-instance-id ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • (사용 중단): 결과가 원시 JSON 형식으로 반환됩니다.
    • 플래그: --json

예:

ibmcloud cos bucket-create --bucket bucket-name --kms-root-key-crn crn:v1:bluemix:public:hs-crypto:us-south:a/ee747e4xxxxxxxxxxxxxxxxxxxxxx7559:ac6xxxxx-xxxx-xxxx-xxxx-xxxxxx1bea99:key:e7451f36-d7ea-4f55-bc1c-ce4bcceb7018

다음 방법을 사용하여 개체를 다운로드합니다. S3Manager

• 조치: S3에서 동시에 오브젝트를 다운로드합니다.
• 사용법: ibmcloud cos download --bucket BUCKET_NAME --key KEY [--concurrency value] [--part-size SIZE] [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--response-cache-control HEADER] [--response-content-disposition HEADER] [--response-content-encoding HEADER] [--response-content-language HEADER] [--response-content-type HEADER] [--response-expires HEADER] [--region REGION] [--output FORMAT] [OUTFILE]
• 제공할 매개변수:
  • 버킷의 이름(BUCKET_NAME)입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 파트를 전송할 때 다운로드 호출당 병렬로 실행할 go 루틴의 수. 기본값은 5입니다.
    • 플래그: --concurrency value
  • 선택 사항 : 데이터를 청크 단위로 버퍼링하여 S3 에 파트로 전송할 때 사용할 버퍼 크기(바이트 단위). 허용되는 최소 파트 크기는 5MB입니다.
    • 플래그: --part-size SIZE
  • 선택 사항 : 객체의 엔티티 태그(ETag)가 지정된 ETAG 와 동일한 경우에만 해당 객체를 반환하고, 그렇지 않은 경우 412(전제 조건 실패)를 반환합니다.
    • 플래그: --if-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 해당 객체가 수정된 경우에만 객체를 반환하고, 그렇지 않은 경우에는 304(수정되지 않음)를 반환합니다.
    • 플래그: --if-modified-since TIMESTAMP
  • 선택 사항 : 객체의 엔티티 태그(ETag)가 지정된 ETAG 과 다를 경우에만 해당 객체를 반환하고, 그렇지 않으면 304(수정 없음)를 반환합니다.
    • 플래그: --if-none-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 해당 객체가 수정되지 않은 경우에만 객체를 반환하고, 그렇지 않은 경우 412(전제 조건 실패)를 반환합니다.
    • 플래그: --if-unmodified-since TIMESTAMP
  • 선택 사항 : 객체의 지정된 RANGE 바이트를 다운로드합니다. HTTP 범위 헤더에 대한 자세한 내용은 HTTP 의 범위 헤더 사양을 참조하십시오.
    • 플래그: --range RANGE
  • 선택 사항 : 응답의 Cache-Control 헤더를 설정합니다.
    • 플래그: --response-cache-control HEADER
  • 선택 사항 : 응답의 Content-Disposition 헤더를 설정합니다.
    • 플래그: --response-content-disposition HEADER
  • 선택 사항 : 응답의 Content-Encoding 헤더를 설정합니다.
    • 플래그: --response-content-encoding HEADER
  • 선택 사항 : 응답의 Content-Language 헤더를 설정합니다.
    • 플래그: --response-content-language HEADER
  • 선택 사항 : 응답의 Content-Type 헤더를 설정합니다.
    • 플래그: --response-content-type HEADER
  • 선택 사항 : 응답의 Expires 헤더를 설정합니다.
    • 플래그: --response-expires HEADER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • 선택 사항 : 객체의 내용을 저장할 위치. 이 매개변수를 제공하지 않으면 프로그램에서 기본 위치를 사용합니다.
    • 매개변수: OUTFILE

확장된 버킷 나열

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 모든 버킷의 목록을 인쇄합니다. 버킷은 여러 영역에 위치할 수 있습니다.
• 사용법: ibmcloud cos buckets-extended [--ibm-service-instance-id ID] [--marker KEY] [--prefix PREFIX] [--page-size SIZE] [--max-items NUMBER] [--output FORMAT]
  • IAM 인증을 사용하는 경우 CRN을 제공해야 합니다. 이는 ibmcloud cos config crn 명령을 사용하여 설정할 수 있습니다.
• 제공할 매개변수:
  • 제공할 매개변수가 없습니다.
  • 선택 사항 : 요청에 ‘ IBM ’ 서비스 인스턴스 ID를 설정합니다.
    • 플래그: --ibm-service-instance-id
  • 선택 사항 : 버킷 내의 객체를 나열할 때 시작할 KEY를 지정합니다.
    • 플래그: --marker KEY
  • 선택 사항 : 응답을 지정된 PREFIX로 시작하는 키로만 제한합니다.
    • 플래그: --prefix PREFIX
  • 선택 사항 : 서비스 호출에서 가져올 각 페이지의 SIZE. 이는 명령의 출력에 리턴된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 더 작게 설정하면 서비스에 대한 호출이 많아져 각 호출에서 더 적은 수의 항목을 검색하게 됩니다. 이는 서비스 호출 시간이 초과하는 것을 방지할 수 있습니다
    • 플래그: --page-size SIZE
  • 선택 사항 : 명령어 출력에 표시할 항목의 총 개수.
    • 플래그: --max-items NUMBER
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

파트 업로드

• 조치: 기존 다중 파트 업로드 인스턴스에 파일의 파트를 업로드합니다.
• 사용법: ibmcloud cos part-upload --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER [--body FILE_PATH] [--region REGION] [--output FORMAT]
  • 업로드된 각 파일 파트의 번호와 ETag (CLI에서 출력해 줍니다)를 해당 파트별로 JSON 파일에 저장해야 한다는 점에 유의하십시오. 자세한 정보는 "다중 파트 업로드 안내서"를 참조하십시오.
• 제공할 매개변수:
  • 다중 파트 업로드가 수행되는 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 다중 파트 업로드를 식별하는 업로드 ID입니다.
    • 플래그: --upload-id ID
  • 업로드하는 파트의 파트 번호입니다. 이는 1에서 10,000 사이의 양의 정수입니다. (기본값: 1)
    • 플래그: --part-number NUMBER
  • 선택 사항 : 객체 데이터 위치 (FILE_PATH).
    • 플래그: --body FILE_PATH
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

파트 사본 업로드

• 조치: 기존 오브젝트에서 데이터를 복사하여 파트를 업로드합니다.
• 사용법: ibmcloud cos part-upload-copy --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER --copy-source SOURCE [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--copy-source-range value] [--region REGION] [--output FORMAT]
  • 업로드된 각 파일 파트의 번호와 ETag (CLI에서 출력해 줍니다)를 해당 파트별로 JSON 파일에 저장해야 한다는 점에 유의하십시오. 자세한 정보는 "다중 파트 업로드 안내서"를 참조하십시오.
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 다중 파트 업로드를 식별하는 업로드 ID입니다.
    • 플래그: --upload-id ID
  • 업로드하는 파트의 파트 번호입니다. 이는 1 - 10,000의 양의 정수입니다.
    • 플래그: --part-number PART_NUMBER
  • (SOURCE) 소스 버킷 이름과 소스 객체의 키 이름으로, 슬래시(/)로 구분됩니다. 반드시 URL 인코딩되어야 합니다.
    • 플래그: --copy-source SOURCE
  • 선택 사항 : 객체의 엔티티 태그(Etag)가 지정된 태그(ETAG)와 일치할 경우, 해당 객체를 복사합니다.
    • 플래그: --copy-source-if-match ETAG
  • 선택 사항 : 지정된 시간(TIMESTAMP) 이후로 개체가 수정된 경우, 해당 개체를 복사합니다.
    • 플래그: --copy-source-if-modified-since TIMESTAMP
  • 선택 사항 : 객체의 엔티티 태그(ETag)가 지정된 태그(ETAG)와 다를 경우, 해당 객체를 복사합니다.
    • 플래그: --copy-source-if-none-match ETAG
  • 선택 사항 : 지정된 시간(TIMESTAMP) 이후로 해당 객체가 수정되지 않은 경우, 객체를 복사합니다.
    • 플래그: --copy-source-if-unmodified-since TIMESTAMP
  • 선택 사항 : 소스 객체에서 복사할 바이트 범위. 범위 값은 bytes=first-last 양식을 사용해야 하며, 이 양식에서 처음과 마지막은 복사할 0 기반 바이트 오프셋입니다. 예를 들어, bytes=0-9는 소스의 처음 10바이트를 복사함을 표시합니다. 소스 오브젝트가 5MB를 초과하는 경우에만 범위를 복사할 수 있습니다.
    • 플래그: --copy-source-range value
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

오브젝트 증거보존 통지 넣기

• 작업: 개체에 법적 보존 조치를 설정합니다.
• 사용법: ibmcloud cos object-legal-hold-put --bucket BUCKET_NAME --key KEY [--legal-hold STRUCTURE] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • JSON 구문을 사용하는 구조. IBM Cloud 문서 를 참조하십시오.

    • 플래그: --legalhold STRUCTURE

      	{
      	   "Status": "ON"|"OFF"
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-legal-hold-put --bucket bucket-name --key file-name.txt --legal-hold '{"Status": "ON"}'

오브젝트 증거보존 통지 가져오기

• 작업: 특정 대상에 대해 법적 보존 조치를 취합니다.
• 사용법: ibmcloud cos object-legal-hold-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-legal-hold-get --bucket bucket-name --key file-name.txt --region us-south

리소스 예:

{
	"LegalHold": {
		"Status": "ON"
	}
}

오브젝트 잠금 넣기 구성

기본적으로 보존 일 및 연도는 동시에 제공할 수 없습니다.

• 작업: 버킷에 대한 객체 잠금 구성을 설정합니다.
• 사용법: ibmcloud cos object-lock-configuration-put --bucket BUCKET_NAME [--object-lock-configuration STRUCTURE] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • JSON 구문을 사용하는 구조. IBM Cloud 문서 를 참조하십시오.

    • 플래그: --object-lock-configuration STRUCTURE

      	{
      	"ObjectLockEnabled": "Enabled",
      	"Rule": {
      		"DefaultRetention": {
      		"Mode": "COMPLIANCE",
      		"Days": integer,
      		"Years": integer
      		}
      	}
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-lock-configuration-put --bucket bucket-name --object-lock-configuration '{ "ObjectLockEnabled": "Enabled", "Rule": { "DefaultRetention": { "Mode": "COMPLIANCE", "Days": 30 }}}'

오브젝트 잠금 구성 가져오기

• 작업: 버킷의 객체 잠금 구성을 가져옵니다.
• 사용법: ibmcloud cos object-lock-configuration-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-lock-configuration-get --bucket bucket-name --region us-south

리소스 예:

{
	"ObjectLockEnabled": "Enabled",
	"Rule": {
		"DefaultRetention": {
			"Mode": "COMPLIANCE",
			"Days": integer,
			"Years": integer
		}
	}
}

오브젝트 보유 넣기

• 작업: 객체에 보존 기간을 설정합니다.
• 사용법: ibmcloud cos object-retention-put --bucket BUCKET_NAME --key KEY [--retention STRUCTURE] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • JSON 구문을 사용하는 구조. IBM Cloud 문서 를 참조하십시오.

    • 플래그: --retention STRUCTURE

      	{
      	  "Mode": "COMPLIANCE",
      	  "RetainUntilDate": timestamp
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-retention-put --bucket bucket-name --key file-name.txt --retention '{ "Mode": "COMPLIANCE", "RetainUntilDate": "2024-02-02T00:00:00"}'

오브젝트 보유 가져오기

• 작업: 객체에 대한 유지 정보를 가져옵니다.
• 사용법: ibmcloud cos object-retention-get --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-retention-get --bucket bucket-name --key file-name.txt --region us-south

리소스 예:

{
	"Retention": {
		"Mode": "COMPLIANCE",
		"RetainUntilDate": "2024-02-02T00:00:00.000Z"
	}
}

오브젝트에 태그 설정

• 작업: 객체에 태그를 지정합니다.
• 사용법: ibmcloud cos object-tagging-put --bucket BUCKET_NAME --key KEY --tagging STRUCTURE [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • 오브젝트의 키입니다.

    • 플래그: --key KEY

  • 태그 집합을 포함하는 JSON 구문을 사용하는 구조체. file:// 접두사를 사용하면 --tagging file://<filename.json> 와 같은 파일에서 JSON 구조를 불러올 수 있습니다.

    • 플래그: --tagging STRUCTURE

      	{
      	  "TagSet": [
      	    {
      	      "Key": "string",
      	      "Value": "string"
      	    }
      	  ]
      	}
      

  • 선택 사항 : 태그를 지정할 객체의 VERSION_ID. 별도로 지정하지 않으면 현재 버전에 태그가 지정됩니다.

    • 플래그: --version-id VERSION_ID

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.

    • 플래그: --region REGION

  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.

    • 플래그: --output FORMAT

예:

ibmcloud cos object-tagging-put --bucket my-bucket --key my-object.txt --tagging '{"TagSet": [{"Key": "env", "Value": "production"}]}'

오브젝트의 태그 가져오기

• 작업: 객체에 대한 태그를 가져옵니다.
• 사용법: ibmcloud cos object-tagging-get --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 태그를 가져올 특정 객체 버전의 VERSION_ID.
    • 플래그: --version-id VERSION_ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-tagging-get --bucket my-bucket --key my-object.txt

오브젝트에서 태그 제거

• 작업: 객체에서 태그를 제거합니다.
• 사용법: ibmcloud cos object-tagging-delete --bucket BUCKET_NAME --key KEY [--version-id VERSION_ID] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 태그를 제거할 특정 객체 버전의 VERSION_ID.
    • 플래그: --version-id VERSION_ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos object-tagging-delete --bucket my-bucket --key my-object.txt

버킷에 공용 액세스 블록 구성 설정

• 작업: 버킷에 대한 공개 액세스 차단 구성을 설정합니다.
• 사용법: ibmcloud cos public-access-block-put --bucket BUCKET_NAME --public-access-block-configuration STRUCTURE [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • JSON 구문을 사용하는 구조. file:// 접두사를 사용하면 --public-access-block-configuration file://<filename.json> 와 같은 파일에서 JSON 구조를 불러올 수 있습니다.

    • 플래그: --public-access-block-configuration STRUCTURE

      	{
      	  "BlockPublicAcls": true|false,
      	  "IgnorePublicAcls": true|false,
      	  "BlockPublicPolicy": true|false,
      	  "RestrictPublicBuckets": true|false
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.

    • 플래그: --region REGION

  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.

    • 플래그: --output FORMAT

예:

ibmcloud cos public-access-block-put --bucket my-bucket --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

버킷에서 공용 액세스 블록 구성 가져오기

• 작업: 버킷의 공개 액세스 블록 구성을 가져옵니다.
• 사용법: ibmcloud cos public-access-block-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos public-access-block-get --bucket my-bucket

버킷에서 공용 액세스 블록 구성 제거

• 작업: 버킷에서 공개 액세스 차단 구성을 제거합니다.
• 사용법: ibmcloud cos public-access-block-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

예:

ibmcloud cos public-access-block-delete --bucket my-bucket

다음 방법을 사용하여 객체를 업로드합니다. S3Manager

• 조치: COS에 오브젝트를 동시에 업로드하십시오.
• 사용법: ibmcloud cos upload --bucket BUCKET_NAME --key KEY --file PATH [--concurrency value] [--max-upload-parts PARTS] [--part-size SIZE] [--leave-parts-on-errors] [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-length SIZE] [--content-md5 MD5] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷의 이름(BUCKET_NAME)입니다.

    • 플래그: --bucket BUCKET_NAME

  • 오브젝트의 키입니다.

    • 플래그: --key KEY

  • 업로드할 파일의 경로입니다.

    • 플래그: --file PATH

  • 선택 사항 : 파트를 전송할 때 Upload 호출당 병렬로 실행할 go 루틴의 수. 기본값은 5입니다.

    • 플래그: --concurrency value

  • 선택 사항 : 업로드할 객체의 부품 크기를 계산하는 S3 에 업로드될 부품의 최대 개수. 한계는 10,000개의 파트입니다.

    • 플래그: --max-upload-parts PARTS

  • 선택 사항 : 데이터를 청크 단위로 버퍼링하여 S3 에 파트로 전송할 때 사용할 버퍼 크기(바이트 단위). 허용되는 최소 파트 크기는 5MB입니다.

    • 플래그: --part-size SIZE

  • 선택 사항 : 이 값을 true로 설정하면, 오류 발생 시 SDK가 AbortMultipartUpload 호출을 수행하지 않게 되며, 성공적으로 업로드된 모든 파트는 S3 에 남아 수동으로 복구할 수 있게 됩니다.

    • 플래그: --leave-parts-on-errors

  • 선택 사항 : 요청/응답 체인에 대한 CACHING_DIRECTIVES를 지정합니다.

    • 플래그: --cache-control CACHING_DIRECTIVES

  • 선택 사항 : 표시 관련 정보(DIRECTIVES)를 지정합니다.

    • 플래그: --content-disposition DIRECTIVES

  • 선택 사항 : 객체에 어떤 콘텐츠 인코딩(CONTENT_ENCODING)이 적용되었는지, 그리고 이에 따라 Content-Type 헤더 필드에서 참조하는 미디어 유형을 얻기 위해 어떤 디코딩 메커니즘을 적용해야 하는지를 명시합니다.

    • 플래그: --content-encoding CONTENT_ENCODING

  • 선택 사항 : 콘텐츠가 작성된 언어.

    • 플래그: --content-language LANGUAGE

  • 선택 사항 : 본문의 크기(바이트 단위). 이 매개변수는 본문의 크기를 자동으로 판별할 수 없는 경우에 유용합니다

    • 플래그: --content-length SIZE

  • 선택 사항 : 데이터의 base64-encoded 128비트 MD5 다이제스트.

    • 플래그: --content-md5 MD5

  • 선택 사항 : 객체 데이터의 형식을 설명하는 표준 MIME 유형.

    • 플래그: --content-type MIME

  • 선택 사항 : 저장할 메타데이터의 MAP. file:// 접두사를 사용하면 파일에서 JSON 구조를 불러올 수 있습니다.

    • 플래그: --metadata MAP

      	{
      		"file_name": "file_20xxxxxxxxxxxx45.zip",
      		"label": "texas",
      		"state": "Texas",
      		"Date_to": "2019-11-09T16:00:00.000Z",
      		"Sha256sum": "9e39dxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx8ce6b68ede3a47",
      		"Timestamp": "Thu, 17 Oct 2019 09:22:13 GMT"
      	}
      

  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.

    • 플래그: --region REGION

  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.

    • 플래그: --output FORMAT

버킷 존재 여부

• 조치: head-bucket 로 폴링할 때 200 응답이 수신될 때까지 기다립니다.
• 사용법: ibmcloud cos wait bucket-exists --bucket BUCKET_NAME [--region REGION]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역.
    • 플래그: --region REGION

예:

ibmcloud cos wait bucket-exists --bucket my-bucket

버킷이 존재하지 않음

• 조치: head-bucket 로 폴링을 수행할 때 404 응답이 수신될 때까지 기다립니다.
• 사용법: ibmcloud cos wait bucket-not-exists --bucket BUCKET_NAME [--region REGION]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 버킷이 위치한 지역.
    • 플래그: --region REGION

예:

ibmcloud cos wait bucket-not-exists --bucket my-bucket

객체 존재 여부

• 조치: head-object 로 폴링할 때 200 응답이 수신될 때까지 기다립니다.
• 사용법: ibmcloud cos wait object-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 객체의 엔티티 태그(ETag)가 제공된 ETAG와 일치하는 경우에만 해당 객체를 반환합니다.
    • 플래그: --if-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 변경된 경우에만 해당 객체를 반환합니다.
    • 플래그: --if-modified-since TIMESTAMP
  • 선택 사항 : 해당 객체의 ETag가 제공된 ETAG와 일치하지 않는 경우에만 객체를 반환합니다.
    • 플래그: --if-none-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 변경된 적이 없는 객체만 반환합니다.
    • 플래그: --if-unmodified-since TIMESTAMP
  • 선택 사항 : 객체의 지정된 바이트 범위를 다운로드합니다.
    • 플래그: --range RANGE
  • 선택 사항 : 읽어들일 객체의 부품 번호.
    • 플래그: --part-number NUMBER
  • 선택 사항 : 버킷이 위치한 지역.
    • 플래그: --region REGION

예:

ibmcloud cos wait object-exists --bucket my-bucket --key my-object.txt

객체가 존재하지 않음

• 조치: head-object 로 폴링을 수행할 때 404 응답이 수신될 때까지 기다립니다.
• 사용법: ibmcloud cos wait object-not-exists --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--part-number NUMBER] [--region REGION]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 객체의 엔티티 태그(ETag)가 제공된 ETAG와 일치하는 경우에만 해당 객체를 반환합니다.
    • 플래그: --if-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 변경된 경우에만 해당 객체를 반환합니다.
    • 플래그: --if-modified-since TIMESTAMP
  • 선택 사항 : 해당 객체의 ETag가 제공된 ETAG와 일치하지 않는 경우에만 객체를 반환합니다.
    • 플래그: --if-none-match ETAG
  • 선택 사항 : 지정된 TIMESTAMP 이후로 변경된 적이 없는 객체만 반환합니다.
    • 플래그: --if-unmodified-since TIMESTAMP
  • 선택 사항 : 객체의 지정된 바이트 범위를 다운로드합니다.
    • 플래그: --range RANGE
  • 선택 사항 : 읽어들일 객체의 부품 번호.
    • 플래그: --part-number NUMBER
  • 선택 사항 : 버킷이 위치한 지역.
    • 플래그: --region REGION

예:

ibmcloud cos wait object-not-exists --bucket my-bucket --key my-object.txt