Exemples d'API : profils de serveurs virtuels
Les informations suivantes affichent des exemples d'API Rest pour l'application des accès aux serveurs virtuels publics qui utilisent des profils prédéfinis.
Pour accéder à des exemples d'API plus robustes, voir les ressources suivantes :
Mise à disposition d'un serveur virtuel public avec un objet de création
Le SoftLayer_Virtual_Guest/createObject Le service API est le moyen le plus simple de provisionner un serveur virtuel public qui utilise des profils prédéfinis.
Non applicable pour les serveurs virtuels transitoires.
Pour mettre à disposition un serveur virtuel public à l'aide de REST, une requête POST sera soumise à https://softlayer.github.io/reference/services/SoftLayer_Virtual_Guest/createObject/ avec le JSON suivant dans le corps de la demande.
Le corps de demande JSON suivant est un exemple générique.
Corps de demande JSON 1
{
"parameters":[
{
"hostname": "public-01-dal10",
"domain": "softlayer.local",
"datacenter": {
"name": "dal10"
},
"operatingSystemReferenceCode": "CENTOS_LATEST",
"networkComponents": [
{
"maxSpeed": 100
}
],
"hourlyBillingFlag": false,
"supplementalCreateObjectOptions": {
"flavorKeyName": "B1_1X2X25"
}
}
]
}
Mise à disposition d'un serveur virtuel public avec un objet de commande d'espace
Le provisionnement d'un serveur virtuel public utilisant des profils prédéfinis s'effectue à l'aide de l'outil SoftLayer_Product_Order/placeOrder Service API.
Non applicable pour les serveurs virtuels transitoires.
Pour provisionner un serveur virtuel public à l'aide de REST, une requête POST serait soumise à Passer la commande avec le JSON suivant dans le corps de la requête.
Les descriptions d'élément ne sont pas requises sur les prix. Elles sont incluses uniquement pour afficher les options de produit soumises.
Le corps de demande JSON suivant est un exemple générique.
Corps de demande JSON 2
{
"parameters": [
{
"location": "449600",
"packageId": 835,
"presetId": 554,
"prices": [
{
"id": 45466,
"item": {
"description": "CentOS 7.x - Minimal Install (64 bit)"
}
},
{
"id": 2202,
"item": {
"description": "25 GB (SAN)"
}
},
{
"id": 905,
"item": {
"description": "Reboot / Remote Console"
}
},
{
"id": 273,
"item": {
"description": "100 Mbps Public & Private Network Uplinks"
}
},
{
"id": 50367,
"item": {
"description": "250 GB Bandwidth"
}
},
{
"id": 21,
"item": {
"description": "1 IP Address"
}
},
{
"id": 55,
"item": {
"description": "Host Ping"
}
},
{
"id": 57,
"item": {
"description": "Email and Ticket"
}
},
{
"id": 58,
"item": {
"description": "Automated Notification"
}
},
{
"id": 420,
"item": {
"description": "Unlimited SSL VPN Users & 1 PPTP VPN User per account"
}
}
],
"quantity": 1,
"useHourlyPricing": false,
"virtualGuests": [
{
"domain": "softlayer.local",
"hostname": "public-01-dal10"
}
],
"complexType": "SoftLayer_Container_Product_Order_Virtual_Guest"
}
]
}
Mise à niveau des serveurs virtuels publics
La mise à niveau d'un serveur virtuel public se fait à l'aide du SoftLayer_Product_Order/placeOrder Service API.
Non applicable pour les serveurs virtuels transitoires.
Pour provisionner un serveur virtuel public à l'aide de REST, une requête POST serait soumise à Passer la commande avec le JSON suivant dans le corps de la requête.
Les descriptions d'élément ne sont pas requises sur les prix. Elles sont incluses uniquement pour afficher les options de produit soumises.
Le corps de demande JSON suivant est un exemple générique.
Corps de demande JSON 3
{
"parameters":[
{
"complexType": "SoftLayer_Container_Product_Order_Virtual_Guest_Upgrade",
"presetId": 494,
"prices": [
{
"id":"274",
"item": {
"description": "1 Gbps Public & Private Network Uplinks"
},
"categories": [
{
"categoryCode": "port_speed"
}
]
}
],
"properties": [
{
"name": "MAINTENANCE_WINDOW",
"value": "2017-07-20T13:48:31-05:00"
}
],
"virtualGuests": [
{
"id": 36189167
}
]
}
]
}
Mise à disposition d'un serveur virtuel transitoire avec un objet de création
Le SoftLayer_Virtual_Guest/createObject Le service API est le moyen le plus simple de provisionner un serveur virtuel temporaire.
Pour provisionner un serveur virtuel temporaire à l'aide de REST, une requête POST serait soumise à Créer un objet avec le JSON suivant dans le corps de la requête.
Le corps de demande JSON suivant est un exemple générique.
Corps de la demande JSON 4
{
"parameters":[
{
"hostname": "sample-transient-public",
"domain": "softlayer.local",
"datacenter": {
"name": "dal10"
},
"operatingSystemReferenceCode": "CENTOS_LATEST",
"networkComponents": [
{
"maxSpeed": 100
}
],
"supplementalCreateObjectOptions": {
"flavorKeyName": "B1_1X2X25"
},
"transientGuestFlag": true
}
]
}