Resource Explorer에 대한 검색 쿼리 구문 참조 - AWS 리소스 탐색기

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

Resource Explorer에 대한 검색 쿼리 구문 참조

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

참고

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

Resource Explorer에서 쿼리가 작동하는 방식

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

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

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

쿼리 문자열 구문

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

기본 사항

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

필터

필터를 포함하면 쿼리 결과를 더 엄격하게 제한할 수 있습니다. 텍스트 키워드와 달리 필터는 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는 지정된 계정이 소유한 리소스만 결과에 포함합니다.

accountid:123456789012

application:

이 필터를 사용하면 awsApplication 태그 키와 리소스 그룹 값을 사용하여 리소스를 검색할 수 있습니다. 애플리케이션 이름 또는 애플리케이션 리소스 그룹 으로 검색할 수 있습니다ARN.

application:MyApplicationName

application:arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

arn:aws:resource-groups:us-east-1:123456789012:group/MyApplicationName/123456789abced

참고

이 필터를 사용하려면 뷰에 태그 지정 데이터에 대한 액세스 권한이 있어야 합니다.

id:

개별 리소스의 식별자로, Amazon 리소스 이름(ARN)으로 표시됩니다.

id:arn:aws:license-manager:us-east-1:123456789012:license-configuration:lic-ecbd5574fd92cb0d312baea26EXAMPLE

region:

리소스가 있는 AWS 리전 위치입니다. Resource Explorer는 결과에 지정된 에 있는 리소스만 포함합니다 AWS 리전.

region:us-east-1

참고

리전 코드만 입력하면(예: us-east-1와 같은 필터 없이) region:us-east-1와 동일한 결과를 반환하지 않습니다. 이 결과는 필터가 아닌 자유 형식 텍스트 키워드로서 리전 코드가 개별 조각으로 분류되기 때문입니다. 예를 들어, us-east-1us, east, 1로 검색됩니다. region: 접두사를 사용하면 이러한 구성 요소 분류가 발생하지 않습니다.

region:global

개인과 연결되지는 AWS 리전 않았지만 범위가 글로벌로 간주되는 리소스를 찾는 데 사용할 수 있는 region: 필터의 특수 사례입니다.

region:global

참고

키워드 global만 입력하면 리터럴 단어 “global”이 글로벌 리소스에 연결되지 않기 때문에 region:global과 동일한 결과가 반환되지 않습니다. global을 키워드로 입력하면 해당 리소스와 연결된 리터럴 문자열이 있는 리소스만 반환됩니다.

resourcetype:

service:type 표기법의 리소스 유형입니다. Resource Explorer는 지정된 유형의 리소스만 결과에 포함합니다.

resourcetype:ec2:instance

resourcetype.supports:

이 필터를 사용하면 태그를 지원하는 리소스를 검색할 수 있습니다. tags는 지원되는 유일한 값입니다. Resource Explorer는 태그 지정 가능한 리소스만 결과에 포함합니다.

resourcetype.supports:tags

service:

리소스 유형과 AWS 서비스 연결된 . Resource Explorer는 지정된 서비스에 의해 생성되고 관리되는 리소스만 결과에 포함합니다.

service:ec2

tag:

<key>=<value>으로 표현되는 태그 키/값 쌍입니다. Resource Explorer는 일치하는 키와 지정된 값이 모두 있는 태그가 있는 리소스만 결과에 포함합니다.

tag:environment=production

tag:all

Resource Explorer에서 리소스 유형이 지원되지 않더라도 하나 이상의 사용자 생성 태그가 연결된 리소스를 검색할 수 있는 tag: 필터의 특수 사례입니다.

참고

AWS 서비스 생성 태그가 있는 리소스는 여전히 이 필터의 결과에 표시됩니다.

tag:none

사용자가 생성한 태그가 연결되지 않은 리소스를 검색할 수 있는 tag: 필터의 특이 케이스입니다.

참고

AWS 서비스 생성 태그가 있는 리소스는 여전히 이 필터의 결과에 표시됩니다.

tag.key:

태그 키. Resource Explorer는 값에 관계없이 일치하는 키가 있는 태그가 있는 리소스만 결과에 포함합니다.

tag.key:environment

tag.value:

태그 값. Resource Explorer는 키 이름에 관계없이 일치하는 값이 있는 태그가 있는 리소스만 결과에 포함합니다.

tag.value:production

필터 연산자

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

연산자 설명 및 예제

"multiple word phrase"

또는

"hyphenated-phrase"

단일 키워드로 취급해야 하는 여러 단어로 구성된 구문을 큰따옴표(" ")로 묶습니다. Resource Explorer는 전체 구문과 모든 단어가 함께 지정된 순서대로 일치하는 리소스만 포함합니다.

큰따옴표를 사용하지 않으면 Resource Explorer는 구문을 공백이나 하이픈으로 구성 요소로 나누고, 함께 있지 않거나 순서가 다르더라도 개별 구성 요소와 일치하는 리소스를 포함합니다. 견적은 연산자 뒤의 모든 것에 관한 것이어야 합니다.

"This matches only resources with the whole sentence."

This matches resources with any of the words.

"us-east-1" - 정확한 리전과 연결된 리소스만 일치합니다.

us-east-1 - “us”, “east” 또는 “1"을 포함하는 모든 리소스와 일치합니다.

-tag:"environment=production"

keyword*

접두사 와일드카드 매칭. 문자열의 끝에만 와일드카드 문자(별표 *)를 넣을 수 있습니다. Resource Explorer는 * 앞에 접두사 텍스트로 시작하는 값이 있는 리소스만 결과에 포함합니다. 다음 예제는 로 시작하는 모든 와 일치 AWS 리전 합니다us-east.

region:us-east*

중요

통합 검색은 문자열의 첫 번째 키워드 끝에 와일드카드 문자(*) 연산자를 자동으로 삽입합니다. 즉, 통합 검색 결과에는 지정된 키워드로 시작하는 모든 문자열과 일치하는 리소스가 포함됩니다.

Resource Explorer 콘솔의 리소스 검색 페이지에 있는 쿼리 텍스트 상자에서 수행되는 검색에는 와일드카드 문자가 자동으로 추가되지 않습니다. 검색 문자열에서 용어 뒤에 *를 수동으로 삽입할 수 있습니다.

-keyword

Not 연산자. 키워드 또는 필터의 시작 부분에 하이픈(-)을 삽입하여 검색 결과를 반전시킬 수 있습니다. Resource Explorer는 이 연산자 다음에 오는 키워드 또는 필터와 일치하는 모든 리소스를 결과에서 제외합니다. 다음 예제에서는 Amazon EC2 서비스와 연결된 모든 리소스를 결과에서 제외합니다.

-service:ec2

중요

명령을 사용하고 AWS CLI search --query-string 파라미터 값에 - 연산자가 첫 번째 문자인 경우 파라미터 이름을 일반 공백 문자 대신 동일한 기호 문자(=)로 해당 값과 분리해야 합니다. 공백 문자를 사용하면 가 문자열을 CLI 잘못 해석합니다. 예를 들어 다음 쿼리는 실패합니다.

aws resource-explorer-2 search --query-string "-tag:none region:us-east-1"

공백을 =으로 대체하는 다음 수정된 쿼리 문자열은 예상대로 작동합니다.

aws resource-explorer-2 search --query-string="-tag:none region:us-east-1"

-가 파라미터 값의 첫 번째 문자가 되지 않도록 쿼리 문자열에서 필터 순서를 변경하는 경우 표준 공백 문자를 사용할 수 있습니다. 다음 쿼리 문자열은 작동합니다.

aws resource-explorer-2 search --query-string "region:us-east-1 -tag:none"
\<special character>

해석하지 않고 표시된 대로 정확히 포함해야 하는 특수 문자를 이스케이프할 수 있습니다. 텍스트에 특수 문자( * " - : = \) 중 하나가 포함된 경우 문자 그대로 해석되도록 하려면 해당 문자 앞에 백슬래시(\)를 붙여야 합니다. 다음은 하이픈(-) 문자("my-key-word")가 포함된 자유 형식 텍스트 키워드를 사용하는 방법을 나타낸 예제입니다.

또한 Resource Explorer에서 하이픈의 표현식을 세 개의 개별 키워드로 분리하지 않도록 문구 전체를 큰따옴표로 묶을 수 있습니다.

"my\-key\-word"

리터럴 백슬래시를 삽입하려면 두 개의 백슬래시 문자를 연속으로 삽입하세요. 첫 번째 백슬래시는 이스케이프 문자로 해석되고 두 번째 백슬래시는 삽입할 리터럴 문자입니다.

"some_text\\some_more_text"

참고

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

다음 중 하나가 true일 경우 작업 시 검증 오류가 발생합니다.

  • 뷰에 태그에 대한 정보가 포함되지 않음

  • 검색 쿼리가 명시적으로 태그 필터(tag.key:, tag.value: 또는 tag:)를 사용함