Installation und Konfiguration

Das Plug-in ist mit Linux (x86_64, arm64, ppc64le, s390x), Windows ® (x64) und macOS® (amd64, arm64) auf 64-Bit-Prozessoren kompatibel.

Führen Sie zum Installieren des Plug-ins den Befehl plugin install aus.

ibmcloud plugin install cloud-object-storage

Nach der Installation des Plug-ins können Sie das Plug-in mit dem Befehl ibmcloud cos config konfigurieren. Auf diese Weise können Sie im Plug-in Ihre Anmeldedaten eingeben, den Standard-Speicherort für Downloads festlegen, die Authentifizierungsmethode auswählen und so weiter.

Stellen Sie für optimale Leistung sicher, dass die Traceerstellung inaktiviert ist, indem Sie die Umgebungsvariable IBMCLOUD_TRACE auf false setzen.

Das Programm bietet außerdem die Möglichkeit, das lokale Standardverzeichnis für heruntergeladene Dateien festzulegen sowie eine Standardregion festzulegen. Sie legen die Standarddownloadposition fest, indem Sie ibmcloud cos config ddl gefolgt von einem gültigen Dateipfad in das Programm eingeben. Wenn Sie eine Standardregion festlegen möchten, geben Sie ibmcloud cos config region ein und geben Sie dann einen Regionscode als Eingabe für das Programm an, wie zum Beispiel us-south. Standardmäßig ist für diese Angabe der Wert us-geo festgelegt.

Sie können Ihre aktuellen Zugangsdaten für „ IBM Cloud Object Storage “ einsehen, indem Sie die Seite ibmcloud cos config list aufrufen. Da die Konfigurationsdatei vom Plug-in generiert wird, ist es ratsam, die Datei nicht manuell zu bearbeiten.

$ 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

Traceerstellung in der Befehlszeilenschnittstelle aktivieren

Die Traceerstellung kann aktiviert werden, indem die Umgebungsvariable IBMCLOUD_TRACE auftrue gesetzt wird (Groß-/Kleinschreibung wird ignoriert). Nach Aktivierung des Tracing werden am Terminal weitere Debugging-Information ausgegeben.

Linux/Mac OS-Terminal:

export IBMCLOUD_TRACE=true

Windows-Eingabeaufforderung:

SET IBMCLOUD_TRACE=true

Zum Inaktivieren der Traceerstellung setzen Sie die Umgebungsvariable IBMCLOUD_TRACEauf false (Groß-/Kleinschreibung wird ignoriert).

Befehlsindex

Zu jeder Operation gibt es eine Erläuterung, was sie bewirkt, wie sie verwendet wird und welche optionalen oder erforderlichen Parameter es gibt. Sofern nicht ausdrücklich als optional vermerkt, handelt es sich bei allen aufgelisteten Parametern um obligatorische Parameter, deren Angabe verbindlich ist.

Das CLI-Plugin unterstützt noch nicht den vollen Funktionsumfang von Object Storage. Aspera High-Speed Transfer, Immutable Object Storage, das Erstellen von Key Protect Buckets oder Bucket Firewalls können nicht über die CLI verwendet werden.

Mehrteiligen Upload abbrechen

• Aktion: Abbrechen der Instanz eines mehrteiligen Uploads durch Beenden des Uploads in das Bucket im IBM Cloud Object Storage-Konto des Benutzers.
• Verwendung: ibmcloud cos multipart-upload-abort --bucket BUCKET_NAME --key KEY --upload-id ID [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Die Upload-ID, die den mehrteiligen Upload angibt.
    • Flag:--upload-id ID
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Statische Website konfigurieren

• Aktion: Konfiguriert ein Bucket zum Hosten einer statischen Website.

• Verwendung: ibmcloud cos bucket-website-put --bucket BUCKET_NAME [--region REGION] [--output FORMAT]

• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Die Websitekonfiguration in Form einer JSON-Struktur Das Präfix file:// wird verwendet, um die JSON-Struktur aus der angegebenen Datei zu laden, beispielsweise --website-configuration file://<filename.json>.

    • Flag:--website-configuration STRUCTURE Die folgenden Parameter sind für die Konfiguration des Verhaltens statischer Websites verfügbar. Es sind keine erforderlich. Weitere Informationen finden Sie in der Dokumentation.

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

      Wenn die Bucket-Website für die Umleitung von Datenverkehr konfiguriert ist, muss sie alternativ der einzige konfigurierte Parameter sein:

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

  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.

    • Flag:--region REGION

  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.

    • Flag:--output FORMAT

Objekt aus Bucket kopieren

Wenn Sie Metadaten zu einem Objekt während des Kopierens hinzufügen wollen (mit dem Feature --metadata ), müssen Sie das Attribut --metadata-directive REPLACE hinzufügen, da Metadaten während der Operation standardmäßig kopiert werden (eine implizite --metadata-directive COPY).

• Aktion: Kopieren eines Objekts aus dem Quellenbucket in das Zielbucket.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Ziel-Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • (QUELLE) Der Name des Quell-Buckets und der Schlüsselname des Quellobjekts, getrennt durch einen Schrägstrich (/). Muss „ URL “-kodiert sein.
    • Flag:--copy-source SOURCE
  • Optional : Legt „ CACHING_DIRECTIVES “ für die Anfrage- und Antwortkette fest.
    • Flag:--cache-control CACHING_DIRECTIVES
  • Optional : Gibt Darstellungsinformationen an (DIRECTIVES).
    • Flag:--content-disposition DIRECTIVES
  • Optional : Gibt an, welche Inhaltskodierungen (CONTENT_ENCODING) auf das Objekt angewendet werden und welche Dekodierungsmechanismen daher erforderlich sind, um den im Header-Feld „Content-Type“ angegebenen Medientyp zu erhalten.
    • Flag:--content-encoding CONTENT_ENCODING
  • Optional : Die SPRACHE, in der der Inhalt verfasst ist.
    • Flag:--content-language LANGUAGE
  • Optional : Ein Standard-MIME-Typ, der das Format der Objektdaten beschreibt.
    • Flag:--content-type MIME
  • Optional : Kopiert das Objekt, wenn dessen Entity-Tag (Etag) mit dem angegebenen Tag (ETAG) übereinstimmt.
    • Flag:--copy-source-if-match ETAG
  • Optional : Kopiert das Objekt, wenn es seit dem angegebenen Zeitpunkt (TIMESTAMP) geändert wurde.
    • Flag:--copy-source-if-modified-since TIMESTAMP
  • Optional : Kopiert das Objekt, wenn sich dessen Entity-Tag (ETag) vom angegebenen Tag (ETAG) unterscheidet.
    • Flag:--copy-source-if-none-match ETAG
  • Optional : Kopiert das Objekt, wenn es seit dem angegebenen Zeitpunkt (TIMESTAMP) nicht geändert wurde.
    • Flag:--copy-source-if-unmodified-since TIMESTAMP
  • Optional : Eine MAP mit den zu speichernden Metadaten.
    • Flag:--metadata MAP JSON-Syntax: Das Flag --metadata verwendet das Präfix file://, das zum Laden der JSON-Struktur aus der angegebenen Datei verwendet wird.

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

Neues Bucket erstellen

• Aktion: Erstellen eines Buckets in einer Instanz von IBM Cloud Object Storage.
• Verwendung: ibmcloud cos bucket-create --bucket BUCKET_NAME [--class CLASS_NAME][--class onerate_active] [--ibm-service-instance-id ID] [--region REGION] [--output FORMAT]
  • Beachten Sie, das Sie einen Cloudressourcennamen (CRN) angeben müssen, wenn Sie die IAM-Authentifizierung verwenden. Dies kann mit dem Befehl ibmcloud cos config crn festgelegt werden.
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Der Name der Klasse.
    • Flag:--class CLASS_NAME
  • Beim Erstellen eines Buckets muss der Benutzer onerate_active angeben.
    • Flag:--class onerate_active
  • Optional : Legt die Instanz-ID des „ IBM “-Dienstes in der Anfrage fest.
    • Flag:--ibm-service-instance-id ID
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--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

Neuen mehrteiligen Upload erstellen

• Aktion: Starten des mehrteiligen Dateiuploads durch Erstellen einer neuen Instanz eines mehrteiligen Uploads.

• Verwendung: 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]

• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Legt „ CACHING_DIRECTIVES “ für die Anfrage- und Antwortkette fest.
    • Flag:--cache-control CACHING_DIRECTIVES
  • Optional : Gibt Darstellungsinformationen an (DIRECTIVES).
    • Flag:--content-disposition DIRECTIVES
  • Optional : Gibt die Inhaltskodierung (CONTENT_ENCODING) des Objekts an.
    • Flag:--content-encoding CONTENT_ENCODING
  • Optional : Die SPRACHE, in der der Inhalt verfasst ist.
    • Flag:--content-language LANGUAGE
  • Optional : Ein Standard-MIME-Typ, der das Format der Objektdaten beschreibt.
    • Flag:--content-type MIME
  • Optional : Eine MAP mit den zu speichernden Metadaten.
    • Flag:--metadata MAP JSON-Syntax: Das Flag --metadata verwendet das Präfix file://, das zum Laden der JSON-Struktur aus der angegebenen Datei verwendet wird.

  {
    "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 : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Vorhandenes Bucket löschen

• Aktion: Löschen eines in einer Instanz von IBM Cloud Object Storage vorhandenen Buckets.
• Verwendung: ibmcloud cos bucket-delete --bucket BUCKET_NAME [--region REGION] [--force] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Bei diesem Vorgang wird keine Bestätigung abgefragt.
    • Flag:--force
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

CORS für Bucket löschen

• Aktion: Löschen der CORS-Konfiguration für ein Bucket im IBM Cloud Object Storage-Konto eines Benutzers.
• Verwendung: ibmcloud cos bucket-cors-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Statische Websitekonfiguration löschen

• Aktion: Entfernt die statische Websitekonfiguration eines Buckets.
• Verwendung: ibmcloud cos bucket-website-delete --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Objekt löschen

• Aktion: Löschen eines Objekts aus einem Bucket im IBM Cloud Object Storage-Konto eines Benutzers.
• Verwendung: ibmcloud cos object-delete --bucket BUCKET_NAME --key KEY [--region REGION] [--force] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Bei diesem Vorgang wird keine Bestätigung abgefragt.
    • Flag:--force
    • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
      • Flag:--output FORMAT

Mehrere Objekte löschen

• Aktion: Löschen mehrerer Objekte aus einem Bucket im IBM Cloud Object Storage-Konto eines Benutzers.

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

• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Eine STRUKTUR, bei der entweder die Kurzform oder JSON-Syntax verwendet wird.
    • Flag:--delete STRUCTURE
    • Syntax der Kurzform: --delete 'Objects=[{Key=string},{Key=string}],Quiet=boolean'

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

      Der Befehl --delete verwendet eine JSON-Struktur, um die zu löschenden Objekte aufzulisten. In diesem Beispiel wird das Präfix file:// zum Laden der JSON-Struktur aus der angegebenen Datei verwendet.

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

  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Objekt herunterladen

• Aktion: Herunterladen eines Objekts aus einem Bucket im IBM Cloud Object Storage-Konto eines Benutzers.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Das Objekt wird nur zurückgegeben, wenn sein Entity-Tag (ETag) mit dem angegebenen ETAG übereinstimmt; andernfalls wird ein 412 zurückgegeben (Voraussetzung nicht erfüllt).
    • Flag:--if-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP geändert wurde; andernfalls wird ein 304 (nicht geändert) zurückgegeben.
    • Flag:--if-modified-since TIMESTAMP
  • Optional : Das Objekt wird nur dann zurückgegeben, wenn sich sein Entity-Tag (ETag) von dem angegebenen ETAG unterscheidet; andernfalls wird ein 304 (not modified) zurückgegeben.
    • Flag:--if-none-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP nicht geändert wurde; andernfalls wird ein 412 zurückgegeben (Vorbedingung nicht erfüllt).
    • Flag:--if-unmodified-since TIMESTAMP
  • Optional : Lädt die angegebenen RANGE-Bytes eines Objekts herunter.
    • Flag:--range RANGE
  • Optional : Legt den Cache-Control-Header der Antwort fest.
    • Flag:--response-cache-control HEADER
  • Optional : Legt den HEADER „Content-Disposition“ der Antwort fest.
    • Flag:--response-content-disposition HEADER
  • Optional : Legt den HEADER „Content-Encoding“ der Antwort fest.
    • Flag:--response-content-encoding HEADER
  • Optional : Legt den HEADER „Content-Language“ der Antwort fest.
    • Flag:--response-content-language HEADER
  • Optional : Legt den HEADER „Content-Type“ der Antwort fest.
    • Flag:--response-content-type HEADER
  • Optional : Legt den „Expires“-HEADER der Antwort fest.
    • Flag:--response-expires HEADER
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT
  • Optional : Der Speicherort, an dem der Inhalt des Objekts gespeichert werden soll. Wenn dieser Parameter nicht angegeben ist, verwendet das Programm die Standardposition.
    • Parameter: OUTFILE

Bucket suchen

• Aktion: Ermitteln der Region und Klasse eines Buckets in einer Instanz von IBM Cloud Object Storage.
• Verwendung: ibmcloud cos bucket-location-get --bucket BUCKET_NAME [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Klasse eines Buckets abrufen

• Aktion: Ermitteln der Klasse eines Buckets in einer Instanz von IBM Cloud Object Storage.
• Verwendung: ibmcloud cos bucket-class-get --bucket BUCKET_NAME [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

CORS für Bucket abrufen

• Aktion: Zurückgeben der CORS-Konfiguration für das Bucket im IBM Cloud Object Storage-Konto eines Benutzers.
• Verwendung: ibmcloud cos bucket-cors-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Header eines Buckets abrufen

• Aktion: Ermitteln, ob ein Bucket in einer Instanz von IBM Cloud Object Storage vorhanden ist.
• Verwendung: ibmcloud cos bucket-head --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Mehrteiligen Upload ausführen

• Aktion: Ausführen der Instanz eines mehrteiligen Uploads durch Assemblieren der gegenwärtig hochgeladenen Teile und Hochladen der Datei in das Bucket im IBM Cloud Object Storage-Konto des Benutzers.
• Verwendung: ibmcloud cos multipart-upload-complete --bucket BUCKET_NAME --key KEY --upload-id ID --multipart-upload STRUCTURE [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Der SCHLÜSSEL des Objekts.

    • Flag:--key KEY

  • Die Upload-ID, die den mehrteiligen Upload angibt.

    • Flag:--upload-id ID

  • Die STRUKTUR für MultipartUpload, die festgelegt werden soll.

    • Flag:--multipart-upload STRUCTURE
    • Syntax der Kurzform: --multipart-upload 'Parts=[{ETag=string,PartNumber=integer},{ETag=string,PartNumber=integer}]'

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

      Der Befehl --multipart-upload erfordert eine JSON-Struktur, die diejenigen Teile des mehrteiligen Uploads beschreibt, aus denen die vollständige Datei neu assembliert werden soll. In diesem Beispiel wird das Präfix file:// zum Laden der JSON-Struktur aus der angegebenen Datei verwendet.

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

  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.

    • Flag:--region REGION

  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.

    • Flag:--output FORMAT

Programm konfigurieren

• Aktion: Konfigurieren der Vorgaben für das Programm.
• Verwendung: ibmcloud cos config [COMMAND]
• Befehle:
  • Zwischen HMAC- und IAM-Authentifizierung wechseln.
    • Befehl: auth
  • CRN in der Konfiguration speichern.
    • Befehl: crn
  • Standarddownloadposition in der Konfiguration speichern.
    • Befehl: ddl
  • HMAC-Berechtigungsnachweise in der Konfiguration speichern.
    • Befehl: hmac
  • Konfiguration auflisten.
    • Befehl: list
  • Standardregion in der Konfiguration speichern.
    • Befehl: region
  • Wechseln Sie zwischen den Stilen „ VHost “ und „Path URL “.
    • Befehl: url-style
  • Standardserviceendpunkt festlegen.
    • Befehl: endpoint-url

      • Parameter:

        • --list zeigt den aktuellen Standardserviceendpunkt an, wenn dieser festgelegt wurde. Andernfalls ist er leer.
        • --url some.end.point.url ändert den Serviceendpunkt in den angegebenen Wert.
        • --clear entfernt den standardmäßig eingestellten Service-Endpunkt URL.

Statische Websitekonfiguration abrufen

• Aktion: Ruft die statische Websitekonfiguration eines Buckets ab.
• Verwendung: ibmcloud cos bucket-website-get --bucket BUCKET_NAME [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Header eines Objekts abrufen

• Aktion: Ermitteln, ob eine Datei in einem Bucket im IBM Cloud Object Storage-Konto eines Benutzers vorhanden ist.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Das Objekt wird nur zurückgegeben, wenn sein Entity-Tag (ETag) mit dem angegebenen ETAG übereinstimmt; andernfalls wird ein 412 zurückgegeben (Voraussetzung nicht erfüllt).
    • Flag:--if-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP geändert wurde; andernfalls wird ein 304 (nicht geändert) zurückgegeben.
    • Flag:--if-modified-since TIMESTAMP
  • Optional : Das Objekt wird nur dann zurückgegeben, wenn sich sein Entity-Tag (ETag) von dem angegebenen ETAG unterscheidet; andernfalls wird ein 304 (not modified) zurückgegeben.
    • Flag:--if-none-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP nicht geändert wurde; andernfalls wird ein 412 zurückgegeben (Vorbedingung nicht erfüllt).
    • Flag:--if-unmodified-since TIMESTAMP
  • Lädt die Byte für den angegebenen BEREICH eines Objekts herunter.
    • Flag:--range RANGE
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Alle Buckets auflisten

• Aktion: Ausgeben einer Liste aller Buckets im IBM Cloud Object Storage-Konto eines Benutzers. Buckets können sich in unterschiedlichen Regionen befinden.
• Verwendung: ibmcloud cos buckets [--ibm-service-instance-id ID] [--output FORMAT]
  • Beachten Sie, das Sie einen Cloudressourcennamen (CRN) angeben müssen, wenn Sie die IAM-Authentifizierung verwenden. Dies kann mit dem Befehl ibmcloud cos config crn festgelegt werden.
• Parameter, die angegeben werden müssen:
  • Es müssen keine Parameter angegeben werden.
    • Optional : Legt die Instanz-ID des „ IBM “-Dienstes in der Anfrage fest.
      • Flag:--ibm-service-instance-id
    • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
      • Flag:--output FORMAT

In Bearbeitung befindliche mehrteilige Uploads auflisten

• Aktion: Auflisten der in Bearbeitung befindlichen mehrteiligen Uploads.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Ein TRENNZEICHEN ist ein Zeichen, mit dem Sie Schlüssel gruppieren können.
    • Flag:--delimiter DELIMITER
  • Optional : Anforderung, die Objektschlüssel in der Antwort zu verschlüsseln, sowie Angabe der zu verwendenden Verschlüsselungsmethode.
    • Flag:--encoding-type METHOD
  • Optional : Beschränkt die Antwort auf Schlüssel, die mit dem angegebenen PREFIX beginnen.
    • Flag:--prefix PREFIX
  • Optional : Zusammen mit „upload-id-marker“ legt dieser Parameter fest, ab welchem Teil des Multipart-Uploads die Auflistung beginnen soll.
    • Flag:--key-marker value
  • Optional : Legt zusammen mit dem Schlüssel-Marker fest, ab welchem mehrteiligen Upload die Auflistung beginnen soll. Wenn 'key-marker' nicht angegeben ist, wird der Parameter 'upload-id-marker' ignoriert.
    • Flag:--upload-id-marker value
  • Optional : Die SIZE jeder Seite, die im Serviceaufruf abgerufen werden soll. Diese Angabe hat keine Auswirkungen auf die Anzahl von Elementen, die in der Ausgabe des Befehls zurückgegeben werden. Die Festlegung einer kleineren Seitengröße führt zu mehr Aufrufen an den Service, wobei in jedem Aufruf weniger Elemente zurückgegeben werden. Dadurch kann verhindert werden, dass die Serviceaufrufe nach einer bestimmten Zeit abbrechen. (Standardwert: 1000).
    • Flag:--page-size SIZE
  • Optional : Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert überschreitet, wird in der Ausgabe des Befehls ein 'NextToken'-Wert angegeben. Um die Paginierung fortzusetzen, geben Sie den Wert „ NextToken “ im Argument „starting-token“ eines nachfolgenden Befehls an. (Standardwert: 0).
    • Flag:--max-items NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Objekte auflisten

• Aktion: Auflisten der in einem Bucket im IBM Cloud Object Storage-Konto eines Benutzers vorhandenen Dateien. Diese Operation ist gegenwärtig auf die 1000 zuletzt erstellten Objekte beschränkt und lässt kein Filtern zu.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Ein TRENNZEICHEN ist ein Zeichen, mit dem Sie Schlüssel gruppieren können.
    • Flag:--delimiter DELIMITER
  • Optional : Anforderung, die Objektschlüssel in der Antwort zu verschlüsseln, sowie Angabe der zu verwendenden Verschlüsselungsmethode.
    • Flag:--encoding-type METHOD
  • Optional : Beschränkt die Antwort auf Schlüssel, die mit dem angegebenen PREFIX beginnen.
    • Flag:--prefix PREFIX
  • Optional : Ein TOKEN, um anzugeben, wo die Paginierung beginnen soll. Dabei handelt es sich um den 'NextToken'-Wert einer zuvor abgeschnittenen Antwort.
    • Flag:--starting-token TOKEN
  • Optional : Die SIZE jeder Seite, die im Serviceaufruf abgerufen werden soll. Diese Angabe hat keine Auswirkungen auf die Anzahl von Elementen, die in der Ausgabe des Befehls zurückgegeben werden. Die Festlegung einer kleineren Seitengröße führt zu mehr Aufrufen an den Service, wobei in jedem Aufruf weniger Elemente zurückgegeben werden. Dadurch kann verhindert werden, dass die Serviceaufrufe nach einer bestimmten Zeit abbrechen. (Standardwert: 1000)
    • Flag:--page-size SIZE
  • Optional : Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert überschreitet, wird in der Ausgabe des Befehls ein 'NextToken'-Wert angegeben. Um die Paginierung fortzusetzen, geben Sie den Wert „ NextToken “ im Argument „starting-token“ eines nachfolgenden Befehls an. (Standard: 0)
    • Flag:--max-items NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Listenobjekte v2

• Aktion: Alle Objekte in einem bestimmten Bucket auflisten.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Ein TRENNZEICHEN ist ein Zeichen, mit dem Sie Schlüssel gruppieren können.
    • Flag:--delimiter DELIMITER
  • Optional : Anforderung, die Objektschlüssel in der Antwort zu verschlüsseln, sowie Angabe der zu verwendenden Verschlüsselungsmethode.
    • Flag:--encoding-type METHOD
  • Optional : Beschränkt die Antwort auf Schlüssel, die mit dem angegebenen PREFIX beginnen.
    • Flag:--prefix PREFIX
  • Optional : Ein TOKEN, um anzugeben, wo die Paginierung beginnen soll. Dabei handelt es sich um den 'NextToken'-Wert einer zuvor abgeschnittenen Antwort.
    • Flag:--starting-token TOKEN
  • Optional : Die SIZE jeder Seite, die im Serviceaufruf abgerufen werden soll. Diese Angabe hat keine Auswirkungen auf die Anzahl von Elementen, die in der Ausgabe des Befehls zurückgegeben werden. Die Festlegung einer kleineren Seitengröße führt zu mehr Aufrufen an den Service, wobei in jedem Aufruf weniger Elemente zurückgegeben werden. Dadurch kann verhindert werden, dass die Serviceaufrufe nach einer bestimmten Zeit abbrechen. (Standardwert: 1000)
    • Flag:--page-size SIZE
  • Optional : Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert überschreitet, wird in der Ausgabe des Befehls ein 'NextToken'-Wert angegeben. Um die Paginierung fortzusetzen, geben Sie den Wert „ NextToken “ im Argument „starting-token“ eines nachfolgenden Befehls an. (Standard: 0)
    • Flag:--max-items NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT
  • Optional : Der boolesche Wert ist standardmäßig in „ listV2 “ nicht vorhanden. Wenn Sie das Feld „owner“ mit jedem Schlüssel im Ergebnis zurückgeben möchten, setzen Sie den Wert für „fetch owner field“ auf „true“.
    • Flag:--fetch-owner Boolean
  • Optional : Unter „Start After“ geben Sie an, ab welcher Stelle „ S3 “ mit der Auflistung beginnen soll. S3 startet die Auflistung nach diesem angegebenen Schlüssel. StartAfter kann ein beliebiger Schlüssel im Bucket sein.
    • Flag:--start-after Start After
  • Veraltet : Die Ausgabe erfolgt im rohen JSON-Format.
    • Flag:--json

Teile auflisten

• Aktion: Ausgeben von Informationen zu einer in Bearbeitung befindlichen Instanz eines mehrteiligen Uploads.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Die Upload-ID, die den mehrteiligen Upload angibt.
    • Flag:--upload-id ID
  • Gibt den WERT der Teilnummer an, nach dem die Auflistung beginnt. (Standardwert: 1)
    • Flag:--part-number-marker VALUE
  • Optional : Die SIZE jeder Seite, die im Serviceaufruf abgerufen werden soll. Diese Angabe hat keine Auswirkungen auf die Anzahl von Elementen, die in der Ausgabe des Befehls zurückgegeben werden. Die Festlegung einer kleineren Seitengröße führt zu mehr Aufrufen an den Service, wobei in jedem Aufruf weniger Elemente zurückgegeben werden. Dadurch kann verhindert werden, dass die Serviceaufrufe nach einer bestimmten Zeit abbrechen. (Standardwert: 1000)
    • Flag:--page-size SIZE
  • Optional : Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen. Wenn die Gesamtzahl der verfügbaren Elemente den angegebenen Wert überschreitet, wird in der Ausgabe des Befehls ein 'NextToken'-Wert angegeben. Um die Paginierung fortzusetzen, geben Sie den Wert „ NextToken “ im Argument „starting-token“ eines nachfolgenden Befehls an. (Standard: 0)
    • Flag:--max-items NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

CORS für Bucket festlegen

• Aktion: Festlegen der CORS-Konfiguration für ein Bucket im IBM Cloud Object Storage-Konto des Benutzers.

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

• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Eine STRUCTURE in JSON-Syntax in einer Datei.
    • Flag:--cors-configuration STRUCTURE

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

      Der Befehl --cors-configuration nimmt eine JSON-Struktur entgegen, die die Konfiguration von CORS beschreibt. In diesem Beispiel wird das Präfix file:// zum Laden der JSON-Struktur aus der angegebenen Datei verwendet.

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

  • Optional : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Objekt mit 'Put' hochladen

• Aktion: Hochladen eines Objekts in ein Bucket im IBM Cloud Object Storage-Konto eines Benutzers.

• Verwendung: 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]

• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Speicherort der Objektdaten (FILE_PATH).
    • Flag:--body FILE_PATH
  • Optional : Legt „ CACHING_DIRECTIVES “ für die Anfrage- und Antwortkette fest.
    • Flag:--cache-control CACHING_DIRECTIVES
  • Optional : Gibt Darstellungsinformationen an (DIRECTIVES).
    • Flag:--content-disposition DIRECTIVES
  • Optional : Gibt die Inhaltskodierung (CONTENT_ENCODING) des Objekts an.
    • Flag:--content-encoding CONTENT_ENCODING
  • Optional : Die SPRACHE, in der der Inhalt verfasst ist.
    • Flag:--content-language LANGUAGE
  • Optional : GRÖSSE des Hauptteils in Byte. Dieser Parameter ist nützlich, wenn die Größe des Hauptteils nicht automatisch ermittelt werden kann. (Standardwert: 0)
    • Flag:--content-length SIZE
  • Optional : Der 128-Bit- MD5-Digest der Daten nach dem „ base64-encoded “-Verfahren.
    • Flag:--content-md5 MD5
  • Optional : Ein Standard-MIME-Typ, der das Format der Objektdaten beschreibt.
    • Flag:--content-type MIME
  • Optional : Eine MAP mit den zu speichernden Metadaten.
    • Flag:--metadata MAP JSON-Syntax: Das Flag --metadata verwendet das Präfix file://, das zum Laden der JSON-Struktur aus der angegebenen Datei verwendet wird.

  {
    "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 : Die REGION, in der sich der Bucket befindet. Ist dieses Flag nicht angegeben, verwendet das Programm die Standardoption, die in der Konfiguration angegeben ist.
    • Flag:--region REGION
  • Optional : Das Ausgabeformat kann nur „json“ oder „text“ sein.
    • Flag:--output FORMAT

Mehrteilige Uploads manuell steuern

Die CLI von „ IBM Cloud Object Storage “ bietet Benutzern die Möglichkeit, große Dateien in mehreren Teilen hochzuladen, indem sie die Funktionen für den mehrteiligen Upload unter AWS nutzen. Um einen neuen mehrteiligen Upload zu starten, führen Sie den Befehl „ multipart-upload-create “ aus, der die Upload-ID der neuen Upload-Instanz zurückgibt. Um mit dem Uploadprozess fortfahren zu können, müssen Sie die Upload-ID für jeden nachfolgenden Befehl speichern. Für diesen Befehl müssen Sie einen MD5-Hash generieren:

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

Nachdem Sie den Befehl multipart-upload-complete ausgeführt haben, führen Sie part-upload für jede Dateikomponente aus, die Sie hochladen wollen. Bei mehrteiligen Uploads muss jeder Dateiteil (mit Ausnahme des letzten Teils) mindestens 5 MB groß sein. Wenn Sie eine Datei in einzelne Teile aufteilen möchten, führen Sie in einem Terminalfenster den Befehl split aus. Wenn Sie zum Beispiel über eine Datei namens TESTFILE verfügen, die eine Größe von 13 MB hat und sich auf Ihrem Desktop befindet, und Sie möchten diese Datei in einzelne Dateiteile von je 5 MB aufteilen, führen Sie den Befehl split -b 3m ~/Desktop/TESTFILE part-file- aus. Durch diesen Befehl werden insgesamt drei Dateiteile namens part-file-aa, part-file-ab und part-file-ac generiert: zwei Dateiteile von je 5 MB und ein Dateiteil von 3 MB. 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-Datendatei.

{
    "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."
    }
    ]
}

Fügen Sie nach Bedarf weitere Einträge zu dieser JSON-Vorlage hinzu.

Um den Status Ihres mehrteiligen Uploads abzurufen, können Sie jederzeit den Befehl „ part-list “ ausführen und dabei den Bucket-Namen, den Schlüssel und die Upload-ID angeben. Hier werden die Rohdaten zu Ihrer mehrteiligen Upload-Instanz ausgegeben. Sobald Sie das Hochladen aller Teile der Datei abgeschlossen haben, führen Sie den Befehl „ multipart-upload-complete “ mit den erforderlichen Parametern aus. Sofern alles wie vorgesehen funktioniert, erhalten Sie eine Bestätigung, dass die Datei erfolgreich in das gewünschte Bucket hochgeladen wurde.

Konfiguration der Objektsperre

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

Objektaufbewahrung

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

Rechtliche Rückstellung für Objekt

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

Bucketreplikation konfigurieren

Konfiguration für die Konfiguration eines replizierten Buckets.

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

Nächste Schritte

Da jede Prozedur immer genau wie geplant verläuft, haben Sie möglicherweise keinen der allgemeinen Header und Fehlercodes gesehen. Weitere Referenzinformationen finden Sie in der API-Referenz.