Python ArcGIS Server用法及代碼示例

本文簡要介紹 python 語言中 arcgis.gis.server.Server 的用法。

用法:

class arcgis.gis.server.Server(url, gis=None, **kwargs)

可選參數：

• baseurl: 可選字符串。站點的根 URL。示例：https://mysite.com/arcgis
• tokenurl: 可選字符串。當站點聯合或令牌 URL 與站點的基本 URL 不同時使用。如果站點是聯合的，則令牌 URL 將作為門戶令牌返回，並且 ArcGIS 服務器用戶將無法正確驗證。
• username: 可選字符串。使用內置ArcGIS 服務器安全性時的登錄用戶名。
• password: 可選字符串。指定用戶名的密碼。
• key_file: 可選字符串。用於向ArcGIS 服務器站點前的 Web 服務器驗證用戶身份的 PKI key 文件的路徑。
• cert_file: 可選字符串。 PKI 證書文件的路徑，用於向ArcGIS 服務器站點前麵的 Web 服務器驗證用戶。
• proxy_host: 可選字符串。如果運行 Python API 的環境需要代理主機來訪問站點 URL 或 GIS URL，則為代理主機的 Web 地址。 示例：proxy.mysite.com
• proxy_port: 可選整數。代理訪問的端口，默認為80。
• expiration: 可選整數。這是通過此登錄過程請求的令牌有效的時間長度(以分鍾為單位)。示例：1440 是一天。默認值為 60。
• all_ssl: 可選的布爾值。如果為 True，則所有調用都將通過 HTTPS 而不是 HTTP 進行。默認值為假。
• portal_connection: 可選字符串。這在聯合站點時使用。它是ArcGIS 企業門戶GIS 對象，代表管理站點的門戶。
• initialize: 可選的布爾值。如果為 True，對象將嘗試訪問 URL 資源並在創建時填充。默認值為假。

基礎：arcgis.gis.server._common._base.BaseServer

用於托管 GIS Web 服務的 ArcGIS 服務器站點。

使用獨立(非聯合)ArcGIS 服務器站點時，可以直接實例化此類。

使用聯合 ArcGIS 服務器站點時，不會直接創建此類，而是使用 ServerManager list() 或 get() 方法。

示例 1：

# Usage Example 1: Get an object for an ArcGIS Server site federated with an ArcGIS Enterprise portal

gis = GIS(profile="your_ent_admin_profile")

hosting_server = gis.admin.servers.get(role="HOSTING_SERVER")

對於獨立的 ArcGIS 服務器站點，直接創建 Server 實例。

示例 2：

# Usage Example 2: Get a stand-alone ArcGIS Server site that has Web Adaptor installed

server_base_url = "https://example.com"

gis_server = Server(url=f"{server_base_url}/web_adaptor/admin",
                    token_url=f"{server_base_url}/web_adaptor/tokens/generateToken",
                    username="admin_user",
                    password="admin_password")

Parameter	Description
url	必需的字符串。 ArcGIS 服務器站點的ArcGIS 服務器管理端點的 URL。 示例：https://gis.mysite.com/arcgis/admin URL 的格式應如下所示：<scheme>://<fully_qualified_domain_name>:<port (optional)>/<web adapter>/admin 注意：建議使用服務器的完全限定域名，也稱為 Web 上下文 URL，因為 Web 服務器的 SSL 證書綁定通常使用此主機名。
gis	可選字符串。表示與此 ArcGIS 服務器站點聯合的 ArcGIS 企業門戶的 GIS 對象。 GIS 對象應使用發布者或管理員角色中的用戶名登錄，以便管理服務器。如果此參數不存在，則必須存在其他關鍵字參數的組合。

注意：

如果gis 參數不存在，任意數量的關鍵字參數組合將初始化一個正常工作的Server 對象。請參閱下麵的示例。

示例 3：

# Usage Example 3: Get the ArcGIS Server site that is federated to an Enterprise (using ``gis``)

server_base_url = "https://example.com"
gis = GIS(profile="your_ent_admin_profile")
gis_server = Server(url=f"{server_base_url}/web_adaptor/admin",
                    gis = gis)

# Usage Example 4: Get the ArcGIS Server site that is federated to an Enterprise (using ``portal_connection``)

server_base_url = "https://example.com"
gis = GIS(profile="your_ent_admin_profile")
gis_server = Server(url=f"{server_base_url}/web_adaptor/admin",
                    portal_connection=gis._portal.con)