Hinzufügen eines Tags zu einem Zugangspunkt für Verzeichnis-Buckets - Amazon Simple Storage Service
BerechtigungenBehebung von FehlernSchritte

Hinzufügen eines Tags zu einem Zugangspunkt für Verzeichnis-Buckets

Sie können Tags zu Amazon S3 Access Points für Verzeichnis-Buckets hinzufügen und diese Tags ändern. Weitere Informationen finden Sie unter Verwenden von Tags mit S3 Zugangspunkten für Verzeichnis-Buckets.

Berechtigungen

Um einem Zugangspunkt für Verzeichnis-Buckets ein Tag hinzuzufügen, benötigen Sie die folgende Berechtigung:

  • s3express:TagResource

Behebung von Fehlern

Wenn beim Versuch, einem Zugangspunkt für Verzeichnis-Buckets 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 Zugangspunkt für Verzeichnis-Buckets 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 Zugangspunkten für 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 einem Zugangspunkt für Verzeichnis-Buckets über die Amazon-S3-Konsole Tags 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 Zugangspunkte (Verzeichnis-Buckets) aus.

  3. Wählen Sie den Namen des Zugriffspunkts aus.

  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 Zugangspunkt für Verzeichnis-Buckets 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::s3:region:111122223333:accesspoint/my-access-point/*")
                .accountId("111122223333")
                .tags(Tag.builder().key("key1").value("value1").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 Zugangspunkt für Verzeichnis-Buckets 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 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:region:444455556666:bucket/prefix--use1-az4--x-s3 \
--tags "Key=key1,Value=value1"

Antwort:

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