Exemplos de API: perfis de servidores virtuais públicos

As informações a seguir exibem exemplos da API de REST para fornecimento de servidores virtuais públicos que usam perfis pré-configurados.

Para exemplos de API mais robustos, veja os recursos a seguir:

Fornecendo um servidor virtual público com Criar objeto

O SoftLayer_Virtual_Guest/createObject O serviço API é a maneira mais simples de provisionar um servidor virtual público que usa perfis predefinidos.

Não aplicável para servidores virtuais temporários.

Para fornecer um servidor virtual público usando REST, uma solicitação POST é enviada para https://softlayer.github.io/reference/services/SoftLayer_Virtual_Guest/createObject/ com o JSON a seguir no corpo da solicitação.

O corpo da solicitação JSON a seguir é um exemplo genérico.

Corpo da solicitação 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"
            }
        }
    ]
}

Fornecendo um servidor virtual público com Pedir objeto

O provisionamento de um servidor virtual público que usa perfis predefinidos é feito usando o SoftLayer_Product_Order/placeOrder Serviço de API.

Não aplicável para servidores virtuais temporários.

Para provisionar um servidor virtual público usando REST, uma solicitação POST seria enviada para Faça a encomenda com o seguinte JSON no corpo da solicitação.

As descrições de itens não são necessárias nos preços. Eles são incluídos apenas para mostrar as opções do produto que estão sendo enviadas.

O corpo da solicitação JSON a seguir é um exemplo genérico.

Corpo da solicitação 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"
        }
    ]
}

Fazendo upgrade de servidores virtuais públicos

A atualização de um servidor virtual público é feita usando o SoftLayer_Product_Order/placeOrder Serviço de API.

Não aplicável para servidores virtuais temporários.

Para provisionar um servidor virtual público usando REST, uma solicitação POST seria enviada para Faça a encomenda com o seguinte JSON no corpo da solicitação.

As descrições de itens não são necessárias nos preços. Eles são incluídos apenas para mostrar as opções do produto que estão sendo enviadas.

O corpo da solicitação JSON a seguir é um exemplo genérico.

Corpo da solicitação 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
                }
            ]
        }
    ]
}

Fornecendo um servidor virtual temporário com Criar objeto

O SoftLayer_Virtual_Guest/createObject O serviço API é a maneira mais simples de provisionar um servidor virtual transitório.

Para provisionar um servidor virtual transitório usando REST, uma solicitação POST seria enviada para Criar objeto com o seguinte JSON no corpo da solicitação.

O corpo da solicitação JSON a seguir é um exemplo genérico.

Corpo da solicitação 4 de JSON

{
    "parameters":[
        {
            "hostname": "sample-transient-public",
            "domain": "softlayer.local",
            "datacenter": {
                "name": "dal10"
            },
            "operatingSystemReferenceCode": "CENTOS_LATEST",
            "networkComponents": [
                {
                    "maxSpeed": 100
                }
            ],
            "supplementalCreateObjectOptions": {
                "flavorKeyName": "B1_1X2X25"
            },
            "transientGuestFlag": true
        }
    ]
}