Crear una Digital LOA
La Carta de Autorización Digital (LOA) permite solicitar cómodamente servicios que requieren autorización de terceros. Minimiza el compromiso tanto del lado A como del lado Z a la hora de tramitar pedidos de servicios de interconexión como Cross Connect.
Este documento es para los socios del lado z que crean una Digital LOA. Si usted es un socio del lado a que busca una LOA Digital de un socio del lado z, consulte Solicitar una Carta de Autorización Digital.
Requisitos previos
-
Autenticar - Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para OAuth2 autenticación. Consulte API Authentication para obtener instrucciones sobre cómo llamar a la API OAuth para validar y autenticar sus credenciales.
-
(Opcional) Obtener posibles socios del lado A. Utilice el punto final Obtener posibles socios A para recuperar la lista de socios A que están presentes en un centro de datos IBX especificado.
Creación de un LOA digital: relación existente con la parte A
Para crear una Digital LOA envíe una solicitud POST al punto final /diloa/v1/digitalLoas. Especifique el interlocutor a y los detalles de la conexión en el cuerpo de la solicitud.
API specification for "diloav1" not found.
Si el cliente del lado A al que desea emitir este documento de Digital LOA aparece en la respuesta a una solicitud GET al punto final Obtener posibles conexiones, establezca el parámetro requestor.type en CUSTOMER_ORGANIZATION.
En el parámetro requestor.ids, especifique las organizaciones de clientes con derecho a utilizar este documento de Digital LOA.
Ejemplo de solicitud cURL:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"products": [
{
"type": "CROSS_CONNECT",
"crossConnect": {
"connectionService": "UTP",
"mediaType": "CAT6",
"protocolType": "ETHERNET",
"zSide": {
"connectorType": "RJ45",
"patchPanelId": "PP:0000:6256843",
"circuitId": "34234535",
"portA": 4
}
}
}
],
"requestor": {
"type": "CUSTOMER_ORGANIZATION",
"contacts": [
{
"type": "NOTIFICATION",
"details": [
{
"value": "jane@xyz.com",
"type": "EMAIL"
}
]
}
],
"orgIds": [
"123412",
"223124"
],
"name": "XYZ Company"
},
"provider": {
"contacts": [
{
"type": "NOTIFICATION",
"firstName": "John",
"lastName": "Smith",
"timezone": "America/Los_Angeles",
"details": [
{
"value": "john@smith.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "",
"expiryDateTime": "2022-07-31T21:59:59.999Z"
}'
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:
{
"token": "<token>",
"uuid": "079dc798-05e8-11ed-b939-0242ac120002",
"state": "READY_FOR_USE",
"draft": false,
"changeLog": {
"createdDateTime": 2018-05-24T18:19:59.999Z
},
"link": {
"rel": "info",
"href": "https://ic-core-prod-ingress-usw1.clouda.equinix.com:80/diloa/v2/digitalLoas/402cbf99-97d7-440f-8291-1a4b9639154a",
"method": "GET",
"contentType": "application/json",
"authenticate": true
},
"expiryDateTime": 2018-06-24T18:19:59.999Z,
"href": "diloa/v1/digitalLoas/079dc798-05e8-11ed-b939-0242ac120002"
}
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 un Digital LOA - Nueva relación A-side
Para crear una Digital LOA envíe una solicitud POST al punto final /diloa/v1/digitalLoas. Especifique los detalles de la conexión en el cuerpo de la solicitud.
Dado que el cliente del lado A al que desea emitir este documento de Digital LOA no aparece en la respuesta a una solicitud GET al punto final Get Possible Connections, establezca el parámetro requestor.type en NEW_RELATIONSHIP. Proporcione también su información de contacto.
Ejemplo de solicitud cURL:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas"
-H "content-type: application/json"
-H "Authorization: Bearer {Access Token}"
-d '{
"products": [
{
"type": "CROSS_CONNECT",
"crossConnect": {
"connectionService": "UTP",
"mediaType": "CAT6",
"protocolType": "ETHERNET",
"zSide": {
"connectorType": "RJ45",
"patchPanelId": "PP:0000:6256843",
"circuitId": "34234535",
"portA": 4
}
}
}
],
"requestor": {
"type": "NEW_RELATIONSHIP",
"email": "jane@xyz.com",
"name": "XYZ Company"
},
"provider": {
"contacts": [
{
"type": "NOTIFICATION",
"firstName": "John",
"lastName": "Smith",
"timezone": "America/Los_Angeles",
"details": [
{
"value": "john@smith.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "",
"expiryDateTime": "2022-07-31T21:59:59.999Z"
}'
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.
Autorizar el uso de Digital LOA
Este paso es aplicable a las nuevas relaciones con clientes de la parte A. Una vez creado el documento de Digital LOA, la parte A recibe una notificación por correo electrónico con el enlace de autorización.
Una vez que la parte A verifique y apruebe el documento de la LOA Digital, envíe una solicitud GET al punto final /diloa/v1/digitalLoas/{id}/actions. Especifique la LOA Digital en la ruta de la solicitud y el type como AUTHORIZE en el cuerpo de la solicitud.
API specification for "diloav1" not found.
Ejemplo de solicitud cURL:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/{id}/actions"
-H "Authorization: Bearer <token>"
-d '{
"type": "AUTHORIZE"
}'
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 del estado de la LOA digital
Utilice la solicitud API /diloa/v1/digitalLoas/{id} para supervisar el estado del documento LOA. Para obtener información sobre los posibles estados, consulte Digital LOA Statuses.