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

# Amazon OpenSearch Serverless용 컬렉션 엔드포인트
<a name="serverless-collection-endpoints"></a>

Amazon OpenSearch Serverless NextGen은 `on.aws` 도메인에 리소스 기반 엔드포인트를 제공합니다. 컬렉션별 엔드포인트를 사용하여 단일 컬렉션에 액세스하거나 계정별 엔드포인트를 사용하여 하나의 호스트 이름을 통해 리전에 있는의 모든 컬렉션 AWS 계정 에 액세스할 수 있습니다. 두 엔드포인트 모두 표준에서 작동합니다 AWS PrivateLink . Amazon VPC 콘솔에서 또는 `CreateVpcEndpoint` Amazon EC2 API를 사용하여 VPC 엔드포인트를 생성합니다.

OpenSearch Serverless Classic은에서 컬렉션별 엔드포인트를 사용합니다`aoss.amazonaws.com`.

**Topics**
+ [엔드포인트 유형](#serverless-collection-endpoints-types)
+ [컬렉션별 엔드포인트](#serverless-per-collection-endpoint)
+ [계정별 엔드포인트](#serverless-per-account-endpoint)

## 엔드포인트 유형
<a name="serverless-collection-endpoints-types"></a>

OpenSearch Serverless는 다음과 같은 컬렉션 엔드포인트 형식을 지원합니다.


**OpenSearch Serverless 컬렉션 엔드포인트 형식**  

| 엔드포인트 유형 | 형식 | 설명 | 
| --- | --- | --- | 
| 컬렉션별(NextGen) | {{collection-id}}.aoss.{{region}}.on.aws | 호스트 이름에서 컬렉션을 식별합니다. 컬렉션당 엔드포인트 1개. | 
| 계정당(NextGen) | {{account-id}}.aoss.{{region}}.on.aws | 요청 헤더에서 컬렉션을 식별합니다. 하나의 엔드포인트는 리전의 AWS 계정 에 있는 모든 컬렉션을 제공합니다. | 
| 컬렉션별(클래식) | {{collection-id}}.{{region}}.aoss.amazonaws.com | 호스트 이름에서 컬렉션을 식별합니다. Classic 컬렉션당 엔드포인트 1개. | 

두 NextGen 엔드포인트 형식 모두 VPC 액세스 AWS PrivateLink 에 표준을 사용합니다. VPC 엔드포인트 생성에 대한 자세한 내용은 [를 통한 데이터 영역 액세스 AWS PrivateLink](serverless-vpc.md) 섹션을 참조하세요.

FIPS AWS 리전 를 지원하는에서 OpenSearch Serverless는 이러한 엔드포인트의 FIPS 준수 변형도 제공합니다. 자세한 내용은 [OpenSearch Serverless에서 FIPS 엔드포인트 사용](fips-compliance-opensearch-serverless.md#using-fips-endpoints-opensearch-serverless)을 참조하세요.

## 컬렉션별 엔드포인트
<a name="serverless-per-collection-endpoint"></a>

컬렉션별 엔드포인트는 컬렉션 ID가 포함된 호스트 이름을 통해 단일 컬렉션을 대상으로 합니다. 엔드포인트는 OpenSearch Serverless 콘솔의 컬렉션 세부 정보 페이지에 표시되며 `collectionEndpoint` 필드의 [https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_BatchGetCollection.html](https://docs.aws.amazon.com/opensearch-service/latest/ServerlessAPIReference/API_BatchGetCollection.html) 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
}
```

## 계정별 엔드포인트
<a name="serverless-per-account-endpoint"></a>

계정별 엔드포인트는 단일 호스트 이름을 통해 리전에 있는 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여야 합니다.