Server Bandwidth

From INAP Dropzone API
(Difference between revisions)
Jump to: navigation, search
(Created page with "The server bandwidth command ==Path== */server/bandwidth/{$serverid}/{$start}/{$end} ==Method== *GET ==Availability== *[[servers#Dedicated Serve...")
 
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
The [[Server|server]] bandwidth command  
+
The [[Server|server]] bandwidth command will return a list the bandwidth usage for a server for a specified period. When this command is run it may take a few minutes for it to finish.
 
==Path==
 
==Path==
*/server/bandwidth/{$serverid}/{$start}/{$end}
+
*/server/bandwidth/{$start}/{$end}/{$serverid}
  
 
==Method==
 
==Method==
Line 13: Line 13:
  
 
==Required Data Parameters==
 
==Required Data Parameters==
 +
*{$start}: The start date and time of the bandwidth records to be retrieved (unix timestamp).
 +
*{$end}: The end date and time of the bandwidth records to be retrieved (unix timestamp).
 
*{$serverid}: The server ID that is returned when using the [[Server List|list]] command.
 
*{$serverid}: The server ID that is returned when using the [[Server List|list]] command.
*{$start}: .
 
*{$end}: .
 
  
 
==Optional Data Parameters==
 
==Optional Data Parameters==
Line 25: Line 25:
 
   [success] => TRUE/FALSE
 
   [success] => TRUE/FALSE
 
   [data] => stdClass Object(
 
   [data] => stdClass Object(
 
+
    [intotal] => The total inbound bandwidth used for the specified start/end time.
 +
    [outtotal] => The total outbound bandwidth used for the specified start/end time.
 +
    [dailyusage] => array(
 +
      [0] => stdClass Object(
 +
        [in] => Inbound bandwidth used on a specific date.
 +
        [out] => Outbound bandwidth used on a specific date.
 +
        [timestamp] => The date the bandwidth usage was retrieved (unix timestamp).
 +
        [date] => The date the bandwidth usage was retrieved (human readable).
 +
      )
 +
    )
 
   )
 
   )
 
)
 
)
 
</pre>
 
</pre>

Latest revision as of 17:02, 16 May 2012

The server bandwidth command will return a list the bandwidth usage for a server for a specified period. When this command is run it may take a few minutes for it to finish.

Contents

Path

  • /server/bandwidth/{$start}/{$end}/{$serverid}

Method

Availability

Required Data Parameters

  • {$start}: The start date and time of the bandwidth records to be retrieved (unix timestamp).
  • {$end}: The end date and time of the bandwidth records to be retrieved (unix timestamp).
  • {$serverid}: The server ID that is returned when using the list command.

Optional Data Parameters

  • None

Returned Data

stdClass Object(
  [success] => TRUE/FALSE
  [data] => stdClass Object(
    [intotal] => The total inbound bandwidth used for the specified start/end time.
    [outtotal] => The total outbound bandwidth used for the specified start/end time.
    [dailyusage] => array(
      [0] => stdClass Object(
        [in] => Inbound bandwidth used on a specific date.
        [out] => Outbound bandwidth used on a specific date.
        [timestamp] => The date the bandwidth usage was retrieved (unix timestamp).
        [date] => The date the bandwidth usage was retrieved (human readable).
      )
    )
  )
)
Personal tools