Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon OpenSearch Serverless-Sammlungen erstellen, auflisten und löschen

Eine Sammlung in Amazon OpenSearch Serverless ist eine logische Gruppierung von einem oder mehreren Indizes, die einen Analyse-Workload darstellen. OpenSearch Der Service verwaltet und optimiert die Sammlung automatisch und erfordert nur minimale manuelle Eingaben.

Erforderliche Berechtigungen

OpenSearch Serverless verwendet die folgenden AWS Identity and Access Management (IAM-) Berechtigungen zum Erstellen und Verwalten von Sammlungen. Sie können IAM-Bedingungen festlegen, um Benutzer auf bestimmte Sammlungen zu beschränken.

Das folgende Beispiel für eine identitätsbasierte Zugriffsrichtlinie stellt die Mindestberechtigungen bereit, die ein Benutzer benötigt, um eine einzelne Sammlung mit dem Namen Logs zu verwalten:

[
   {
      "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 und aoss:CreateSecurityPolicy sind enthalten, da Verschlüsselungs-, Netzwerk- und Datenzugriffsrichtlinien erforderlich sind, damit eine Sammlung ordnungsgemäß funktioniert. Weitere Informationen finden Sie unter Identity and Access Management für Amazon OpenSearch Serverless.

Erstellen von Sammlungen

Sie können die Konsole oder die verwenden, um eine serverlose Sammlung AWS CLI zu erstellen. In diesen Schritten wird beschrieben, wie Sie eine Suche oder eine Zeitreihensammlung erstellen. Informationen zum Erstellen einer Vektorsuchsammlung finden Sie unterArbeiten mit Vektorsuchsammlungen.

Eine Sammlung erstellen (Konsole)

Der Erfassungsstatus ändert sich in, wenn Creating OpenSearch Serverless die Sammlung erstellt.

Eine Sammlung erstellen (CLI)

Bevor Sie eine Sammlung mit dem erstellen AWS CLI, benötigen Sie eine Verschlüsselungsrichtlinie mit einem Ressourcenmuster, das dem beabsichtigten Namen der Sammlung entspricht. Wenn Sie beispielsweise Ihre Sammlungs-Protokollanwendung benennen möchten, können Sie eine Verschlüsselungsrichtlinie wie die folgende erstellen:

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

Wenn Sie die Richtlinie für weitere Sammlungen verwenden möchten, können Sie die Regel breiter fassen, wie z. B. collection/logs* oder collection/*.

Außerdem müssen Sie Netzwerkeinstellungen für die Sammlung in Form einer Netzwerkrichtlinie konfigurieren. Unter Verwendung des vorherigen Beispiels für die Protokollanwendung könnten Sie die folgende Netzwerkrichtlinie erstellen:

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}]"

Um eine Sammlung zu erstellen, senden Sie eine CreateCollectionAnfrage:

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

Geben Sie für type entweder SEARCH oder TIMESERIES an. Weitere Informationen finden Sie unter Auswahl eines Sammlungstyps.

Beispielantwort

{
    "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
    }
}

Wenn Sie in der Anfrage keinen Sammlungstyp angeben, wird standardmäßig TIMESERIES verwendet. Wenn Ihre Sammlung mit einem AWS-eigener Schlüssel verschlüsselt ist, handelt es sich bei kmsKeyArn um auto und nicht um einen ARN.

Zugreifen auf OpenSearch Dashboards

Nachdem Sie eine Sammlung mit dem erstellt haben AWS Management Console, können Sie zur OpenSearch Dashboard-URL der Sammlung navigieren. Sie finden die Dashboard-URL, indem Sie im linken Navigationsbereich Sammlungen und dann die Sammlung auswählen, um die zugehörige Detailseite zu öffnen. Die URL nimmt das Format https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc an. Sobald Sie zur URL navigieren, melden Sie sich automatisch bei Dashboards an.

Wenn Sie die OpenSearch Dashboard-URL bereits verfügbar haben, aber nicht auf der sind AWS Management Console, wird beim Aufrufen der Dashboard-URL über den Browser zur Konsole weitergeleitet. Sobald Sie Ihre AWS Anmeldeinformationen eingegeben haben, melden Sie sich automatisch bei Dashboards an. Informationen zum Zugriff auf Sammlungen für SAML finden Sie unter Zugreifen auf OpenSearch Dashboards mit SAML.

Das Timeout der OpenSearch Dashboard-Konsole beträgt eine Stunde und ist nicht konfigurierbar.

Anzeigen von Sammlungen

Sie können die vorhandenen Sammlungen in Ihrem AWS-Konto auf der Registerkarte Sammlungen der Amazon OpenSearch Service-Konsole einsehen.

Um Sammlungen zusammen mit ihren IDs aufzulisten, senden Sie eine ListCollectionsAnfrage.

aws opensearchserverless list-collections

Beispielantwort

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

Um die Suchergebnisse einzuschränken, verwenden Sie Sammlungsfilter. Diese Anfrage filtert die Antwort auf Sammlungen im ACTIVE-Zustand:

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

Um detailliertere Informationen zu einer oder mehreren Sammlungen, einschließlich des OpenSearch Endpunkts und des OpenSearch Dashboards-Endpunkts, zu erhalten, senden Sie eine BatchGetCollectionAnfrage:

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

Beispielantwort

{
   "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":[]
}

Löschen von Sammlungen

Beim Löschen einer Sammlung werden alle Daten und Indizes in der Sammlung gelöscht. Sie können Sammlungen nicht wiederherstellen, nachdem Sie diese gelöscht haben.

Um eine Sammlung mit dem zu löschen AWS CLI, senden Sie eine DeleteCollectionAnfrage:

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

Beispielantwort

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