Docs Menu
Docs Home
/ /

atlas api

Acceda a todas las funciones de la API de administración de Atlas a través de la CLI de Atlas usando el comando 'atlas api <tag> <operationId>'.

Esta función agiliza el desarrollo de scripts al permitirle interactuar directamente con cualquier punto final de la API de administración de Atlas a través de la CLI de Atlas.

Para obtener más información sobre la API de administración de Atlas, consulte: https://www.mongodb.com/es/docs/api/doc/atlas-admin-api-v2/ - Introducción a 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 atlas api se genera automáticamente desde la API de administración de MongoDB Atlas y ofrece cobertura completa de dicha API. Las capacidades de la API de administración tienen su propio ciclo de vida de lanzamiento, que puede consultar a través del enlace de documentación del punto final de la API.

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

Importante

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

Nombre
Tipo
Requerido
Descripción

<tag>

string

true

La categoría de operaciones de la API de Administración de Atlas en camelCase. Para encontrar y formatear la etiqueta, consulte la URL de la documentación de la API para el punto final. Aparece después #tag/ de, pero debe cambiar a camelCase. Para consultar la documentación de la API de Atlas, consulte: 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 formato camelCase. Para encontrar el operationId, consulte la URL de la documentación de la API correspondiente. Aparece después operation/ de. Para consultar la documentación de la API de Atlas, consulte: 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.

Pase la ruta y los parámetros de consulta del punto final de la API de administración de Atlas como indicadores. Por ejemplo, si el punto final es /api/atlas/v2/orgs/{orgId}/invoices/{invoiceId}, el comando CLI de Atlas es:

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

Nota

Normalmente no es necesario especificar --orgId ni --projectId, ya que provienen de tu perfil. Indícalos solo si no están configurados en tu perfil.

Si corresponde al punto final, pase el cuerpo de la solicitud mediante 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. El valor predeterminado es la última versión de la API o el valor que haya configurado para api_version en su perfil.

--out

string

false

Formato de salida. El valor predeterminado es json, pero los formatos admitidos pueden variar según el punto final:

  • La mayoría de los puntos finales generan json. Si se admite json, también se puede usar una plantilla de Go.

  • Algunos puntos finales admiten json y csv, lo que le permite utilizar json, csv o una plantilla Go.

  • Ciertos puntos finales 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 del archivo donde se guarda el resultado. Por defecto, el resultado se muestra en la terminal.

--file

string

false

Ruta del archivo al contenido del cuerpo de la solicitud, si la operación lo requiere. Como alternativa, proporcione la entrada mediante la entrada estándar (stdin).

-h, --help

booleano

false

Ayuda para el comando actual.

Nombre
Tipo
Requerido
Descripción

-h, --ayuda

false

ayuda para api

Nombre
Tipo
Requerido
Descripción

-P, --profile

string

false

Nombre del perfil que se usará en el archivo de configuración. Para obtener más información sobre los perfiles de la CLI de Atlas, consulte https://dochub.mongodb.org/core/atlas-cli-save-connection-settings.

Volver

invitar a

En esta página