Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Crear, mostrar y eliminar colecciones de Amazon OpenSearch sin servidor

Una colección de Amazon OpenSearch sin servidor es una agrupación lógica de uno o varios índices que representan una carga de trabajo de análisis. OpenSearch Service administra y ajusta de forma automática la colección, lo que requiere una intervención manual mínima.

Permisos necesarios

OpenSearch sin servidor utiliza los siguientes permisos de AWS Identity and Access Management (IAM) para crear y administrar colecciones. Puede especificar las condiciones de IAM para restringir a los usuarios a colecciones específicas.

El siguiente ejemplo de política de acceso basada en la identidad proporciona los permisos mínimos necesarios para que un usuario administre una única colección denominada 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 y aoss:CreateSecurityPolicy se incluyen porque se requieren las políticas de cifrado, de red y de acceso a los datos para que una colección funcione de forma correcta. Para más información, consulte Identity and Access Management para Amazon OpenSearch Serverless.

Creación de colecciones

Puede utilizar la consola o la AWS CLI para crear una colección sin servidor. En estos pasos se explica cómo crear una búsqueda o una colección de series temporales. Para crear una colección de búsquedas vectoriales, consulte Trabajo con colecciones de búsqueda vectorial.

Crear una colección (consola)

El estado de la colección cambia a Creating mientras OpenSearch sin servidor crea la colección.

Para crear una colección (CLI)

Antes de crear una colección mediante la AWS CLI, debe tener una política de cifrado con un patrón de recursos que coincida con el nombre previsto para la colección. Por ejemplo, si planea nombrar la colección como registros de la aplicación, puede crear una política de cifrado como esta:

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

Si piensa utilizar la política para colecciones adicionales, puede hacer que la regla sea más amplia, como collection/logs* o collection/*.

También debe configurar los ajustes de la red para la colección en forma de política de red. Para seguir con el ejemplo anterior, logs-application, puede crear la siguiente política de red:

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

Para crear una colección, envíe la solicitud CreateCollection:

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

En type, especifique SEARCH o TIMESERIES. Para más información, consulte Elección de un tipo de colección.

Respuesta de ejemplo

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

Si no especifica ningún tipo de colección en la solicitud, se usa TIMESERIES de forma predeterminada. Si su colección está cifrada con un Clave propiedad de AWS, el kmsKeyArn es un auto en lugar de un ARN.

Acceso a OpenSearch Dashboards

Después de crear una colección con la AWS Management Console, puede ir hasta la URL de OpenSearch Dashboards de la colección. Para encontrar la URL de Dashboards, seleccione Colecciones en el panel de navegación izquierdo y elija la colección para abrir su página de detalles. La URL toma el formato https://dashboards.us-east-1.aoss.amazonaws.com/_login/?collectionId=07tjusf2h91cunochc. Cuando navegue hasta la URL, iniciará sesión automáticamente en Dashboards.

Si ya tiene disponible la URL de OpenSearch Dashboards, pero no está en la AWS Management Console, si llama a la URL de los paneles desde el navegador, se redirigirá a la consola. Una vez que ingrese sus credenciales de AWS, iniciará sesión automáticamente en Dashboards. Para obtener información sobre cómo acceder a las colecciones para SAML, consulte Accessing OpenSearch Dashboards with SAML.

El tiempo de espera de la consola de OpenSearch Dashboards es de una hora y no se puede configurar.

Visualización de colecciones

Puede ver las colecciones existentes en su Cuenta de AWS desde la pestaña Colecciones de la consola de Amazon OpenSearch Service.

Para enumerar las colecciones junto con sus ID, envíe la solicitud ListCollections.

aws opensearchserverless list-collections

Respuesta de ejemplo

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

Para limitar los resultados de la búsqueda, utilice filtros de colección. Esta solicitud filtra la respuesta a las colecciones en estado ACTIVE:

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

Para obtener información detallada sobre una o más colecciones, incluidos el punto de conexión de OpenSearch y el punto de conexión de OpenSearch Dashboards, envíe la solicitud BatchGetCollection:

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

Respuesta de ejemplo

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

Eliminación de colecciones

Al eliminar una colección, se eliminan todos los datos e índices en la colección. No se pueden recuperar las colecciones después de eliminarlas.

Para eliminar una colección mediante la AWS CLI, envíe la solicitud DeleteCollection:

aws opensearchserverless delete-collection --id 07tjusf2h91cunochc

Respuesta de ejemplo

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