API: conexión a AWS Direct Connect

Establezca una conexión directa de capa 2 entre sus activos de IBX y sus recursos de Amazon Web Services (AWS) con Fabric y AWS Direct Connect. Utilice el API para crear la conexión desde un puerto, un dispositivo Network Edge o Fabric Cloud Router.

Si tiene un token de servicio proporcionado por AWS, consulte Conectarse a un destino mediante un token de servicio .

Requisitos previos de la API

Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte Autenticación de API para obtener instrucciones sobre cómo llamar a OAuth API para validar y autenticar sus credenciales.
Determine su información de A-Side. O bien:
- Determine la información de sus puertos Equinix Fabric enviando una GET solicitud al /fabric/v4/ports punto final. Necesita los UUID del puerto y el tipo de protocolo de enlace (DOT1Q o QINQ),
O
- Recupere su token o tokens de servicio de A-Side enviando una GET solicitud al /fabric/v4/serviceTokens punto final. Necesita el UUID del token. El token de A-Side proporciona la información relevante para configurar el A-Side de la conexión.
O
- Determina la información de tu dispositivo Network Edge. Compruebe sus dispositivos virtuales y clústeres disponibles enviando una GET solicitud al /ne/v1/devices punto final. Necesita el UUID(s) del dispositivo. Envíe una GET solicitud al /ne/v1/devices/{device_id} punto final para obtener los detalles de un dispositivo. Puede elegir cualquier interfaz disponible en el dispositivo para su conexión. Si no especifica una, la conexión se asigna automáticamente a la siguiente interfaz disponible.
O
- Determina la información de tu Fabric Cloud Router. Compruebe sus enrutadores en la nube disponibles enviando una POST solicitud al /fabric/v4/routers/search punto final. Necesita el UUID del router.
Identifique el perfil de servicio de AWS Direct Connect y la información de ubicación. Más información sobre el perfil de servicio que debe elegir se encuentra en la páginaDescripción general de AWS Direct Connect.
- UUID de AWS Direct Connect - 69ee618d-be52-468d-bc99-00566f2dd2b9
- UUID de alta capacidad de AWS Direct Connect - de55ca94-df3b-4680-845f-6f7093f76bef
- UUID redundante de AWS Direct Connect - 8b5cbdbd-53da-4d37-9bfc-cc988eb522f1
- AWS Direct Connect- Redundante de alta capacidad - ed48616a-c182-40b4-a462-a78ba812e961
Para encontrar la información de ubicación, envíe una GET solicitud al /fabric/v4/serviceProfiles/{service_profile_ID} punto final utilizando uno de los IDS del perfil de servicio de AWS Direct Connect. El metros objeto de la respuesta contiene una lista de áreas metropolitanas de Equinix y su región AWS asociada. Necesita ambos para crear una conexión.
Identifique y valide su ID de cuenta de Amazon. Inicie sesión en la consola de administración de AWS y localice su número de cuenta. Consulte la documentación de AWS para obtener instrucciones sobre cómo encontrar su número de cuenta. Envíe una POST solicitud al /fabric/v4/connections/validate punto final para verificar que su ID de cuenta de AWS se puede utilizar para crear una conexión con el perfil de servicio seleccionado en el área metropolitana correspondiente.

Conexión desde un puerto DOT1Q

Para crear una conexión desde su puerto DOT1Q a AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

Proporcione la información de su puerto en el aSide objeto, incluyendo:

accessPoint.type as COLO
Proporcione el UUID de su puerto a port.uuid
LinkProtocol.type as DOT1Q
Proporcione el ID de VLAN a linkProtocol.vlanTag

Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el zSide objeto, incluidos:

Establecer accessPoint.type como SP.
Establecer profile.type como L2_PROFILE.
Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
Especifique la ubicación de área metropolitana de Equinix a la que se está conectando en location.metroCode.
Especifique la región de AWS asociada al área metropolitana de Equinix en sellerRegion. Esta información se puede encontrar en el /fabric/v4/serviceProfiles/{service_profile_ID} punto final. Consulte el punto final delos requisitos previos de API. Consulte losrequisitos previos de API para obtener más detalles.
Establezca authenticationKey como su ID de cuenta de AWS.

Especifique cualquier otro detalle de configuración de la conexión, incluidos bandwidth y redundancy, en el cuerpo de la solicitud. Para obtener una lista completa de parámetros y sus descripciones, consulte la referencia de API .

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "DOT1Q",
        "vlanTag": <vlan_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conexión desde un puerto QINQ

Para crear una conexión desde su puerto de QINQ a AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

Proporcione la información de su puerto en el aSide objeto, incluyendo:

Establecer accessPoint.type como COLO
Proporcione el UUID de su puerto a port.uuid
linkProtocol.type as QINQ
Proporcione el ID de etiqueta interno a linkProtocol.vlanCTag
Proporcione el ID de la etiqueta externa a linkProtocol.vlanSTag

Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el zSide objeto, incluidos:

Establecer accessPoint.type como SP.
Establecer profile.type como L2_PROFILE.
Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
Especifique la ubicación de área metropolitana de Equinix a la que se está conectando en location.metroCode.
Especifique la región de AWS asociada al área metropolitana de Equinix en sellerRegion. Esta información se puede encontrar en el /fabric/v4/serviceProfiles/{service_profile_ID} punto final. Consulte el punto final delos requisitos previos de API. Consulte losrequisitos previos de API para obtener más detalles.
Establezca authenticationKey como su ID de cuenta de AWS.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "COLO",
      "port": {
        "uuid": "<port_uuid>"
      },
      "linkProtocol": {
        "type": "QINQ",
        "vlanCTag": <inner_tag_ID>,
        "vlanSTag": <outer_tag_ID>
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexión mediante un token de servicio

Para crear una conexión con un token de servicio de A-Side A AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

Proporcione su UUID de token de servicio en el aSide objeto. El token de servicio proporciona toda la información necesaria para establecer la conexión.

Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el zSide objeto, incluidos:

Establecer accessPoint.type como SP.
Establecer profile.type como L2_PROFILE.
Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
Especifique la ubicación de área metropolitana de Equinix a la que se está conectando en location.metroCode.
Especifique la región de AWS asociada al área metropolitana de Equinix en sellerRegion. Esta información se puede encontrar en el /fabric/v4/serviceProfiles/{service_profile_ID} punto final. Consulte el punto final delos requisitos previos de API. Consulte losrequisitos previos de API para obtener más detalles.
Establezca authenticationKey como su ID de cuenta de AWS.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "serviceToken": {
      "uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}

Conexión desde un dispositivo Network Edge

Para crear una conexión desde su dispositivo Network Edge a AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es EVPL_VC.

Defina su dispositivo Network Edge en el aSide objeto, incluyendo:

accessPoint.type as VD
virtualDevice.type as EDGE
virtualDevice.uuid Como UUID de su dispositivo

Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el zSide objeto, incluidos:

Establecer accessPoint.type como SP.
Establecer profile.type como L2_PROFILE.
Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
Especifique la ubicación de área metropolitana de Equinix a la que se está conectando en location.metroCode.
Especifique la región de AWS asociada al área metropolitana de Equinix en sellerRegion. Esta información se puede encontrar en el /fabric/v4/serviceProfiles/{service_profile_ID} punto final. Consulte el punto final delos requisitos previos de API. Consulte losrequisitos previos de API para obtener más detalles.
Establezca authenticationKey como su ID de cuenta de AWS.

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "EVPL_VC",
  "name": "<your_connection_name>",
  "bandwidth": <connection_speed>,
  "redundancy": {
    "priority": "<redundancy_code>"
  },
  "aSide": {
    "accessPoint": {
      "type": "VD",
      "virtualDevice": {
        "type": "EDGE",
        "uuid": "<device_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Conexión desde un Fabric Cloud Router

Para crear una conexión desde su Fabric Cloud Router a AWS, envíe una POST solicitud al /fabric/v4/connections punto final. La conexión type es IP_VC.

Defina su Fabric Cloud Router en el aSide objeto incluyendo:

Establecer accessPoint.type como CLOUD_ROUTER.
Establezca router.uuid como UUID de su router.

Proporcione los detalles de su AWS Direct Connect y los detalles de la ubicación en el zSide objeto, incluidos:

Establecer accessPoint.type como SP.
Establecer profile.type como L2_PROFILE.
Especifique el perfil de servicio de AWS al que se está conectando en profile.uuid.
Especifique la ubicación de área metropolitana de Equinix a la que se está conectando en location.metroCode.
Especifique la región de AWS asociada al área metropolitana de Equinix en sellerRegion. Esta información se puede encontrar en el /fabric/v4/serviceProfiles/{service_profile_ID} punto final. Consulte el punto final delos requisitos previos de API. Consulte losrequisitos previos de API para obtener más detalles.
Establezca authenticationKey como su ID de cuenta de AWS

Ejemplo de solicitud cURL:

curl -X
POST 'https://api.equinix.com/fabric/v4/connections'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
  "type": "IP_VC",
  "name": "<your_connection_name>",
    "bandwidth": <connection_speed>,
    "redundancy": {
      "priority": "<redundancy_code>"
    },
  "aSide": {
    "accessPoint": {
      "type": "CLOUD_ROUTER",
      "router": {
        "uuid": "<cloud_router_uuid>"
      }
    }
  },
  "zSide": {
    "accessPoint": {
      "type": "SP",
      "profile": {
        "type": "L2_PROFILE",
        "uuid": "<service_profile_uuid>"
      },
      "location": {
        "metroCode": "<equinix_metro_code>"
      },
      "sellerRegion": "<aws_region_name>",
      "authenticationKey": "<amazon_account_ID>"
    }
  },
  "project": {
    "projectId": "<project_uuid>"
  },
  "notifications": [
    {
      "type": "ALL",
      "emails": [
      "<contact_email>"
      ]
    }
  ]
}'

Supervisión del estado de la conexión

Envíe una GET solicitud al fabric/v4/connections/{connection_id} punto final para supervisar el estado de la conexión.

`equinixStatus` valores de atributo	`providerStatus` valores de atributo	Estado de AWS Direct Connect	Descripción
`PROVISIONING`	`PROVISIONING`		La solicitud de conexión aún no se ha enviado a AWS.
`PROVISIONED`	`PENDING_APPROVAL`	Pedidos -> Solicitados	La conexión espera su aceptación.
`PROVISIONED`	`PROVISIONING`	Pendiente	Establecimiento de conexión en curso.
`PROVISIONED`	`PROVISIONED`	Pendiente -> Disponible	La conexión ha sido aceptada.

Requisitos previos de la API​

Conexión desde un puerto DOT1Q​

Conexión desde un puerto QINQ​

Conexión mediante un token de servicio​

Conexión desde un dispositivo Network Edge​

Conexión desde un Fabric Cloud Router​

Supervisión del estado de la conexión​

Requisitos previos de la API

Conexión desde un puerto DOT1Q

Conexión desde un puerto QINQ

Conexión mediante un token de servicio

Conexión desde un dispositivo Network Edge

Conexión desde un Fabric Cloud Router

Supervisión del estado de la conexión