Devolver todas las direcciones IP del plano de control

Obtener /api/atlas/v2/unauth/direccionesIP del plano de control

Devuelve todas las direcciones IP del plano de control.

Parámetros de consulta

envolvente booleano

Indicador que indica si la aplicación encapsula la respuesta en un objeto JSON envelope. Algunos clientes de la API no pueden acceder a los encabezados de respuesta HTTP ni al código de estado. Para solucionar esto, configure envelope=true en la consulta. Los endpoints que devuelven una lista de resultados utilizan el objeto de resultados como encapsulado. La aplicación añade el parámetro de estado al cuerpo de la respuesta.

El valor predeterminado es false.

Respuestas

200 application/vnd.atlas.2023-11-15+json

Vale
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- entrante Objeto
  
  Lista de direcciones IP entrantes al plano de control de Atlas, categorizadas por proveedor de nube. Si su aplicación solo permite solicitudes HTTP salientes a direcciones IP específicas, debe permitir el acceso a las siguientes direcciones IP para que sus solicitudes de API puedan llegar al plano de control de Atlas.
  
  Ocultar atributos entrantes Mostrar atributos de entrada Objeto
  
  AWS Objeto
  
  Direcciones IP del plano de control en AWS. Cada clave identifica una región de Amazon Web Services (AWS). Cada valor identifica las direcciones IP del plano de control en la región de AWS.
  
  Ocultar atributo aws Mostrar atributo aws Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en AWS. Cada clave identifica una región de Amazon Web Services (AWS). Cada valor identifica las direcciones IP del plano de control en la región de AWS.
  
  azur Objeto
  
  Direcciones IP del plano de control en Azure. Cada clave identifica una región de Azure. Cada valor identifica las direcciones IP del plano de control en la región de Azure.
  
  Ocultar atributo azul Mostrar atributo azul Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en Azure. Cada clave identifica una región de Azure. Cada valor identifica las direcciones IP del plano de control en la región de Azure.
  
  gcp Objeto
  
  Direcciones IP del plano de control en GCP. Cada clave identifica una región de Google Cloud (GCP). Cada valor identifica las direcciones IP del plano de control en la región de GCP.
  
  Ocultar atributo gcp Mostrar atributo gcp Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en GCP. Cada clave identifica una región de Google Cloud (GCP). Cada valor identifica las direcciones IP del plano de control en la región de GCP.
- saliente Objeto
  
  Lista de direcciones IP salientes del plano de control de Atlas, categorizadas por proveedor de nube. Si su red solo permite solicitudes HTTP entrantes desde direcciones IP específicas, debe permitir el acceso desde las siguientes direcciones IP para que Atlas pueda comunicarse con sus webhooks y KMS.
  
  Ocultar atributos de salida Mostrar atributos de salida Objeto
  
  AWS Objeto
  
  Direcciones IP del plano de control en AWS. Cada clave identifica una región de Amazon Web Services (AWS). Cada valor identifica las direcciones IP del plano de control en la región de AWS.
  
  Ocultar atributo aws Mostrar atributo aws Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en AWS. Cada clave identifica una región de Amazon Web Services (AWS). Cada valor identifica las direcciones IP del plano de control en la región de AWS.
  
  azur Objeto
  
  Direcciones IP del plano de control en Azure. Cada clave identifica una región de Azure. Cada valor identifica las direcciones IP del plano de control en la región de Azure.
  
  Ocultar atributo azul Mostrar atributo azul Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en Azure. Cada clave identifica una región de Azure. Cada valor identifica las direcciones IP del plano de control en la región de Azure.
  
  gcp Objeto
  
  Direcciones IP del plano de control en GCP. Cada clave identifica una región de Google Cloud (GCP). Cada valor identifica las direcciones IP del plano de control en la región de GCP.
  
  Ocultar atributo gcp Mostrar atributo gcp Objeto
  
  * array[string] Propiedades adicionales
  
  Direcciones IP del plano de control en GCP. Cada clave identifica una región de Google Cloud (GCP). Cada valor identifica las direcciones IP del plano de control en la región de GCP.
500 aplicación/json

Error Interno del Servidor.
Ocultar atributos de respuesta Mostrar los atributos de respuesta Objeto
- badRequestDetail Objeto
  
  Detalle de solicitud incorrecto.
  
  Ocultar el atributo badRequestDetail Mostrar el atributo badRequestDetail Objeto
  
  campos matriz[objeto]
  
  Describe todas las violaciones en una solicitud de cliente.
  
  Ocultar atributos de campos Mostrar atributos de campos Objeto
  
  Descripción string Requerido
  
  Una descripción de por qué el elemento de solicitud es incorrecto.
  
  Campo string Requerido
  
  Una ruta que conduce a un campo en el cuerpo de la solicitud.
- detalle string
  
  Describe las condiciones o razones específicas que causan cada tipo de error.
- Error integer(int32) Requerido
  
  Código de estado HTTP devuelto con este error.
  
  Documentación externa
- errorCode string Requerido
  
  Código de error de aplicación devuelto con este error.
- Parámetros matriz[objeto]
  
  Parámetros utilizados para dar más información sobre el error.
- razón string
  
  Se devolvió un mensaje de error de aplicación con este error.

OBTENER /api/atlas/v2/unauth/controlPlaneIPAddresses

atlas api root listControlPlaneAddresses --help

import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20250219001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.ListControlPlaneIpAddressesApiParams{}
	sdkResp, httpResp, err := client.RootApi.
		ListControlPlaneIpAddressesWithParams(ctx, params).
		Execute()
}

curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2025-02-19+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/unauth/controlPlaneIPAddresses?pretty=true"

curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2025-02-19+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/unauth/controlPlaneIPAddresses?pretty=true"

Ejemplos de respuestas (200)

{
  "inbound": {
    "aws": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    },
    "azure": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    },
    "gcp": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    }
  },
  "outbound": {
    "aws": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    },
    "azure": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    },
    "gcp": {
      "additionalProperty1": [
        "string"
      ],
      "additionalProperty2": [
        "string"
      ]
    }
  }
}

Ejemplos de respuestas (500)

{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}