설치 및 구성

플러그인은 64비트프로세서에서 실행되는 Linux (x86_64, arm64, ppc64le, s390x), Windows ® (x64) 및 macOS® (amd64, arm64) 플랫폼과 호환 가능합니다.

plugin install 명령을 사용하여 플러그인을 설치하십시오.

ibmcloud plugin install cloud-object-storage

플러그인이 설치되면 ibmcloud cos config 명령을 사용하여 플러그인을 구성할 수 있습니다. 이를 통해 플러그인에 사용자 인증 정보, 기본 다운로드 위치, 인증 방식 선택 등을 설정할 수 있습니다.

최적의 성능을 위해 IBMCLOUD_TRACE 환경 변수를 false 로 설정하여 추적이 사용 안함으로 설정되어 있는지 확인하십시오.

프로그램은 다운로드한 파일의 기본 로컬 디렉토리를 설정하고 기본 지역을 설정하는 기능도 제공합니다. 기본 다운로드 위치를 설정하려면 ibmcloud cos config ddl을 입력하고 프로그램에 올바른 파일 경로를 입력하십시오. 기본 지역을 설정하려면 ibmcloud cos config region을 입력하고 프로그램에 지역 코드(예: us-south)를 입력하십시오. 기본적으로 이 값을 us-geo로 설정합니다.

ibmcloud cos config list 에 접속하면 현재 IBM Cloud Object Storage 계정 정보를 확인할 수 있습니다. 구성 파일이 플러그인에서 생성되므로 파일을 수동으로 편집하지 않는 것이 좋습니다.

$ ibmcloud cos config list
Key                     Value
Last Updated            Tuesday, April 28 2020 at 19:35:57
Default Region          us-south
Download Location       /home/ibmuser/Downloads
CRN                     8f275e7b-c076-49e2-b9c5-f985704cf678
AccessKeyID             9eib1eejar6HaezaohveV5hikei4aNg2ooV0qu
SecretAccessKey         ********************************************
Authentication Method   IAM
URL Style               VHost

$ 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
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

명령행 인터페이스에서 추적 사용

IBMCLOUD_TRACE 환경 변수를 true(으)로 설정하여 추적을 사용할 수 있습니다(대소문자가 무시됨). 추적이 사용되면 추가 디버깅 정보가 터미널에 인쇄됩니다.

Linux/macOS 터미널에서:

export IBMCLOUD_TRACE=true

Windows 프롬프트에서:

SET IBMCLOUD_TRACE=true

추적을 사용하지 않으려면 IBMCLOUD_TRACE 환경 변수를 false(으)로 설정하십시오(대소문자가 무시됨).

명령 색인

각 명령어에는 해당 명령어의 기능, 사용 방법, 그리고 선택적 또는 필수 매개변수에 대한 설명이 포함되어 있습니다. 선택사항으로 지정되지 않는 한 나열된 매개변수는 필수입니다.

CLI 플러그인은 아직 Object Storage 에서 제공되는 전체 기능을 지원하지 않습니다. Aspera High-Speed Transfer, 불변 Object Storage, Key Protect 버킷 생성 또는 버킷 방화벽은 CLI에서 사용할 수 없습니다.

다중 파트 업로드 정보

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에 대한 업로드를 종료하여 다중 파트 업로드 인스턴스를 중단합니다.
• 사용법: ibmcloud cos multipart-upload-abort --bucket BUCKET_NAME --key KEY --upload-id ID [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 다중 파트 업로드를 식별하는 업로드 ID입니다.
    • 플래그: --upload-id ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

정적 웹 사이트 구성

• 조치: 정적 웹 사이트를 호스트하도록 버킷을 구성합니다.

• 사용법: ibmcloud cos bucket-website-put --bucket BUCKET_NAME [--region REGION] [--output FORMAT]

• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • JSON 구조 양식의 웹 사이트 구성입니다. file:// 접두부는 지정된 파일 (예: --website-configuration file://<filename.json>) 에서 JSON 구조를 로드하는 데 사용됩니다.

    • 플래그: --website-configuration STRUCTURE 정적 웹 사이트 동작을 구성하는 데 사용할 수 있는 매개변수는 다음과 같습니다. 아무 것도 필요하지 않습니다. 자세한 정보는 문서를 참조하십시오.

      {
        "ErrorDocument": {
          "Key": "string"
        },
        "IndexDocument": {
          "Suffix": "string"
        },
        "RoutingRules": [
          {
            "Condition": {
              "HttpErrorCodeReturnedEquals": "string",
              "KeyPrefixEquals": "string"
            },
            "Redirect": {
              "HostName": "string",
              "HttpRedirectCode": "string",
              "Protocol": "http"|"https",
              "ReplaceKeyPrefixWith": "string",
              "ReplaceKeyWith": "string"
            }
          }
          ...
        ]
      }
      

      또는 버킷 웹 사이트가 트래픽을 경로 재지정하도록 구성된 경우 구성된 유일한 매개변수여야 합니다.

      	  "RedirectAllRequestsTo": {
      	    "HostName": "string",
      	    "Protocol": "http"|"https"
      	  }
      	  ```
      
      
      

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

    • 플래그: --region REGION

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

    • 플래그: --output FORMAT

버킷에서 오브젝트 복사

복사 중에 ( --metadata 기능을 사용하여) 오브젝트에 메타데이터를 추가하려면 --metadata-directive REPLACE 속성을 추가해야 합니다. 기본적으로 조작 중에 메타데이터가 복사되기 때문입니다 (암시적 --metadata-directive COPY).

• 조치: 소스 버킷에서 대상 버킷으로 오브젝트를 복사합니다.
• 사용법: ibmcloud cos object-copy --bucket BUCKET_NAME --key KEY --copy-source SOURCE [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--copy-source-if-match ETAG] [--copy-source-if-modified-since TIMESTAMP] [--copy-source-if-none-match ETAG] [--copy-source-if-unmodified-since TIMESTAMP] [--metadata MAP] [--metadata-directive DIRECTIVE] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 대상 버킷의 이름.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • (SOURCE) 소스 버킷 이름과 소스 객체의 키 이름으로, 슬래시(/)로 구분됩니다. 반드시 URL 인코딩되어야 합니다.
    • 플래그: --copy-source SOURCE
  • 선택 사항 : 요청 및 응답 체인에 대해 CACHING_DIRECTIVES 을 지정합니다.
    • 플래그: --cache-control CACHING_DIRECTIVES
  • 선택 사항 : 표시 정보를 지정합니다(DIRECTIVES).
    • 플래그: --content-disposition DIRECTIVES
  • 선택 사항 : 객체에 어떤 콘텐츠 인코딩(CONTENT_ENCODING)이 적용되는지, 그리고 이에 따라 Content-Type 헤더 필드에서 참조하는 미디어 유형을 얻기 위해 어떤 디코딩 메커니즘을 적용해야 하는지를 명시합니다.
    • 플래그: --content-encoding CONTENT_ENCODING
  • 선택 사항 : 콘텐츠가 작성된 언어.
    • 플래그: --content-language LANGUAGE
  • 선택 사항 : 객체 데이터의 형식을 설명하는 표준 MIME 유형.
    • 플래그: --content-type MIME
  • 선택 사항 : 객체의 엔티티 태그(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
  • 선택 사항 : 저장할 메타데이터의 MAP.
    • 플래그: --metadata MAP JSON 구문: --metadata 플래그는 지정된 파일에서 JSON 구조를 로드하는 데 사용되는 file:// 접두부를 사용합니다.

      {
        "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"
      }
      ```

   * _Optional_: Specifies whether the metadata is copied from the source object or replaced with metadata provided in the request. DIRECTIVE values: COPY,REPLACE.
        * Flag: ` --metadata-directive DIRECTIVE`
    * _Optional_: The REGION where the bucket is present. If this flag is not provided, the program uses the default option that is specified in config.
        * Flag: `--region REGION`
    * _Optional_: Output FORMAT can be only json or text.
        * Flag: `--output FORMAT`

새 버킷 작성

• 조치: IBM Cloud Object Storage 인스턴스에서 버킷을 작성합니다.
• 사용법: ibmcloud cos bucket-create --bucket BUCKET_NAME [--class CLASS_NAME][--class onerate_active] [--ibm-service-instance-id ID] [--region REGION] [--output FORMAT]
  • IAM 인증을 사용하는 경우 CRN을 제공해야 합니다. 이는 ibmcloud cos config crn 명령을 사용하여 설정할 수 있습니다.
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택사항: 클래스의 이름입니다.
    • 플래그: --class CLASS_NAME
  • 사용자는 버킷을 생성할 때 onerate_active를 지정해야 합니다.
    • 플래그: --class onerate_active
  • 선택 사항 : 요청에 ‘ IBM ’ 서비스 인스턴스 ID를 설정합니다.
    • 플래그: --ibm-service-instance-id ID
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

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

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

다중 파트 업로드 새로 작성

• 조치: 다중 파트 업로드 인스턴스를 새로 작성하여 다중 파트 파일 업로드 프로세스를 시작합니다.

• 사용법: ibmcloud cos multipart-upload-create --bucket BUCKET_NAME --key KEY [--cache-control CACHING_DIRECTIVES] [--content-disposition DIRECTIVES] [--content-encoding CONTENT_ENCODING] [--content-language LANGUAGE] [--content-type MIME] [--metadata MAP] [--region REGION] [--output FORMAT]

• 제공할 매개변수:

  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 요청 및 응답 체인에 대해 CACHING_DIRECTIVES 을 지정합니다.
    • 플래그: --cache-control CACHING_DIRECTIVES
  • 선택 사항 : 표시 정보를 지정합니다(DIRECTIVES).
    • 플래그: --content-disposition DIRECTIVES
  • 선택 사항 : 객체의 콘텐츠 인코딩(CONTENT_ENCODING)을 지정합니다.
    • 플래그: --content-encoding CONTENT_ENCODING
  • 선택 사항 : 콘텐츠가 작성된 언어.
    • 플래그: --content-language LANGUAGE
  • 선택 사항 : 객체 데이터의 형식을 설명하는 표준 MIME 유형.
    • 플래그: --content-type MIME
  • 선택 사항 : 저장할 메타데이터의 MAP.
    • 플래그: --metadata MAP JSON 구문: --metadata 플래그는 지정된 파일에서 JSON 구조를 로드하는 데 사용되는 file:// 접두부를 사용합니다.

  {
    "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

기존 버켓 삭제

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

버킷 CORS 삭제

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

정적 웹 사이트 구성 삭제

• 조치: 버킷의 정적 웹 사이트 구성을 제거합니다.
• 사용법: ibmcloud cos bucket-website-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

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

오브젝트 삭제

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에서 오브젝트를 삭제합니다.
• 사용법: ibmcloud cos object-delete --bucket BUCKET_NAME --key KEY [--region REGION] [--force] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 이 작업은 확인을 요청하지 않습니다.
    • 플래그: --force
    • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
      • 플래그: --output FORMAT

다중 오브젝트 삭제

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에서 다중 오브젝트를 삭제합니다.

• 사용법: ibmcloud cos objects-delete --bucket BUCKET_NAME --delete STRUCTURE [--region REGION] [--output FORMAT]

• 제공할 매개변수:

  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 단축 또는 JSON 구문을 사용하는 구조입니다.
    • 플래그: --delete STRUCTURE
    • 단축 구문: --delete 'Objects=[{Key=string},{Key=string}],Quiet=boolean'

    • JSON 구문: --delete file://<filename.json>

      --delete 명령은 삭제할 오브젝트를 나열하는 JSON 구조를 사용합니다. 이 예에서 file:// 접두부는 지정된 파일에서 JSON 구조를 로드하는 데 사용됩니다.

  	{
  	"Objects": [
  	{
  	"Key": "string",
  	"VersionId": "string"
  	}
  ...
  	],
  	"Quiet": true|false
  	}
  

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

오브젝트 다운로드

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에서 오브젝트를 다운로드합니다.
• 사용법: ibmcloud cos object-get --bucket BUCKET_NAME --key KEY [--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 BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 객체의 엔티티 태그(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 바이트를 다운로드합니다.
    • 플래그: --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 bucket-location-get --bucket BUCKET_NAME [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

버킷의 클래스 가져오기

• 조치: IBM Cloud Object Storage 인스턴스에서 버킷의 클래스를 판별합니다.
• 사용법: ibmcloud cos bucket-class-get --bucket BUCKET_NAME [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

버킷 CORS 가져오기

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

버킷의 헤더 가져오기

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

다중 파트 업로드 완료

• 조치: 현재 업로드한 파트를 어셈블하고 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에 파일을 업로드하여 다중 파트 업로드 인스턴스를 완료합니다.
• 사용법: ibmcloud cos multipart-upload-complete --bucket BUCKET_NAME --key KEY --upload-id ID --multipart-upload STRUCTURE [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

    • 플래그: --bucket BUCKET_NAME

  • 오브젝트의 키입니다.

    • 플래그: --key KEY

  • 다중 파트 업로드를 식별하는 업로드 ID입니다.

    • 플래그: --upload-id ID

  • 설정할 다중 파트 업로드의 구조입니다.

    • 플래그: --multipart-upload STRUCTURE
    • 단축 구문: --multipart-upload 'Parts=[{ETag=string,PartNumber=integer},{ETag=string,PartNumber=integer}]'

    • JSON 구문: --multipart-upload file://<filename.json>

      --multipart-upload 명령은 전체 파일에 리어셈블해야 하는 다중 파트 업로드의 파트를 설명하는 JSON 구조를 사용합니다. 이 예에서 file:// 접두부는 지정된 파일에서 JSON 구조를 로드하는 데 사용됩니다.

    		{
    		"Parts": [
    			{
    			 "ETag": "string",
    			 "PartNumber": integer
    			}
    			...
    			]
    		}
    

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

    • 플래그: --region REGION

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

    • 플래그: --output FORMAT

프로그램 구성

• 조치: 프로그램의 환경 설정을 구성합니다.
• 사용법: ibmcloud cos config [COMMAND]
• 명령:
  • HMAC와 IAM 인증 사이에서 전환합니다.
    • Command: auth
  • 구성에 CRN을 저장합니다.
    • Command: crn
  • 구성에 기본 다운로드 위치를 저장합니다.
    • Command: ddl
  • 구성에 HMAC 인증 정보를 저장합니다.
    • Command: hmac
  • 구성을 나열합니다.
    • Command: list
  • 구성에 기본 지역을 저장합니다.
    • Command: region
  • VHost 과 Path URL 스타일 간에 전환합니다.
    • Command: url-style
  • 기본 서비스 엔드포인트를 설정하십시오.
    • Command: endpoint-url

      • 매개변수:

        • --list 는 현재 기본 서비스 엔드포인트 (설정된 경우) 를 표시합니다. 그렇지 않으면 비어 있습니다.
        • --url some.end.point.url 는 서비스 엔드포인트를 제공된 값으로 변경합니다.
        • --clear 설정된 기본 서비스 엔드포인트( URL )를 제거합니다.

정적 웹 사이트 구성 가져오기

• 조치: 버킷의 정적 웹 사이트 구성을 가져옵니다.
• 사용법: ibmcloud cos bucket-website-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• 제공할 매개변수:

  • 버킷 이름입니다.

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

오브젝트의 헤더 가져오기

• 조치: 파일이 사용자의 IBM Cloud Object Storage 계정의 버킷에 있는지 판별합니다.
• 사용법: ibmcloud cos object-head --bucket BUCKET_NAME --key KEY [--if-match ETAG] [--if-modified-since TIMESTAMP] [--if-none-match ETAG] [--if-unmodified-since TIMESTAMP] [--range RANGE] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 객체의 엔티티 태그(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 바이트를 다운로드합니다.
    • 플래그: --range RANGE
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

모든 버킷 나열

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 모든 버킷의 목록을 인쇄합니다. 버킷은 여러 영역에 위치할 수 있습니다.
• 사용법: ibmcloud cos buckets [--ibm-service-instance-id ID] [--output FORMAT]
  • IAM 인증을 사용하는 경우 CRN을 제공해야 합니다. 이는 ibmcloud cos config crn 명령을 사용하여 설정할 수 있습니다.
• 제공할 매개변수:
  • 제공할 매개변수가 없습니다.
    • 선택 사항 : 요청에 ‘ IBM ’ 서비스 인스턴스 ID를 설정합니다.
      • 플래그: --ibm-service-instance-id
    • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
      • 플래그: --output FORMAT

진행 중인 다중 파트 업로드 나열

• 조치: 진행 중인 다중 파트 업로드를 나열합니다.
• 사용법: ibmcloud cos multipart-uploads --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--key-marker value] [--upload-id-marker value] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 구분자(DELIMITER)는 키를 묶는 데 사용하는 문자입니다.
    • 플래그: --delimiter DELIMITER
  • 선택 사항 : 응답에 포함된 객체 키를 인코딩하도록 요청하며, 사용할 인코딩 방식을 지정합니다.
    • 플래그: --encoding-type METHOD
  • 선택 사항 : 응답을 지정된 PREFIX로 시작하는 키로만 제한합니다.
    • 플래그: --prefix PREFIX
  • 선택 사항 : 이 매개변수는 upload-id-marker와 함께, 어느 지점부터 목록 표시를 시작해야 하는지를 지정합니다.
    • 플래그: --key-marker value
  • 선택 사항 : key-marker와 함께 사용하면, 목록 표시가 시작되어야 할 멀티파트 업로드 지점을 지정합니다. key-marker를 지정하지 않으면 upload-id-marker 매개변수가 무시됩니다.
    • 플래그: --upload-id-marker value
  • 선택 사항 : 서비스 호출 시 가져올 각 페이지의 SIZE. 이는 명령의 출력에 리턴된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 더 작게 설정하면 서비스에 대한 호출이 많아져 각 호출에서 더 적은 수의 항목을 검색하게 됩니다. 이렇게 하면 서비스 호출이 시간 초과되는 것을 방지하는 데 도움이 됩니다. (기본값: 1000).
    • 플래그: --page-size SIZE
  • 선택 사항 : 명령어 출력에서 반환할 항목의 총 개수. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우에는 NextToken이 명령의 출력에 제공됩니다. 페이지 분할을 재개하려면, 다음 명령어의 starting-token 인자에 NextToken 값을 지정하십시오. (기본값: 0).
    • 플래그: --max-items NUMBER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

오브젝트 나열

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷의 파일을 나열합니다. 이 오퍼레이션은 현재 1000개의 최근에 작성된 오브젝트로 제한되며 필터링되지 않습니다.
• 사용법: ibmcloud cos objects --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--starting-token TOKEN] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 구분자(DELIMITER)는 키를 묶는 데 사용하는 문자입니다.
    • 플래그: --delimiter DELIMITER
  • 선택 사항 : 응답에 포함된 객체 키를 인코딩하도록 요청하며, 사용할 인코딩 방식을 지정합니다.
    • 플래그: --encoding-type METHOD
  • 선택 사항 : 응답을 지정된 PREFIX로 시작하는 키로만 제한합니다.
    • 플래그: --prefix PREFIX
  • 선택 사항 : 페이지 분할을 시작할 위치를 지정하는 TOKEN. 이는 이전에 잘린 응답의 NextToken입니다.
    • 플래그: --starting-token TOKEN
  • 선택 사항 : 서비스 호출 시 가져올 각 페이지의 SIZE. 이는 명령의 출력에 리턴된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 더 작게 설정하면 서비스에 대한 호출이 많아져 각 호출에서 더 적은 수의 항목을 검색하게 됩니다. 이렇게 하면 서비스 호출이 시간 초과되는 것을 방지할 수 있습니다. (기본값: 1000)
    • 플래그: --page-size SIZE
  • 선택 사항 : 명령어 출력에서 반환할 항목의 총 개수. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우에는 NextToken이 명령의 출력에 제공됩니다. 페이지 분할을 재개하려면, 다음 명령어의 starting-token 인자에 NextToken 값을 지정하십시오. (기본값: 0)
    • 플래그: --max-items NUMBER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

오브젝트 나열 v2

• 작업: 특정 버킷에 있는 모든 객체를 나열합니다.
• 사용법: list-objects-v2 --bucket BUCKET_NAME [--starting-token Starting Token] [--delimiter DELIMITER] [--encoding-type METHOD] [--fetch-owner Boolean] [--max-items NUMBER] [--prefix PREFIX] [--start-after Start After] [--page-size SIZE] [--region REGION] [--output FORMAT] [--json]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 구분자(DELIMITER)는 키를 묶는 데 사용하는 문자입니다.
    • 플래그: --delimiter DELIMITER
  • 선택 사항 : 응답에 포함된 객체 키를 인코딩하도록 요청하며, 사용할 인코딩 방식을 지정합니다.
    • 플래그: --encoding-type METHOD
  • 선택 사항 : 응답을 지정된 PREFIX로 시작하는 키로만 제한합니다.
    • 플래그: --prefix PREFIX
  • 선택 사항 : 페이지 분할을 시작할 위치를 지정하는 TOKEN. 이는 이전에 잘린 응답의 NextToken입니다.
    • 플래그: --starting-token TOKEN
  • 선택 사항 : 서비스 호출 시 가져올 각 페이지의 SIZE. 이는 명령의 출력에 리턴된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 더 작게 설정하면 서비스에 대한 호출이 많아져 각 호출에서 더 적은 수의 항목을 검색하게 됩니다. 이렇게 하면 서비스 호출이 시간 초과되는 것을 방지할 수 있습니다. (기본값: 1000)
    • 플래그: --page-size SIZE
  • 선택 사항 : 명령어 출력에서 반환할 항목의 총 개수. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우에는 NextToken이 명령의 출력에 제공됩니다. 페이지 분할을 재개하려면, 다음 명령어의 starting-token 인자에 NextToken 값을 지정하십시오. (기본값: 0)
    • 플래그: --max-items NUMBER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT
  • 선택 사항 : 기본적으로 listV2 에는 이 부울 값이 포함되어 있지 않습니다. 결과의 각 키와 함께 소유자 필드를 반환하려면 fetch owner field 를 true 로 설정하십시오.
    • 플래그: --fetch-owner Boolean
  • 선택 사항 : ‘시작 위치’는 ‘ S3 ’가 목록을 표시하기 시작할 위치를 지정하는 곳입니다. S3는 이 지정된 키 다음에 나열을 시작합니다. StartAfter는 버킷의 모든 키가 될 수 있습니다.
    • 플래그: --start-after Start After
  • 사용 중단됨 : 출력이 원시 JSON 형식으로 반환되었습니다.
    • 플래그: --json

파트 나열

• 조치: 진행 중인 다중 파트 업로드 인스턴스에 대한 정보를 출력합니다.
• 사용법: ibmcloud cos parts --bucket BUCKET_NAME --key KEY --upload-id ID --part-number-marker VALUE [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--output FORMAT]
• 제공할 매개변수:
  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 다중 파트 업로드를 식별하는 업로드 ID입니다.
    • 플래그: --upload-id ID
  • 목록이 시작되는 파트 번호 값입니다(기본값: 1).
    • 플래그: --part-number-marker VALUE
  • 선택 사항 : 서비스 호출 시 가져올 각 페이지의 SIZE. 이는 명령의 출력에 리턴된 항목의 수에 영향을 주지 않습니다. 페이지 크기를 더 작게 설정하면 서비스에 대한 호출이 많아져 각 호출에서 더 적은 수의 항목을 검색하게 됩니다. 이렇게 하면 서비스 호출이 시간 초과되는 것을 방지할 수 있습니다. (기본값: 1000)
    • 플래그: --page-size SIZE
  • 선택 사항 : 명령어 출력에서 반환할 항목의 총 개수. 사용 가능한 총 항목 수가 지정된 값을 초과하는 경우에는 NextToken이 명령의 출력에 제공됩니다. 페이지 분할을 재개하려면, 다음 명령어의 starting-token 인자에 NextToken 값을 지정하십시오. (기본값: 0)
    • 플래그: --max-items NUMBER
  • 선택 사항 : 버킷이 위치한 지역. 이 플래그를 제공하지 않으면 프로그램에서 구성에 지정된 기본 옵션을 사용합니다.
    • 플래그: --region REGION
  • 선택 사항 : 출력 형식은 json 또는 text 중 하나만 가능합니다.
    • 플래그: --output FORMAT

버킷 CORS 설정

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에 대한 CORS 구성을 설정합니다.

• 사용법: ibmcloud cos bucket-cors-put --bucket BUCKET_NAME [--cors-configuration STRUCTURE] [--region REGION] [--output FORMAT]

• 제공할 매개변수:

  • 버킷 이름입니다.
    • 플래그: --bucket BUCKET_NAME
  • 선택 사항 : 파일에 JSON 구문을 사용한 STRUCTURE.
    • 플래그: --cors-configuration STRUCTURE

    • JSON 구문: --cors-configuration file://<filename.json>

      --cors-configuration 명령은 CORS 구성을 설명하는 JSON 구조를 사용합니다. 이 예에서 file:// 접두부는 지정된 파일에서 JSON 구조를 로드하는 데 사용됩니다.

  	{
  	"CORSRules": [
  	{
    	"AllowedHeaders": ["*"],
    	"AllowedMethods": ["PUT", "GET", "DELETE"],
    	"AllowedOrigins": ["http://www.example.com"],
    	"ExposeHeaders": ["ExposeHeader7","ExposeHeader8"],
    	"MaxAgeSeconds": 75
  	}
  	...
  	]
  	}
  

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

오브젝트 배치

• 조치: 사용자의 IBM Cloud Object Storage 계정에 있는 버킷에 오브젝트를 업로드합니다.

• 사용법: ibmcloud cos object-put --bucket BUCKET_NAME --key KEY [--body FILE_PATH] [--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 BUCKET_NAME
  • 오브젝트의 키입니다.
    • 플래그: --key KEY
  • 선택 사항 : 객체 데이터 위치 (FILE_PATH).
    • 플래그: --body FILE_PATH
  • 선택 사항 : 요청 및 응답 체인에 대해 CACHING_DIRECTIVES 을 지정합니다.
    • 플래그: --cache-control CACHING_DIRECTIVES
  • 선택 사항 : 표시 정보를 지정합니다(DIRECTIVES).
    • 플래그: --content-disposition DIRECTIVES
  • 선택 사항 : 객체의 콘텐츠 인코딩(CONTENT_ENCODING)을 지정합니다.
    • 플래그: --content-encoding CONTENT_ENCODING
  • 선택 사항 : 콘텐츠가 작성된 언어.
    • 플래그: --content-language LANGUAGE
  • 선택 사항 : 본문의 크기(바이트 단위). 본문의 크기를 자동으로 파악할 수 없는 경우 이 매개변수가 유용합니다. (기본값: 0)
    • 플래그: --content-length SIZE
  • 선택 사항 : 데이터의 base64-encoded 128비트 MD5 다이제스트.
    • 플래그: --content-md5 MD5
  • 선택 사항 : 객체 데이터의 형식을 설명하는 표준 MIME 유형.
    • 플래그: --content-type MIME
  • 선택 사항 : 저장할 메타데이터의 MAP.
    • 플래그: --metadata MAP JSON 구문: --metadata 플래그는 지정된 파일에서 JSON 구조를 로드하는 데 사용되는 file:// 접두부를 사용합니다.

  {
    "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

다중 파트 업로드 수동 제어

IBM Cloud Object Storage CLI는 AWS 의 멀티파트 업로드 기능을 활용하여 사용자가 대용량 파일을 여러 부분으로 나누어 업로드할 수 있도록 지원합니다. 새로운 멀티파트 업로드를 시작하려면 multipart-upload-create 명령을 실행하면 되며, 이 명령은 새로운 업로드 인스턴스의 업로드 ID를 반환합니다. 업로드 프로세스를 계속하려면 각 후속 명령에 대한 업로드 ID를 저장해야 합니다. 이 명령을 사용하려면 MD5 해시를 생성해야 합니다:

{object data} | openssl dgst -md5 -binary | openssl enc -base64

multipart-upload-complete 명령을 실행한 후 업로드할 각 파일 파트에 대해 part-upload 를 실행하십시오. 다중 파일 업로드의 경우, 마지막 파일을 제외한 모든 파일의 크기는 5MB 이상이어야 합니다. 파일을 개별 파트로 분할하기 위해 터미널 창에서 split를 실행할 수 있습니다. 예를 들어, 데스크탑에 이름이 TESTFILE인 13MB 파일이 있고 이 파일을 각각 5MB의 파일 파트로 분할하려는 경우 split -b 3m ~/Desktop/TESTFILE part-file-을 실행할 수 있습니다. 이 명령은 세 개의 파일 파트를 두 개는 각각 5MB이고 하나는 3MB인 파일 파트로 생성하며, 파일의 이름은 part-file-aa, part-file-ab 및 part-file-ac입니다. As each file part is uploaded, the CLI print its ETag . You must save this ETag into a formatted JSON file, along with the part number. Use this template to create your own ETag JSON 데이터 파일입니다.

{
    "Parts": [
    {
      "PartNumber": 1,
      "ETag": "The ETag of the first file part goes here."
    },
    {
      "PartNumber": 2,
      "ETag": "The ETag of the second file part goes here."
    }
    ]
}

필요에 따라 이 JSON 템플리트에 항목을 추가하십시오.

다중 파트 업로드 인스턴스의 상태를 확인하려면, 버킷 이름, 키 및 업로드 ID를 지정하여 언제든지 part-list 명령어를 실행하면 됩니다. 이 명령어는 다중 파일 업로드 인스턴스에 대한 원시 정보를 출력합니다. 파일의 각 부분 업로드를 모두 완료한 후, 필요한 매개변수를 지정하여 multipart-upload-complete 명령을 실행하십시오. 모두 잘 진행되면 파일이 원하는 버킷에 업로드되었다는 확인 메시지를 수신합니다.

오브젝트 잠금 구성

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 us-south

오브젝트 보존

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-put --bucket bucket-name --key file-name.txt --region us-south

오브젝트 증거보존 통지

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

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

버킷 복제 구성

복제된 버킷을 구성하기 위한 설정입니다.

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

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

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

다음 단계

모든 프로시저가 항상 계획대로 진행되므로 공통 헤더 및 오류 코드 가 표시되지 않을 수 있습니다. 자세한 정보는 API 참조 를 확인하십시오.