Die Verwendung von AWS Tags mit S3 Access Grants - Amazon Simple Storage Service

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.

Die Verwendung von AWS Tags mit S3 Access Grants

Tags in Amazon S3 Access Grants besitzen ähnliche Eigenschaften wie Objekt-Tags in Amazon S3. Jeder Tag ist ein Schlüssel/Wert-Paar. Die Ressourcen in S3 Access Grants, die Sie markieren können, sind Instances, Speicherorte und Gewährungen.

Anmerkung

Das Tagging in S3 Access Grants verwendet andere API Operationen als das Tagging von Objekten. S3 Access Grants verwendet die TagResource, UntagResource, und ListTagsForResourceAPIOperationen, bei denen es sich bei einer Ressource entweder um eine S3 Access Grants-Instanz, einen registrierten Standort oder um eine Zugriffsberechtigung handeln kann.

Ähnlich wie bei Objekt-Tags gelten die folgenden Einschränkungen:

  • Sie können Tags zu neuen S3-Access-Grants-Ressourcen hinzufügen, wenn Sie diese erstellen, oder zu vorhandenen Ressourcen hinzufügen.

  • Sie können einer Ressource bis zu 10 Tags zuordnen. Wenn mehrere Tags derselben Ressource zugeordnet sind, müssen sie eindeutige Tag-Schlüssel besitzen.

  • Ein Tag-Schlüssel kann maximal 128 Unicode-Zeichen lang sein, und die Tag-Werte können bis zu 256 Unicode-Zeichen lang sein. Tags werden intern in UTF -16 dargestellt. In UTF -16 verbrauchen Zeichen entweder 1 oder 2 Zeichenpositionen.

  • Schlüssel und Werte unterscheiden nach Groß- und Kleinschreibung.

Weitere Informationen zu Tag-Einschränkungen finden Sie unter Einschränkungen für benutzerdefinierte Tags im AWS Billing Benutzerleitfaden.

Sie können Ressourcen in S3 Access Grants taggen, indem Sie den AWS Command Line Interface (AWS CLI), der Amazon S3 REST API oder der AWS SDKs.

Um das zu installieren AWS CLI, siehe Installation des AWS CLI in der AWS Command Line Interface Benutzerleitfaden.

Sie können eine S3-Access-Grants-Ressource während oder nach der Erstellung markieren. Die folgenden Beispiele zeigen, wie Sie eine S3-Access-Grants-Instance markieren oder eine vorhandene Markierung aufheben. Sie können ähnliche Operationen für registrierte Speicherorte und Zugriffsgewährungen durchführen.

Um die folgenden Beispielbefehle zu verwenden, ersetzen Sie user input placeholders durch eigene Daten.

Beispiel – Erstellen einer S3-Access-Grants-Instance mit Tags
aws s3control create-access-grants-instance \ --account-id 111122223333 \ --profile access-grants-profile \ --region us-east-2 \ --tags Key=tagKey1,Value=tagValue1

Antwort:

{ "CreatedAt": "2023-10-25T01:09:46.719000+00:00", "AccessGrantsInstanceId": "default", "AccessGrantsInstanceArn": "arn:aws:s3:us-east-2:111122223333:access-grants/default" }
Beispiel – Markieren einer bereits erstellten S3-Access-Grants-Instance
aws s3control tag-resource \ --account-id 111122223333 \ --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \ --profile access-grants-profile \ --region us-east-2 \ --tags Key=tagKey2,Value=tagValue2
Beispiel – Auflisten der Tags für eine S3-Access-Grants-Instance
aws s3control list-tags-for-resource \ --account-id 111122223333 \ --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \ --profile access-grants-profile \ --region us-east-2

Antwort:

{ "Tags": [ { "Key": "tagKey1", "Value": "tagValue1" }, { "Key": "tagKey2", "Value": "tagValue2" } ] }
Beispiel – Aufheben der Markierung für eine S3-Access-Grants-Instance
aws s3control untag-resource \ --account-id 111122223333 \ --resource-arn "arn:aws:s3:us-east-2:111122223333:access-grants/default" \ --profile access-grants-profile \ --region us-east-2 \ --tag-keys "tagKey2"

Sie können Amazon S3 verwenden, API um Tags für eine S3 Access Grants-Instance, einen registrierten Standort oder eine Zugriffserteilung zu taggen, aufzuheben oder aufzulisten. Informationen zur REST API Unterstützung der Verwaltung von S3 Access Grants-Tags finden Sie in den folgenden Abschnitten der Amazon Simple Storage Service API Reference: