Tagging von Objekten

Tags, die Ihre Objekte beschreiben, können über verschiedene Schnittstellen und Architekturen verwaltet werden. Über die Konsole wird eine grafische Benutzerschnittstelle bereitgestellt. Für die Verwendung der Befehlszeile sind Tools wie curl und das Wissen über die Interaktion mit Object Storageerforderlich.

Vorbereitende Schritte

Sie benötigen Folgendes:

• Ein IBM Cloud® Platform-Konto
• Eine -Instanz von IBM Cloud Object Storage und ein Bucket, das für diesen Zweck erstellt wurde.
• Ein IAM-API-Schlüssel mit Schreibzugriff auf Ihr Object Storage-Bucket oder Ihre Instanz.
• Entweder vorhandene oder neue Objekte, auf die Tags angewendet werden.

Tags lesen

Auf Tags kann in einer Instanz mit den entsprechenden Berechtigungen zugegriffen werden. Während die wahre Organisationskraft bei der Verwendung von Tags als Organisationsprinzip mit Ihnen skaliert wird, können Sie auch individuell auf Tags zugreifen.

Melden Sie sich bei der Konsolean und wählen Sie Ihre Instanz von IBM Cloud Object Storage und Ihr Bucket aus, in dem Ihre Daten dargestellt werden. Nachdem Sie Dateien in Ihr Bucket hochgeladen haben, können Sie Ihre Tags direkt vor Ort anzeigen und verwalten. Setzen Sie den Cursor auf die Auslassungspunkte am Ende einer beliebigen Zeile, die Ihre Daten darstellt (als Objekt gespeichert), und wählen Sie "Tags verwalten" aus den Optionen im Menü aus.

Eine ordnungsgemäß formatierte und authentifizierte "GET" -Anforderung mit dem Abfrageparameter ?tagging ist alles, was für den Zugriff auf die Tags für Ihre Objekte mit curl erforderlich ist. In den Beispielen hier werden Trägertokens verwendet, die mit diesem Beispiel generiert wurden. Neben der Bucket-ID und dem Objektschlüssel benötigen Sie auch den richtigen Endpunkt. Das resultierende XML-Objekt wird ebenfalls angezeigt, wobei das Element "Tag" für jeden Tag wiederholt wird, der dem Objekt zugeordnet ist. Wenn keine Tags vorhanden sind, gibt die Antwort XML mit einem leeren Element <TagSet /> zurück.

curl 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<Tagging xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <TagSet>
    <Tag>
      <Key>Example Key</Key>
      <Value>Value Example</Value>
    </Tag>
  </TagSet>
</Tagging>

Natürlich müssen sie erstellt werden, bevor Tags angezeigt werden können, woran wir uns weiter wenden.

Tags erstellen

Tags müssen den folgenden Einschränkungen entsprechen:

• Ein Objekt kann maximal 10 Tags haben
• Für jedes Objekt muss jeder Tagschlüssel eindeutig sein und jeder Tagschlüssel kann nur einen einzigen Wert haben.
• Mindestschlüssellänge-1 Unicode-Zeichen in UTF-8
• Maximale Schlüssellänge-128 Unicode-Zeichen in UTF-8
• Maximale Schlüsselbytegröße-256 Byte
• Mindestwertlänge-0 Unicode-Zeichen in UTF-8 (Tagwert kann leer sein)
• Maximale Wertlänge-256 Unicode-Zeichen in UTF-8
• Maximale Bytegröße-512 Byte
• Ein Tagschlüssel und -wert können aus alphanumerischen Zeichen (a-z,A-Z,0-9) und Leerzeichen, die in UTF-8dargestellt werden, sowie den folgenden Symbolen bestehen: _, ., *, ', -, :
• Bei Tagschlüsseln und -werten muss die Groß-/Kleinschreibung beachtet werden.
• ibm: kann nicht als Schlüsselpräfix für Tags verwendet

Wie bereits erwähnt, melden Sie sich bei Ihrer Instanz an und navigieren Sie zu dem Bucket und dem Objekt, das Sie mit einem Tag versehen möchten. Klicken Sie in der Anzeige, die angezeigt wird, wenn Sie "Tags verwalten" auswählen, zunächst auf die Schaltfläche "Tags hinzufügen +". Anschließend können Sie Tags hinzufügen, indem Sie wie gewünscht Text in die Felder key und value eingeben. Fügen Sie mehrere Tags gleichzeitig hinzu, indem Sie die soeben ausgeführten Schritte wiederholen.

Wenn Sie beim Abschließen Ihrer Änderungen nicht auf "Speichern" klicken, werden Sie in einem Dialogfeld an die Folgen erinnert. Das heißt, Änderungen werden verworfen, wenn sie nicht gespeichert werden.

Wie bereits erwähnt, müssen Sie sich authentifizieren, um Tags zu Ihren Daten hinzuzufügen. Wenn Sie Fragen zu Trägertokens haben, sehen Sie sich dieses Beispiel an. Beachten Sie auch hier die Abfragezeichenfolge für die Arbeit mit Tags: ?tagging.

curl -X "PUT" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain" \
--data "<Tagging><TagSet><Tag><Key>your key</Key><Value>your text</Value></Tag></TagSet></Tagging>"

Das Beispiel beschreibt wie gezeigt einen Tag mit einem key von 'source' und einem value von 'text' in der XML, die als Daten im Hauptteil der Anforderung gesendet wird. Das Schema der XML muss bei der Ausführung validiert werden. Wenn Sie mehrere Tags hinzufügen möchten, duplizieren Sie den Knoten 'Tag' und ändern Sie den Inhalt jedes Schlüssel-und Wertelements Ihren Spezifikationen entsprechend. Für jedes Objekt gibt es nur ein ElementTagSet. Der Befehl 'PUT' ersetzt alle vorhandenen Metadaten durch die von Ihnen angegebenen Werte.

curl -X "PUT" "https://s3.test.cloud-object-storage.sample.appdomain.cloud/taggingtest/example-file.csv?tagging" -H "Authorization: bearer ...iOiIyMDIwMTIwNzE0NDkiLCJh..." -H "ibm-service-instance-id: 7nnnnn52-2nn0-nna9-bann-7nnnnn4cc4e7" --data "<Tagging><TagSet><Tag><Key>source</Key><Value>text</Value></Tag></TagSet></Tagging>"

Tags bearbeiten

Sobald Ihre Objekte markiert wurden, kann es im Laufe der Zeit erforderlich werden, sie zu ändern.

Um die Tags über die grafische Schnittstelle zu bearbeiten, müssen Sie sich an der Konsole anmelden und wie zuvor beschrieben auf Ihre Objekte zugreifen. Sobald Sie auf die Option "Tags verwalten" geklickt haben, ändern Sie einfach den Inhalt der Formularfelder. Denken Sie daran, nach Abschluss auf "Speichern" zu klicken.

Ihre Anforderungen müssen authentifiziert werden, um Ihre Daten zu kennzeichnen. Außerdem müssen Sie alle alten Tags programmgesteuert beibehalten, während Sie Ihre Objekte mit neuen Informationen aktualisieren. Das gezeigte Beispiel wiederholt die Tags aus den vorherigen Beispielen, während ein neuer Tag hinzugefügt wird.

Denken Sie daran, dass die Ausführung von "PUT" -Operationen mit Tags alle aktuellen Tags überschreibt.

curl -X "PUT" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain" \
--data "<Tagging><TagSet><Tag><Key>source</Key><Value>text</Value></Tag><Tag><Key>source1</Key><Value>text1</Value></Tag></TagSet></Tagging>"

Tags entfernen

Nachdem Sie Ihren Objekten Tags hinzugefügt haben, kann es erforderlich werden, sie zu entfernen.

Um die Tags über die grafische Schnittstelle zu löschen, müssen Sie sich an der Konsole anmelden und wie zuvor beschrieben auf Ihre Objekte zugreifen. Klicken Sie erneut auf die Option "Tags verwalten" und wählen Sie in der Anzeige, die angezeigt wird, entweder "Alle löschen" oder löschen Sie jeweils einen Tag, indem Sie auf das Symbol "Papierkorb" in derselben Zeile wie der Tag klicken.

Denken Sie daran, nach Abschluss auf "Speichern" zu klicken.

Sie müssen sich authentifizieren, um Tags aus Ihren Daten zu löschen. Verwenden Sie einfach die HTTP-Methode "DELETE" mit dem Abfrageparameter ?tagging, um alle Tags zu löschen. Wenn Sie einen oder mehrere Tags löschen und gleichzeitig einen oder mehrere Tags beibehalten möchten, verwenden Sie die Anweisungen zum Bearbeiten, um Ihre Änderungen vorzunehmen.

curl -X "DELETE" 'https://<endpoint>/<bucketname>/<objectname>?tagging' \
-H 'Authorization: bearer <token>' \
-H "content-type: text/plain"