Docs Menu
Docs Home
/ /

atlas api

Accede a todas las funcionalidades de la API de administración de Atlas mediante la CLI de Atlas usando el comando 'atlas api <tag> <operationId>'.

Esta funcionalidad agiliza el desarrollo de scripts, permitiéndote interactuar directamente con cualquier endpoint de la API de administración de Atlas a través de la Atlas CLI.

Para obtener más información sobre - API de Administración de Atlas, consulta: https://www.mongodb.com/es/docs/api/doc/atlas-admin-api-v2/ - Comenzar con la API de administración de Atlas: https://www.mongodb.com/es/docs/atlas/configure-api-access/#std-label-atlas-admin-api-access

El subcomando del atlas api se genera automáticamente a partir de la API de administración de MongoDB Atlas y ofrece una cobertura total de la API de administración. Las capacidades de la API de administración tienen su propio ciclo de vida de lanzamiento, que puedes consultar a través del enlace a la documentación del endpoint de la API proporcionada.

Sintaxis del comando
atlas api <tag> <operationId> [options]

Importante

Ambos <tag> y <operationId> debe estar en camelCase.

Nombre
Tipo
Requerido
Descripción

<tag>

string

true

La categoría de las operaciones de la API de administración de Atlas en camelCase. Para encontrar y formatear la etiqueta, revisa la URL de la documentación de la API del endpoint. Aparece después de #tag/, pero necesitas cambiar a camelCase. Para la documentación de la API de Atlas, consulta: https://www.mongodb.com/es/docs/atlas/reference/api-resources-spec/v2/.

Por ejemplo, en https://www.mongodb.com/es/docs/atlas/reference/api-resources-spec/v2/#tag/Monitoring-and-Logs, la etiqueta es Monitoring-and-Logs. En camelCase, es monitoringAndLogs.

<operationId>

string

true

El identificador del punto final de la API de administración de Atlas en camelCase. Para encontrar el operationId, consulta la URL de la documentación de la API para el endpoint. Aparece después de operation/. Para la documentación de la API de Atlas, consulta: https://www.mongodb.com/es/docs/atlas/reference/api-resources-spec/v2/.

Por ejemplo, en https://www.mongodb.com/es/docs/api/doc/atlas-admin-api-v2/operation/operation-listclusters, el operationId es listClusters.

Pasa la ruta y los parámetros de consulta para el endpoint de la API de Administración de Atlas como banderas. Por ejemplo, si el endpoint es /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}, el comando de la Atlas CLI es:

atlas api <tag> <operationId> --orgId <ORG_ID> --invoiceId <INVOICE_ID>

Nota

Por lo general, no necesitas especificar --orgId y --projectId ya que se obtienen de tu perfil. Especifícalos sólo si no están configurados en tu perfil.

Si aplica al endpoint, envía el cuerpo de la solicitud usando la opción --file o la entrada estándar (stdin). Por ejemplo:

atlas api clusters create --file cluster-config.json

Además, las siguientes opciones están disponibles para todos los puntos finales de la API de administración de Atlas.

Nombre
Tipo
Requerido
Descripción

--api-version

string

false

Especifique la versión de la API de administración de Atlas para el comando. Por defecto, utiliza la última versión de la API o el valor que hayas configurado para api_version en tu perfil.

--out

string

false

Formato de salida. El valor por defecto es json, pero los formatos admitidos pueden variar según el endpoint:

  • La mayoría de los endpoints devuelven json. Cuando se admite json, también puedes usar una plantilla Go (Go template).

  • Algunos endpoints admiten json y csv, lo que te permite usar json, csv o una plantilla Go.

  • Algunos endpoints generan datos binarios (por ejemplo, registros en formato gzip), lo que requiere la opción --out.

Para determinar los formatos admitidos para un endpoint:

-o, --out-file

string

false

Ruta de archivo para guardar la salida. Por defecto, el resultado se muestra en el terminal.

--file

string

false

Ruta de archivo al contenido del cuerpo de la solicitud, si la operación la requiere. Alternativamente, proporcionar la entrada a través de la entrada estándar (stdin).

-h, --help

booleano

false

Ayuda para el comando actual.

Nombre
Tipo
Requerido
Descripción

-h, --help

false

ayuda para api

Nombre
Tipo
Requerido
Descripción

-P, --profile

string

false

Volver

invitar

En esta página