Sanal Sunucuya Eylem Gönder

Belirli bir hizmet ID'sine sahip Sanal Sunucu üzerinde başlatma, durdurma, yeniden başlatma veya gücü kesme gibi eylemleri gerçekleştirmek için bu endpointi kullanın.

Belirli bir hizmetinize (service) bağlı olan Sanal Sunucu üzerinde çeşitli güç eylemleri (başlatma, durdurma vb.) gerçekleştirmek için aşağıdaki bilgileri kullanabilirsiniz.

Endpoint Bilgileri

Note:

HTTP Methodu: POST

URL Yolu: /api/services/service_id/vps/action

Tam URL (Örnek): https://nodesty.com/api/services/YOUR_SERVICE_ID/vps/action

  • {service_id} (Path Parametresi): Üzerinde eylem gerçekleştirmek istediğiniz hizmetin benzersiz kimliğidir. Bu ID'yi genellikle hizmet listeleme (/api/services) endpoint'inden veya Müşteri Panelinizden öğrenebilirsiniz. URL'de YOUR_SERVICE_ID yazan kısmı bu değerle değiştirmelisiniz.

Kimlik Doğrulama (Authentication)

Bu isteği yapabilmek için Authorization başlığını (Header) kullanmanız gerekmektedir.

  • Header Adı: Authorization
  • Değer Formatı: PAT <TOKEN>

<TOKEN> kısmını size özel Nodesty Kişisel Erişim Token'ınız (Personal Access Token) ile değiştirin. Token'ınızı Müşteri Paneli'nden alabilirsiniz.

İstek (Request)

Bu endpoint POST metodu ile çalıştığı için bir Request Body gönderilmesi gereklidir. Body, JSON formatında olmalı ve gerçekleştirilecek eylemi belirtmelidir.

  • Content-Type: application/json

Request Body Yapısı:

{
  "action": "string" 
}
  • action (string, zorunlu): Sanal sunucu üzerinde gerçekleştirilecek eylemi belirtir. Kabul edilen değerler şunlardır:
    • 'start': Sanal sunucuyu başlatır.
    • 'stop': Sanal sunucuyu düzgün bir şekilde kapatır (işletim sistemine kapatma sinyali gönderir).
    • 'restart': Sanal sunucuyu yeniden başlatır.
    • 'poweroff': Sanal sunucunun gücünü aniden keser (zorla kapatma).

Örnek İstek (cURL)

Aşağıdaki komut ile kendi token'ınızı, API adresinizi, eylem yapılacak hizmetin service_id'sini ve istediğiniz action değerini kullanarak Sanal Sunucuya eylem gönderebilirsiniz (örnekte 'start' eylemi kullanılmıştır):

request.bash
# YOUR_PERSONAL_ACCESS_TOKEN kısmını kendi tokenınız ile değiştirin.
# https://nodesty.com kısmını API'nizin adresi ile değiştirin.
# YOUR_SERVICE_ID kısmını eylem yapılacak hizmetin ID'si ile değiştirin.
# "action" değerini 'start', 'stop', 'restart' veya 'poweroff' olarak değiştirin.

curl --request POST \\
     --url https://nodesty.com/api/services/YOUR_SERVICE_ID/vps/action \\
     --header 'Authorization: PAT YOUR_PERSONAL_ACCESS_TOKEN' \\
     --header 'Content-Type: application/json' \\
     --data '{
       "action": "start" 
     }'

Bu isteği başarıyla gönderdiğinizde, sunucu genellikle eylemin başarıyla tetiklendiğini belirten bir yanıt (örneğin 200 OK veya 202 Accepted) dönecektir. Hatalı durumlarda (örneğin geçersiz token, bulunamayan service_id veya geçersiz action değeri) uygun bir HTTP hata kodu alırsınız.