기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
Amazon OpenSearch Serverless용 컬렉션 엔드포인트
Amazon OpenSearch Serverless NextGen은 on.aws 도메인에 리소스 기반 엔드포인트를 제공합니다. 컬렉션별 엔드포인트를 사용하여 단일 컬렉션에 액세스하거나 계정별 엔드포인트를 사용하여 하나의 호스트 이름을 통해 리전에 있는의 모든 컬렉션 AWS 계정 에 액세스할 수 있습니다. 두 엔드포인트 모두 표준에서 작동합니다 AWS PrivateLink . Amazon VPC 콘솔에서 또는 CreateVpcEndpoint Amazon EC2 API를 사용하여 VPC 엔드포인트를 생성합니다.
OpenSearch Serverless Classic은에서 컬렉션별 엔드포인트를 사용합니다aoss.amazonaws.com.
엔드포인트 유형
OpenSearch Serverless는 다음과 같은 컬렉션 엔드포인트 형식을 지원합니다.
| 엔드포인트 유형 | 형식 | 설명 |
|---|---|---|
| 컬렉션별(NextGen) | |
호스트 이름에서 컬렉션을 식별합니다. 컬렉션당 엔드포인트 1개. |
| 계정당(NextGen) | |
요청 헤더에서 컬렉션을 식별합니다. 하나의 엔드포인트는 리전의 AWS 계정 에 있는 모든 컬렉션을 제공합니다. |
| 컬렉션별(클래식) | |
호스트 이름에서 컬렉션을 식별합니다. Classic 컬렉션당 엔드포인트 1개. |
두 NextGen 엔드포인트 형식 모두 VPC 액세스 AWS PrivateLink 에 표준을 사용합니다. VPC 엔드포인트 생성에 대한 자세한 내용은 를 통한 데이터 영역 액세스 AWS PrivateLink 섹션을 참조하세요.
FIPS AWS 리전 를 지원하는에서 OpenSearch Serverless는 이러한 엔드포인트의 FIPS 준수 변형도 제공합니다. 자세한 내용은 OpenSearch Serverless에서 FIPS 엔드포인트 사용을 참조하세요.
컬렉션별 엔드포인트
컬렉션별 엔드포인트는 컬렉션 ID가 포함된 호스트 이름을 통해 단일 컬렉션을 대상으로 합니다. 엔드포인트는 OpenSearch Serverless 콘솔의 컬렉션 세부 정보 페이지에 표시되며 collectionEndpoint 필드의 BatchGetCollection API에서 반환됩니다.
- 형식
-
-
NextGen:
collection-id.aoss.region.on.aws -
클래식:
collection-id.region.aoss.amazonaws.com
-
다음 요청은 문서를의 컬렉션 movies 인덱스로 1tg2xudton46knx2a95g 인덱싱합니다. us-east-1
PUT https://1tg2xudton46knx2a95g.aoss.us-east-1.on.aws/movies/_doc/1 { "title": "Shawshank Redemption", "year": 1994 }
계정별 엔드포인트
계정별 엔드포인트는 단일 호스트 이름을 통해 리전에 있는 AWS 계정 의 모든 컬렉션을 대상으로 합니다. 호스트 이름은 모든 컬렉션에 대해 동일하므로 이러한 HTTP 헤더 중 하나를 통해 각 요청에서 대상 컬렉션을 식별합니다(하나 이상 필요, 둘 다를 포함하는 경우 동일한 컬렉션을 참조해야 함).
-
x-amz-aoss-collection-name- 고객이 할당한 컬렉션 이름 -
x-amz-aoss-collection-id- 서비스 생성 컬렉션 ID
계정별 엔드포인트를 사용하면 헤더를 통해 요청당 대상 컬렉션을 전환하여 단일 클라이언트가 여러 컬렉션에서 하나의 연결 풀을 공유할 수 있습니다. 이는 각 테넌트를 별도의 컬렉션으로 모델링하는 다중 테넌트 애플리케이션에 유용합니다.
애플리케이션이 이미 알고 있는 이름으로 요청을 라우팅할 수 x-amz-aoss-collection-name 있도록를 사용합니다. 서비스 생성 컬렉션 ID 저장 또는 조회를 건너뜁니다.
계정별 엔드포인트는 OpenSearch Serverless 콘솔에 표시되지 않습니다. AWS 계정 ID와 리전에서 구성합니다.
- 형식
-
-
NextGen:
account-id.aoss.region.on.aws
-
다음 요청은 문서를의 계정my-collection에서 컬렉션 movies 인덱스로 123456789012 인덱싱합니다. us-east-1
PUT https://123456789012.aoss.us-east-1.on.aws/movies/_doc/1 x-amz-aoss-collection-name: my-collection { "title": "Shawshank Redemption", "year": 1994 }
참고
x-amz-aoss-collection-name 및 x-amz-aoss-collection-id 헤더는 SigV4-signed. AWS SDKs여야 합니다.