API-Beispiele: Profile öffentlicher virtueller Server

Die folgenden Informationen zeigen REST-API-Beispiele für die Bereitstellung öffentlicher virtueller Server an, die vordefinierte Profile verwenden.

Besonders leistungsfähige API-Beispiele finden Sie in den folgenden Ressourcen:

Öffentlichen virtuellen Server mit Erstellungsobjekt bereitstellen

Der SoftLayer_Virtual_Guest/createObject Der API-Dienst ist die einfachste Möglichkeit, einen öffentlichen virtuellen Server bereitzustellen, der voreingestellte Profile verwendet.

Nicht zutreffend für transiente virtuelle Server.

Wenn Sie einen öffentlichen virtuellen Server mithilfe von REST bereitstellen möchten, wird eine POST-Anforderung mit dem folgenden JSON-Format im Anforderungshauptteil an https://softlayer.github.io/reference/services/SoftLayer_Virtual_Guest/createObject/ übergeben.

Der folgende JSON-Anforderungshauptteil stellt ein generisches Beispiel dar.

JSON-Anforderungshauptteil 1

{
    "parameters":[
        {
            "hostname": "public-01-dal10",
            "domain": "softlayer.local",
            "datacenter": {
                "name": "dal10"
            },
            "operatingSystemReferenceCode": "CENTOS_LATEST",
            "networkComponents": [
                {
                    "maxSpeed": 100
                }
            ],
            "hourlyBillingFlag": false,
            "supplementalCreateObjectOptions": {
                "flavorKeyName": "B1_1X2X25"
            }
        }
    ]
}

Öffentlichen virtuellen Server mit Bestellungsobjekt bereitstellen

Die Bereitstellung eines öffentlichen virtuellen Servers, der voreingestellte Profile verwendet, erfolgt über das SoftLayer_Product_Order/placeOrder API-Dienst.

Nicht zutreffend für transiente virtuelle Server.

Um einen öffentlichen virtuellen Server mit REST bereitzustellen, wird eine POST-Anfrage an Bestellung aufgeben mit dem folgenden JSON im Anforderungstext.

Die Artikelbezeichnungen sind für die Preise nicht erforderlich. Sie sind nur enthalten, um die Produktoptionen anzuzeigen, die übergeben werden.

Der folgende JSON-Anforderungshauptteil stellt ein generisches Beispiel dar.

JSON-Anforderungshauptteil 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"
        }
    ]
}

Upgrade für öffentliche virtuelle Server durchführen

Das Upgrade eines öffentlichen virtuellen Servers erfolgt über den SoftLayer_Product_Order/placeOrder API-Dienst.

Nicht zutreffend für transiente virtuelle Server.

Um einen öffentlichen virtuellen Server mit REST bereitzustellen, wird eine POST-Anfrage an Bestellung aufgeben mit dem folgenden JSON im Anforderungstext.

Die Artikelbezeichnungen sind für die Preise nicht erforderlich. Sie sind nur enthalten, um die Produktoptionen anzuzeigen, die übergeben werden.

Der folgende JSON-Anforderungshauptteil stellt ein generisches Beispiel dar.

JSON-Anforderungshauptteil 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
                }
            ]
        }
    ]
}

Transienten virtuellen Server mit Erstellungsobjekt bereitstellen

Der SoftLayer_Virtual_Guest/createObject Der API-Dienst ist die einfachste Möglichkeit, einen temporären virtuellen Server bereitzustellen.

Um einen temporären virtuellen Server mit REST bereitzustellen, wird eine POST-Anfrage an Objekt erstellen mit dem folgenden JSON im Anforderungstext.

Der folgende JSON-Anforderungshauptteil stellt ein generisches Beispiel dar.

JSON-Anforderungshauptteil 4

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