Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

创建、列出和删除 Amazon OpenSearch 无服务器产品系列

Amazon OpenSearch Serverless 中的集合是由一个或多个代表分析工作负载的索引组成的逻辑分组。 OpenSearch Service 会自动管理和调整馆藏，只需要最少的手动输入。

所需权限

OpenSearch Serverless 使用以下 Amazon 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 无服务器的 Identity and Access Management。

创建集合

您可以使用控制台或创建无服务器集合。 Amazon CLI 这些步骤介绍如何创建搜索集合或时间序列集合。要创建向量搜索集合，请参阅 使用向量搜索集合。

创建集合（控制台）

在 OpenSearch Serverless 创建集合时，集合状态将更改Creating为。

创建集合（CLI）

在使用创建集合之前 Amazon CLI，必须有一个加密策略，其资源模式必须与该集合的预期名称相匹配。例如，如果您计划将您的集合命名为 logs-application，则可以创建如下所示的加密策略：

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

如果您计划将该策略用于其他集合，则可以扩大该规则的范围，如 collection/logs* 或 collection/*。

您还需要以网络策略的形式为集合配置网络设置。使用前面的 logs-application 示例，您可以创建以下网络策略：

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。如果您的集合使用 Amazon 拥有的密钥进行加密，则 kmsKeyArn 将是 auto 而非 ARN。

访问 OpenSearch 仪表板

使用创建收藏夹后 Amazon Web Services Management Console，您可以导航到该集合的 OpenSearch 仪表板网址。您可以通过选择左侧导航窗格中的集合，然后选择该集合以打开其详细信息页面，来查找控制面板 URL。该 URL 采用 https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc 格式。导航到 URL 后，将自动登录控制面板。

如果您已有 OpenSearch 仪表板 URL 可用但不在 Amazon Web Services Management Console，则从浏览器调用仪表板 URL 将重定向到控制台。输入 Amazon 凭据后，您将自动登录控制面板。有关访问 SAML 集合的信息，请参阅使用 SAML 访问 OpenSearch 仪表板。

OpenSearch 仪表板控制台超时为一小时，不可配置。

查看集合

您可以在亚马逊 OpenSearch 服务控制台的 “收藏夹” 选项卡 Amazon Web Services 账户 上查看您的现有馆藏。

要列出收藏品及其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":[]
}

删除集合

删除集合将删除该集合中的所有数据和索引。删除集合后，您将无法恢复它们。

要使用删除收藏夹 Amazon CLI，DeleteCollection请发送请求：

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

示例响应

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