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)