Hinzufügen einer Markierung zu einem Verzeichnis-Bucket - Amazon Simple Storage Service
BerechtigungenBehebung von FehlernSchritte

Hinzufügen einer Markierung zu einem Verzeichnis-Bucket

Sie können Tags zu Amazon S3-Verzeichnis-Buckets hinzufügen und diese Tags ändern. Es fallen keine zusätzlichen Kosten für die Verwendung von Tags in Verzeichnis-Buckets an, die über die Standard-S3-API-Anforderungsgebühren hinausgehen. Weitere Informationen finden Sie unter Amazon S3 – Preise. Weitere Information zu Verzeichnis-Buckets finden Sie unter Verwendung von Tags mit S3-Verzeichnis-Buckets.

Berechtigungen

Um einem Verzeichnis-Bucket ein Tag hinzuzufügen, müssen Sie über die folgende Berechtigung verfügen:

  • s3express:TagResource

Behebung von Fehlern

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

  • Vergewissern Sie sich, dass Sie über die erforderlichen Berechtigungen verfügen, um ein Tag zu einem Verzeichnis-Bucket 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-Konsole, die AWS Command Line Interface (AWS CLI), die Amazon S3 REST-API und AWS SDKs verwenden.

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

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

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

  3. Wählen Sie den Bucket-Namen.

  4. Wählen Sie die Registerkarte Eigenschaften aus.

  5. Klicken Sie im Abschnitt Tags auf Neuen Tag hinzufügen.

  6. Die Seite Tags hinzufügen wird geöffnet. Sie können bis zu 50 Schlüssel-Wert-Paare taggen.

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

  8. Auf der Seite Tags können Sie auch die Schlüssel und Werte von vorhandenen Tags bearbeiten.

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

SDK for Java 2.x

In diesem Beispiel wird gezeigt, wie Sie einem Verzeichnis-Bucket unter Verwendung von AWS SDK for Java 2.xTags hinzufügen können. Um den Befehl zu verwenden, ersetzen Sie den Platzhaltertext des Benutzers 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 über die Unterstützung der Amazon S3 REST-API für das Hinzufügen von Tags zu einem Verzeichnis-Bucket finden Sie im folgenden Abschnitt 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 veranschaulicht, wie Sie mithilfe der AWS CLI Tags zu einem Verzeichnis-Bucket hinzufügen können. Um den Befehl zu verwenden, ersetzen Sie den Platzhaltertext des Benutzers durch Ihre eigenen Informationen.

Anforderung:

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