SSM 문서 검색 - AWS Systems Manager
자유 텍스트 검색 사용필터 사용즐겨찾기에 문서 추가

SSM 문서 검색

자유 텍스트 검색 또는 필터 기반 검색을 사용하여 AWS Systems Manager(SSM) 문서 저장소에서 SSM 문서를 검색할 수 있습니다. 자주 사용하는 SSM 문서를 찾는 데 도움이 되도록 문서를 즐겨찾기에 추가할 수도 있습니다. 다음 섹션에서는 이러한 기능을 사용하는 방법을 설명합니다.

자유 텍스트 검색 사용

Systems Manager [Documents] 페이지의 검색 상자에서 자유 텍스트 검색을 지원합니다. 자유 텍스트 검색은 입력한 검색어를 각 SSM 문서의 문서 이름과 비교합니다. 단일 검색어(예: ansible)를 입력하면 Systems Manager는 이 용어가 발견된 모든 SSM 문서를 반환합니다. 여러 검색어를 입력하면 Systems Manager는 OR 문을 사용하여 검색합니다. 예를 들어 ansible 및 linux을 지정하면 검색 시 이름에 두 키워드 중 하나가 포함된 모든 문서가 반환됩니다.

자유 텍스트 검색어를 입력하고 [플랫폼 유형(Platform type)]과 같은 검색 옵션을 선택하면 검색에 AND 문이 사용되고 이름에 키워드를 포함하는 지정된 플랫폼 유형의 모든 문서가 반환됩니다.

참고

자유 텍스트 검색에 대한 다음 세부 정보에 유의합니다.

  • 자유 텍스트 검색은 대/소문자를 구분하지 않습니다.

  • 검색어는 최소 3자, 최대 20자여야 합니다.

  • 자유 텍스트 검색은 최대 5개의 검색어를 허용합니다.

  • 검색어 사이에 공백을 입력하면 검색 시 공백이 포함됩니다.

  • 자유 텍스트 검색을 [문서 유형(Document type)] 또는 [플랫폼 유형(Platform type)]과 같은 다른 검색 옵션과 결합할 수 있습니다.

  • [문서 이름 접두사(Document Name Prefix)] 필터와 자유 텍스트 검색은 상호 배타적이므로 함께 사용할 수 없습니다.

SSM 문서를 검색하려면

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Documents를 선택합니다.

  3. 검색 상자에 검색어를 입력하고 Enter 키를 누릅니다.

AWS CLI를 사용하여 자유 텍스트 문서 검색 수행

CLI를 사용하여 자유 텍스트 문서 검색을 수행하려면

  1. 아직 하지 않은 경우 AWS Command Line Interface(AWS CLI)를 설치하고 구성합니다.

    자세한 내용은 최신 버전의 AWS CLI 설치 또는 업데이트를 참조하세요.

  2. 한 용어로 자유 텍스트 문서 검색을 수행하려면 다음 명령을 실행합니다. 이 명령에서 search_term을 자신의 정보로 바꿉니다.

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term"

    다음은 그 예입니다.

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg" --region us-east-2

    AND 문을 생성하는 여러 용어를 사용하여 검색하려면 다음 명령을 실행합니다. 이 명령에서 search_term_1과 search_term_2를 자신의 정보로 바꿉니다.

    aws ssm list-documents --filters Key="SearchKeyword",Values="search_term_1","search_term_2","search_term_3" --region us-east-2

    다음은 그 예입니다.

    aws ssm list-documents --filters Key="SearchKeyword",Values="aws-asg","aws-ec2","restart" --region us-east-2

필터 사용

검색 상자를 선택하면 Systems Manager [Documents] 페이지에 자동으로 다음 필터가 표시됩니다.

  • 문서 이름 접두사

  • 플랫폼 유형

  • 문서 유형

  • 태그 키

SSM Documents 페이지의 필터 옵션

단일 필터를 사용하여 SSM 문서를 검색할 수 있습니다. 좀 더 구체적인 SSM 문서 집합을 반환하려는 경우 여러 필터를 적용할 수 있습니다. 다음은 [플랫폼 유형(Platform types)] 및 [문서 이름 접두사(Document name prefix)] 필터를 사용하는 검색의 예입니다.

SSM Documents 페이지에서 여러 필터 옵션 적용

여러 필터를 적용하는 경우 Systems Manager는 선택한 필터에 따라 다른 검색 문을 생성합니다.

  • 동일한 필터를 여러 번 적용하는 경우(예: [문서 이름 접두사(Document name prefix)]) Systems Manager는 OR 문을 사용하여 검색합니다. 예를 들어 [문서 이름 접두사(Document name prefix)]=AWS 필터 하나와 [문서 이름 접두사(Document name prefix)]=Lambda 필터를 또 하나 지정하는 경우 검색 시 접두사 "AWS"가 있는 모든 문서와 접두사 "Lambda"가 있는 모든 문서가 반환됩니다.

  • 여러 필터를 적용하는 경우(예: 문서 이름 접두사(Document name prefix) 및 플랫폼 유형(Platform types)) Systems Manager는 AND 명령문을 사용하여 검색합니다. 예를 들어 문서 이름 접두사=AWS 필터와 플랫폼 유형(Platform types)=Linux 필터를 지정하면 검색 시 Linux 플랫폼에 특정한 접두사 "AWS"가 있는 모든 문서가 반환됩니다.

참고

필터를 사용하는 검색은 대/소문자를 구분합니다.

즐겨찾기에 문서 추가

자주 사용하는 SSM 문서를 찾는 데 도움이 되도록 문서를 즐겨찾기에 추가합니다. 문서 유형, AWS 계정 및 AWS 리전로 최대 20개의 문서를 즐겨찾기에 추가할 수 있습니다. 문서 AWS Management Console에서 즐겨찾기를 선택, 수정 및 확인할 수 있습니다. 다음 절차에서는 즐겨찾기를 선택하고 수정하고 보는 방법을 설명합니다.

즐겨찾기에 SSM 문서 추가

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Documents를 선택합니다.

  3. 즐겨찾기에 추가하려는 문서 이름 옆의 별표 아이콘을 선택합니다.

즐겨찾기에서 SSM 문서 제거

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Documents를 선택합니다.

  3. 즐겨찾기에서 제거하려는 문서 이름 옆의 별표 아이콘 선택을 취소합니다.

문서 AWS Management Console에서 즐겨찾기 보기

  1. AWS Systems Manager 콘솔(https://console.aws.amazon.com/systems-manager/)을 엽니다.

  2. 탐색 창에서 Documents를 선택합니다.

  3. 즐겨찾기 탭을 선택합니다.