Usa el Explorador de API

En esta página, se explica cómo usar el Explorador de API para probar los métodos de la API de Dataproc Metastore. El Explorador de API es un widget adjunto a la página de referencia de la API de REST para un método. Aparece como un panel con el título Try this API (Prueba esta API).

El Explorador de API es una excelente manera de probar los métodos en la API de Dataproc Metastore sin tener que escribir ningún código. El widget presenta un formulario que muestra los parámetros para cada método. Completa el formulario, haz clic en Ejecutar y observa los resultados.

También puedes ocultar el widget haciendo clic en el botón para cerrar en la parte superior del panel, o puedes expandirlo a pantalla completa haciendo clic en el botón de pantalla completa.

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Enable the Dataproc Metastore API.

    Enable the API

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  5. Enable the Dataproc Metastore API.

    Enable the API

Cómo acceder al Explorador de API

El Explorador de API se adjunta a la página de referencia para cada método de API de REST. A fin de buscar el widget, ve a la página de referencia de un método, por ejemplo, la página de referencia de Dataproc Metastore projects.locations.services.create.

Ejecuta una solicitud mínima

La mayoría de los métodos tienen algunos parámetros obligatorios y otros opcionales. Los obligatorios se marcan con una barra roja hasta que se completan. Puedes ejecutar una solicitud mínima si proporcionas solo los argumentos necesarios.

El método services.create crea un servicio de Dataproc Metastore en la ubicación y el proyecto elegido. Los campos obligatorios son parent y serviceId. A fin de crear un servicio, proporciona el número del proyecto y el ID de ubicación de tu proyecto para parent con el formulario projects/{projectNumber}/locations/{locationId}. Además, proporciona el ID de servicio para serviceId.

Pruébalo

Los resultados de la invocación del método aparecen en un cuadro debajo del botón Ejecutar. Por lo general, el cuadro tiene un encabezado verde con el código de estado HTTP 200, lo que indica que la solicitud se realizó correctamente.

Si el encabezado es rojo y contiene un código de error HTTP, el cuadro contiene el mensaje de error. Consulta las Sugerencias para obtener consejos sobre cómo resolver errores.

Proporcionar parámetros adicionales

La lista de parámetros que ves depende del método al que se adjunta el widget del Explorador de API. El método services.create tiene más que solo los parámetros parent y serviceId, pero estos son los únicos parámetros obligatorios.

Puedes usar el parámetro opcional requestId para especificar un ID de solicitud único a fin de permitir que el servidor ignore la solicitud si se completó.

Usa campos para limitar aún más los resultados

De forma predeterminada, el conjunto de parámetros que muestra el Explorador de API corresponde a los parámetros del método asociado. Sin embargo, el widget del Explorador de API también tiene un conjunto de campos adicionales que no están disponibles a través del método.

Estos parámetros están ocultos en el botón de activación Mostrar parámetros estándar.

Haz clic en este botón de activación para exponer los parámetros adicionales de widgets. Haz clic en Ocultar parámetros estándar para ocultarlos.

El más útil de estos parámetros estándar es el parámetro fields, que te permite seleccionar los campos en el resultado que se muestra y que deseas ver. Esto es muy útil en el panel del Explorador de API, en el que el resultado se muestra en un cuadro. A menudo, hay muchos resultados para desplazarse.

Sugerencias

Las siguientes secciones contienen sugerencias del Explorador de API.

Recuerda cambiar {projectNumber} and {locationId}

No olvides reemplazar {projectNumber} and {locationId} por el número de tu proyecto y el ID de la ubicación. Ten en cuenta que la API también acepta el ID del proyecto en lugar del número.

Problemas con los valores

Estos son algunos problemas que debes tener en cuenta cuando uses los formularios del Explorador de API. Estos pueden causar errores o ser aceptados, pero se tratan como errores de ortografía en el método de la API:

  • No uses comillas alrededor de valores de campos de ningún tipo.
  • Asegúrate de entrecomillar las strings que aparecen dentro de los filtros. Usa comillas dobles (") y no apóstrofos (').
  • No uses barras inversas ni codificación de URL en los campos del formulario. Si es necesario, la codificación de URL se realiza en los valores del campo cuando ejecutas el método.
  • Observa el valor en el cuadro de resultados después de ejecutar la llamada. Es posible que veas el problema allí.
  • Proporciona un valor para el campo pageSize, como 2. Esto limita la cantidad de datos que se muestran mientras depuras tu llamada a la API.

Agrega URL a favoritos para depurar

Después de obtener el resultado que deseas, agrega a favoritos la URL del Explorador de API. Cuando desees volver a ejecutar el método, pega la URL en tu navegador. Verás tus valores ya se propagaron en el formulario. Realiza los cambios necesarios en los parámetros y haz clic en Ejecutar para ejecutar el método otra vez.

Authentication

Hay una sección Credentials en la página del Explorador de API, arriba del botón Ejecutar. Por lo general, no es necesario realizar ningún cambio aquí.

El mecanismo de autenticación predeterminado es Google OAuth 2.0.

También hay un botón de activación Mostrar permisos en la sección Credenciales. Esto te muestra qué permisos de Compute Engine tienes disponibles. De forma predeterminada, todos los permisos disponibles están habilitados.

¿Qué sigue?