기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Resource Explorer에 대한 검색 쿼리 구문 참조
<a name="using-search-query-syntax"></a>

AWS 리소스 탐색기 는 에서 개별 AWS 리소스를 찾는 데 도움이 됩니다 AWS 계정. 원하는 리소스를 정확히 찾을 수 있도록 Resource Explorer는 이 항목에 설명된 구문을 지원하는 검색 쿼리 문자열을 허용합니다. 여기에 설명된 기능을 사용하는 방법을 보여 주는 쿼리의 예제는 [Resource Explorer 검색 쿼리 예제](using-search-query-examples.md)를 참조하세요.

**참고**  
현재 역할 또는 사용자와 같이 AWS Identity and Access Management (IAM) 리소스에 연결된 태그는 인덱싱되지 않습니다.

## Resource Explorer에서 쿼리가 작동하는 방식
<a name="query-background"></a>

검색 쿼리는 항상 뷰를 사용합니다. 명시적으로 지정하지 않으면 Resource Explorer는 작업 AWS 리전 중인 의 기본값으로 지정된 보기를 사용합니다.

뷰는 쿼리에 사용할 수 있는 리소스를 결정합니다. 각각 다른 리소스 세트를 반환하는 다양한 뷰를 생성할 수 있습니다.

예를 들어 키 `Environment` 및 값 `Production`으로 태그가 지정된 리소스만 포함하는 뷰를 생성할 수 있습니다. 그런 다음 해당 리소스를 봐야 하는 업무상 이유가 있는 사용자에게만 해당 뷰에 대한 액세스 권한을 부여하도록 선택할 수 있습니다. `Alpha` 또는 `Beta` 환경 리소스가 포함된 별도의 뷰에는 해당 리소스를 확인해야 하는 여러 사용자가 액세스할 수 있습니다. 각 뷰에 액세스할 수 있는 사용자를 제어하는 방법에 대한 자세한 내용은 [검색을 위해 Resource Explorer 뷰에 대한 액세스 권한 부여](manage-views-grant-access.md)를 참조하세요.

## 쿼리 문자열 구문
<a name="query-syntax"></a>

이 섹션에서는 쿼리 구문, 필터 및 필터 연산자의 기본 측면에 대한 정보를 제공합니다.

### 기본 사항
<a name="query-syntax-basics"></a>

가장 기본적으로 `QueryString`은 논리 `OR` 연산자로 암시적으로** 결합되는 자유 형식 텍스트 키워드 세트입니다. 다음 예제와 같이 공백을 사용하여 각 키워드를 다른 키워드와 구분합니다.

`ec2 billing test gamma`

Resource Explorer는 이 키워드 목록을 다음과 같은 의미로 평가합니다.

`ec2 OR billing OR test OR gamma`

Resource Explorer는 관련성을 기준으로 결과를 정렬하여 더 많은 수의 검색어와 일치하는 리소스에 더 높은 우선 순위를 부여합니다. 하나 이상의 용어와 일치하지 않는 리소스는 결과에서 제외되지 않습니다. 하지만 Resource Explorer는 관련성이 낮은 것으로 간주하여 검색 결과에서 더 아래로 밀어냅니다.

`QueryString` 파라미터에 빈 문자열을 지정하는 경우 쿼리는 작업에 사용된 뷰를 통해 사용할 수 있는 첫 1,000개의 리소스를 반환합니다. 쿼리에서 반환할 수 있는 최대 리소스 수는 1,000개입니다.

**참고**  
AWS 는 자유 형식 텍스트 키워드를 평가하기 위해 일치하는 로직 및 관련성 알고리즘을 업데이트하여 고객에게 가장 적절한 결과를 제공할 수 있는 권한을 보유합니다. 따라서 자유 형식 텍스트 키워드를 사용한 동일한 쿼리에 대해 반환되는 결과는 시간이 지남에 따라 변경될 수 있습니다. 보다 확실한 결과가 필요한 경우 필터를 사용하는 것이 좋습니다. 필터 매칭 로직은 시간이 지나도 변경되지 않습니다.

### 필터
<a name="query-syntax-filters"></a>

**필터****를 포함하면 쿼리 결과를 더 엄격하게 제한할 수 있습니다. 텍스트 키워드와 달리 필터는 **AND** 연산자를 사용하여 쿼리에서 평가됩니다. 예를 들어 두 개의 자유 형식 키워드와 두 개의 필터로 구성된 다음 쿼리를 생각해 보세요.

```
test instance service:EC2 region:us-west-2
```

이 쿼리는 다음과 같이 평가됩니다.

```
( test OR instance ) AND service:EC2 AND region:us-west-2
```

필터는 항상 **AND** 논리적 연산자를 사용하여 평가됩니다. 리소스가 필터와 일치하지 않는 경우 해당 리소스는 결과에 포함되지 않습니다. 예제 쿼리 결과에는 Amazon과 연결되어 EC2 있고 미국 서부(오레곤)에 있으며 어떤 방식으로든 키워드 중 하나 이상이 연결된 리소스 AWS 리전 가 포함됩니다.

**참고**  
암시적 `AND`로 인해 리소스와 연결된 값을 하나만 가질 수 있는 속성에 대해 하나의 필터만 사용할 수 있습니다. 예를 들어, 리소스는 하나의 AWS 리전에만 속할 수 있습니다. 따라서 다음 쿼리는 결과를 반환하지 않습니다.  

```
region:us-east-1 region:us-west-1
```
이 제한은 동시에 여러 값을 가질 수 있는 속성(예: `tag:`, `tag.key:`, `tag.value:`)의 필터에는 적용되지 **않습니다****.

다음 표에는 Resource Explorer 검색 쿼리에 사용할 수 있는 사용 가능한 필터 이름이 나열되어 있습니다.


| 필터 이름 | 설명 및 예제 | 
| --- | --- | 
| `accountid:` | 리소스를 소유 AWS 계정 한 . Resource Explorer는 지정된 계정이 소유한 리소스만 결과에 포함합니다.<br />`accountid:123456789012` | 
| `application:` | 이 필터를 사용하면 `awsApplication` 태그 키와 리소스 그룹 값을 사용하여 리소스를 검색할 수 있습니다. 애플리케이션 이름 또는 애플리케이션 리소스 그룹 으로 검색할 수 있습니다ARN.<br />`application:MyApplicationName`<br />`application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced`<br />`arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced` 이 필터를 사용하려면 뷰에 태그 지정 데이터에 대한 액세스 권한이 있어야 합니다.  | 
| `id:` | 개별 리소스의 식별자로, [Amazon 리소스 이름(ARN)](https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html)으로 표시됩니다.<br />`id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE` | 
| `region:` | 리소스가 있는 AWS 리전 위치입니다. Resource Explorer는 결과에 지정된 에 있는 리소스만 포함합니다 AWS 리전.<br />`region:us-east-1` 리전 코드만 입력하면(예: `us-east-1`와 같은 필터 없이) `region:us-east-1`와 동일한 결과를 반환하지 않습니다. 이 결과는 필터가 아닌 자유 형식 텍스트 키워드로서 리전 코드가 개별 조각으로 분류되기 때문입니다. 예를 들어, `us-east-1`은 `us`, `east`, `1`로 검색됩니다. `region:` 접두사를 사용하면 이러한 구성 요소 분류가 발생하지 않습니다.  | 
| `region:global` | 개인과 연결되지는 AWS 리전 않았지만 범위가 글로벌로 간주되는 리소스를 찾는 데 사용할 수 있는 `region:` 필터의 특수 사례입니다.<br />`region:global` 키워드 `global`만 입력하면 리터럴 단어 “global”이 글로벌 리소스에 연결되지 않기 때문에 `region:global`과 동일한 결과가 반환되지 않습니다. `global`을 키워드로 입력하면 해당 리소스와 연결된 리터럴 문자열이 있는 리소스만 반환됩니다.  | 
| `resourcetype:` | `{{service}}:{{type}}` 표기법의 리소스 유형입니다. Resource Explorer는 지정된 유형의 리소스만 결과에 포함합니다.<br />`resourcetype:ec2:instance` | 
| `resourcetype.supports:` | 이 필터를 사용하면 태그를 지원하는 리소스를 검색할 수 있습니다. `tags`는 지원되는 유일한 값입니다. Resource Explorer는 태그 지정 가능한 리소스만 결과에 포함합니다.<br />`resourcetype.supports:tags` | 
| `service:` | 리소스 유형과 AWS 서비스 연결된 . Resource Explorer는 지정된 서비스에 의해 생성되고 관리되는 리소스만 결과에 포함합니다.<br />`service:ec2` | 
| `tag:` | `<key>=<value>`으로 표현되는 태그 키/값 쌍입니다. Resource Explorer는 일치하는 키와 지정된 값이 모두 있는 태그가 있는 리소스만 결과에 포함합니다.<br />`tag:environment=production` | 
| `tag:all` | Resource Explorer에서 리소스 유형이 지원되지 않더라도 하나 이상의 사용자 생성 태그가 연결된 리소스를 검색할 수 있는 `tag:` 필터의 특수 사례입니다. AWS 서비스 생성** 태그가 있는 리소스는 여전히 이 필터의 결과에 표시됩니다.  | 
| `tag:none` | 사용자가 생성한 태그가 연결되지 않은 리소스를 검색할 수 있는 `tag:` 필터의 특이 케이스입니다. AWS 서비스 생성** 태그가 있는 리소스는 여전히 이 필터의 결과에 표시됩니다.  | 
| `tag.key:` | 태그 키. Resource Explorer는 값에 관계없이 일치하는 키가 있는 태그가 있는 리소스만 결과에 포함합니다.<br />`tag.key:environment` | 
| `tag.value:` | 태그 값. Resource Explorer는 키 이름에 관계없이 일치하는 값이 있는 태그가 있는 리소스만 결과에 포함합니다.<br />`tag.value:production` | 

### 필터 연산자
<a name="query-syntax-operators"></a>

다음 표에 표시된 연산자 중 하나를 문자열의 일부로 포함하여 키워드와 필터를 수정할 수 있습니다.


| 연산자 | 설명 및 예제 | 
| --- | --- | 
| `"{{multiple word phrase}}"`<br />또는<br />"{{hyphenated-phrase}}" | 단일 키워드로 취급해야 하는 여러 단어로 구성된 구문을 큰따옴표(`" "`)로 묶습니다. Resource Explorer는 전체 구문과 모든 단어가 함께 지정된 순서대로 일치하는 리소스만 포함합니다.<br />큰따옴표를 사용하지 않으면 Resource Explorer는 구문을 공백이나 하이픈으로 구성 요소로 나누고, 함께 있지 않거나 순서가 다르더라도 개별 구성 요소와 일치하는 리소스를 포함합니다. 견적은 연산자 뒤의 모든 것에 관한 것이어야 합니다.<br />`"This matches only resources with the whole sentence."`<br />`This matches resources with any of the words.`<br />`"us-east-1"` - 정확한 리전과 연결된 리소스만 일치합니다.<br />`us-east-1` - “us”, “east” 또는 “1"을 포함하는 모든 리소스와 일치합니다.<br />`-tag:"environment=production"`  | 
| `{{keyword}}*` |  접두사 와일드카드 매칭. 문자열의 끝에만 와일드카드 문자(별표 `*`)를 넣을 수 있습니다. Resource Explorer는 `*` 앞에 접두사 텍스트로 시작하는 값이 있는 리소스만 결과에 포함합니다. 다음 예제는 로 시작하는 모든 와 일치 AWS 리전 합니다`us-east`.<br />`region:us-east*` 통합 검색은 문자열의 첫 번째 키워드 끝에 와일드카드 문자(`*`) 연산자를 자동으로 삽입합니다. 즉, 통합 검색 결과에는 지정된 키워드로 시작하는 모든 문자열과 일치하는 리소스가 포함됩니다. <br />Resource Explorer 콘솔의 [리소스 검색](https://console.aws.amazon.com/resource-explorer/home#/explorer) 페이지에 있는 **쿼리** 텍스트 상자에서 수행되는 검색에는 와일드카드 문자가 자동으로 추가되지 **않습니다****. 검색 문자열에서 용어 뒤에 `*`를 수동으로 삽입할 수 있습니다.  | 
| `-{{keyword}}` | `Not` 연산자. 키워드 또는 필터의 시작 부분에 하이픈(`-`)을 삽입하여 검색 결과를 반전시킬 수 있습니다. Resource Explorer는 이 연산자 다음에 오는 키워드 또는 필터와 일치하는 모든 리소스를 결과에서 **제외합니다****. 다음 예제에서는 Amazon EC2 서비스와 연결된 모든 리소스를 결과에서 제외합니다.<br />`-service:ec2` 명령을 사용하고 AWS CLI `search` `--query-string` 파라미터 값에 `-` 연산자가 첫 번째 문자인 경우 파라미터 이름을 일반 공백 문자 대신 동일한 기호 문자(`=`)로 해당 값과 분리해야 합니다. 공백 문자를 사용하면 가 문자열을 CLI 잘못 해석합니다. 예를 들어 다음 쿼리는 실패합니다. <pre>aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"</pre> <br />공백을 `=`으로 대체하는 다음 수정된 쿼리 문자열은 예상대로 작동합니다. <pre>aws resource-explorer-2 search --query-string{{=}}"-tag:none region:us-east-1"</pre> <br />`-`가 파라미터 값의 첫 번째 문자가 되지 않도록 쿼리 문자열에서 필터 순서를 변경하는 경우 표준 공백 문자를 사용할 수 있습니다. 다음 쿼리 문자열은 작동합니다. <pre>aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"</pre>  | 
| \\{{<special character>}} | 해석하지 않고 표시된 대로 정확히 포함해야 하는 특수 문자를 이스케이프할 수 있습니다. 텍스트에 특수 문자(` * " - : = \`) 중 하나가 포함된 경우 문자 그대로 해석되도록 하려면 해당 문자 앞에 백슬래시(`\`)를 붙여야 합니다. 다음은 하이픈(`-`) 문자(`"my-key-word"`)가 포함된 자유 형식 텍스트 키워드를 사용하는 방법을 나타낸 예제입니다.<br />또한 Resource Explorer에서 하이픈의 표현식을 세 개의 개별 키워드로 분리하지 않도록 문구 전체를 큰따옴표로 묶을 수 있습니다.<br /> `"my\-key\-word"` <br />리터럴 백슬래시를 삽입하려면 두 개의 백슬래시 문자를 연속으로 삽입하세요. 첫 번째 백슬래시는 이스케이프 문자로 해석되고 두 번째 백슬래시는 삽입할 리터럴 문자입니다.<br />`"some_text\\some_more_text"` | 

**참고**  
뷰에 리소스에 연결된 태그가 포함되어 있는 경우 유효하지 않은 필터가 자유 형식 텍스트 검색으로 해석될 수도 있기 때문에 `Search` 작업 시 검색 문자열에 대한 검증 오류가 발생하지 않습니다. 예를 들어 `cat:blue`가 필터처럼 **보이더라도**** `cat:`는 유효하고 정의된 필터 중 하나가 아니기 때문에 Resource Explorer는 이를 하나로 구문 분석할 수 없습니다. 대신 Resource Explorer는 전체 문자열을 자유 형식 검색 문자열로 해석하여 태그 키 이름이나 의 일부와 일치시킬 수 있습니다ARN.  
다음 중 하나가 true일 경우 작업 시 검증 오류가 발생합니다.  
뷰에 태그에 대한 정보가 포함되지 않음
검색 쿼리가 명시적으로 태그 필터(`tag.key:`, `tag.value:` 또는 `tag:`)를 사용함