Demande de Digital LOA
La Digital Letter of Authorization (LOA) permet de commander facilement des services nécessitant l'autorisation d'un tiers. Elle minimise l'engagement du côté A et du côté Z lors du traitement des commandes de services d'interconnexion tels que Cross-Connect.
Ce document s'adresse aux partenaires côté a qui demandent une Digital LOA. Si vous êtes un partenaire côté z qui crée une LOA numérique, consultez Demander une lettre d'autorisation numérique.
Conditions préalables
-
Authentifier - Soumettez vos informations d'identification, votre ID client et votre secret client pour OAuth2. authentification. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
-
Obtenez des partenaires Z-side possibles. Utilisez le point de terminaison Get Possible Connections pour récupérer la liste des partenaires potentiels côté Z présents dans un centre de données IBX donné.
Création d'une demande - Partenaire Z-side connu
Pour créer une requête, envoyez une requête POST au point de terminaison /diloa/v1/digitalLoas/loaRequest.
Si le partenaire côté z que vous souhaitez solliciter pour ce document Digital LOA est répertorié dans la réponse à une requête GET au point de terminaison Get Possible Connections, définissez le paramètre provider.type sur CUSTOMER_ORGANIZATION, et fournissez ses coordonnées.
API specification for "diloav1" not found.
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 requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/diloav1/#tag/LoaRequests/operation/createRequest).
Création d'une demande - Nouveau partenaire Z-side
Pour créer une requête, envoyez une requête POST au point de terminaison /diloa/v1/digitalLoas/loaRequest.
Étant donné que le partenaire côté z à qui vous souhaitez délivrer ce document Digital LOA n'est pas répertorié dans la réponse à une requête GET au point de terminaison Get Possible Connections, définissez le paramètre provider.type 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 requête sont spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API] (/api-catalog/diloav1/#tag/LoaRequests/operation/createRequest).