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

Verwenden 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

Beim Markieren in S3 Access Grants werden andere API-Operationen als beim Markieren von Objekten verwendet. S3 Access Grants verwendet die API-Operationen TagResource, UntagResource und ListTagsForResource. Eine Ressource kann eine Instance, ein registrierter Speicherort oder eine Zugriffsgewährung in S3 Access Grants sein.

Ä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 nehmen Zeichen 1 oder 2 Zeichenpositionen ein.

  • 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 -Benutzerhandbuch.

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

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

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 über die Amazon-S3-API Tags für eine Instance, einen registrierten Standort oder eine Zugriffsgewährung in S3 Access Grants erstellen, entfernen oder auflisten. Informationen zur REST-API-Unterstützung für die Verwaltung von S3-Access-Grants-Tags finden Sie in den folgenden Abschnitten in der Amazon-Simple-Storage-Service-API-Referenz: