Demande de Digital LOA
La lettre d'autorisation numérique (LOA) permet de commander facilement des services nécessitant une autorisation tierce. Elle réduit l'engagement des deux côtés A et Z lors du traitement des commandes de services d'interconnexion tels que Cross Connect.
Ce document s'adresse aux partenaires a-Side qui demandent une lettre d'autorisation numérique. Si vous êtes un partenaire z-Side qui crée une lettre d'autorisation numérique, reportez-vous à la rubrique demande d'une lettre d'autorisation numérique .
Conditions préalables
-
Authentification - Soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour OAuth2 authentification. Pour obtenir des instructions sur la façon d'appeler l'API OAuth pour valider et authentifier vos identifiants, reportez-vous à authentification API.
-
Obtenez des partenaires Z-Side possibles. Utilisez le point de terminaisonobtenir les connexions possibles pour récupérer la liste des partenaires Z-Side potentiels présents dans un datacentre IBX donné.
Création d'une requête - Partenaire Z connu
Pour créer une demande, envoyez-la POSTau /diloa/v1/digitalLoas/loaRequestpoint final.
Si le partenaire z-Side auprès duquel vous souhaitez demander cette lettre d’autorisation numérique est répertorié dans la réponse
à une demande GET adressée au point de terminaison Get possible Connections, définissez le provider.type paramètre sur CUSTOMER_ORGANIZATIONet fournissez ses détails.
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 |
Exemple de requête 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"
}'
Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence API .
Création d'une demande - Nouveau partenaire Z-side
Pour créer une demande, envoyez-la POSTau /diloa/v1/digitalLoas/loaRequestpoint final.
Dans la mesure où le partenaire z-Side auquel vous souhaitez émettre ce document de lettre d’autorisation numérique n’est pas répertorié dans la réponse
à une demande GET adressée au point de terminaison Get possible Connections, définissez le provider.type paramètre sur NEW_RELATIONSHIP. Indiquez également leurs coordonnées.
Exemple de requête 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"
}'
Les paramètres inclus dans le corps de la demande sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, reportez-vous à la référence API .