Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
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.
# Beispiele für Amazon RDS Performance Insights mit AWS CLI
Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit Amazon RDS Performance Insights Aktionen ausführen und allgemeine Szenarien implementieren.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden.
**Topics**
+ [Aktionen](#actions)
## Aktionen
### `create-performance-analysis-report`
Das folgende Codebeispiel zeigt, wie Sie`create-performance-analysis-report`.
**AWS CLI**
**So erstellen Sie einen Leistungsanalysebericht**
Im folgenden Beispiel für `create-performance-analysis-report` wird ein Leistungsanalysebericht mit der Startzeit `1682969503` und der Endzeit `1682979503` für die `db-abcdefg123456789`-Datenbank erstellt.
```
aws pi create-performance-analysis-report \
--service-type RDS \
--identifier db-abcdefg123456789 \
--start-time 1682969503 \
--end-time 1682979503
```
Ausgabe:
```
{
"AnalysisReportId": "report-0234d3ed98e28fb17"
}
```
Weitere Informationen zum Erstellen von Leistungsanalyseberichten finden Sie unter [Erstellen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) im *Benutzerhandbuch für Amazon RDS* und [Erstellen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [CreatePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/create-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*.
### `delete-performance-analysis-report`
Das folgende Codebeispiel zeigt die Verwendung`delete-performance-analysis-report`.
**AWS CLI**
**So löschen Sie einen Leistungsanalysebericht**
Im folgenden Beispiel für `delete-performance-analysis-report` wird der Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` gelöscht.
```
aws pi delete-performance-analysis-report \
--service-type RDS \
--identifier db-abcdefg123456789 \
--analysis-report-id report-0d99cc91c4422ee61
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen zum Löschen von Leistungsanalyseberichten finden Sie unter [Löschen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) im *Benutzerhandbuch für Amazon RDS* und [Löschen eines Leistungsanalyseberichts in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [DeletePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/delete-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*.
### `describe-dimension-keys`
Das folgende Codebeispiel zeigt die Verwendung`describe-dimension-keys`.
**AWS CLI**
**Beispiel 1: So beschreiben Sie Dimensionsschlüssel**
In diesem Beispiel werden die Namen aller Warteereignisse abgefragt. Die Daten werden nach Ereignisnamen und den Aggregatwerten dieser Ereignisse über den angegebenen Zeitraum zusammengefasst.
Befehl:
```
aws pi describe-dimension-keys --service-type RDS --identifier db-LKCGOBK26374TPTDFXOIWVCPPM --start-time 1527026400 --end-time 1527080400 --metric db.load.avg --group-by '{"Group":"db.wait_event"}'
```
Ausgabe:
```
{
"AlignedEndTime": 1.5270804E9,
"AlignedStartTime": 1.5270264E9,
"Keys": [
{
"Dimensions": {"db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"},
"Total": 0.05906906851195666
},
{
"Dimensions": {"db.wait_event.name": "wait/io/aurora_redo_log_flush"},
"Total": 0.015824722186149193
},
{
"Dimensions": {"db.wait_event.name": "CPU"},
"Total": 0.008014396230265477
},
{
"Dimensions": {"db.wait_event.name": "wait/io/aurora_respond_to_client"},
"Total": 0.0036361612526204477
},
{
"Dimensions": {"db.wait_event.name": "wait/io/table/sql/handler"},
"Total": 0.0019108398419382965
},
{
"Dimensions": {"db.wait_event.name": "wait/synch/cond/mysys/my_thread_var::suspend"},
"Total": 8.533847837782684E-4
},
{
"Dimensions": {"db.wait_event.name": "wait/io/file/csv/data"},
"Total": 6.864181956477376E-4
},
{
"Dimensions": {"db.wait_event.name": "Unknown"},
"Total": 3.895887056379051E-4
},
{
"Dimensions": {"db.wait_event.name": "wait/synch/mutex/sql/FILE_AS_TABLE::LOCK_shim_lists"},
"Total": 3.710368625122906E-5
},
{
"Dimensions": {"db.wait_event.name": "wait/lock/table/sql/handler"},
"Total": 0
}
]
}
```
**Beispiel 2: So finden Sie die SQL-ID für Anweisungen, die am meisten zur DB-Last beitragen**
Im folgenden `describe-dimension-keys` werden die SQL-Anweisung und die SQL-ID für die 10 Anweisungen abgefragt, die am meisten zur Datenbanklast beigetragen haben.
```
aws pi describe-dimension-keys \
--service-type RDS \
--identifier db-abcdefg123456789 \
--start-time 2023-05-01T00:00:00Z \
--end-time 2023-05-01T01:00:00Z \
--metric db.load.avg \
--group-by '{"Group": "db.sql", "Dimensions": ["db.sql.id", "db.sql.statement"],"Limit": 10}'
```
Ausgabe:
```
{
"AlignedEndTime": 1.5270804E9,
"AlignedStartTime": 1.5270264E9,
"Identifier": "db-abcdefg123456789",
"MetricList": [
{
"Keys": [
{
"Dimensions": {"db.sql.id": "AKIAIOSFODNN7EXAMPLE", "db.sql.statement": "SELECT * FROM customers WHERE customer_id = 123"},
"Total": 25.5,"Partitions": [12.3, 13.2]
}
]
}
]
}
```
Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [DescribeDimensionKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/describe-dimension-keys.html)in der *AWS CLI Befehlsreferenz*.
### `get-dimension-key-details`
Das folgende Codebeispiel zeigt die Verwendung`get-dimension-key-details`.
**AWS CLI**
**So rufen Sie Details für eine bestimmte Dimensionsgruppe einer DB-Instance ab**
Im folgenden Beispiel für `get-dimension-key-details` wird der Volltext einer SQL-Anweisung für die DB-Instance `db-10BCD2EFGHIJ3KL4M5NO6PQRS5` abgerufen. `--group` ist `db.sql` und `--group-identifier` ist `db.sql.id`. In diesem Beispiel ist `example-sql-id` eine SQL-ID, die mithilfe der Operationen `get-resource-metrics` oder `describe-dimension-keys` abgerufen wurde. In diesem Beispiel sind die Dimensionsdetails verfügbar. Performance Insights ruft also den vollständigen Text der SQL-Anweisung ab, ohne ihn abzuschneiden.
```
aws pi get-dimension-key-details \
--service-type RDS \
--identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
--group db.sql \
--group-identifier example-sql-id \
--requested-dimensions statement
```
Ausgabe:
```
{
"Dimensions":[
{
"Value": "SELECT e.last_name, d.department_name FROM employees e, departments d WHERE e.department_id=d.department_id",
"Dimension": "db.sql.statement",
"Status": "AVAILABLE"
},
...
]
}
```
Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [GetDimensionKeyDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-dimension-key-details.html)in der *AWS CLI Befehlsreferenz*.
### `get-performance-analysis-report`
Das folgende Codebeispiel zeigt die Verwendung`get-performance-analysis-report`.
**AWS CLI**
**So rufen Sie einen Leistungsanalysebericht ab**
Im folgenden Beispiel für `get-performance-analysis-report` wird der Leistungsanalysebericht für die Datenbank `db-abcdefg123456789` mit der Berichts-ID `report-0d99cc91c4422ee61` abgerufen. Die Antwort enthält den Berichtsstatus, die ID, Zeitdetails und Einblicke.
```
aws pi get-performance-analysis-report \
--service-type RDS \
--identifier db-abcdefg123456789 \
--analysis-report-id report-0d99cc91c4422ee61
```
Ausgabe:
```
{
"AnalysisReport": {
"Status": "Succeeded",
"ServiceType": "RDS",
"Identifier": "db-abcdefg123456789",
"StartTime": 1680583486.584,
"AnalysisReportId": "report-0d99cc91c4422ee61",
"EndTime": 1680587086.584,
"CreateTime": 1680587087.139,
"Insights": [
... (Condensed for space)
]
}
}
```
Weitere Informationen zu Leistungsanalyseberichten finden Sie unter [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon RDS* und [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [GetPerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-performance-analysis-report.html)in der *AWS CLI Befehlsreferenz*.
### `get-resource-metadata`
Das folgende Codebeispiel zeigt die Verwendung`get-resource-metadata`.
**AWS CLI**
**So rufen Sie Ressourcen-Metadaten für eine Datenbank ab**
Im folgenden Beispiel für `get-resource-metadata` werden die Ressourcenmetadaten für die Datenbank `db-abcdefg123456789` abgerufen. Die Antwort zeigt, dass „SQL-Digest-Statistiken“ aktiviert ist.
```
aws pi get-resource-metadata \
--service-type RDS \
--identifier db-abcdefg123456789
```
Ausgabe:
```
{
"Identifier": "db-abcdefg123456789",
"Features":{
"SQL_DIGEST_STATISTICS":{
"Status": "ENABLED"
}
}
}
```
Weitere Informationen zu SQL-Statistiken für Performance Insights finden Sie unter [SQL-Statistiken für Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sql-statistics.html) im *Benutzerhandbuch für Amazon RDS* und [SQL-Statistiken für Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/sql-statistics.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [GetResourceMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metadata.html)in der *AWS CLI Befehlsreferenz*.
### `get-resource-metrics`
Das folgende Codebeispiel zeigt die Verwendung`get-resource-metrics`.
**AWS CLI**
**So rufen Sie Ressourcenmetriken ab**
In diesem Beispiel werden Datenpunkte für die Dimensionsgruppe *db.wait\$1event* und für die Dimension *db.wait\$1event.name* in dieser Gruppe angefordert. In der Antwort werden die relevanten Datenpunkte nach der angeforderten Dimension (*db.wait\$1event.name*) gruppiert.
Befehl:
```
aws pi get-resource-metrics --service-type RDS --identifier db-LKCGOBK26374TPTDFXOIWVCPPM --start-time 1527026400 --end-time 1527080400 --period-in-seconds 300 --metric db.load.avg --metric-queries file://metric-queries.json
```
Die Argumente für `--metric-queries` werden in der JSON-Datei `metric-queries.json` gespeichert. Hier ist der Inhalt dieser Datei:
```
[
{
"Metric": "db.load.avg",
"GroupBy": {
"Group":"db.wait_event"
}
}
]
```
Ausgabe:
```
{
"AlignedEndTime": 1.5270804E9,
"AlignedStartTime": 1.5270264E9,
"Identifier": "db-LKCGOBK26374TPTDFXOIWVCPPM",
"MetricList": [
{
"Key": {
"Metric": "db.load.avg"
},
"DataPoints": [
{
"Timestamp": 1527026700.0,
"Value": 1.3533333333333333
},
{
"Timestamp": 1527027000.0,
"Value": 0.88
},
<...remaining output omitted...>
]
},
{
"Key": {
"Metric": "db.load.avg",
"Dimensions": {
"db.wait_event.name": "wait/synch/mutex/innodb/aurora_lock_thread_slot_futex"
}
},
"DataPoints": [
{
"Timestamp": 1527026700.0,
"Value": 0.8566666666666667
},
{
"Timestamp": 1527027000.0,
"Value": 0.8633333333333333
},
<...remaining output omitted...>
],
},
<...remaining output omitted...>
]
}
```
+ Einzelheiten zur API finden Sie [GetResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metrics.html)in der *AWS CLI Befehlsreferenz*.
### `list-available-resource-dimensions`
Das folgende Codebeispiel zeigt die Verwendung`list-available-resource-dimensions`.
**AWS CLI**
**So listen Sie die Dimensionen auf, die für einen Metriktyp von einer DB-Instance abgefragt werden können**
Das folgende `list-available-resource-dimensions` Beispiel listet die `db.load` Metriken auf, die Sie für die Datenbank abfragen können. `db-abcdefg123456789`
```
aws pi list-available-resource-dimensions \
--service-type RDS \
--identifier db-abcdefg123456789 \
--metrics db.load
```
Ausgabe:
```
{
"MetricDimensions": [
{
"Metric": "db.load",
"Groups": [
{
"Group": "db.user",
"Dimensions": [
{
"Identifier": "db.user.id"
},
{
"Identifier": "db.user.name"
}
]
},
{
"Group": "db.sql_tokenized",
"Dimensions": [
{
"Identifier": "db.sql_tokenized.id"
},
{
"Identifier": "db.sql_tokenized.db_id"
},
{
"Identifier": "db.sql_tokenized.statement"
}
]
},
...
]
}
]
}
```
Weitere Informationen zu Dimensionen in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [ListAvailableResourceDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-dimensions.html)in der *AWS CLI Befehlsreferenz*.
### `list-available-resource-metrics`
Das folgende Codebeispiel zeigt die Verwendung`list-available-resource-metrics`.
**AWS CLI**
**So listen Sie die Metriken auf, die für einen Metriktyp von einer DB-Instance abgefragt werden können**
Das folgende `list-available-resource-metrics` Beispiel listet die `db.load` Metriken auf, die Sie für die Datenbank abfragen können. `db-abcdefg123456789`
```
aws pi list-available-resource-metrics \
--service-type RDS \
--identifier db-abcdefg123456789 \
--metric-types "os" "db"
```
Ausgabe:
```
{
"Metrics": [
{
"Description": "The number of virtual CPUs for the DB instance",
"Metric": "os.general.numVCPUs",
"Unit": "vCPUs"
},
......,
{
"Description": "Time spent reading data file blocks by backends in this instance",
"Metric": "db.IO.read_latency",
"Unit": "Milliseconds per block"
},
......
]
}
```
Weitere Informationen zu Metriken in Performance Insights finden Sie unter [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon RDS* und [Datenbanklast](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [ListAvailableResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-metrics.html)in der *AWS CLI Befehlsreferenz*.
### `list-performance-analysis-reports`
Das folgende Codebeispiel zeigt die Verwendung`list-performance-analysis-reports`.
**AWS CLI**
**So listen Sie Leistungsanalyseberichte für eine Datenbank auf**
Im folgenden Beispiel für `list-performance-analysis-reports` werden alle Leistungsanalyseberichte für die `db-abcdefg123456789`-Datenbank aufgelistet. In der Antwort werden alle Berichte mit der Berichts-ID, dem Status und den Details zum Zeitraum aufgeführt.
```
aws pi list-performance-analysis-reports \
--service-type RDS \
--identifier db-abcdefg123456789
```
Ausgabe:
```
{
"AnalysisReports": [
{
"Status": "Succeeded",
"EndTime": 1680587086.584,
"CreateTime": 1680587087.139,
"StartTime": 1680583486.584,
"AnalysisReportId": "report-0d99cc91c4422ee61"
},
{
"Status": "Succeeded",
"EndTime": 1681491137.914,
"CreateTime": 1681491145.973,
"StartTime": 1681487537.914,
"AnalysisReportId": "report-002633115cc002233"
},
{
"Status": "Succeeded",
"EndTime": 1681493499.849,
"CreateTime": 1681493507.762,
"StartTime": 1681489899.849,
"AnalysisReportId": "report-043b1e006b47246f9"
},
{
"Status": "InProgress",
"EndTime": 1682979503.0,
"CreateTime": 1682979618.994,
"StartTime": 1682969503.0,
"AnalysisReportId": "report-01ad15f9b88bcbd56"
}
]
}
```
Weitere Informationen zu Leistungsanalyseberichten finden Sie unter [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon RDS* und [Analysieren der Datenbankleistung für einen bestimmten Zeitraum](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [ListPerformanceAnalysisReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-performance-analysis-reports.html)in der *AWS CLI Befehlsreferenz*.
### `list-tags-for-resource`
Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`.
**AWS CLI**
**So listen Sie alle Tags für einen Leistungsanalysebericht auf**
Das folgende `list-tags-for-resource`-Beispiel listet Tags für einen Leistungsanalysebericht mit der Berichts-ID auf`report-0d99cc91c4422ee61`.
```
aws pi list-tags-for-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61
```
Ausgabe:
```
{
"Tags": [
{
"Value": "test-tag",
"Key": "name"
}
]
}
```
Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*.
### `tag-resource`
Das folgende Codebeispiel zeigt die Verwendung`tag-resource`.
**AWS CLI**
**So fügen Sie ein Tag zu einem Leistungsanalysebericht hinzu**
Im folgenden Beispiel für `tag-resource` wird der Tag-Schlüssel `name` mit dem Tag-Wert `test-tag` zu einem Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` hinzugefügt.
```
aws pi tag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \
--tags Key=name,Value=test-tag
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/tag-resource.html)in der *AWS CLI Befehlsreferenz*.
### `untag-resource`
Das folgende Codebeispiel zeigt die Verwendung`untag-resource`.
**AWS CLI**
**So löschen Sie ein Tag aus einem Leistungsanalysebericht**
Im folgenden Beispiel für `untag-resource` wird das Tag `name` aus einem Leistungsanalysebericht mit der Berichts-ID `report-0d99cc91c4422ee61` gelöscht.
```
aws pi untag-resource \
--service-type RDS \
--resource-arn arn:aws:pi:us-west-2:123456789012:perf-reports/RDS/db-abcdefg123456789/report-0d99cc91c4422ee61 \
--tag-keys name
```
Mit diesem Befehl wird keine Ausgabe zurückgegeben.
Weitere Informationen zum Markieren von Leistungsanalyseberichten finden Sie unter [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon RDS* und [Hinzufügen von Tags zu einem Leistungsanalysebericht in Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) im *Benutzerhandbuch für Amazon Aurora*.
+ Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/untag-resource.html)in der *AWS CLI Befehlsreferenz*.