Ir al contenido principal

Pruebas de API Cross Connect

La API Cross Connect le permite solicitar, gestionar y desinstalar conexiones físicas por cable entre equipos en los centros de datos de Equinix. Esta guía proporciona estrategias de prueba, ejemplos y mejores prácticas para la integración con la API Cross Connect.

Visión general​

Las conexiones cruzadas son conexiones físicas por cable que utilizan cables coaxiales, de fibra o de cobre que conectan los equipos de los clientes directamente con otros equipos de clientes dentro de los centros de datos Equinix. Dado que las conexiones cruzadas transmiten datos punto a punto, evitan los problemas de latencia y congestión de la Internet pública.

La API Cross Connect v2 proporciona tres puntos finales principales:

MethodEndpointDescription
POST/colocations/v2/orders/crossConnectsOrder new cross connects
PATCH/colocations/v2/orders/crossConnects/{orderId}Update existing cross connect order
POST/colocations/v2/orders/crossConnects/deinstallDeinstall existing cross connects

Antes de probar la API Cross Connect, asegúrese de que dispone de:

  • Una cuenta de desarrollador de Equinix con permisos de pedido de conexión cruzada
  • Credenciales de API válidas (ID de cliente y secreto de cliente)
  • Acceso a ubicaciones de centros de datos adecuadas
  • Comprensión de API Authentication

Flujo de trabajo de prueba de Cross Connects​

Comience por validar su flujo de autenticación con la API Cross Connect:

# Test authentication for Cross Connect API (Python example)
import requests

auth_url = "https://api.equinix.com/oauth2/v1/token"
auth_payload = {
    "grant_type": "client_credentials",
    "client_id": "<your_client_id>",
    "client_secret": "<your_client_secret>"
}
response = requests.post(auth_url, data=auth_payload)
data = response.json()

if response.status_code != 200:
    raise Exception(f"Authentication failed: {response.status_code} {data}")

access_token = data.get("access_token")
print("Access token:", access_token)
print("Token timeout:", data.get("token_timeout"))

Prueba básica de pedido Cross-Connect

Pruebe el escenario más habitual: solicitar una conexión cruzada de fibra monomodo:

import requests
import json

# Setup authentication
base_url = "https://api.equinix.com"
auth_url = f"{base_url}/oauth2/v1/token"
auth_payload = {
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
}

auth_response = requests.post(auth_url, data=auth_payload)
token = auth_response.json()["access_token"]

# Prepare request
headers = {
    "Authorization": f"Bearer {token}",
    "Content-Type": "application/json"
}

# Test ordering a basic single mode fiber cross connect
payload = {
    "customerReferenceId": "TEST-CC-001",
    "description": "Test cross connect for API integration",
    "details": [
        {
            "aSide": {
                "connectionService": "SINGLE_MODE_FIBER",
                "mediaType": "SINGLE_MODE_FIBER",
                "protocolType": "10_GIG_ETHERNET",
                "connectorType": "FC",
                "patchPanel": {
                    "id": "CP:0104:1199890"
                }
            },
            "zSide": {
                "patchPanel": {
                    "id": "PP:0104:1190123"
                },
                "circuitId": "TEST-CIRCUIT-001",
                "connectorType": "LC"
            }
        }
    ]
}

response = requests.post(
    f"{base_url}/colocations/v2/orders/crossConnects",
    headers=headers,
    data=json.dumps(payload)
)

# Verify response
assert response.status_code == 201, f"Failed to create order: {response.text}"
order_data = response.json()
order_id = order_data.get("orderId")

print(f"Successfully created Cross Connect order with ID: {order_id}")
print(f"Current status: {order_data.get('status')}")

Mejores prácticas para las pruebas de API Cross Connect​

IDs de paneles de conexión no válidos

  • Asegúrese de que los ID de los paneles de conexiones siguen el formato correcto: CP:XXXX:XXXXXXX.
  • Verifique la disponibilidad del panel de conexiones en el centro de datos de destino

Errores de autenticación

  • Compruebe la caducidad del token (normalmente 1 hora)
  • Verifique que las credenciales del cliente son correctas
  • Garantice la correcta implementación del flujo OAuth2

Errores de validación

  • Revise los campos obligatorios frente a los opcionales en la especificación API
  • Compruebe los tipos de datos y los requisitos de formato
  • Validar valores enum para connectionService, mediaType, etc.

Errores de permiso

  • Verifique que su cuenta tiene permisos para pedidos de conexión cruzada
  • Comprobar los permisos de acceso al centro de datos
  • Asegúrese de tener acceso a las ubicaciones IBX especificadas

Documentación relacionada​

Necesita ayuda​

Si encuentra problemas mientras prueba la API Cross Connect:

¿Fue útil esta página?