Python ArcGIS UserManager.create用法及代碼示例

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

用法:

create(username, password, firstname, lastname, email, description=None, role=None, provider='arcgis', idp_username=None, level=2, thumbnail=None, user_type=None, credits=- 1, groups=None)

返回：

如果成功創建則為user，如果不成功則為 None。

create 操作用於在企業門戶中預先創建內置或企業帳戶，或在ArcGIS Online 組織帳戶中預先創建內置用戶。

注意：

隻有管理員才能調用此方法。

成員的 user_type 確定可以分配給成員的默認 role。下表中注明了與每個角色兼容的用戶類型(在user_type 部分中)。

要創建查看者帳戶，請選擇 role='viewer' 和 user_type='viewer'

Parameter	Description
username	必需的字符串。用戶名，在 Portal 中必須是唯一的，長度為 6-24 個字符。
password	必需的字符串。用戶的密碼。它必須至少有 8 個字符。僅當提供者是 arcgis 時，這是必需的參數；否則，密碼參數將被忽略。如果在ArcGIS Online 組織中創建帳戶，可以將其設置為無，讓用戶通過單擊通過電子郵件發送給他/她的鏈接來設置密碼。當。。。的時候provider是企業, 密碼是可選的。
firstname	必需的字符串。用戶的名字
lastname	必需的字符串。用戶的姓氏
email	必需的字符串。用戶的電子郵件地址。這一點很重要。
description	可選字符串。用戶帳戶的說明。
thumbnail	可選字符串。用戶圖像的 URL。
role	可選字符串。用戶帳戶的 role。默認值為org_user。其他可能的值包括 org_publisher 、 org_admin 、 viewer 、 viewplusedit 或從 RoleManager 類的 all() 方法獲取的自定義 role_id 值。
provider	可選字符串。帳戶的提供者。默認值為 arcgis。另一個可能的值是企業。
idp_username	可選字符串。由企業用戶存儲存儲的用戶名。僅當提供者參數為企業時才需要此參數。
level	可選整數。帳戶級別。 (ArcGIS Enterprise 版本 10.7 之前的版本。有關完整詳細信息，請參閱User types, roles, and privileges。)可以在以下三個級別分配 GIS Professional user_type，這三個級別對應於 ArcGIS Pro 的三個許可證級別： GIS Professional Basic GIS Professional Standard GIS Professional Advanced
user_type	必需的字符串。帳戶用戶類型。這可以是創建者、查看者等。類型影響用戶可以使用哪些應用程序以及他們可以在組織中執行哪些操作。 (ArcGIS Enterprise 10.7+ 和 ArcGIS Online。請參閱 User types, roles, and privileges 了解完整詳細信息。) Members assigned the viewer role cannot create or share content, or perform analysis, and the viewer role is compatible with all user types. The Data Editor role viewplusedit is compatible with all user types except viewer. The org_user, org_publisher, and org_admin roles are compatible with the Creator, GIS Professional, Storyteller, and Insights Analyst user types. A complete list of user_type values can be obtained from the license_types property on the UserManager.
credits	可選浮點數。分配給用戶的積分數。默認為無，表示無限製。 (10.7+)
groups	可選列表。一組組對象，為給定用戶提供訪問權限。 (10.7+)

例子：

# Usage Example: Assign custom role to a new user

>>> role_mgr = gis.users.roles

>>> for role in role_mgr.all():
>>>     print(f"{role.name}  {role.role_id}")

Viewer              iAAAAAAAAAAAAAAA
Data Editor         iBBBBBBBBBBBBBBB
CustomRole          bKrTCjFF9tKbaFk8

>>> user1 = gis.users.create(username='new_user_1',
                             password='<strong_password>',
                             firstname='New',
                             lastname='User',
                             email='namee@organization.com',
                             description='User with custom role assigned',
                             role='bKrTCjFF9tKbaFk8',
                             user_type='Creator')

>>> if user1: # setting the start_page of the newly created user
>>>     user1.landing_page = "organization"