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

Amazon OpenSearch Serverless 컬렉션 생성, 리스팅, 삭제

Amazon OpenSearch Serverless의 컬렉션은 분석 워크로드를 나타내는 하나 이상의 인덱스를 논리적으로 그룹화한 것입니다. OpenSearch Service는 컬렉션을 자동으로 관리하고 조정하므로 수동 입력이 거의 필요하지 않습니다.

필요한 권한

OpenSearch Serverless는 컬렉션을 생성하고 관리하는 데 다음 AWS Identity and Access Management(IAM) 권한을 사용합니다. 사용자를 특정 컬렉션으로 제한하도록 IAM 조건을 지정할 수 있습니다.

다음 샘플 자격 증명 기반 액세스 정책은 사용자가 Logs라는 단일 컬렉션을 관리하는 데 필요한 최소 권한을 제공합니다.

[
   {
      "Sid":"Allows managing logs collections",
      "Effect":"Allow",
      "Action":[
         "aoss:CreateCollection",
         "aoss:ListCollections",
         "aoss:BatchGetCollection",
         "aoss:UpdateCollection",
         "aoss:DeleteCollection",
         "aoss:CreateAccessPolicy",
         "aoss:CreateSecurityPolicy"
      ],
      "Resource":"*",
      "Condition":{
         "StringEquals":{
            "aoss:collection":"Logs"
         }
      }
   }
]

컬렉션이 제대로 작동하려면 암호화, 네트워크, 데이터 액세스 정책이 필요하기 때문에 aoss:CreateAccessPolicy 및 aoss:CreateSecurityPolicy가 포함됩니다. 자세한 내용은 Amazon OpenSearch Serverless용 자격 증명 및 액세스 관리 단원을 참조하십시오.

컬렉션 생성

콘솔이나 AWS CLI를 사용하여 서버리스 컬렉션을 생성할 수 있습니다. 다음 단계에서는 검색 또는 시계열 컬렉션을 만드는 방법을 다룹니다. 벡터 검색 컬렉션을 만들려면 벡터 검색 컬렉션 작업(을)를 참조하세요.

컬렉션 생성(콘솔)

컬렉션 상태는 OpenSearch Serverless가 컬렉션을 생성함에 따라 Creating으로 변경됩니다.

컬렉션 생성(CLI)

AWS CLI를 사용하여 컬렉션을 생성하기 전에 원하는 컬렉션 이름과 일치하는 리소스 패턴을 가진 암호화 정책이 있어야 합니다. 예를 들어 컬렉션 로그 애플리케이션의 이름을 지정하려는 경우 다음과 같은 암호화 정책을 생성할 수 있습니다.

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type encryption --policy "{\"Rules\":[{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AWSOwnedKey\":true}"

정책을 추가 컬렉션에 사용하려는 경우 collection/logs* 또는 collection/*과 같이 규칙을 더 광범위하게 만들 수 있습니다.

또한 컬렉션에 대한 네트워크 설정을 네트워크 정책의 형태로 구성해야 합니다. 이전 로그 애플리케이션 예시를 사용하여 다음과 같은 네트워크 정책을 생성할 수 있습니다.

aws opensearchserverless create-security-policy \
  --name logs-policy \
  --type network --policy "[{\"Description\":\"Public access for logs collection\",\"Rules\":[{\"ResourceType\":\"dashboard\",\"Resource\":[\"collection\/logs-application\"]},{\"ResourceType\":\"collection\",\"Resource\":[\"collection\/logs-application\"]}],\"AllowFromPublic\":true}]"

컬렉션을 생성하려면 CreateCollection 요청을 보냅니다.

aws opensearchserverless create-collection --name "logs-application" --type SEARCH --description "A collection for storing log data"

type에서 SEARCH 또는 TIMESERIES를 지정합니다. 자세한 내용은 컬렉션 유형 선택 단원을 참조하십시오.

샘플 응답

{
    "createCollectionDetail": {
        "id": "07tjusf2h91cunochc",
        "name": "books",
        "description":"A collection for storing log data",
        "status": "CREATING",
        "type": "SEARCH",
        "kmsKeyArn": "auto",
        "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
        "createdDate": 1665952577473
    }
}

요청에 컬렉션 유형을 지정하지 않으면 기본값은 TIMESERIES입니다. 컬렉션이 AWS 소유 키로 암호화된 경우 kmsKeyArn은 ARN이 아니라 auto입니다.

OpenSearch 대시보드 액세스

AWS Management Console에서 컬렉션을 생성한 후 컬렉션의 OpenSearch 대시보드 URL로 이동할 수 있습니다. 왼쪽 탐색 창에서 컬렉션을 선택하고 해당 컬렉션을 선택한 다음 세부 정보 페이지를 열면 Dashboards URL을 찾을 수 있습니다. URL은 https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc 형식을 취합니다. URL을 탐색하면 Dashboards에 자동으로 로그인됩니다.

OpenSearch 대시보드 URL을 이미 사용할 수 있지만 AWS Management Console에 없는 경우 브라우저에서 대시보드 URL을 호출하면 콘솔로 리디렉션됩니다. AWS 보안 인증 정보를 입력하면 Dashboards에 자동으로 로그인됩니다. SAML용 컬렉션에 액세스하는 방법에 대한 자세한 내용은 SAML을 통한 OpenSearch Dashboards 액세스를 참조하세요.

OpenSearch Dashboards 콘솔 제한 시간은 1시간이며 구성할 수 없습니다.

컬렉션 보기

Amazon OpenSearch Service 콘솔의 Collections(컬렉션) 탭에서 AWS 계정의 기존 컬렉션을 볼 수 있습니다.

컬렉션을 ID와 함께 나열하려면 ListCollections 요청을 보냅니다.

aws opensearchserverless list-collections

샘플 응답

{
   "collectionSummaries":[
      {
         "arn":"arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "id":"07tjusf2h91cunochc",
         "name":"my-collection",
         "status":"CREATING"
      }
   ]
}

검색 결과를 제한하려면 컬렉션 필터를 사용합니다. 이 요청은 ACTIVE 상태의 컬렉션에 대한 응답을 필터링합니다.

aws opensearchserverless list-collections --collection-filters '{ "status": "ACTIVE" }'

OpenSearch 엔드포인트 및 OpenSearch 대시보드 엔드포인트를 포함하여 하나 이상의 컬렉션에 대한 자세한 정보를 보려면 BatchGetCollection 요청을 보냅니다.

aws opensearchserverless batch-get-collection --ids ["07tjusf2h91cunochc", "1iu5usc4rame"]

샘플 응답

{
   "collectionDetails":[
      {
         "id": "07tjusf2h91cunochc",
         "name": "my-collection",
         "status": "ACTIVE",
         "type": "SEARCH",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/07tjusf2h91cunochc",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://07tjusf2h91cunochc.us-east-1.aoss.amazonaws.com/_dashboards"
      },
      {
         "id": "178ukvtg3i82dvopdid",
         "name": "another-collection",
         "status": "ACTIVE",
         "type": "TIMESERIES",
         "description": "",
         "arn": "arn:aws:aoss:us-east-1:123456789012:collection/178ukvtg3i82dvopdid",
         "kmsKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
         "createdDate": 1667446262828,
         "lastModifiedDate": 1667446300769,
         "collectionEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com",
         "dashboardEndpoint": "https://178ukvtg3i82dvopdid.us-east-1.aoss.amazonaws.com/_dashboards"
      }
   ],
   "collectionErrorDetails":[]
}

컬렉션 삭제

컬렉션을 삭제하면 컬렉션의 모든 데이터와 인덱스가 삭제됩니다. 컬렉션을 삭제한 후에는 복구할 수 없습니다.

AWS CLI를 사용하여 컬렉션을 삭제하려면 DeleteCollection 요청을 보냅니다.

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

샘플 응답

{
   "deleteCollectionDetail":{
      "id":"07tjusf2h91cunochc",
      "name":"my-collection",
      "status":"DELETING"
   }
}