Conectarse a un proveedor de servicios en Fabric
Establezca una conexión entre sus activos colocados en IBX y un perfil de servicio.
Requisitos previos
-
Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
-
Determine la información del puerto del lado A. Obtenga la información de puerto relevante utilizando el punto final Obtener todos los puertos.
-
Elija la ubicación del metro del lado z. Utilice el punto final Get All Metros para encontrar todos los metros en los que Equinix Fabric está disponible y determinar la ubicación de destino de su conexión.
-
Identifique la información del perfil de servicio del proveedor de servicios. Utilice el punto final Recuperar perfiles de servicio para buscar un perfil de servicio específico o utilice el punto final Obtener perfiles de servicio para listar todos los perfiles de servicio disponibles e identifique el perfil al que desea conectarse.
Creación de una conexión desde un puerto DOT1Q a un proveedor de servicios
Para crear una conexión desde un puerto DOT1Q a un proveedor de servicios, envíe una solicitud POST al punto final /fabric/v4/connections. Especifique los detalles de configuración de su conexión en el cuerpo de la solicitud.
POST /fabric/v4/connections | |
|---|---|
| Method | POST |
| Endpoint | /fabric/v4/connections |
| Headers | Authorization, Content-Type |
| Path Parameters | Not applicable |
| Query Parameters | Not applicable |
| Body Parameters | type, name, order, redundancy, bandwidth, aSide, zSide, notifications |
Para validar de forma segura esta solicitud en producción sin crear una conexión, consulte Pruebas en producción (API Dry Run).
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": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de los parámetros y sus descripciones, consulte la Referencia API.
Respuesta de muestra:
{
"href": "https://api.equinix.com/fabric/v4/connections/3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"type": "EVPL_VC",
"uuid": "3a58dd05-f46d-4b1d-a154-2e85c396ea62",
"name": "Conn-1",
"state": "PROVISIONING",
"order": {
"purchaseOrderNumber": "1-129105284100",
"billingTier": "Up to 1 Gbps"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"href": "https://api.equinix.com/fabric/v4/ports/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "XF_PORT",
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "DOT1Q",
"vlanTag": 1001
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"href": "https://api.equinix.com/fabric/v4/serviceProfiles/a867f685-41b0-1b07-6de0-320a5c00abdd",
"type": "L2_Profile",
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f4"
},
"location": {
"href": "https://api.equinix.com/v4/metros/SV",
"metrocode": "SV",
"region": "AMER"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test2@equinix.com"
]
}
],
"operation": {
"equinixStatus": "PENDING_APPROVAL",
"providerStatus": "NOT_AVAILABLE"
},
"changeLog": {
"createdDateTime": "2021-07-15T19:30:29.526Z"
}
}
La carga útil de la respuesta incluye los parámetros de configuración definidos en el cuerpo de la solicitud. Para obtener una lista completa de los posibles parámetros y sus descripciones, consulte la Referencia API.
Creación de una conexión desde un puerto QINQ a un proveedor de servicios
Para crear una conexión desde un puerto QINQ a un proveedor de servicios envíe una solicitud POST al punto final /fabric/v4/connections. Especifique los detalles de configuración de su conexión en el cuerpo de la solicitud.
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": "Conn-1",
"order": {
"purchaseOrderNumber": "1-129105284100"
},
"bandwidth": 1000,
"redundancy": {
"group": "b767f685-41b0-1b07-6de0-320a5c00abdd",
"priority": "SECONDARY"
},
"aSide": {
"accessPoint": {
"type": "COLO",
"port": {
"uuid": "a867f685-41b0-1b07-6de0-320a5c00abdd"
},
"linkProtocol": {
"type": "QINQ",
"vlanCTag": 1001,
"vlanSTag": 1002
}
}
},
"zSide": {
"accessPoint": {
"type": "SP",
"profile": {
"uuid": "20d32a80-0d61-4333-bc03-707b591ae2f5"
},
"location": {
"metroCode": "SV"
}
}
},
"notifications": [
{
"type": "ALL",
"emails": [
"test@equinix.com",
"test@equinix.com"
]
}
]
}'
Los parámetros incluidos en el cuerpo de la solicitud son específicos de este ejemplo. Para obtener una lista completa de los parámetros y sus descripciones, consulte la Referencia API.
Supervisión de la conexión
Utilice el punto final Obtener conexión especificada para supervisar el estado de la conexión.
equinixStatus parameter values | providerStatus parameter values | Description |
|---|---|---|
PENDING_APPROVAL | NOT_AVAILABLE | Connection request awaiting approval. |
PROVISIONING or REJECTED | NOT_AVAILABLE | Connection establishment in progress or the seller has rejected the connection. |
PROVISIONED | AVAILABLE | Connection established. |
