Hinzufügen eines Tags zu einem Verzeichnis-Bucket - Amazon Simple Storage Service
BerechtigungenBehebung von FehlernSchritte

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Hinzufügen eines Tags zu einem Verzeichnis-Bucket

Sie können Tags zu Amazon S3 S3-Verzeichnis-Buckets hinzufügen und diese Tags ändern. Für die Verwendung von Tags in Verzeichnis-Buckets fallen keine zusätzlichen Gebühren an, die über die standardmäßigen S3-API-Anforderungsraten hinausgehen. Weitere Informationen finden Sie unter Amazon S3 – Preise. Weitere Informationen zum Taggen von Verzeichnis-Buckets finden Sie unter. Verwenden von Tags mit S3-Verzeichnis-Buckets

Berechtigungen

Um einem Verzeichnis-Bucket ein Tag hinzuzufügen, benötigen Sie die folgenden Berechtigungen:

  • s3express:TagResource

Behebung von Fehlern

Wenn beim Versuch, einem Verzeichnis-Bucket ein Tag hinzuzufügen, ein Fehler auftritt, können Sie wie folgt vorgehen:

  • Stellen Sie sicher, dass Sie über die erforderlichen Berechtigungen Voraussetzungen verfügen, um einem Verzeichnis-Bucket ein Tag hinzuzufügen.

  • Wenn Sie versucht haben, einen Tag-Schlüssel hinzuzufügen, der mit dem AWS reservierten Präfix beginntaws:, ändern Sie den Tag-Schlüssel und versuchen Sie es erneut.

Schritte

Sie können Tags zu Verzeichnis-Buckets hinzufügen, indem Sie die Amazon S3 S3-Konsole, die AWS Befehlszeilenschnittstelle (AWS CLI), die Amazon S3 S3-REST-API und AWS SDKs verwenden.

So fügen Sie mithilfe der Amazon S3 S3-Konsole Tags zu einem Verzeichnis-Bucket hinzu:

  1. Melden Sie sich bei der Amazon S3 S3-Konsole an unter https://console.aws.amazon.com/s3/.

  2. Wählen Sie im linken Navigationsbereich Directory-Buckets aus.

  3. Wählen Sie den Bucket-Namen.

  4. Wählen Sie die Registerkarte Eigenschaften aus.

  5. Scrollen Sie zum Abschnitt „Tags“ und wählen Sie „Neues Tag hinzufügen“.

  6. Dadurch wird die Seite „Tags hinzufügen“ geöffnet. Sie können bis zu 50 Tag-Schlüsselwertpaare eingeben.

  7. Wenn Sie ein neues Tag mit demselben Schlüsselnamen wie ein vorhandenes Tag hinzufügen, überschreibt der Wert des neuen Tags den Wert des vorhandenen Tags.

  8. Sie können auf dieser Seite auch die Werte vorhandener Tags bearbeiten.

  9. Nachdem Sie die Tags hinzugefügt haben, wählen Sie Änderungen speichern.

SDK for Java 2.x

Dieses Beispiel zeigt Ihnen, wie Sie mithilfe von Tags zu einem Verzeichnis-Bucket hinzufügen AWS SDK for Java 2.x. Um den Befehl zu verwenden, ersetzen Sie den user input placeholders durch Ihre eigenen Informationen. 

import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
import software.amazon.awssdk.services.s3control.model.TagResourceResponse;

public class TagResourceExample {
    public static void tagResourceExample() {
        S3ControlClient s3Control = S3ControlClient.builder().region(Region.US_WEST_2).build();

        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn("arn:aws::s3express:us-west-2:111122223333:bucket/my-directory-bucket--usw2-az1--x-s3")
                .accountId("111122223333")
                .tags(Tag.builder().key("MyTagKey").value("MyTagValue").build())
                .build();

        TagResourceResponse response = s3Control.tagResource(tagResourceRequest);
        System.out.println("Status code (should be 204):");
        System.out.println(response.sdkHttpResponse().statusCode());
    }
}

Informationen zur Amazon S3 S3-REST-API-Unterstützung für das Hinzufügen von Tags zu einem Directory-Bucket finden Sie im folgenden Abschnitt in der Amazon Simple Storage Service API-Referenz:

Informationen zur Installation der AWS CLI finden Sie unter Installation der AWS CLI im AWS Command Line Interface Benutzerhandbuch.

Das folgende CLI-Beispiel zeigt Ihnen, wie Sie Tags zu einem Verzeichnis-Bucket hinzufügen, indem Sie den verwenden AWS CLI. Um den Befehl zu verwenden, ersetzen Sie den user input placeholders durch Ihre eigenen Informationen.

Anfrage:

aws s3control tag-resource \
--account-id 111122223333 \
--resource-arn arn:aws::s3express:us-east-1:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=mykey,Value=myvalue"

Antwort:

{
  "ResponseMetadata": {
      "RequestId": "EXAMPLE123456789",
      "HTTPStatusCode": 200,
      "HTTPHeaders": {
          "date": "Wed, 19 Jun 2025 10:30:00 GMT",
          "content-length": "0"
      },
      "RetryAttempts": 0
  }
}