

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Exemplos de Performance Insights do Amazon RDS usando AWS CLI
<a name="cli_2_pi_code_examples"></a>

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o Amazon RDS Performance Insights.

*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

**Topics**
+ [Ações](#actions)

## Ações
<a name="actions"></a>

### `create-performance-analysis-report`
<a name="pi_CreatePerformanceAnalysisReport_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `create-performance-analysis-report`.

**AWS CLI**  
**Como criar um relatório de análise de performance**  
O exemplo `create-performance-analysis-report` a seguir cria um relatório de análise de performance com o horário de início `1682969503` e o horário de término `1682979503` do banco de dados `db-abcdefg123456789`.  

```
aws pi create-performance-analysis-report \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --start-time 1682969503 \
    --end-time 1682979503
```
Saída:  

```
{
    "AnalysisReportId": "report-0234d3ed98e28fb17"
}
```
Para ter mais informações sobre como criar relatórios de análise de performance, consulte [Criar um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) no *Guia do usuário do Amazon RDS* e [Criar um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.CreatingPerfAnlysisReport.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [CreatePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/create-performance-analysis-report.html)em *Referência de AWS CLI Comandos*. 

### `delete-performance-analysis-report`
<a name="pi_DeletePerformanceAnalysisReport_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `delete-performance-analysis-report`.

**AWS CLI**  
**Como excluir um relatório de análise de performance**  
O exemplo `delete-performance-analysis-report` a seguir exclui o relatório de análise de performance com o ID de relatório `report-0d99cc91c4422ee61`.  

```
aws pi delete-performance-analysis-report \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --analysis-report-id report-0d99cc91c4422ee61
```
Este comando não produz saída.  
Para ter mais informações sobre como excluir relatórios de análise de performance, consulte [Excluir um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) no *Guia do usuário do Amazon RDS* e [Excluir um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.DeletePerfAnalysisReport.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [DeletePerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/delete-performance-analysis-report.html)em *Referência de AWS CLI Comandos*. 

### `describe-dimension-keys`
<a name="pi_DescribeDimensionKeys_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `describe-dimension-keys`.

**AWS CLI**  
**Exemplo 1: descrever chaves de dimensão**  
Este exemplo solicita os nomes de todos os eventos de espera. Os dados são organizados pelo nome do evento e pelos valores agregados desses eventos durante o período especificado.  
Comando:  

```
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"}'
```
Saída:  

```
{
    "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
        }
    ]
}
```
**Exemplo 2: encontrar o ID SQL das instruções que mais contribuem para a carga do banco de dados**  
O `describe-dimension-keys` a seguir solicita a instrução SQL e o ID SQL para as dez instruções que mais contribuíram para a carga do banco de dados.  

```
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}'
```
Saída:  

```
{
    "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]
                }
            ]
        }
    ]
}
```
Para ter mais informações sobre carga de banco de dados, consulte [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon RDS* ou [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [DescribeDimensionKeys](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/describe-dimension-keys.html)em *Referência de AWS CLI Comandos*. 

### `get-dimension-key-details`
<a name="pi_GetDimensionKeyDetails_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-dimension-key-details`.

**AWS CLI**  
**Como obter detalhes de um grupo de dimensões especificado para uma instância de banco de dados**  
O exemplo `get-dimension-key-details` a seguir recupera o texto completo de uma instrução SQL para a instância de banco de dados `db-10BCD2EFGHIJ3KL4M5NO6PQRS5`. O `--group` é `db.sql`, e o `--group-identifier` é `db.sql.id`. Neste exemplo, `example-sql-id` representa um ID SQL recuperado usando as operações `get-resource-metrics` ou `describe-dimension-keys`. Nesse exemplo, os detalhes das dimensões estão disponíveis. Assim, o Performance Insights recupera o texto completo da instrução SQL, sem truncá-lo.  

```
aws pi get-dimension-key-details \
    --service-type RDS \
    --identifier db-10BCD2EFGHIJ3KL4M5NO6PQRS5 \
    --group db.sql \
    --group-identifier example-sql-id \
    --requested-dimensions statement
```
Saída:  

```
{
    "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"
        },
    ...
    ]
}
```
Para ter mais informações sobre carga de banco de dados, consulte [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon RDS* ou [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [GetDimensionKeyDetails](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-dimension-key-details.html)em *Referência de AWS CLI Comandos*. 

### `get-performance-analysis-report`
<a name="pi_GetPerformanceAnalysisReport_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-performance-analysis-report`.

**AWS CLI**  
**Como visualizar um relatório de análise de performance**  
O exemplo `get-performance-analysis-report` a seguir obtém o relatório de análise de performance para o banco de dados `db-abcdefg123456789` com o ID de relatório `report-0d99cc91c4422ee61`. A resposta fornece o status, o ID, os detalhes do horário e os insights do relatório.  

```
aws pi get-performance-analysis-report \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --analysis-report-id report-0d99cc91c4422ee61
```
Saída:  

```
{
    "AnalysisReport": {
        "Status": "Succeeded",
        "ServiceType": "RDS",
        "Identifier": "db-abcdefg123456789",
        "StartTime": 1680583486.584,
        "AnalysisReportId": "report-0d99cc91c4422ee61",
        "EndTime": 1680587086.584,
        "CreateTime": 1680587087.139,
        "Insights": [
            ... (Condensed for space)
       ]
    }
}
```
Para ter mais informações sobre relatórios de análise de performance, consulte [Analisar a performance do banco de dados por um período](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) no *Guia do usuário do Amazon RDS* e [Analisar a performance do banco de dados por um período](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [GetPerformanceAnalysisReport](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-performance-analysis-report.html)em *Referência de AWS CLI Comandos*. 

### `get-resource-metadata`
<a name="pi_GetResourceMetadata_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-resource-metadata`.

**AWS CLI**  
**Como obter metadados de recursos para um banco de dados**  
O exemplo `get-resource-metadata` a seguir obtém os metadados do recurso para o banco de dados `db-abcdefg123456789`. A resposta mostra que as estatísticas de resumo do SQL estão habilitadas.  

```
aws pi get-resource-metadata \
    --service-type RDS \
    --identifier db-abcdefg123456789
```
Saída:  

```
{
    "Identifier": "db-abcdefg123456789",
    "Features":{
        "SQL_DIGEST_STATISTICS":{
            "Status": "ENABLED"
        }
    }
}
```
Para ter mais informações sobre estatísticas SQL para o Performance Insights, consulte [Estatísticas SQL para Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/sql-statistics.html) no *Guia do usuário do Amazon RDS* e [Estatísticas SQL para Performance Insights](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/sql-statistics.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [GetResourceMetadata](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metadata.html)em *Referência de AWS CLI Comandos*. 

### `get-resource-metrics`
<a name="pi_GetResourceMetrics_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `get-resource-metrics`.

**AWS CLI**  
**Para obter métricas de recursos**  
Este exemplo solicita pontos de dados para o grupo de dimensões *db.wait\$1event* e para a dimensão *db.wait\$1event.name* dentro desse grupo. Na resposta, os pontos de dados relevantes são agrupados pela dimensão solicitada (*db.wait\$1event.name*).  
Comando:  

```
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
```
Os argumentos para `--metric-queries` são armazenados no arquivo JSON chamado `metric-queries.json`. Veja o conteúdo desse arquivo:  

```
[
    {
        "Metric": "db.load.avg",
        "GroupBy": {
            "Group":"db.wait_event"
        }
    }
]
```
Saída:  

```
{
    "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...>
    ]
}
```
+  Para obter detalhes da API, consulte [GetResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/get-resource-metrics.html)em *Referência de AWS CLI Comandos*. 

### `list-available-resource-dimensions`
<a name="pi_ListAvailableResourceDimensions_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-available-resource-dimensions`.

**AWS CLI**  
**Como listar as dimensões que podem ser consultadas para um tipo de métrica em uma instância de banco de dados**  
O exemplo `list-available-resource-dimensions` a seguir lista as métricas `db.load` que você pode consultar para o banco de dados `db-abcdefg123456789`.  

```
aws pi list-available-resource-dimensions \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --metrics db.load
```
Saída:  

```
{
    "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"
                        }
                    ]
                },
                ...
            ]
        }
    ]
}
```
Para ter mais informações sobre carga de banco de dados, consulte [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon RDS* ou [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [ListAvailableResourceDimensions](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-dimensions.html)em *Referência de AWS CLI Comandos*. 

### `list-available-resource-metrics`
<a name="pi_ListAvailableResourceMetrics_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-available-resource-metrics`.

**AWS CLI**  
**Como listar as métricas que podem ser consultadas para um tipo de métrica em uma instância de banco de dados**  
O exemplo `list-available-resource-metrics` a seguir lista as métricas `db.load` que você pode consultar para o banco de dados `db-abcdefg123456789`.  

```
aws pi list-available-resource-metrics \
    --service-type RDS \
    --identifier db-abcdefg123456789 \
    --metric-types "os" "db"
```
Saída:  

```
{
    "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"
        },
        ......
    ]
}
```
Para ter mais informações sobre métricas no Insights de Performance, consulte [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon RDS* ou [Carga de banco de dados](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.Overview.ActiveSessions.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [ListAvailableResourceMetrics](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-available-resource-metrics.html)em *Referência de AWS CLI Comandos*. 

### `list-performance-analysis-reports`
<a name="pi_ListPerformanceAnalysisReports_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-performance-analysis-reports`.

**AWS CLI**  
**Como listar relatórios de análise de performance para um banco de dados**  
O exemplo `list-performance-analysis-reports` a seguir lista todos os relatórios de análise de performance disponíveis para o banco de dados `db-abcdefg123456789`. A resposta lista todos os relatórios com o ID do relatório, o status e os detalhes do período.  

```
aws pi list-performance-analysis-reports \
    --service-type RDS \
    --identifier db-abcdefg123456789
```
Saída:  

```
{
    "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"
        }
    ]
}
```
Para ter mais informações sobre relatórios de análise de performance, consulte [Analisar a performance do banco de dados por um período](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) no *Guia do usuário do Amazon RDS* e [Analisar a performance do banco de dados por um período](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.AnalyzePerformanceTimePeriod.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [ListPerformanceAnalysisReports](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-performance-analysis-reports.html)em *Referência de AWS CLI Comandos*. 

### `list-tags-for-resource`
<a name="pi_ListTagsForResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `list-tags-for-resource`.

**AWS CLI**  
**Como listar tags para um relatório de análise de performance**  
O exemplo `list-tags-for-resource` a seguir lista as tags para um relatório de análise de performance com o ID de relatório `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
```
Saída:  

```
{
    "Tags": [
        {
            "Value": "test-tag",
            "Key": "name"
        }
    ]
}
```
Para ter mais informações sobre como marcar relatórios de análise de performance, consulte [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon RDS* e [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*. 

### `tag-resource`
<a name="pi_TagResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `tag-resource`.

**AWS CLI**  
**Como adicionar tags a um relatório de análise de performance**  
O exemplo `tag-resource` a seguir adiciona a chave de tag `name` com o valor de tag `test-tag` a um relatório de análise de performance com o ID de relatório `report-0d99cc91c4422ee61`.  

```
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
```
Este comando não produz saída.  
Para ter mais informações sobre como marcar relatórios de análise de performance, consulte [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon RDS* e [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/tag-resource.html)em *Referência de AWS CLI Comandos*. 

### `untag-resource`
<a name="pi_UntagResource_cli_2_topic"></a>

O código de exemplo a seguir mostra como usar `untag-resource`.

**AWS CLI**  
**Como excluir tags a um relatório de análise de performance**  
O exemplo `untag-resource` a seguir exclui a tag `name` de um relatório de análise de performance com o ID de relatório `report-0d99cc91c4422ee61`.  

```
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
```
Este comando não produz saída.  
Para ter mais informações sobre como marcar relatórios de análise de performance, consulte [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon RDS* e [Adicionar tags a um relatório de análise de performance no Insights de Performance](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_PerfInsights.UsingDashboard.ManagePerfAnalysisReportTags.html) no *Guia do usuário do Amazon Aurora*.  
+  Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/pi/untag-resource.html)em *Referência de AWS CLI Comandos*. 