Solicitar LOA digital
A carta de autorização digital (LOA) permite o pedido conveniente de serviços que exigem autorização de terceiros. Ele minimiza o envolvimento do A-Side e Z-Side ao processar pedidos de serviços de interconexão, como Cross Connect.
Este documento é para parceiros A-Side que solicitam uma LOA digital. Se você for um parceiro z-Side criando uma LOA Digital, consulte Solicitar uma Carta de Autorização Digital .
Pré-requisitos
-
Autenticar - Envie suas credenciais de usuário, ID do cliente e segredo do cliente para OAuth2. autenticação. Consulte Autenticação API para obter instruções sobre como chamar o OAuth API para validar e autenticar suas credenciais.
-
Obtenha possíveis parceiros do Z-Side. Use o endpointGet Possible Connections para recuperar a lista de possíveis parceiros Z-Side presentes em um determinado data center IBX.
Criando uma solicitação - Parceiro conhecido do lado Z
Para criar uma solicitação, envie uma POST solicitação para o /diloa/v1/digitalLoas/loaRequest terminal.
Se o parceiro z-Side do qual você deseja solicitar este documento de LOA Digital estiver listado na resposta
a uma solicitação GET para o endpoint Obter conexões possíveis, defina o provider.type parâmetro como CUSTOMER_ORGANIZATIONe forneça os detalhes.
POST /diloa/v1/digitalLoas/loaRequestsView the API Reference | |
|---|---|
| Method | POST |
| URL or End Point | /diloa/v1/digitalLoas/loaRequests |
| Headers | Content-Type |
| Query Parameters | Not applicable |
| Body Parameters | ibx, requestedNumber, requestor {contacts [{type, registeredUser, firstName, lastName, timezone, availability, details [{notes, value, type}]}]}, provider {type}, notes |
Exemplo de requisição cURL:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "CUSTOMER_ORGANIZATION",
"orgIds": [
"123456"
],
"name": "Michael Scott Paper Company",
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"notes": "No additional notes"
}'
Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa de parâmetros e suas descrições, consulte a Referência API .
Criando uma solicitação - Novo parceiro Z-side
Para criar uma solicitação, envie uma POST solicitação para o /diloa/v1/digitalLoas/loaRequest terminal.
Como o parceiro z-Side para o qual você deseja emitir este documento LOA Digital não está listado na resposta
a uma solicitação GET para o endpoint GET Possíveis Conexões, defina o provider.type parâmetro como NEW_RELATIONSHIP. Também forneça suas informações de contato.
Exemplo de requisição cURL:
curl -X
POST "https://api.equinix.com/diloa/v1/digitalLoas/loaRequest"
-H "content-type: application/json"
-H "Authorization: Bearer <token>"
-d '{
"ibx": "CH1",
"requestedNumber": 2,
"requestor": {
"contacts": [
{
"type": "NOTIFICATION",
"registeredUser": "Registered",
"firstName": "John",
"lastName": "Smith",
"timezone": "Australia/Perth",
"availability": "ANYTIME",
"details": [
{
"note": "new email address",
"value": "kyle@mail.com",
"type": "EMAIL"
}
]
}
]
},
"provider": {
"type": "NEW_RELATIONSHIP",
"email": "mike@mspc.us",
"name": "Michael Scott Paper Company"
},
"notes": "No additional notes"
}'
Os parâmetros incluídos no corpo da solicitação são específicos deste exemplo. Para obter uma lista completa de parâmetros e suas descrições, consulte a Referência API .