

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 einer Markierung zu einem Verzeichnis-Bucket
<a name="directory-bucket-tag-add"></a>



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](https://docs.aws.amazon.com/s3/pricing/). Weitere Information zu Verzeichnis-Buckets finden Sie unter [Verwendung von Tags mit S3-Verzeichnis-Buckets](directory-buckets-tagging.md).

## Berechtigungen
<a name="tag-add-permissions"></a>

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

## Behebung von Fehlern
<a name="tag-add-troubleshooting"></a>

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](#tag-add-permissions) 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 beginnt`aws:`, ändern Sie den Tag-Schlüssel und versuchen Sie es erneut. 

## Schritte
<a name="tag-add-steps"></a>

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.

## Verwenden der S3-Konsole
<a name="directory-bucket-tag-add-console"></a>

So fügen Sie mithilfe der Amazon-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/](https://console.aws.amazon.com/s3/).

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

1. Wählen Sie den Bucket-Namen. 

1. Wählen Sie die Registerkarte **Eigenschaften** aus. 

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

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

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

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

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

## Verwenden Sie den AWS SDKs
<a name="directory-bucket-tag-add-sdks"></a>

------
#### [ SDK for Java 2.x ]

In diesem Beispiel wird gezeigt, wie Sie einem Verzeichnis-Bucket unter Verwendung von AWS SDK for Java 2.x Tags hinzufügen können. Um den Befehl zu verwenden, ersetzen Sie die *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());
    }
}
```

------

## Verwenden der REST-API
<a name="directory-bucket-tag-add-api"></a>

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*:
+ [TagResource](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_TagResource.html)

## Verwenden Sie den AWS CLI
<a name="directory-bucket-tag-add-cli"></a>

Informationen zur Installation der AWS CLI finden Sie unter [Installation der AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) 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 *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
  }
}
```