

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

# Encontre segredos em AWS Secrets Manager
<a name="manage_search-secret"></a>

Quando você pesquisa por segredos sem um filtro, o Secrets Manager faz correspondências com base em palavras-chave com o nome do segredo, descrição, chave de tag e valor da tag. Pesquisar sem filtros não diferencia maiúsculas de minúsculas e ignora caracteres especiais, como espaço, /, \$1, =, \$1, e usa apenas números e letras. Quando você pesquisa sem um filtro, o Secrets Manager analisa a string de pesquisa para convertê-la em palavras separadas. As palavras são separadas por qualquer alteração de maiúsculas para minúsculas, de letra para número ou de pontuação. number/letter Por exemplo, inserir o termo de pesquisa `credsDatabase#892` gera a pesquisa por `creds`, `Database` e `892` no nome, descrição e chave de tag e valor.

O Secrets Manager gera uma entrada de CloudTrail registro quando você lista segredos. Para obter mais informações, consulte [AWS Secrets Manager Registre eventos com AWS CloudTrail](monitoring-cloudtrail.md).

O Secrets Manager é um serviço regional e apenas segredos na região selecionada são retornados.

## Filtros de pesquisa
<a name="manage_search-secret-filters"></a>

Se você não usar nenhum filtro, o Secrets Manager dividirá a string de pesquisa em palavras e, em seguida, pesquisará correspondências em todos os atributos. Essa pesquisa não diferencia maiúsculas de minúsculas. Por exemplo, pesquisar por **My\$1Secret** encontra correspondência com segredos com a palavra **my** ou **secret** no nome, na descrição ou nas tags.

É possível aplicar os seguintes filtros para sua pesquisa:

**Nome**  
Encontra correspondências com o início dos nomes de segredo; diferencia maiúsculas de minúsculas. Por exemplo, **Name:** **Data** retorna um segredo nomeado como `DatabaseSecret`, mas não `databaseSecret` ou `MyData`. 

**Description**  
Encontra correspondência nas palavras em descrições dos segredos, não diferencia letras maiúsculas de minúsculas. Por exemplo, **Description**: **My Description** encontra correspondências entre segredos com as seguintes descrições:   
+ `My Description`
+ `my description`
+ `My basic description`
+ `Description of my secret`

**Gerenciado por**  
Encontra segredos gerenciados por serviços externos à AWS, por exemplo:  
+ 1Password
+ Akeyless
+ CyberArk
+ HashiCorp

**Serviço de propriedade**  
Faz correspondências com o início do prefixo do ID do serviço de gerenciamento, não diferencia maiúsculas de minúsculas. Por exemplo, **my-ser** faz a correspondência com segredos gerenciados por serviços com os prefixos `my-serv` e `my-service`. Para obter mais informações, consulte [Segredos gerenciados por outros serviços](service-linked-secrets.md). 

**Segredos replicados**  
É possível filtrar segredos primários, réplicas de segredo ou segredos que não estão replicados.

**Chaves de tags**  
Encontra correspondências com o início das chaves de tag; diferencia maiúsculas de minúsculas. Por exemplo, **Tag key:** **Prod** retorna segredos com as tags `Production` e `Prod1`, mas não segredos com as tags `prod` ou `1 Prod`.

**Valores de tags**  
Encontra correspondências com o início dos valores de tag; diferencia maiúsculas de minúsculas. Por exemplo, **Tag value:** **Prod** retorna segredos com as tags `Production` e `Prod1`, mas não segredos com valor de tag `prod` ou `1 Prod`. 

## AWS CLI
<a name="manage_search-secret_cli"></a>

**Example Listar os segredos em sua conta**  
O exemplo de [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) a seguir mostra uma lista dos segredos em sua conta.  

```
aws secretsmanager list-secrets
```

**Example Filtrar a lista de segredos em sua conta**  
O exemplo de [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) a seguir obtém uma lista dos segredos em sua conta que têm **Test** no nome. A filtragem por nome diferencia maiúsculas de minúsculas.  

```
aws secretsmanager list-secrets \
    --filters Key="name",Values="Test"
```

**Example Encontre segredos que são gerenciados por outros AWS serviços**  
O exemplo de [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) a seguir obtém uma lista de segredos gerenciados por um serviço. Você especifica o ID do serviço. Para obter mais informações, consulte [Segredos gerenciados por outros serviços](service-linked-secrets.md).  

```
aws secretsmanager list-secrets \
    --filters Key="owning-service",Values="<service ID prefix>"
```

## AWS SDK
<a name="manage_search-secret_sdk"></a>

Para descobrir segredos usando um dos AWS SDKs, use [https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecrets.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecrets.html). Para obter mais informações, consulte [AWS SDKs](asm_access.md#asm-sdks).

