IAM-Authentifizierung

Wenn Sie die IAM-Authentifizierung verwenden, müssen Sie Ihren Client mit einer Instanz-ID konfigurieren, um bestimmte Befehle nutzen zu können. Weitere Informationen zum Erstellen einer Serviceinstanz finden Sie unter Erstellen einer Serviceinstanz. Um die Instanz-ID abzurufen ibmcloud resource service-instance <INSTANCE_NAME> --id, geben Sie ein und ersetzen Sie dabei durch <INSTANCE_NAME> den eindeutigen Alias, den Sie Ihrer Service-Instanz zugewiesen haben. In den folgenden Beispielen ist der Wert 8f275e7b-c076-49e2-b9c5-f985704cf678 eine Beispiel-Instanz-ID.

Rufen Sie zuerst den CRN und die ID mit dem Namen Ihrer Instanz ab. Stellen Sie sicher, dass Sie Anführungszeichen (') für Ihren Instanznamen verwenden und dass Sie bei IBM Cloudangemeldet sind. Es wird nur das letzte Teil der CRN benötigt, das Teil nach ::.

$ 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

Legen Sie den CRN mit dem Befehl ibmcloud cos config crn fest. Möglicherweise werden Sie vor dem Überschreiben gewarnt. Wenn Sie den CRN nicht interaktiv bereitstellen wollen, können Sie ihn mit dem Flag --crn in demselben Befehl angeben.

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

Überprüfen Sie die Konfiguration:

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

Alternativ können Sie auch die webbasierte Konsole öffnen, in der Seitenleiste Serviceberechtigungsnachweise auswählen und eine neue Gruppe von Berechtigungsnachweisen erstellen (oder eine vorhandene Berechtigungsnachweisdatei anzeigen, die Sie bereits erstellt haben).

HMAC-Berechtigungsnachweise

Auf Wunsch können Sie an Stelle des API-Schlüssels die HMAC-Berechtigungsnachweise einer Service-ID verwenden. Führen Sie in diesem Fall ibmcloud cos config hmac aus, um die HMAC-Berechtigungsnachweise einzugeben, und wechseln Sie dann durch Eingabe von ibmcloud cos config auth die Berechtigungsmethode.

Wenn Sie die Tokenauthentifizierung in Verbindung mit Ihrem eigenen API-Schlüssel verwenden möchten, ist keine Eingabe von Berechtigungsnachweisen erforderlich, denn das Programm authentifiziert Sie automatisch.

Sie können jederzeit ibmcloud cos config auth eingeben, um zwischen HMAC-und IAM-Authentifizierung zu wechseln. Weitere Informationen zur Authentifizierung und Berechtigung in IBM Cloudfinden Sie in der Dokumentation zu Identity and Access Management.

Objekte mit Aspera herunterladen

• Vorgehensweise: Laden Sie ein Objekt mithilfe der Hochgeschwindigkeitsübertragung Aspera aus einem Bucket herunter.
• Verwendung: ibmcloud cos aspera-download --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [OUTFILE]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der Schlüssel des Objekts, das heruntergeladen werden soll.
    • 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 : Das Ausgabeformat kann nur json oder text sein.
    • Flag:--output FORMAT
  • Optional : Lokaler Pfad, unter dem die heruntergeladene Datei gespeichert wird. Sofern nicht anders angegeben, wird die Datei unter dem Dateinamen des Objektschlüssels im Standard-Download-Verzeichnis gespeichert.
    • Argument: OUTFILE

Beispiel:

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

Laden Sie Dateien oder Verzeichnisse mithilfe von Aspera hoch

• Vorgehensweise: Laden Sie eine Datei oder ein Verzeichnis mithilfe der Hochgeschwindigkeitsübertragung Aspera in einen Bucket hoch.
• Verwendung: ibmcloud cos aspera-upload --bucket BUCKET_NAME --key KEY [--region REGION] [--output FORMAT] [SRCFILE]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der KEY (Name des Zielobjekts) im Bucket.
    • 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 : Das Ausgabeformat kann nur json oder text sein.
    • Flag:--output FORMAT
  • Optional : Lokaler Pfad der hochzuladenden Datei oder des Verzeichnisses.
    • Argument: SRCFILE

Beispiel:

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

Lebenszykluskonfiguration für ein Bucket definieren

• Aktion: Konfigurieren Sie den Lebenszyklus eines Buckets.
• Verwendung: ibmcloud cos bucket-lifecycle-configuration-put --bucket BUCKET_NAME --lifecycle-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Eine STRUCTURE unter Verwendung der JSON-Syntax. Das Präfix file:// kann verwendet werden, um die JSON-Struktur aus einer Datei zu laden, z. B. --lifecycle-configuration file://<filename.json>.

    • Flag:--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
      	      }
      	    }
      	  ]
      	}
      

  • 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

Beispiel – Verwendung einer Datei:

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

Beispiel – inline:

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

Lebenszykluskonfiguration für ein Bucket abrufen

• Aktion: Abrufen der Lebenszykluskonfiguration für einen Bucket.
• Verwendung: ibmcloud cos bucket-lifecycle-configuration-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

Beispiel:

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

Lebenszykluskonfiguration aus einem Bucket löschen

• Aktion: Löschen der Lebenszykluskonfiguration aus einem Bucket.
• Verwendung: ibmcloud cos bucket-lifecycle-configuration-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

Beispiel:

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

Put-Bucket-Replikation

• Aktion: Konfigurieren Sie die Replikation für einen Bucket.
• Verwendung: ibmcloud cos bucket-replication-put --bucket BUCKET_NAME --replication-configuration STRUCTURE [--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
  • Eine STRUCTURE unter Verwendung der JSON-Syntax.

    • Flag:--replication-configuration STRUCTURE

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

Beispiel – Verwendung einer Datei:

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

Beispiel – inline:

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

Bucketreplikation abrufen

• Aktion: Abrufen der Replikationskonfiguration für einen Bucket.
• Verwendung: ibmcloud cos bucket-replication-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

Beispiel:

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

Bucketreplikation löschen

• Aktion: Löschen der Replikationskonfiguration aus einem Bucket.
• Verwendung: ibmcloud cos bucket-replication-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

Beispiel:

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

Auflistung von Replikationsfehlern für einen Bucket

• Aktion: Auflistung von Replikationsfehlern für einen Bucket.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Ein TOKEN, mit dem angegeben wird, wo die nächste Seite mit Ergebnissen beginnen soll.
    • Flag:--starting-token TOKEN
  • Optional : Anforderung, die Objektschlüssel in der Antwort zu verschlüsseln, und Angabe der zu verwendenden Verschlüsselungsmethode.
    • Flag:--encoding-type METHOD
  • Optional : Filtert die Ergebnisse so, dass nur Fehler berücksichtigt werden, bei denen der erste Synchronisierungsversuch vor dem angegebenen TIMESTAMP (im ISO 8601-Format) erfolgte.
    • Flag:--first-sync-attempted-before TIMESTAMP
  • Optional : Die maximale ANZAHL der zurückzugebenden Schlüssel.
    • Flag:--max-keys 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

Beispiel:

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

Replikation für fehlgeschlagene Objekte in einem Bucket erneut versuchen

• Aktion: Wiederholen Sie die Replikation für fehlgeschlagene Objekte in einem Bucket.
• Verwendung: ibmcloud cos bucket-replication-reattempt --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

Beispiel:

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

Versionskonfiguration für ein Bucket festlegen

• Aktion: Konfigurieren Sie die Versionsverwaltung für einen Bucket.
• Verwendung: ibmcloud cos bucket-versioning-put --bucket BUCKET_NAME --versioning-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Eine STRUCTURE in JSON-Syntax, die den Versionsstatus angibt. Gültige Werte für Status sind und Enabled Suspended.

    • Flag:--versioning-configuration STRUCTURE

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

  • 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

Beispiel:

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

Versionskonfiguration für ein Bucket abrufen

• Aktion: Die Versionskonfiguration für einen Bucket abrufen.
• Verwendung: ibmcloud cos bucket-versioning-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

Beispiel:

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

Erstellen Sie einen neuen Bucket mit Key Protect

• Vorgehensweise: Erstellen Sie einen Bucket mit Key Protect in einer IBM Cloud Object Storage-Instanz.
• Verwendung: 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]
  • 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
  • Der CUSTOMERROOTKEYCRN des KMS-Stammschlüssels, der dem Bucket zur Datenverschlüsselung zugeordnet werden soll.
    • Flag:--kms-root-key-crn CUSTOMERROOTKEYCRN
  • Optional : Der ALGORITHMUS und die GRÖSSE, die mit dem mithilfe von Key Protect gespeicherten Verschlüsselungsschlüssel verwendet werden sollen.
    • Flag:--kms-encryption-algorithm ALGORITHM
  • Optional : Der Name der Klasse.
    • Flag:--class CLASS_NAME
  • 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
  • (Veraltet): Die Ausgabe erfolgt im rohen JSON-Format.
    • Flag:--json

Beispiel:

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

Neues Bucket mit Hyper Protect Crypto Services erstellen

• Aktion: Erstellen Sie ein neues Bucket mit Hyper Protect Crypto Services.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der CUSTOMERROOTKEYCRN des KMS-Stammschlüssels, der dem Bucket zur Datenverschlüsselung zugeordnet werden soll.
    • Flag:--kms-root-key-crn CUSTOMERROOTKEYCRN
  • Optional : Der ALGORITHMUS und die GRÖSSE, die mit dem mithilfe von Key Protect gespeicherten Verschlüsselungsschlüssel verwendet werden sollen.
    • Flag:--kms-encryption-algorithm ALGORITHM
  • Optional : Der Name der Klasse.
    • Flag:--class CLASS_NAME
  • 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
  • (Veraltet): Die Ausgabe erfolgt im rohen JSON-Format.
    • Flag:--json

Beispiel:

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

Objekte mit S3Manager herunterladen

• Aktion: Gleichzeitiges Herunterladen von Objekten von S3.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:
  • Der Name (BUCKETNAME) des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Optional : Die Anzahl der Go-Routinen, die pro Aufruf parallel gestartet werden sollen, um Teile herunterzuladen. Der Standardwert ist 5.
    • Flag:--concurrency value
  • Optional : Die Puffergröße (in Byte), die beim Puffern von Daten in Blöcke und beim Senden dieser Blöcke als Teile an S3 verwendet werden soll. Die zulässige Mindestgröße für Teile beträgt 5 MB.
    • Flag:--part-size SIZE
  • Optional : Das Objekt wird nur zurückgegeben,ETag wenn sein Entity-Tag mit dem ETAG angegebenen übereinstimmt; andernfalls wird ein 412 zurückgegeben (Vorbedingung 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 zurückgegeben, wenn sich sein Entity-Tag(ETag) von dem ETAG angegebenen unterscheidet; andernfalls wird ein 304 (nicht geändert) 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 angegebene Anzahl von Bytes (RANGE) eines Objekts herunter. Weitere Informationen zum HTTP-Range-Header finden Sie unter HTTP-Range-Header-Spezifikation.
    • 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 Content-Type-Header 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

Erweiterte Auflistung von Buckets

• 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-extended [--ibm-service-instance-id ID] [--marker KEY] [--prefix PREFIX] [--page-size SIZE] [--max-items NUMBER] [--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 : Gibt den Schlüssel an, mit dem bei der Auflistung von Objekten in einem Bucket begonnen werden soll.
    • Flag:--marker KEY
  • Optional : Beschränkt die Antwort auf Schlüssel, die mit dem angegebenen PREFIX beginnen.
    • Flag:--prefix PREFIX
  • Optional : Die GRÖSSE 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. Dies kann dazu beitragen, dass keine Zeitlimitüberschreitungen für Serviceaufrufe auftreten.
    • Flag:--page-size SIZE
  • Optional : Die Gesamtanzahl der Elemente, die in der Ausgabe des Befehls zurückgegeben werden sollen.
    • Flag:--max-items NUMBER
  • Optional : Das Ausgabeformat kann nur json oder text sein.
    • Flag:--output FORMAT

Teil hochladen

• Aktion: Hochladen eines Teils einer Datei bei einer vorhandenen Instanz eines mehrteiligen Uploads.
• Verwendung: ibmcloud cos part-upload --bucket BUCKET_NAME --key KEY --upload-id ID --part-number NUMBER [--body FILE_PATH] [--region REGION] [--output FORMAT]
  • Beachten Sie, dass Sie die Nummer jedes hochgeladenen Dateiteils sowie ( ETag die die CLI für Sie ausgibt) für jeden Teil in einer JSON-Datei speichern müssen. Weitere Informationen enthält der 'Leitfaden für mehrteilige Uploads' weiter unten.
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets, bei dem der mehrteilige Upload stattfindet.
    • Flag:--bucket BUCKET_NAME
  • Der SCHLÜSSEL des Objekts.
    • Flag:--key KEY
  • Die Upload-ID, die den mehrteiligen Upload angibt.
    • Flag:--upload-id ID
  • TeilNUMMER des Teils, der hochgeladen wird. Dies ist eine positive ganze Zahl im Bereich von 1 bis 10.000. (Standardwert: 1)
    • Flag:--part-number NUMBER
  • Optional : Speicherort der Objektdaten (FILE_PATH).
    • Flag:--body FILE_PATH
  • 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

Kopie eines Teils hochladen

• Aktion: Hochladen eines Teils durch Kopieren von Daten aus einem vorhandenen Objekt.
• Verwendung: 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]
  • Beachten Sie, dass Sie die Nummer jedes hochgeladenen Dateiteils sowie ( ETag die die CLI für Sie ausgibt) für jeden Teil in einer JSON-Datei speichern müssen. Weitere Informationen enthält der 'Leitfaden für mehrteilige Uploads'.
• 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
  • TeilNUMMER des Teils, der hochgeladen wird. Hierbei handelt es sich um eine positive Ganzzahl zwischen 1 und 10.000.
    • Flag:--part-number PART_NUMBER
  • (SOURCE) 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 : Kopiert das Objekt, wenn dessen Entity-Tag mit Etag``ETAG dem angegebenen Tag ü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 : Der Bereich der Bytes, die aus dem Quellobjekt kopiert werden sollen. Der Bereichswert im Format 'bytes=erster_wert-letzter_wert' verwenden, wobei 'erster_wert' und 'letzer_wert' die relativen Byteadressen mit der Basis null angeben, die kopiert werden sollen. Die Angabe 'bytes=0-9' gibt beispielweise an, dass die ersten zehn Byte der Quelle kopiert werden sollen. Ein Bereich kann nur kopiert werden, wenn die Größe des Quellenobjekts 5 MB überschreitet.
    • Flag:--copy-source-range value
  • 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 zurückstellen

• Aktion: Eine Aufbewahrungsverpflichtung für ein Objekt festlegen.
• Verwendung: ibmcloud cos object-legal-hold-put --bucket BUCKET_NAME --key KEY [--legal-hold 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
  • Eine STRUCTURE unter Verwendung der JSON-Syntax. Weitere Informationen finden Sie in der Dokumentation zuIBM Cloud.

    • Flag:--legalhold STRUCTURE

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

  • 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

Beispiel:

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

Rechtsrückstellung für Objekt abrufen

• Aktion: Eine Aufbewahrungsverfügung für ein Objekt erwirken.
• Verwendung: ibmcloud cos object-legal-hold-get --bucket BUCKET_NAME --key KEY [--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 : 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

Beispiel:

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

Beispielantwort:

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

Konfiguration der PUT-Objektsperre

In der Standardeinstellung können Tage und Jahre nicht gleichzeitig angegeben werden.

• Aktion: Konfigurieren Sie die Objektsperre für einen Bucket.
• Verwendung: ibmcloud cos object-lock-configuration-put --bucket BUCKET_NAME [--object-lock-configuration STRUCTURE] [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Eine STRUCTURE unter Verwendung der JSON-Syntax. Weitere Informationen finden Sie in der Dokumentation zuIBM Cloud.

    • Flag:--object-lock-configuration STRUCTURE

      	{
      	"ObjectLockEnabled": "Enabled",
      	"Rule": {
      		"DefaultRetention": {
      		"Mode": "COMPLIANCE",
      		"Days": integer,
      		"Years": 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

Beispiel:

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

Objektsperrkonfiguration abrufen

• Aktion: Abrufen der Objekt-Sperrkonfiguration für einen Bucket.
• Verwendung: ibmcloud cos object-lock-configuration-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

Beispiel:

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

Beispielantwort:

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

Aufbewahrungsdauer für Einreihungsobjekt

• Aktion: Festlegen der Aufbewahrungsdauer für ein Objekt.
• Verwendung: ibmcloud cos object-retention-put --bucket BUCKET_NAME --key KEY [--retention 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
  • Eine STRUCTURE unter Verwendung der JSON-Syntax. Weitere Informationen finden Sie in der Dokumentation zuIBM Cloud.

    • Flag:--retention STRUCTURE

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

  • 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

Beispiel:

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

Objektaufbewahrung abrufen

• Aktion: Aufbewahrungsdauer für ein Objekt abrufen.
• Verwendung: ibmcloud cos object-retention-get --bucket BUCKET_NAME --key KEY [--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 : 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

Beispiel:

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

Beispielantwort:

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

Tags für ein Objekt festlegen

• Aktion: Tags für ein Objekt festlegen.
• Verwendung: ibmcloud cos object-tagging-put --bucket BUCKET_NAME --key KEY --tagging STRUCTURE [--version-id VERSION_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

  • Eine STRUCTURE in JSON-Syntax, die den Tag-Satz enthält. Das Präfix file:// kann verwendet werden, um die JSON-Struktur aus einer Datei zu laden, z. B. --tagging file://<filename.json>.

    • Flag:--tagging STRUCTURE

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

  • Optional : Die VERSION_ID des zu kennzeichnenden Objekts. Sofern nicht anders angegeben, wird die aktuelle Version gekennzeichnet.

    • Flag:--version-id VERSION_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

Beispiel:

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

Tags für ein Objekt abrufen

• Aktion: Tags für ein Objekt abrufen.
• Verwendung: ibmcloud cos object-tagging-get --bucket BUCKET_NAME --key KEY [--version-id VERSION_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
  • Optional : Die VERSION_ID der spezifischen Objektversion, für die Tags abgerufen werden sollen.
    • Flag:--version-id VERSION_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

Beispiel:

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

Tags von einem Objekt entfernen

• Aktion: Tags von einem Objekt entfernen.
• Verwendung: ibmcloud cos object-tagging-delete --bucket BUCKET_NAME --key KEY [--version-id VERSION_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
  • Optional : Die VERSION_ID der spezifischen Objektversion, aus der Tags entfernt werden sollen.
    • Flag:--version-id VERSION_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

Beispiel:

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

Konfiguration einer Sperre der öffentlichen Zugriffsberechtigung in einem Bucket festlegen

• Aktion: Konfiguration der Sperre für den öffentlichen Zugriff auf einen Bucket festlegen.
• Verwendung: ibmcloud cos public-access-block-put --bucket BUCKET_NAME --public-access-block-configuration STRUCTURE [--region REGION] [--output FORMAT]
• Parameter, die angegeben werden müssen:

  • Der Name des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Eine STRUCTURE unter Verwendung der JSON-Syntax. Das Präfix file:// kann verwendet werden, um die JSON-Struktur aus einer Datei zu laden, z. B. --public-access-block-configuration file://<filename.json>.

    • Flag:--public-access-block-configuration STRUCTURE

      	{
      	  "BlockPublicAcls": true|false,
      	  "IgnorePublicAcls": true|false,
      	  "BlockPublicPolicy": true|false,
      	  "RestrictPublicBuckets": 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

Beispiel:

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

Konfiguration einer Sperre der öffentlichen Zugriffsberechtigung in einem Bucket abrufen

• Aktion: Konfiguration des öffentlichen Zugriffsblocks für einen Bucket abrufen.
• Verwendung: ibmcloud cos public-access-block-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

Beispiel:

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

Konfiguration einer Sperre der öffentlichen Zugriffsberechtigung aus einem Bucket entfernen

• Aktion: Konfiguration der Sperre für den öffentlichen Zugriff aus einem Bucket entfernen.
• Verwendung: ibmcloud cos public-access-block-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

Beispiel:

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

Objekte hochladen mit S3Manager

• Aktion: Laden Sie Objekte gleichzeitig in COS hoch.
• Verwendung: 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]
• Parameter, die angegeben werden müssen:

  • Der Name (BUCKETNAME) des Buckets.

    • Flag:--bucket BUCKET_NAME

  • Der SCHLÜSSEL des Objekts.

    • Flag:--key KEY

  • Der PFAD zu der Datei, die hochgeladen werden soll.

    • Flag:--file PATH

  • Optional : Die Anzahl der Go-Routinen, die pro Aufruf von Upload beim Senden von Teilen parallel gestartet werden sollen. Der Standardwert ist 5.

    • Flag:--concurrency value

  • Optional : Maximale Anzahl von PARTS, die auf S3 hochgeladen werden sollen; diese Seite berechnet die Teilgröße des hochzuladenden Objekts. Die Obergrenze liegt bei 10.000 Teilen.

    • Flag:--max-upload-parts PARTS

  • Optional : Die Puffergröße (in Byte), die beim Puffern von Daten in Blöcke und beim Senden dieser Blöcke als Teile an S3 verwendet werden soll. Die zulässige Mindestgröße für Teile beträgt 5 MB.

    • Flag:--part-size SIZE

  • Optional : Wenn dieser Wert auf true gesetzt wird, vermeidet das SDK bei einem Fehler den Aufruf von AbortMultipartUpload und belässt alle erfolgreich hochgeladenen Teile auf S3, damit sie manuell wiederhergestellt werden können.

    • Flag:--leave-parts-on-errors

  • Optional : Legt CACHING_DIRECTIVES für die Anfrage-/Antwortkette fest.

    • Flag:--cache-control CACHING_DIRECTIVES

  • Optional : Legt Darstellungsinformationen fest (DIRECTIVES).

    • Flag:--content-disposition DIRECTIVES

  • Optional : Gibt an, welche Inhaltskodierungen (CONTENT_ENCODING) auf das Objekt angewendet wurden und welche Dekodierungsmechanismen daher angewendet werden müssen, um den vom Header-Feld Content-Type referenzierten Medientyp zu erhalten.

    • Flag:--content-encoding CONTENT_ENCODING

  • Optional : Die SPRACHE, in der der Inhalt verfasst ist.

    • Flag:--content-language LANGUAGE

  • Optional : Größe des Hauptteils in Byte. Dieser Parameter ist nützlich, wenn die Größe des Hauptteils nicht automatisch bestimmt werden kann. ris useful when the size of the body cannot be determined automatically.

    • Flag:--content-length SIZE

  • Optional : Die 128-Bit- MD5-Zusammenfassung der Daten im base64-encoded-Format.

    • 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. Mit dem Präfix file:// kann die JSON-Struktur aus einer Datei geladen werden.

    • Flag:--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"
      	}
      

  • 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

bucket-exists

• Maßnahme: Warten Sie beim Abfragen mit auf den Empfang einer 200-Antwort head-bucket.
• Verwendung: ibmcloud cos wait bucket-exists --bucket BUCKET_NAME [--region REGION]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet.
    • Flag:--region REGION

Beispiel:

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

bucket-not-exists

• Maßnahme: Warten Sie, bis beim Abfragen mit eine 404-Antwort empfangen wird head-bucket.
• Verwendung: ibmcloud cos wait bucket-not-exists --bucket BUCKET_NAME [--region REGION]
• Parameter, die angegeben werden müssen:
  • Der Name des Buckets.
    • Flag:--bucket BUCKET_NAME
  • Optional : Die REGION, in der sich der Bucket befindet.
    • Flag:--region REGION

Beispiel:

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

object-exists

• Maßnahme: Warten Sie beim Abfragen mit auf den Empfang einer 200-Antwort head-object.
• Verwendung: 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]
• 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 nur dann zurückgeben, wenn sein Entity-Tag (ETag) mit dem angegebenen ETAG übereinstimmt.
    • Flag:--if-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP geändert wurde.
    • Flag:--if-modified-since TIMESTAMP
  • Optional : Das Objekt wird nur zurückgegeben, wenn sein ETag nicht mit dem angegebenen ETAG übereinstimmt.
    • Flag:--if-none-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP nicht geändert wurde.
    • Flag:--if-unmodified-since TIMESTAMP
  • Optional : Lädt den angegebenen Byte-BEREICH eines Objekts herunter.
    • Flag:--range RANGE
  • Optional : Teilenummer des zu lesenden Objekts.
    • Flag:--part-number NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet.
    • Flag:--region REGION

Beispiel:

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

Objekt existiert nicht

• Maßnahme: Warten Sie, bis beim Abfragen mit eine 404-Antwort empfangen wird head-object.
• Verwendung: 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]
• 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 nur dann zurückgeben, wenn sein Entity-Tag (ETag) mit dem angegebenen ETAG übereinstimmt.
    • Flag:--if-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP geändert wurde.
    • Flag:--if-modified-since TIMESTAMP
  • Optional : Das Objekt wird nur zurückgegeben, wenn sein ETag nicht mit dem angegebenen ETAG übereinstimmt.
    • Flag:--if-none-match ETAG
  • Optional : Das Objekt wird nur zurückgegeben, wenn es seit dem angegebenen TIMESTAMP nicht geändert wurde.
    • Flag:--if-unmodified-since TIMESTAMP
  • Optional : Lädt den angegebenen Byte-BEREICH eines Objekts herunter.
    • Flag:--range RANGE
  • Optional : Teilenummer des zu lesenden Objekts.
    • Flag:--part-number NUMBER
  • Optional : Die REGION, in der sich der Bucket befindet.
    • Flag:--region REGION

Beispiel:

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