翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# でシークレットを検索する AWS Secrets Manager
<a name="manage_search-secret"></a>

フィルタなしでシークレットを検索すると、Secrets Manager はシークレット名、説明、タグキー、およびタグ値のキーワードを照合します。フィルタなしで検索すると、大文字と小文字は区別されず、スペース、/、\$1、=、\$1 などの特殊文字は無視され、数字と文字のみが使用されます。フィルタなしで検索すると、Secrets Manager は検索文字列を分析して個別の単語に変換します。単語は、大文字から小文字、文字から数字、または数字/文字から句読点への変更によって区切られます。たとえば、名前、説明、およびタグのキーと値で、`creds`、`Database`、および `892` を検索する検索語 `credsDatabase#892` を入力するとします。

Secrets Manager では、シークレットをリストアップする際に CloudTrail のログエントリーが生成されます。詳細については、「[で AWS Secrets Manager イベントをログに記録する AWS CloudTrail](monitoring-cloudtrail.md)」を参照してください。

Secrets Manager はリージョンのサービスであり、検索は、選択されたリージョンのシークレットのみを返します。

## 検索フィルター
<a name="manage_search-secret-filters"></a>

フィルターを使用しない場合、Secrets Manager は検索文字列を単語に分割し、すべての属性で一致するものを検索します。この検索では、大文字と小文字は区別されません。例えば、**My\$1Secret** を検索すると、名前、説明、またはタグの **my** または **secret** という単語が含まれるシークレットが一致します。

検索に次のフィルタを適用できます。

**名前**  
シークレット名の先頭に一致します。大文字と小文字は区別されます。たとえば、**名前:** **Data** は、`databaseSecret` でも `MyData` でもない `DatabaseSecret` という名前のシークレットを返します。

**説明**  
シークレットの説明内の単語に一致します。大文字と小文字は区別されません。たとえば、**説明**: **My Description** は、シークレットを次の説明で照合します。  
+ `My Description`
+ `my description`
+ `My basic description`
+ `Description of my secret`

**管理者**  
外部のサービスによって管理されるシークレットを検索します AWS。次に例を示します。  
+ 1Password
+ Akeyless
+ CyberArk
+ HashiCorp

**所有しているサービス**  
管理サービスの ID プレフィックスの先頭に一致します。大文字と小文字は区別されません。例えば、**my-ser** は、プレフィックス `my-serv` および `my-service` を持つサービスが管理するシークレットと一致します。詳細については、「[他のサービスによって管理されるシークレット](service-linked-secrets.md)」を参照してください。

**レプリケート:**  
プライマリシークレット、レプリカシークレット、またはレプリケートされないシークレットをフィルタリングできます。

**タグキー**  
タグキーの先頭に一致します。大文字と小文字は区別されます。たとえば、**タグキー:** **Prod** は、タグ `Production` そして `Prod1` 付きのシークレットを返しますが、タグ `prod` または `1 Prod` 付きのシークレットは返しません。

**タグ 値**  
タグ値の先頭に一致します。大文字と小文字は区別されます。たとえば、**タグ値:** **Prod** はタグ `Production` そして `Prod1` 付きのシークレットを返しますが、タグ値 `prod` または `1 Prod` を持つシークレットは返しません。

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

**Example アカウントにあるシークレットを一覧表示する**  
以下の [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) 例は、 アカウント内にあるシークレットの一覧を取得します。  

```
aws secretsmanager list-secrets
```

**Example アカウントにあるシークレットの一覧をフィルタリングする**  
次の [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) の例は、アカウント内にあり、名前に **Test** が含まれているシークレットの一覧を取得します。名前によるフィルタリングでは、大文字と小文字が区別されます。  

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

**Example 他の AWS サービスによって管理されているシークレットを検索する**  
次の [https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html](https://docs.aws.amazon.com//cli/latest/reference/secretsmanager/list-secrets.html) の例では、サービスによって管理されているシークレットの一覧を取得します。サービスは ID で指定します。詳細については、「[他のサービスによって管理されるシークレット](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>

 AWS SDKs のいずれかを使用してシークレットを検索するには、 を使用します[https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecrets.html](https://docs.aws.amazon.com/secretsmanager/latest/apireference/API_ListSecrets.html)。詳細については、「[AWS SDKs](asm_access.md#asm-sdks)」を参照してください。