ArcGIS Server Administrator API 编写python脚本(一)

jingjihui

　　ArcGIS 10.1 for Server 包含一个 Administrator API，可用于为服务器的常用操作编写脚本。通过为服务器管理编写脚本，您可在计划的时间自动执行各种常用的任务。还可降低执行复杂或重复性任务时犯错误的可能性。
　　通过 Administrator API，您可以调用 ArcGIS Server 所支持的各项管理任务。事实上，ArcGIS 附带的所有管理工具（包括 ArcGIS for Desktop 和 ArcGIS Server 管理器）均可使用此 API。
　　Administrator API 使用 RESTful 架构，并且可以由任何可调用 Web 服务的语言（如 Python、Java、JavaScript、PowerShell、C#、Ruby、Scala、Perl 以及其他语言）进行调用。
　　您可以通过 Administrator API 以编程方式完成许多服务器管理任务，示例如下：

• 静默安装 ArcGIS Server 后创建一个站点
  
• 服务不可用时向您发送电子邮件
  
• 添加服务
  
• 编辑服务属性（如最大实例数）
  
• 授予和撤消用户对服务的权限
  
• 停止和启动服务
  
• 查询日志并根据日志创建使用情况报告
  

　　Server Admin地址为：http://MyServer:6080/arcgis/admin
　　不论何时登录到管理器或管理员目录，都需要提供具有 ArcGIS Server 管理或发布者权限的帐户的用户名和密码。同样的概念也适用于编写脚本时。需通过编程的方式将名称和密码提交到服务器。服务器将返回一个令牌（即一个特殊的字符串），以向服务器证明您具有执行某些类型的操作的权限。对服务器进行的任何 Web 服务请求中都必须包含此令牌。
　　令牌不会永远有效；它具有超时设计，以防被恶意用户偷窃并无限期使用。每次运行脚本时（但并非每次进行请求时），必须请求一个新令牌。
　　可通过以下 Python 函数请求令牌。服务器名称、端口号、用户名和密码将作为参数提供。
　　从 ArcGIS Server 请求管理令牌
　　def getToken(username, password, serverName, serverPort):
# Token URL is typically http://server[:port]/arcgis/admin/generateToken
tokenURL = "/arcgis/admin/generateToken"

# URL-encode the token parameters:-
params = urllib.urlencode({'username': username, 'password': password, 'client': 'requestip', 'f': 'json'})

headers = {"Content-type": "application/x-www-form-urlencoded", "Accept": "text/plain"}

# Connect to URL and post parameters
httpConn = httplib.HTTPConnection(serverName, serverPort)
httpConn.request("POST", tokenURL, params, headers)

# Read response
response = httpConn.getresponse()
if (response.status != 200):
httpConn.close()
print "Error while fetch tokens from admin URL. Please check the URL and try again."
return
else:
data = response.read()
httpConn.close()

# Extract the token from it
token = json.loads(data)
return token['token']