RemoteAdmin:admin delete region

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Returned Parameters)
m (Robot: Cosmetic changes)
Line 53: Line 53:
 
When an error occures the following error value are returned
 
When an error occures the following error value are returned
  
*region \"{REGION NAME}\" does not exist
+
* region \"{REGION NAME}\" does not exist
  
  
 
== Notes ==
 
== Notes ==
*If you just want to shutdown a region without removing the region from the database, use admin_close_region
+
* If you just want to shutdown a region without removing the region from the database, use admin_close_region
  
  

Revision as of 21:06, 3 March 2012

admin_delete_region remotely allows to delete regions. All region data in the database will be removed. The region will be shutdown and removed from the map.


Contents

Enabling admin_delete_region

If not all functions are enabled, use admin_delete_region to enable the function in the [RemoteAdmin] section

enabled_methods = admin_delete_region,...

Parameters

Required Parameters

These parameters are required

parameter Description Values
region_name Name of the new region


Optional Parameters

There are no optional parameters for this function


Returned Parameters

Returned Parameters

These parameters are returned by Remote Admin

parameter Description Values
success true when successfull true, false
error error message when not successfull
region_id uuid of the region

Error messages

When an error occures the following error value are returned

  • region \"{REGION NAME}\" does not exist


Notes

  • If you just want to shutdown a region without removing the region from the database, use admin_close_region


Example

PHP

<?php
 
// Including the RemoteAdmin PHP class.
include('RemoteAdmin.php');
 
// Instantiate the class with parameters identical to the Python example above
$myRemoteAdmin = new RemoteAdmin('127.0.0.1', 9000, 'secret');
 
// Invoke admin_create_user (multiple parameters)
$parameters = array('region_name' => 'My Plaza');
$myRemoteAdmin->SendCommand('admin_delete_region', $parameters);
?>

RemoteAdmin RemoteAdmin:Commands

Personal tools
General
About This Wiki