Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme - AWS X-Ray
Tag-EinschränkungenTags in der Konsole verwaltenVerwaltung von Stichwörtern in AWS CLISteuern Sie den Zugriff auf X-Ray-Ressourcen anhand von Tags

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.

Kennzeichnen von Regeln und Gruppen für die Röntgenprobenahme

Stichwörter sind Wörter oder Ausdrücke, mit denen Sie Ihre AWS Ressourcen identifizieren und organisieren können. Sie können jeder Ressource mehrere Tags hinzufügen. Jedes Tag enthält einen Schlüssel und einen optionalen Wert, den Sie definieren. Ein Tag-Schlüssel könnte beispielsweise seindomain, und der Tag-Wert könnte seinexample.com. Sie können Ihre Ressourcen anhand der von Ihnen hinzugefügten Tags suchen und filtern. Weitere Informationen zur Verwendung von Tags finden Sie unter AWS Ressourcen taggen in der AWS allgemeinen Referenz.

Sie können Tags verwenden, um tagbasierte Berechtigungen für Distributionen durchzusetzen. CloudFront Weitere Informationen finden Sie unter Steuern des Zugriffs auf AWS Ressourcen mithilfe von Ressourcen-Tags.

Anmerkung

Tag Editor und AWS Resource Groups unterstützen derzeit keine X-Ray-Ressourcen. Sie können Tags hinzufügen und verwalten, indem Sie die AWS X-Ray Konsole oder verwendenAPI.

Sie können Tags auf Ressourcen anwenden, indem Sie die X-Ray-KonsoleAPI, AWS CLI,SDKs, und verwenden AWS Tools for Windows PowerShell. Weitere Informationen finden Sie in der folgenden -Dokumentation:

Anmerkung

Wenn Sie einer X-Ray-Ressource keine Tags hinzufügen oder ändern können oder wenn Sie keine Ressource mit bestimmten Tags hinzufügen können, verfügen Sie möglicherweise nicht über die erforderlichen Berechtigungen, um diesen Vorgang auszuführen. Um Zugriff zu beantragen, wenden Sie sich an einen AWS Benutzer in Ihrem Unternehmen, der über Administratorrechte in X-Ray verfügt.

Tag-Einschränkungen

Für Tags gelten die folgenden Einschränkungen.

  • Maximale Anzahl von Tags pro Ressource: 50

  • Maximale Schlüssellänge – 128 Unicode-Zeichen.

  • Maximale Wertlänge – 256 Unicode-Zeichen.

  • Gültige Werte für Schlüssel- und Wert sind a-z, A-Z, 0-9, Leerzeichen und die folgenden Zeichen: _ . : / = + - und @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

  • Verwenden Sie es nicht aws: als Präfix für Schlüssel; es ist für die AWS Verwendung reserviert.

Anmerkung

Sie können Systemtags nicht bearbeiten oder löschen.

Tags in der Konsole verwalten

Sie können optionale Tags hinzufügen, wenn Sie eine X-Ray-Gruppe oder eine Probenahmeregel erstellen. Tags können auch später in der Konsole geändert oder gelöscht werden.

Die folgenden Verfahren erklären, wie Sie Tags für Ihre Gruppen und Sampling-Regeln in der X-Ray-Konsole hinzufügen, bearbeiten und löschen.

Fügen Sie Tags zu einer neuen Gruppe (Konsole) hinzu

Wenn Sie eine neue X-Ray-Gruppe erstellen, können Sie optionale Tags auf der Seite Gruppe erstellen hinzufügen.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die X-Ray-Konsole zu https://console.aws.amazon.com/xray/Hause.

  2. Erweitern Sie im Navigationsbereich die Option Konfiguration und wählen Sie Gruppen aus.

  3. Wählen Sie Create group (Gruppe erstellen) aus.

  4. Geben Sie auf der Seite Gruppe erstellen einen Namen und einen Filterausdruck für die Gruppe an. Weitere Informationen zu diesen Eigenschaften finden Sie unter Konfigurieren von Gruppen.

  5. Geben Sie im Feld Tags einen Tag-Schlüssel und optional einen Tag-Wert ein. Sie können beispielsweise den Tag-Schlüssel und den Tag-Wert von Stage eingebenProduction, um anzugeben, dass diese Gruppe für Produktionszwecke bestimmt ist. Wenn Sie ein Tag hinzufügen, wird eine neue Zeile angezeigt, in der Sie bei Bedarf ein weiteres Tag hinzufügen können. Tag-EinschränkungenIn diesem Thema finden Sie Einschränkungen für Tags.

  6. Wenn Sie mit dem Hinzufügen von Tags fertig sind, wählen Sie Gruppe erstellen aus.

Fügen Sie Stichwörter zu einer neuen Stichprobenregel hinzu (Konsole)

Wenn Sie eine neue Röntgenprobenregel erstellen, können Sie auf der Seite Probenahmeregel erstellen Tags hinzufügen.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die X-Ray-Konsole zu https://console.aws.amazon.com/xray/Hause.

  2. Erweitern Sie im Navigationsbereich die Option Konfiguration und wählen Sie Sampling aus.

  3. Wählen Sie Stichprobenregel erstellen aus.

  4. Geben Sie auf der Seite Stichprobenregel erstellen einen Namen, eine Priorität, Grenzwerte, Übereinstimmungskriterien und passende Attribute an. Weitere Informationen zu diesen Eigenschaften finden Sie unter Konfigurieren von -Samplingregeln.

  5. Geben Sie im Feld Tags einen Tag-Schlüssel und optional einen Tag-Wert ein. Sie können beispielsweise den Tag-Schlüssel und den Tag-Wert von eingebenStage, um anzugebenProduction, dass diese Stichprobenregel für Produktionszwecke bestimmt ist. Wenn Sie ein Tag hinzufügen, wird eine neue Zeile angezeigt, in der Sie bei Bedarf ein weiteres Tag hinzufügen können. Tag-EinschränkungenIn diesem Thema finden Sie Einschränkungen für Tags.

  6. Wenn Sie mit dem Hinzufügen von Tags fertig sind, wählen Sie Stichprobenregel erstellen aus.

Bearbeiten oder löschen Sie Tags für eine Gruppe (Konsole)

Sie können Tags in einer X-Ray-Gruppe auf der Seite Gruppe bearbeiten ändern oder löschen.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die X-Ray-Konsole zu https://console.aws.amazon.com/xray/Hause.

  2. Erweitern Sie im Navigationsbereich die Option Konfiguration und wählen Sie Gruppen aus.

  3. Wählen Sie in der Tabelle Gruppen den Namen einer Gruppe aus.

  4. Bearbeiten Sie auf der Seite Gruppe bearbeiten unter Tags die Tag-Schlüssel und -Werte. Sie können keine doppelten Tag-Schlüssel haben. Tag-Werte sind optional; Sie können Werte löschen, falls gewünscht. Weitere Informationen zu anderen Eigenschaften auf der Seite Gruppe bearbeiten finden Sie unterKonfigurieren von Gruppen. Tag-EinschränkungenIn diesem Thema finden Sie Einschränkungen für Tags.

  5. Um ein Tag zu löschen, wählen Sie X rechts neben dem Tag aus.

  6. Wenn Sie mit dem Bearbeiten oder Löschen von Tags fertig sind, wählen Sie Gruppe aktualisieren.

Bearbeiten oder löschen Sie Tags für eine Stichprobenregel (Konsole)

Sie können Tags in einer Röntgen-Sampling-Regel auf der Seite Sampling-Regel bearbeiten ändern oder löschen.

  1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die X-Ray-Konsole zu https://console.aws.amazon.com/xray/Hause.

  2. Erweitern Sie im Navigationsbereich die Option Konfiguration und wählen Sie Sampling aus.

  3. Wählen Sie in der Tabelle mit den Stichprobenregeln den Namen einer Stichprobenregel aus.

  4. Bearbeiten Sie unter Tags die Tag-Schlüssel und -Werte. Sie können keine doppelten Tag-Schlüssel haben. Tag-Werte sind optional; Sie können Werte löschen, falls gewünscht. Weitere Informationen zu anderen Eigenschaften auf der Seite Stichprobenregel bearbeiten finden Sie unterKonfigurieren von -Samplingregeln. Tag-EinschränkungenIn diesem Thema finden Sie Einschränkungen für Tags.

  5. Um ein Tag zu löschen, wählen Sie X rechts neben dem Tag aus.

  6. Wenn Sie mit dem Bearbeiten oder Löschen von Tags fertig sind, wählen Sie Stichprobenregel aktualisieren.

Verwaltung von Stichwörtern in AWS CLI

Sie können Tags hinzufügen, wenn Sie eine X-Ray-Gruppe oder eine Probenahmeregel erstellen. Sie können die auch verwenden AWS CLI , um Tags zu erstellen und zu verwalten. Um Tags für eine bestehende Gruppe oder Stichprobenregel zu aktualisieren, verwenden Sie die AWS X-Ray Konsole oder das TagResourceoder UntagResourceAPIs.

Hinzufügen von Tags zu einer neuen X-Ray-Gruppe oder Sampling-Regel (CLI)

Verwenden Sie einen der folgenden Befehle, um beim Erstellen einer neuen X-Ray-Gruppe oder Sampling-Regel optionale Tags hinzuzufügen.

  • Um einer neuen Gruppe Tags hinzuzufügen, führen Sie den folgenden Befehl aus und ersetzen group_name mit dem Namen deiner Gruppe mydomain.com mit dem Endpunkt Ihres Dienstes key_name mit einem Tag-Schlüssel und optional value mit einem Tag-Wert. Weitere Informationen zum Erstellen einer Gruppe finden Sie unterGruppen.

    aws xray create-group \
   --group-name "group_name" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "key_name","Value": "value"},{"Key": "key_name","Value": "value"}]

    Im Folgenden wird ein Beispiel gezeigt.

    aws xray create-group \
   --group-name "AdminGroup" \
   --filter-expression "service(\"mydomain.com\") {fault OR error}" \
   --tags [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

  • Um einer neuen Stichprobenregel Tags hinzuzufügen, führen Sie den folgenden Befehl aus und ersetzen key_name mit einem Tag-Schlüssel und optional value mit einem Tag-Wert. Dieser Befehl gibt die Werte im --sampling-rule Parameter als JSON Datei an. Weitere Informationen zum Erstellen einer Stichprobenregel finden Sie unterSamplingregeln.

    aws xray create-sampling-rule \
   --cli-input-json file://file_name.json

    Im Folgenden finden Sie den Inhalt der JSON Datei file_name.json das wird durch den --cli-input-json Parameter angegeben.

    {
    "SamplingRule": {
        "RuleName": "rule_name",
        "RuleARN": "string",
        "ResourceARN": "string",
        "Priority": integer,
        "FixedRate": double,
        "ReservoirSize": integer,
        "ServiceName": "string",
        "ServiceType": "string",
        "Host": "string",
        "HTTPMethod": "string",
        "URLPath": "string",
        "Version": integer,
        "Attributes": {"attribute_name": "value","attribute_name": "value"...}
    }
    "Tags": [
           {
               "Key":"key_name",
               "Value":"value"
           },
           {
               "Key":"key_name",
               "Value":"value"
           }
          ]
}

    Nachfolgend finden Sie einen Beispielbefehl.

    aws xray create-sampling-rule \
   --cli-input-json file://9000-base-scorekeep.json

    Im Folgenden finden Sie den Inhalt der durch den --cli-input-json Parameter angegebenen 9000-base-scorekeep.json Beispieldatei.

    {
    "SamplingRule": {
        "RuleName": "base-scorekeep",
        "ResourceARN": "*",
        "Priority": 9000,
        "FixedRate": 0.1,
        "ReservoirSize": 5,
        "ServiceName": "Scorekeep",
        "ServiceType": "*",
        "Host": "*",
        "HTTPMethod": "*",
        "URLPath": "*",
        "Version": 1
    }
    "Tags": [
           {
               "Key":"Stage",
               "Value":"Prod"
           },
           {
               "Key":"Department",
               "Value":"QA"
           }
          ]
}

Fügen Sie einer vorhandenen Ressource Tags hinzu (CLI)

Sie können den tag-resource Befehl ausführen, um einer vorhandenen X-Ray-Gruppe oder einer Stichprobenregel Tags hinzuzufügen. Diese Methode ist möglicherweise einfacher als das Hinzufügen von Tags durch Ausführen von update-group oderupdate-sampling-rule.

Um einer Gruppe oder einer Stichprobenregel Tags hinzuzufügen, führen Sie den folgenden Befehl aus. Ersetzen Sie dabei das durch das ARN der Ressource und geben Sie die Schlüssel und optionalen Werte der Tags an, die Sie hinzufügen möchten. ARN

aws xray tag-resource \
   --resource-arn "ARN" \
   --tag-keys [{"Key":"key_name","Value":"value"}, {"Key":"key_name","Value":"value"}]

Im Folgenden wird ein Beispiel gezeigt.

aws xray tag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup" \
   --tag-keys [{"Key": "Stage","Value": "Prod"},{"Key": "Department","Value": "QA"}]

Listet die Tags einer Ressource auf (CLI)

Sie können den list-tags-for-resource Befehl ausführen, um die Tags einer X-Ray-Gruppe oder einer Stichprobenregel aufzulisten.

Um die Tags aufzulisten, die einer Gruppe oder einer Stichprobenregel zugeordnet sind, führen Sie den folgenden Befehl aus und ersetzen Sie ARN dabei das durch das ARN der Ressource.

aws xray list-tags-for-resource \
   --resource-arn "ARN"

Im Folgenden wird ein Beispiel gezeigt.

aws xray list-tags-for-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/AdminGroup"

Löschen Sie Tags auf einer Ressource (CLI)

Sie können den untag-resource Befehl ausführen, um Tags aus einer X-Ray-Gruppe oder einer Stichprobenregel zu entfernen.

Um Tags aus einer Gruppe oder einer Stichprobenregel zu entfernen, führen Sie den folgenden Befehl aus. Ersetzen Sie dabei das durch das ARN der Ressource und geben Sie die Schlüssel der Tags an, die Sie entfernen möchten. ARN

Mit dem untag-resource Befehl können Sie nur ganze Tags entfernen. Um Tag-Werte zu entfernen, verwenden Sie die X-Ray-Konsole oder löschen Sie Tags und fügen Sie neue Tags mit denselben Schlüsseln, aber unterschiedlichen oder leeren Werten hinzu.

aws xray untag-resource \
   --resource-arn "ARN" \
   --tag-keys ["key_name","key_name"]

Im Folgenden wird ein Beispiel gezeigt.

aws xray untag-resource \
   --resource-arn "arn:aws:xray:us-east-2:01234567890:group/group_name" \
   --tag-keys ["Stage","Department"]

Steuern Sie den Zugriff auf X-Ray-Ressourcen anhand von Tags

Sie können Tags an X-Ray-Gruppen oder Sampling-Regeln anhängen oder Tags in einer Anfrage an X-Ray übergeben. Um den Zugriff auf der Grundlage von Tags zu steuern, geben Sie im Bedingungselement einer Richtlinie Tag-Informationen an, indem Sie die Schlüssel xray:ResourceTag/key-name, aws:RequestTag/key-name, oder Bedingung aws:TagKeys verwenden. Weitere Informationen zu diesen Bedingungsschlüsseln finden Sie unter Steuern des Zugriffs auf AWS Ressourcen mithilfe von Ressourcen-Tags.

Ein Beispiel für eine identitätsbasierte Richtlinie zur Einschränkung des Zugriffs auf eine Ressource auf der Grundlage der Markierungen dieser Ressource finden Sie unter Verwaltung des Zugriffs auf X-Ray-Gruppen und Stichprobenregeln auf der Grundlage von Tags.