本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

建立、列出和刪除 Amazon OpenSearch 無伺服器集合

Amazon OpenSearch 無伺服器中的集合是由代表分析工作負載的一或多個索引組成的邏輯分組。 OpenSearch 服務會自動管理和調整集合，需要最少的手動輸入。

必要許可

OpenSearch 無伺服器會使用下列 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 無伺服器的 Identity and Access Management。

建立集合

您可以使用主控台或建 AWS CLI 立無伺服器集合。這些步驟涵蓋如何建立搜尋或時間序列集合。若要建立向量搜尋集合，請參閱使用向量搜尋集合。

建立集合 (主控台)

Creating當「 OpenSearch 無伺服器」建立集合時，收集狀態會變更為。

建立集合 (CLI)

使用建立集合之前 AWS 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。如果您的集合使用 AWS 擁有的金鑰加密，則 kmsKeyArn 是 auto 而不是 ARN。

存取 OpenSearch 儀表板

使用建立商品系列後 AWS Management Console，您可以導覽至該系列的 OpenSearch 儀表板 URL。您可以在左側導覽窗格中選擇「商品系列」，然後選取商品系列以開啟其詳細資訊頁面，以尋找儀表板 URL。URL 採用的格式為 https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc。導航到 URL 後，您將自動登錄到儀表板。

如果您已經有可用的 OpenSearch 儀表板 URL，但不在 AWS Management Console，從瀏覽器呼叫儀表板 URL 將重新導向到控制台。輸入 AWS 認證後，您將自動登入儀表板。如需存取 SAML 集合的相關資訊，請參閱使用 SAML 存取 OpenSearch 儀表板。

OpenSearch 儀表板主控台逾時為一小時，無法設定。

檢視集合

您可以在 Amazon OpenSearch 服務主控台的「集合」索引標籤 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"
   }
}