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.
# Tutorial: Introducción a Amazon OpenSearch Serverless
En este tutorial, se explican los pasos básicos para poner en marcha rápidamente una colección de *búsquedas* de Amazon OpenSearch Serverless. Una colección de búsqueda le permite potenciar las aplicaciones de sus redes internas y las aplicaciones orientadas a Internet, como la búsqueda en sitios web de comercio electrónico y la búsqueda de contenido.
Para obtener información sobre cómo utilizar una colección de *búsqueda vectorial*, consulte. [Trabajo con colecciones de búsqueda vectorial](serverless-vector-search.md) Para obtener información detallada sobre el uso de colecciones, consulte [Administración de colecciones de Amazon OpenSearch Serverless](serverless-manage.md) y los demás temas de esta guía.
En este tutorial, deberá completar los siguientes pasos:
1. [Configurar permisos](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [Crear una colección](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [Cargar y buscar datos](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [Eliminar la colección](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**nota**
Recomendamos que usted utilice únicamente caracteres ASCII para su `IndexName`. Si no utiliza caracteres ASCII`IndexName`, las CloudWatch métricas de entrada se convertirán a un formato codificado `IndexName` en URL para caracteres que no sean ASCII.
## Paso 1: configurar permisos
Para completar este tutorial y utilizar OpenSearch Serverless en general, debe tener los permisos de IAM correctos. En este tutorial, creará una colección, cargará y buscará datos y, a continuación, eliminará la colección.
Su usuario o rol debe tener adjunta una [política basada en la identidad](security-iam-serverless.md#security-iam-serverless-id-based-policies) con los siguientes permisos mínimos:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"aoss:CreateCollection",
"aoss:ListCollections",
"aoss:BatchGetCollection",
"aoss:DeleteCollection",
"aoss:CreateAccessPolicy",
"aoss:ListAccessPolicies",
"aoss:UpdateAccessPolicy",
"aoss:CreateSecurityPolicy",
"aoss:GetSecurityPolicy",
"aoss:UpdateSecurityPolicy",
"iam:ListUsers",
"iam:ListRoles"
],
"Effect": "Allow",
"Resource": "*"
}
]
}
```
------
Para obtener más información sobre los permisos de IAM OpenSearch sin servidor, consulte. [Identity and Access Management para Amazon OpenSearch Serverless](security-iam-serverless.md)
## Paso 2: crear una colección
Una colección es un grupo de OpenSearch índices que funcionan juntos para respaldar una carga de trabajo o un caso de uso específicos.
**Para crear una colección OpenSearch sin servidor**
1. Abre la consola OpenSearch de Amazon Service en [https://console.aws.amazon.com/aos/casa](https://console.aws.amazon.com/aos/home ).
1. Seleccione **Colecciones** en el panel de navegación de la izquierda y elija **Crear colección**.
1. Asigne un nombre a las **películas** de la colección.
1. Para el tipo de colección, seleccione **Buscar**. Para obtener más información, consulte [Choosing a collection type](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase) (Elección de un tipo de recopilación).
1. En **Seguridad**, elija **Creación estándar**.
1. En **Cifrado**, seleccione **Utilizar Clave propiedad de AWS**. Esto es AWS KMS key lo que OpenSearch Serverless utilizará para cifrar sus datos.
1. En **Red**, configure los ajustes de red para la colección.
+ Para el tipo de acceso, seleccione **Público**.
+ Para el tipo de recurso, elija Habilitar el **acceso a los OpenSearch puntos finales y Habilitar** **el acceso a** los paneles. OpenSearch Como cargará y buscará datos mediante los OpenSearch paneles de control, debe habilitar ambas opciones.
1. Elija **Siguiente**.
1. En **Configurar el acceso a los datos**, defina los ajustes de acceso a la colección. Las [políticas de acceso a los datos](serverless-data-access.md) le permiten a los usuarios y a los roles acceder a los datos de una colección. En este tutorial, le brindaremos a un solo usuario los permisos necesarios para indexar y buscar datos en la colección de *películas*.
Cree una sola regla que proporcione acceso a la colección *películas*. Asígnele a la regla el nombre **Acceso a la colección de películas**.
1. Elija **Agregar directores**, **usuarios y roles de IAM y** seleccione el usuario o rol que usará para iniciar sesión en los OpenSearch paneles e indexar datos. Seleccione **Save**.
1. En **Indexar permisos**, seleccione todos los permisos.
1. Seleccione **Siguiente**.
1. En la configuración de la política de acceso, seleccione **Crear una nueva política de acceso a datos** y póngale el nombre **películas** a la política.
1. Seleccione **Siguiente**.
1. Revise la configuración de la colección y seleccione **Enviar**. Espere unos minutos hasta que el estado de la colección cambie a `Active`.
## Paso 3: cargar y buscar datos
Puedes cargar datos a una colección OpenSearch sin servidor mediante [Postman](https://www.postman.com/downloads/) o cURL. Para abreviar, en estos ejemplos se utilizan las **herramientas de desarrollo** de la consola de Dashboards. OpenSearch
**Para indexar y buscar datos en la colección de películas**
1. Seleccione **Colecciones** en el panel de navegación de la izquierda y elija la colección de **películas** para abrir su página de detalles.
1. Elija la URL de los OpenSearch paneles de control para la colección. La URL toma el formato `https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}`.
1. En los OpenSearch paneles, abra el panel de navegación izquierdo y elija **Dev** Tools.
1. Para crear un índice único llamado *índice de películas*, envíe la siguiente solicitud:
```
PUT movies-index
```
![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/es_es/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. Para indexar un solo documento en *índice de películas*, envíe la siguiente solicitud:
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. Para buscar datos en los OpenSearch paneles, debe configurar al menos un patrón de índice. OpenSearch utiliza estos patrones para identificar los índices que desea analizar. Abra el menú principal del panel, seleccione **Administración de pilas**. Luego, seleccione **Patrones de índices** y, a continuación, seleccione **Crear patrón de índice**. Para este tutorial, escriba *Películas*.
1. seleccione **Siguiente paso** y, a continuación, seleccione **Crear patrón de índice**. Una vez creado el patrón, puede ver los diversos campos de documento, como `title` y `genre`.
1. Para comenzar a buscar los datos, abra el panel de navegación izquierdo y elija **Explorar** o utilice la [API de búsqueda](https://opensearch.org/docs/latest/api-reference/search/) dentro de Herramientas de desarrollo.
## Gestión de errores
Al ejecutar operaciones de indexación y búsqueda, usted puede recibir las siguientes respuestas de error:
+ `HTTP 507`: indica que se produjo un error interno del servidor. Este error generalmente indica que sus unidades de OpenSearch cómputo (OCUs) están sobrecargadas por el volumen o la complejidad de sus solicitudes. Si bien OpenSearch Serverless escala automáticamente para gestionar la carga, puede producirse un retraso en la implementación de recursos adicionales.
Para mitigar este error, implemente una política de reintentos con retroceso exponencial. Este enfoque reduce temporalmente la tasa de solicitudes para administrar la carga de manera eficaz. Para obtener más información, consulte el [comportamiento de los reintentos](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html) en la Guía de *referencia de herramientas AWS SDKs y herramientas*.
+ `HTTP 402`— Indica que ha alcanzado el límite máximo de capacidad de la unidad de OpenSearch cómputo (OCU). Optimice su carga de trabajo para reducir el uso de OCU o solicite un aumento de cuota.
## Paso 4: eliminar la colección
Dado que la colección de *películas* es para hacer pruebas, debe eliminarla cuando termine de experimentar.
**Para eliminar una colección OpenSearch sin servidor**
1. Vuelve a la consola ** OpenSearch de Amazon Service**.
1. Seleccione **Colecciones** en el panel de navegación de la izquierda y elija la colección de **películas**.
1. Seleccione **Eliminar** y confirme la eliminación.
## Siguientes pasos
Ahora que sabe cómo crear una colección e indexar datos, puede que desee probar algunos de los siguientes ejercicios:
+ Consulte opciones más avanzadas para crear una colección. Para obtener más información, consulte [Administración de colecciones de Amazon OpenSearch Serverless](serverless-manage.md).
+ Aprenda a configurar las políticas de seguridad para gestionar la seguridad de las colecciones a escala. Para obtener más información, consulte [Descripción general de la seguridad en Amazon OpenSearch Serverless](serverless-security.md).
+ Descubra otras formas de indexar datos en las colecciones. Para obtener más información, consulte [Ingerir datos en colecciones de Amazon OpenSearch Serverless](serverless-clients.md).