arcgis.gis module

The gis module provides an information model for GIS hosted within ArcGIS Online or ArcGIS Enterprise, serving as an entry point to the GIS. This module, the most important in the ArcGIS API for Python, provides functionality to manage (create, read, update and delete) GIS users, groups and content. The module allows for access to the GIS services using Python and is an invaluable tool in the API.

GIS

class arcgis.gis.GIS(url=None, username=None, password=None, key_file=None, cert_file=None, verify_cert=True, set_active=True, client_id=None, profile=None, **kwargs)

The GIS class is representative of a single ArcGIS Online organization or an ArcGIS Enterprise deployment. The GIS object provides helper objects to manage (search, create, retrieve) GIS resources such as content, users, and groups.

Additionally, the GIS object has properties to query its state, which is accessible using the properties attribute.

Note

The GIS provides a mapping widget that can be used in the Jupyter Notebook environment for visualizing GIS content as well as the results of your analysis. To create a new map, call the map method. IE11 is no longer supported. Please use the latest version of Google Chrome, Mozilla Firefox, Apple Safari, or Microsoft Edge.

The constructor constructs a GIS object given a url and user credentials to ArcGIS Online or an ArcGIS Enterprise portal. User credentials can be passed in using username/password pair, or key_file/cert_file pair (in case of PKI). Supports built-in users, LDAP, PKI, Integrated Windows Authentication (using NTLM and Kerberos) and Anonymous access.

If no url is provided, ArcGIS Online is used. If username/password or key/cert files are not provided, the currently logged-in user’s credentials (IWA) or anonymous access is used.

Persisted profiles for the GIS can be created by giving the GIS authorization credentials and specifying a profile name. The profile stores all of the authorization credentials (except the password) in the user’s home directory in an unencrypted config file named .arcgisprofile. The profile securely stores the password in an O.S. specific password manager through the keyring python module.

Note

Linux systems may need additional software installed and configured for proper security.

Once a profile has been saved, passing the profile parameter by itself uses the authorization credentials saved in the configuration file/password manager by that profile name. Multiple profiles can be created and used in parallel.

See Working with different authentication schemes in the ArcGIS API for Python guide for examples.

Argument

Description

url

Optional string. If URL is None, then the URL will be ArcGIS Online. This should be a web address to either an ArcGIS Enterprise portal or to ArcGIS Online in the form: <scheme>://<fully_qualified_domain_name>/<web_adaptor>. An Enterprise example is formatted in the form: https://gis.example.com/portal

username

Optional string. The login user name (case-sensitive).

password

Optional string. If a username is provided, a password is expected. This is case-sensitive. If the password is not provided, the user is prompted in the interactive dialog.

key_file

Optional string. The file path to a user’s key certificate for PKI authentication

cert_file

Optional string. The file path to a user’s certificate file for PKI authentication. If a PFX or P12 certificate is used, a password is required. If a PEM file is used, the key_file is required.

verify_cert

Optional boolean. If a site has an invalid SSL certificate or is being accessed via the IP or hostname instead of the name on the certificate, set this value to False. This will ensure that all SSL certificate issues are ignored. The default is True.

Warning

Setting the value to False can be a security risk.

set_active

Optional boolean. The default is True. If True, the GIS object will be used as the default GIS object throughout the whole scripting session.

client_id

Optional string. Used for OAuth authentication. This is the client ID value.

profile

Optional string. the name of the profile that the user wishes to use to authenticate, if set, the identified profile will be used to login to the specified GIS.

In addition to explicitly named parameters, the GIS object supports optional key word arguments:

kwargs

Description

proxy_host

Optional string. The host name of the proxy server used to allow HTTP/S access in the network where the script is run.

ex: 127.0.0.1

use_gen_token

Optional Boolean. The default is False. For older Enterprises, the BUILT-IN users can specify using the generateToken end point for creating the token.

proxy_port

Optional integer. The proxy host port. The default is 80.

token

Optional string. This is the Enterprise token for built-in logins. This parameter is only honored if the username/password is None and the security for the site uses BUILT-IN security.

api_key

Optional string. This is a key generated by the developer site to allow for a limited subset of the REST API functionality.

trust_env

Optional Boolean. Trust environment settings for proxy configuration, default authentication and similar. If False the GIS class will ignore the netrc files defined on the system.

proxy

Optional Dictionary. If you need to use a proxy, you can configure individual requests with the proxy argument to any request method. See `Usage Exmaple 9: Using a Proxy` for example usage.

Usage Example

{

“http” : “http://10.343.10.22:111”, “https” : “https://127.343.13.22:6443

}

expiration

Optional Integer. The default is 60 minutes. The expiration time for a given token. This is used for user provided tokens and API Keys.

validate_url

Optional Boolean. The default is False. A user can choose to validate the URL on an Item’s url.

# Usage Example 1: Anonymous Login to ArcGIS Online

gis = GIS()
# Usage Example 2: Built-in Login to ArcGIS Online

gis = GIS(username="someuser", password="secret1234")
# Usage Example 3: Built-in Login to ArcGIS Enterprise

gis = GIS(url="http://pythonplayground.esri.com/portal",
      username="user1", password="password1")
# Usage Example 4: Built-in Login to ArcGIS Enterprise, ignoring SSL errors

gis = GIS(url="http://pythonplayground.esri.com/portal", username="user1",
          password="password1", verify_cert=False)
# Usage Example 5: Anonymous ArcGIS Online Login with Proxy

gis = GIS(proxy_host='127.0.0.1', proxy_port=8888)
# Usage Example 6: PKI Login to ArcGIS Enterprise, using PKCS12 user certificate

gis = GIS(url="https://pkienterprise.esri.com/portal",
          cert_file="C:\users\someuser\mycert.pfx", password="password1")
# Usage Exmaple 7: Login with token (actual token abbreviated for this illustration)

gis = GIS(token="3G_e-FSoJdwxBgSA0RiOZg7zJVVqlOG-ENw83UtoUzDdz4 ... _L2aQMrthrEq7vKYBn39HGSc.",
          referer="https://www.arcgis.com")
# Usage Exmaple 8: Login with API Key (actual token abbreviated for this illustration)

gis = GIS(api_key="APKSoJdwxBgSA0RiOZg7zJVVqlOG-ENw83UtoUzDdz4 ... _L2aQMrth39HGSc.",
          referer="https")
# Usage Exmaple 9: Using a Proxy
proxy = {
    'http': 'http://10.10.1.10:3128',
    'https': 'http://10.10.1.10:1080',
}
gis = GIS(proxy=proxy)
property api_keys

The api_keys property returns an instance of APIKeyManager object which allows the User to generate, manage and modify API Keys for controlled application access.

Note

The API Key manager is only available for ArcGIS Online

Returns

An APIKeyManager object

property content

The content property is the resource manager for GIS content. See ContentManager for more information.

property datastore

The datastore property is the resource manager for GIS datastores. .. note:

This is only available with ArcGIS Enterprise 10.7+.
See :class:`~arcgis.gis._impl._datastores.PortalDataStore` for more information.
Returns

A PortalDataStore object

property groups

The groups property is resource manager for GIS groups. See GroupManager for more information.

property hosting_servers

Returns the hosting servers for the GIS

Returns

list

property hub

The hub property is the resource manager for GIS hub. See Hub for more information.

property languages

Lists the available languages.

Returns

List[Dict[str, Any]]

map(location=None, zoomlevel=None, mode='2D', geocoder=None)

The map method creates a map widget centered at the declared location with the specified zoom level. If an address is provided, it is geocoded using the GIS’s configured geocoders. Provided a match is found, the geographic extent of the matched address is used as the extent of the map. If a zoomlevel is also provided, the map is centered at the matched address instead and the map is zoomed to the specified zoomlevel. See MapView for more information.

Note

The map widget is only supported within a Jupyter Notebook. IE11 is no longer supported. Please use the latest version of Google Chrome, Mozilla Firefox, Apple Safari, or Microsoft Edge.

Argument

Description

location

Optional string. The address or lat-long tuple of where the map is to be centered.

zoomlevel

Optional integer. The desired zoom level.

mode

Optional string of either ‘2D’ or ‘3D’ to specify map mode. Defaults to ‘2D’.

geocoder

Optional Geocoder. Allows users to specify a geocoder to find a given location. See the Understanding geocoders page in the ArcGIS API for Python guide for more information.

Note

If the Jupyter Notebook server is running over http, you need to configure your ArcGIS Enterprise portal or ArcGIS Online organization to allow your host and port; or else you will run into CORS issues when displaying this map widget.

This can be accomplished by signing into your ArcGIS Enterprise portal or ArcGIS Online organization in a browser, then navigating to:

Organization > Settings > Security > Allow origins > Add > http://localhost:8888 (replace with the host/port you are running on)

# Usage Example

>>> gis = GIS(url="http://pythonplayground.esri.com/portal", username="user1", password="password1")

>>> gis.map("Durham,NC")
Returns

A map widget (the widget is displayed in Jupyter Notebook when queried).

property notebook_server

The notebook_server property provides access to the NotebookServer registered with the organization or enterprise. :return: List [NotebookServer]

property org_settings

The portal settings resource is used to return a view of the portal’s configuration as seen by the current users, either anonymous or logged in. Information returned by this resource includes helper services, allowed redirect URIs, and the current configuration for any access notices or information banners.

Parameters

Description

settings

Required Dict. A dictionary of the settings

Fields

Description

anonymousAccessNotice

Dict. A JSON object representing a notice that is shown to your organization’s anonymous users. Ex: {‘title’: ‘Anonymous Access Notice Title’, ‘text’: ‘Anonymous Access Notice Text’, ‘buttons’: ‘acceptAndDecline’, ‘enabled’: True}

authenticatedAccessNotice

Dict. A JSON object representing a notice that is shown to your organization’s authenticated users. Ex: {‘title’: ‘Authenticated Access Notice Title’, ‘text’: ‘Authenticated Access Notice Text’, ‘buttons’: ‘okOnly’, ‘enabled’: True}

informationalBanner

Dict. A JSON object representing the informational banner that is shown at the top of your organization’s page. Ex: {‘text’: ‘Header Text’, ‘bgColor’: ‘grey’, ‘fontColor’: ‘blue’, ‘enabled’: True}

clearEmptyFields

Bool. If True, any empty dictionary will be set to null.

Returns

Dictionary indicating ‘success’ or ‘error’

property properties

properties manages the actual properties of the GIS object.

property regions

Lists the available regions.

Returns

List[Dict[str, Any]]

property servers

Returns the servers registered with ArcGIS Entperise. For ArcGIS Online, the return value is None.

Returns

dict

property sites

The sites property is the resource manager for Enterprise Sites. See sites for more information.

update_properties(properties_dict)

The update_properties method updates the GIS’s properties from those in properties_dict. This method can be useful for updating the utility services used by the GIS.

Argument

Description

properties_dict

Required dictionary. A dictionary of just those properties and values that are to be updated.

Returns

A boolean indicating success (True), or failure (False)

Note

For examples of the property names and key/values to use when updating utility services, refer to the Common parameters page in the ArcGIS REST API.

# Usage Example: Update the geocode service

gis = GIS(profile='xyz')
upd = {'geocodeService': [{
  "singleLineFieldName": "Single Line Input",
  "name": "AtlantaLocator",
  "url": "https://some.server.com/server/rest/services/GeoAnalytics/AtlantaLocator/GeocodeServer",
  "itemId": "abc6e1fc691542938917893c8944606d",
  "placeholder": "",
  "placefinding": "true",
  "batch": "true",
  "zoomScale": 10000}]}

gis.update_properties(upd)
property url

The url property is a read-only URL of your GIS connection.

property users

The users property is the resource manager for GIS users. See UserManager for more information.

property velocity

The resource manager for ArcGIS Velocity. See Velocity :return: Velocity

property version

The version property returns the GIS version number

Item

class arcgis.gis.Item(gis, itemid, itemdict=None)

Bases: dict

The Item class represents an item in the GIS, where an item is simply considered a unit of content in the GIS. Each item has a unique identifier and a well-known URL that is independent of the user owning the item. Additionally, each item can have associated binary or textual data that’s available via the item data resource. For example, an item of type Map Package returns the actual bits corresponding to the map package via the item data resource.

Items that have layers (eg FeatureLayerCollection items and ImageryLayer items) and tables have the dynamic layers and tables properties to get to the individual layers/tables in this item.

add_comment(comment)

The add_comment method adds a comment to an item.

Note

The add_comment method is only available only to authenticated users who have access to the item.

Argument

Description

comment

Required string. Text to be added as a comment to a specific item.

Returns

Comment ID if successful, None if failure occurs.

# Usage Example

>>> item.add_comment("Detailed Comment on the Item")
add_relationship(rel_item, rel_type)

The add_relationship method adds a relationship from the current item to rel_item.

Note

Note: Relationships are not tied to an item. Instead, they are directional links from an origin item to a destination item and have a type. The type of the relationship defines the valid origin and destination item types as well as some rules. See Relationship types in REST API help for more information. Users don’t have to own the items they relate unless so defined by the rules of the relationship type.

Users can only delete relationships they create.

Relationships are deleted automatically if one of the two items is deleted.

Argument

Description

rel_item

Required Item object corresponding to the related item.

rel_type

Required string. The type of the related item; is one of [‘Map2Service’, ‘WMA2Code’, ‘Map2FeatureCollection’, ‘MobileApp2Code’, ‘Service2Data’, ‘Service2Service’]. See Relationship Types in the REST API help for more information on this parameter.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> item.add_relationship(reL_item=item2, rel_type='Map2FeatureCollection')
<True>
property app_info

The app_info property is a resource for accessing application information. If the parent item is registered using the register app operation, app_info returns information pertaining to the registered app. Every registered app gets an App ID and App Secret, which are titled client_id and client_secret, respectively, in the terminology of OAuth.

Returns

A Dictionary

property can_delete

Checks if the Item can be removed from the system.

Returns

bool

property comments

The comments property gets a list of comments for a given item.

property content_status

The content_status property states if an Item is authoritative or deprecated. This givens owners and administrators of Item the ability to warn users that they should be either this information or not.

Argument

Description

value

Optional string or None. Defines if an Item is deprecated or authoritative. If a value of None is given, then the value will be reset.

Allowed Values: authoritative, deprecated, or None

copy(title=None, tags=None, snippet=None, description=None, layers=None)

The copy method allows for the creation of an item that is derived from the current Item.

For layers, copy will create a new item that uses the URL as a reference. For non-layer based items, these will be copied and the exact same data will be provided.

If title, tags, snippet of description is not provided the values from item will be used. The copy method can be used in a variety of situations, such as:

  1. Vector tile service sprite customization

  2. Limiting feature service exposure

  3. Sharing content by reference with groups

  4. Creating backup items.

Argument

Description

title

Optional string. The name of the new item.

tags

Optional list of string. Descriptive words that help in the searching and locating of the published information.

snippet

Optional string. A brief summary of the information being published.

description

Optional string. A long description of the Item being published.

layers

Optional list of integers. If you have a layer with multiple and you only want specific layers, an index can be provided those layers. If nothing is provided, all layers will be visible.

Returns

An Item object

**Usage Example**

>>> item.copy()
<Item title:"gisslideshow - Copy 94452b" type:Microsoft Powerpoint owner:geoguy>

>>> item.copy(title="GIS_Tutorial")
<Item title:"GIS_Tutorial" type:Microsoft Powerpoint owner:geoguy>

>>> item.copy()
<Item title:"NZTiles - Copy 021a06" type:Vector Tile Layer owner:geoguy>

copy_feature_layer_collection(service_name, layers=None, tables=None, folder=None, description=None, snippet=None, owner=None)

The copy_feature_layer_collection method allows users to copy existing Feature Layer Collections and select the layers/tables that the user wants in the service. It is quite similar to the copy method, but only copies the selected Feature Layer Collections.

Argument

Description

service_name

Required string. It is the name of the service.

layers

Optional list/string. This is a either a list of integers or a comma seperated list of integers as a string. Each index value represents a layer in the feature layer collection.

tables

Optional list/string. This is a either a list of integers or a comma seperated list of integers as a string. Each index value represents a table in the feature layer collection.

folder

Optional string. This is the name of the folder to place in. The default is None, which means the root folder.

description

Optional string. This is the Item description of the service.

snippet

Optional string. This is the Item’s snippet of the service. It is no longer than 250 characters.

owner

Optional string/User. The default is the current user, but if you want the service to be owned by another user, pass in this value.

Returns

If successful, returns an Item object. Otherwise, returns None on failure.

# Usage Example

>>> item.copy_feature_layer_collection(service_name="service_name", layers="1,4,5,8")
copy_item(*, title=None, tags=None, folder=None, include_resources=False, include_private=False)

The copy_item operation creates a new Item that is a copy of the original Item on the server side. It is quite similar to the copy method, but only creates a new Item.

The copy_item method is allowed for the following:

  1. Original item being copied is owned by the user invoking the copy operation.

  2. The User object is an administrator.

  3. The User object has itemControl update capability.

Additionally, there are several caveats to the copy_item method. First, the new item created by the copy_item operation will have a system generated itemID. Additionally, hosted services are copied as reference only. Reserved keywords, ratings, views, comments and listing properties are reset for the new item. Sharing access of the original item is not preserved and sharing access of new item is set to private. Lastly, relationships and dependencies of the original item are not maintained in the new item.

Note

This method is only available on ArcGIS Online or ArcGIS Enterprise 10.9 or higher

Argument

Description

title

Optional string. The title of the destination item. If not specified, title of the original item is used.

tags

Optional String. New set of tags (comma separated) of the destination item.

folder

Optional String. Folder Id of the destination item. If the folder Id is not specified, then the item remains in the same folder.

If the administrator invokes a copy of an item belonging to another user, and does not specify the folder Id, the item gets created in the root folder of the administrator.

include_resources

Optional boolean. If true, the file resources of the original item will be copied over to the new item. Private file resources will not be copied over. If false, the file resources of the original item will not be copied over to the new item. The default is false.

include_private

If true, and if include_resources is set to true as well, then the private resources of the original item will be copied over to the new item. If false, the private file resources of the original item will not be copied over to the new item. The default is false.

Returns

An Item object

create_thumbnail(update=True)

The create_thumbnail method creates a Thumbnail for a feature service portal item using the service’s symbology and the print service registered for the enterprise.

Argument

Description

update

Optional boolean. When set to True, the item will be updated with the thumbnail generated in this call, else it will not update the item. The default is True.

Returns

A DataFile object

create_tile_service(title, min_scale, max_scale, cache_info=None, build_cache=False)

The create_tile_service method allows publishers and administrators to publish hosted feature layers and hosted feature layer views as a tile service.

Argument

Description

title

Required string. The name of the new service.

min_scale

Required float. The smallest scale at which to view data.

max_scale

Required float. The largest scale at which to view data.

cache_info

Optional dictionary. If not none, administrator provides the tile cache info for the service. The default is the ArcGIS Online scheme.

build_cache

Optional boolean. Default is False; if True, the cache will be built at publishing time. This will increase the time it takes to publish the service.

Returns

The Item object if successfully added, None if unsuccessful.

# Usage Example

>>> item.create_tile_service(title="SeasideHeightsNJTiles", min_scale= 70000.0,max_scale=80000.0)
delete(force=False, dry_run=False)

The delete method deletes the item. If the item is unable to be deleted , a RuntimeException is raised. To know if you can safely delete the item, use the optional parameter ‘dry_run’ in order to test the operation without actually deleting the item.

Argument

Description

force

Optional boolean. Available in ArcGIS Enterprise 10.6.1 and higher. Force deletion is applicable only to items that were orphaned when a server federated to the ArcGIS Enterprise was removed accidentally before properly unfederating it. When called on other items, it has no effect.

dry_run

Optional boolean. Available in ArcGIS Enterprise 10.6.1 and higher.If True, checks if the item can be safely deleted and gives you back either a dictionary with details. If dependent items are preventing deletion, a list of such Item objects are provided.

Returns

A boolean indicating success (True), or failure (False). When dry_run is used, a dictionary containing details of the item is returned.

USAGE EXAMPLE: Successful deletion of an item

item1 = gis.content.get('itemId12345')
item1.delete()

>> True
USAGE EXAMPLE: Failed deletion of an item

item1 = gis.content.get('itemId12345')
item1.delete()

>> RuntimeError: Unable to delete item. This service item has a related Service item
>> (Error Code: 400)
USAGE EXAMPLE: Dry run to check deletion of an item

item1 = gis.content.get('itemId12345abcde')
item1.delete(dry_run=True)

>> {'can_delete': False,
>> 'details': {'code': 400,
>> 'message': 'Unable to delete item. This service item has a related Service item',
>> 'offending_items': [<Item title:"Chicago_accidents_WFS" type:WFS owner:sharing1>]}}

Note

During the dry run, if you receive a list of offending items, attempt to delete them first before deleting the current item. You can in turn call dry_run on those items to ensure they can be deleted safely.

delete_rating()

The delete_rating method removes the rating the calling user added for the specified item.

delete_relationship(rel_item, rel_type)

The delete_relationship method deletes a relationship between this item and the rel_item.

Argument

Description

rel_item

Required Item object corresponding to the related item.

rel_type

Required string. The type of the related item; is one of [‘Map2Service’, ‘WMA2Code’, ‘Map2FeatureCollection’, ‘MobileApp2Code’, ‘Service2Data’, ‘Service2Service’]. See Relationship Types in the REST API help for more information on this parameter.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

item.delete_relationship(item2, 'Map2FeatureCollection')
property dependencies

The dependencies property returns a class to manage the Item’s dependencies

dependent_to()

The dependent_to method returns items, urls, etc that are dependent to this item.

Note

This capability (item dependencies) is not yet available on ArcGIS Online - Currently, it is available

only with an ArcGIS Enterprise.

dependent_upon()

The dependent_upon method returns items, urls, etc that this item is dependent on.

Note

This capability (item dependencies) is not yet available on ArcGIS Online - Currently, it is available only with an ArcGIS Enterprise.

download(save_path=None, file_name=None)

The download method downloads the data to the specified folder or a temporary folder, if a folder is not provided.

Argument

Description

save_path

Optional string. Folder location to download the file to.

file_name

Optional string. The name of the file.

Returns

The download path if data was available, otherwise None.

# Usage Example

>>> item.download("C:\ARCGIS\Projects", "hurricane_data")
download_metadata(save_folder=None)

The download_metadata method is similar to the download method but only downloads the item metadata for the specified item id. Items with metadata have ‘Metadata’ in their typeKeywords.

Argument

Description

save_folder

Optional string. Folder location to download the item’s metadata to.

Returns

A file path, if the metadata download was successful. None if the item does not have metadata.

download_thumbnail(save_folder=None)

The download_thumbnail method is similar to the download method but only downloads the item thumbnail.

Argument

Description

save_folder

Optional string. Folder location to download the item’s thumbnail to.

return

A file path, If the download was successful. None if the item does not have a thumbnail.

export(title, export_format, parameters=None, wait=True, enforce_fld_vis=None, tags=None, snippet=None)

The export method is used to export a service item to the specified export format. However, it is available only to users with an organizational subscription and can only be invoked by the service item owner or an administrator, unless a Location Tracking Service or Location Tracking View is used. The export method is useful for long running exports that could hold up a script.

Argument

Description

title

Required string. The desired name of the exported service item.

export_format

Required string. The format to export the data to. Allowed types: Shapefile, CSV, File Geodatabase, Feature Collection, GeoJson, Scene Package, KML,

Excel, geoPackage, or Vector Tile Package.

parameters

Optional string. A JSON object describing the layers to be exported and the export parameters for each layer.and the export parameters for each layer. See Export Item in the REST API for guidance.

wait

Optional boolean. Default is True, which forces a wait for the export to complete; use False for when it is okay to proceed while the export continues to completion.

enforce_fld_vis

Optional boolean. Be default when you are the owner of an item and the export operation is called, the data provides all the columns. If the export is being perform on a view, to ensure the view’s column definition is honor, then set the value to True. When the owner of the service and the value is set to False, all data and columns will be exported.

tags

Optional String. A comma seperated value of item descriptors.

snippet

Optional String. A short descriptive piece of text.

Returns

An Item object or a dictionary. Item is returned when wait=True. A dictionary describing the status of the item is returned when wait=False. See the status method for more information.

# Usage Example

>>> item.export("hurricane_data", "CSV", wait =True, tags= "Hurricane, Natural Disasters")
get_data(try_json=True)

The get_data method retrieves the data associated with an item.

Note

This call may return different results for different item types: some item types may even return None. See Working with users, groups, and items in the ArcGIS REST API for more information.

Argument

Description

try_json

Optional string. Default is True. For JSON/text files, if try_json is True, the method tries to convert the data to a Python dictionary (use json.dumps(data) to convert the dictionary to a string), otherwise the data is returned as a string.

Returns

Dependent on the content type of the data. For non-JSON/text data, binary files are returned and the path to the downloaded file. For JSON/text files, a Python dictionary or a string. All others will be a byte array, that can be converted to string using data.decode(‘utf-8’). Zero byte files will return None.

get_thumbnail()

The get_thumbnail method retrieves the bytes that make up the thumbnail for this item.

Returns

Bytes that represent the item’s thumbnail.

Example

>>> response = item.get_thumbnail()
>>> f = open(filename, 'wb')
>>> f.write(response)

The get_thumbnail_link method is similar to the get_thumbnail method, but retrieves the link to the item’s thumbnail rather than the bytes that make up the thumbnail for this item.

Returns

The link to the item’s thumbnail.

property homepage

The homepage property gets the URL to the HTML page for the item.

property metadata

The metadata property gets and sets the item metadata for the specified item. metadata returns None if the item does not have metadata.

Note

Items with metadata have ‘Metadata’ in their typeKeywords.

move(folder)

The move method moves the current item to the name of the folder passed when move is called.

Argument

Description

folder

Required string. The name of the folder to move the item to. Use ‘/’ for the root folder. For other folders, pass in the folder name as a string, or a dictionary containing the folder ID, such as the dictionary obtained from the folders property.

Returns

A json object in the following format: { “success”: true | false, “itemId”: “<item id>”, “owner”: “<owner username>”, “folder”: “<folder id>” }

# Usage Example

>>> item.move("C:\Projects\ARCGIS\ArcGis_data")
protect(enable=True)

The protect method enables or disables delete protection on this item, essentially allowing the item to be deleted or protecting it from deletion.

Argument

Description

enable

Optional boolean. Default is True which enables delete protection, False to disable delete protection.

Returns

A json object in the following format: {“success”: true | false}

property proxies

The proxies property gets the ArcGIS Online hosted proxy services, set on a registered app, item with the Registered App type keyword. Additionally, this resource is only available to the item owner and the organization administrator.

publish(publish_parameters=None, address_fields=None, output_type=None, overwrite=False, file_type=None, build_initial_cache=False, item_id=None, geocode_service=None)

The publishes method is used to publish a hosted service based on an existing source item (this item). Publishers can then create feature, tiled map, vector tile and scene services. Feature services can be created from input files of various types, including

  1. csv files

  2. shapefiles

  3. service definition files

  4. feature collection files

  5. file geodatabase files

CSV files that contain location fields (i.e. address fields or XY fields) are spatially enabled during the process of publishing. Shapefiles and file geodatabases should be packaged as *.zip files.

Tiled map services can be created from service definition (*.sd) files, tile packages, and existing feature services.

Vector tile services can be created from vector tile package (*.vtpk) files.

Scene services can be created from scene layer package (*.spk, *.slpk) files.

Service definitions are authored in ArcGIS Pro or ArcGIS Desktop and contain both the cartographic definition for a map as well as its packaged data together with the definition of the geo-service to be created.

Note

ArcGIS does not permit overwriting if you published multiple hosted feature layers from the same data item.

Note

ArcGIS for Enterprise for Kubernetes does not support publishing service definition file generated by ArcMap.

Argument

Description

publish_parameters

Optional dictionary. containing publish instructions and customizations. Cannot be combined with overwrite. See Publish Item in the ArcGIS REST API for details.

address_fields

Optional dictionary. containing mapping of df columns to address fields,

output_type

Optional string. Only used when a feature service is published as a tile service.

overwrite

Optional boolean. If True, the hosted feature service is overwritten. Only available in ArcGIS Enterprise 10.5+ and ArcGIS Online.

file_type

Optional string. Some formats are not automatically detected, when this occurs, the file_type can be specified: serviceDefinition, shapefile, csv, excel, tilePackage, featureService, featureCollection, fileGeodatabase, geojson, scenepackage, vectortilepackage, imageCollection, mapService, and sqliteGeodatabase are valid entries. This is an optional parameter.

build_initial_cache

Optional boolean. The boolean value (default False), if true and applicable for the file_type, the value will built cache for the service.

item_id

Optional string. Available in ArcGIS Enterprise 10.8.1+. Not available in ArcGIS Online. This parameter allows the desired item id to be specified during creation which can be useful for cloning and automated content creation scenarios. The specified id must be a 32 character GUID string without any special characters.

If the item_id is already being used, an error will be raised during the publish process.

geocode_service

Optional Geocoder. When publishing a table of data, an optional Geocoder can be supplied in order to specify which service geocodes the information. If no geocoder is given, the first registered Geocoder is used.

Returns

An Item object corresponding to the published web layer.

# Publishing a Hosted Table Example

>>> csv_item = gis.content.get('<csv item id>')
>>> analyzed = gis.content.analyze(item=csv_item)
>>> publish_parameters = analyzed['publishParameters']
>>> publish_parameters['name'] = 'AVeryUniqueName' # this needs to be updated
>>> publish_parameters['locationType'] = None # this makes it a hosted table
>>> published_item = csv_item.publish(publish_parameters)
# Publishing a Tile Service Example

>>> item.publish(address_fields= { "CountryCode" : "Country"},
>>>               output_type="Tiles",
>>>               file_type="CSV",
>>>               item_id=9311d21a9a2047d19c0faaebd6f2cca6
>>>             )

Note

For publish_parameters, see Publish Item in the ArcGIS REST API for more details.

property rating

Get/Set the rating given by the current user to the item. Set adds a rating to an item to which you have access - Only one rating can be given to an item per user. If this call is made on a currently rated item, the new rating will overwrite the existing rating. A user cannot rate their own item. Available only to authenticated users.

Argument

Description

value

Required float. The rating to be applied for the item. The value must be a floating point number between 1.0 and 5.0.

reassign_to(target_owner, target_folder=None)

The reassign_to method allows the administrator to reassign a single item from one user to another.

Note

If you wish to move all of a user’s items (and groups) to another user then use the user.reassign_to() method. The item.reassign_to method (this method) only moves one item at a time.

Argument

Description

target_owner

Required string. The new desired owner of the item.

target_folder

Optional string. The folder to move the item to.

Returns

A boolean indicating success (True) with the ID of the reassigned item, or failure (False).

# Usage Example

>>> item.reassign_to("User1234")
register(app_type, redirect_uris=None, http_referers=None, privileges=None)

The register method registers an app item with the enterprise, resulting in an APPID and APPSECRET (also known as client_id and client_secret in OAuth speak, respectively) being generated for that app. Upon successful registration, a Registered App type keyword gets appended to the app item.

Note

The register method is available to the item owner.

Argument

Description

app_type

Required string. The type of app that was registered indicating whether it’s a browser app, native app, server app, or a multiple interface app. Values: browser, native, server, or multiple

redirect_uris

Optional list. The URIs where the access_token or authorization code will be delivered upon successful authorization. The redirect_uri specified during authorization must match one of the registered URIs, otherwise authorization will be rejected.

A special value of urn:ietf:wg:oauth:2.0:oob can also be specified for authorization grants. This will result in the authorization code being delivered to a portal URL (/oauth2/approval). This value is typically used by apps that don’t have a web server or a custom URI scheme where the code can be delivered.

The value is a JSON string array.

http_referers

Optional List. A list of the http referrers for which usage of the APIKey will be restricted to.

Note

Http Referrers can be configured for non apiKey type apps as well. The list configured here will be used to validate the app tokens sent in while accessing the sharing API. The referrer checks will not be applied to user tokens.

privileges

Optional List. A list of the privileges that will be available for this APIKey.

Note

Privileges can be configured for non API Key type apps as well. The list configured here will be used to grant access to items when item endpoint is accessed with app tokens. The checks will not be applied to user tokens and they can continue accessing items based on the current item sharing model. With app tokens, all items of app owner can be accessed if the privileges list is not configured.

Returns

A dictionary indicating ‘success’ or ‘error’

# Usage Example

>>> item.register(app_type = "browser",
>>>             redirect_uris = [ "https://app.example.com", "urn:ietf:wg:oauth:2.0:oob" ],
>>>             http_referers = [ "https://foo.com", "https://bar.com" ],
>>>            privileges = ["portal:apikey:basemaps", "portal:app:access:item:itemId",
>>>                         "premium:user:geocode", "premium:user:networkanalysis"]
                  )
related_items(rel_type, direction='forward')

The related_items method retrieves the items related to this item. Relationships can be added and deleted using item.add_relationship() and item.delete_relationship(), respectively.

Note

With WebMaps items, relationships are only available on local enterprises.

Argument

Description

rel_type

Required string. The type of the related item; is one of [‘Map2Service’, ‘WMA2Code’, ‘Map2FeatureCollection’, ‘MobileApp2Code’, ‘Service2Data’, ‘Service2Service’]. See Relationship Types in the REST API help for more information on this parameter.

direction

Required string. One of [‘forward’, ‘reverse’]

Returns

The list of related items.

# Usage Example

>>> item.related_items("Service2Service", "forward")
property resources

The resources property returns the Item’s Resource Manager

Returns

A ResourceManager object

share(everyone=False, org=False, groups=None, allow_members_to_edit=False)

The share method shares an item with the specified list of groups.

Argument

Description

everyone

Optional boolean. Default is False, don’t share with everyone.

org

Optional boolean. Default is False, don’t share with the organization.

groups

Optional list of group ids as strings, or a list of arcgis.gis.Group objects, or a comma-separated list of group IDs.

allow_members_to_edit

Optional boolean. Default is False, to allow item to be shared with groups that allow shared update

Returns

A dictionary with a key titled “notSharedWith”,containing array of groups with which the item could not be shared.

# Usage Example

>>> item.share(org = True, allow_members_to_edit = True)
property shared_with

The shared_with property reveals the privacy or sharing status of the current item. An item can be private or shared with one or more of the following:

  1. A specified list of groups

  2. All members in the organization

  3. Everyone (including anonymous users).

Note

If the return is False for org, everyone and contains an empty list of groups, then the item is private and visible only to the owner.

Returns

A Dictionary in the following format: { ‘groups’: [], # one or more Group objects ‘everyone’: True | False, ‘org’: True | False }

property snapshots

The snapshots property provides access to the Notebook Item’s Snapshots. If the user is not the owner of the Item, the snapshots will be an empty list.

Returns

List[SnapShot]

status(job_id=None, job_type=None)
The status method provides the status of an Item in the following situations:
  1. Publishing an Item

  2. Adding an Item in async mode

3. Adding with a multipart upload. Partial is available for Add Item Multipart when only a part is uploaded and the Item object is not committed.

Argument

Description

job_id

Optional string. The job ID returned during publish, generateFeatures, export, and createService calls.

job_type

Optional string. The type of asynchronous job for which the status has to be checked. Default is none, which checks the item’s status. This parameter is optional unless used with the operations listed below. Values: publish, generateFeatures, export, and createService

Returns

The status of a publishing Item object.

# Usage Example

>>> item.status(job_type="generateFeatures")
unregister()

The unregister property removes the application registration from an app Item, along with the Registered App type keyword.

Note

The unregister method is available to the item owner and organization administrators.

Returns

A boolean indicating success (True), or failure (False)

unshare(groups)

The unshare method stops sharing of the Item with the specified list of groups.

Argument

Description

groups

Optional list of group names as strings, or a list of Group objects, or a comma-separated list of group IDs.

Returns

A Dictionary containing the key notUnsharedFrom containing array of groups from which the item could not be unshared.

update(item_properties=None, data=None, thumbnail=None, metadata=None)

The update method updates an item in a Portal.

Note

The content can be a file (such as a layer package, geoprocessing package, map package) or a URL (to an ArcGIS Server service, WMS service, or an application).

To upload a package or other type of file, a path or URL to the file must be provided in the data argument.

For item_properties, pass in arguments for only the properties you want to be updated. All other properties will be untouched. For example, if you want to update only the item’s description, then only provide the description argument in item_properties.

Argument

Description

item_properties

Required dictionary. See table below for the keys and values.

data

Optional string, io.StringIO, or io.BytesIO. Either a path or URL to the data or an instance of StringIO or BytesIO objects.

thumbnail

Optional string. Either a path or URL to a thumbnail image.

metadata

Optional string. Either a path or URL to the metadata.

Key:Value Dictionary Options for Argument item_properties

Key

Value

type

Optional string. Indicates type of item, see the link below for valid values.

typeKeywords

Optional string. Provide a lists all sub-types, see the link below for valid values.

description

Optional string. Description of the item.

title

Optional string. Name label of the item.

url

Optional string. URL to item that are based on URLs.

tags

Optional string. Tags listed as comma-separated values, or a list of strings. Used for searches on items.

text

Optional string. For text based items such as Feature Collections & WebMaps

snippet

Optional string. Provide a short summary (limit to max 250 characters) of the what the item is.

extent

Optional string. Provide comma-separated values for min x, min y, max x, max y.

spatialReference

Optional string. Coordinate system that the item is in.

accessInformation

Optional string. Information on the source of the content.

licenseInfo

Optional string. Any license information or restrictions regarding the content.

culture

Optional string. Locale, country and language information.

access

Optional string. Valid values are private, shared, org, or public.

commentsEnabled

Optional boolean. Default is true, controls whether comments are allowed (true) or not allowed (false).

Note

See Items and Item Types in the ArcGIS REST API documentation for more details.

return

A boolean indicating success (True) or failure (False).

# Usage Example

item.update(description ="aggregated US hurricane data", title = "US Hurricane Data",
                tags = "Hurricanes, USA, Natural Disasters")
usage(date_range='7D', as_df=True)

Note

The usage method is available for ArcGIS Online Only.

For item owners and administrators, the usage method provides usage details about an item that help you gauge its popularity. Usage details show how many times the item has been used for the time period you select. Historical usage information is available for the past year. Depending on the item type, usage details can include the number of views, requests, or downloads, and the average number of views, requests, or downloads per day.

Views refers to the number of times the item has been viewed or opened. For maps, scenes, non-hosted layers, and web apps, the view count is increased by one when you open the item page or open the item in Map Viewer. For example, if you opened the item page for a map image layer and clicked Open in Map Viewer, the count would increase by two. For other items such as mobile apps, KML, and so on, the view count is increased by one when you open the item; the count does not increase when you open the item details page.

For hosted web layers (feature, tile, and scene), the number of requests is provided instead of views. Requests refers to the number of times a request is made for the data within the layer. For example, someone might open an app that contains a hosted feature layer. Opening the app counts as one view for the application, but multiple requests may be necessary to draw all the features in the hosted layer and are counted as such.

For downloadable file item types such as CSV, SHP, and so on, the number of downloads is displayed. For registered apps, the Usage tab also displays the number of times users have logged in to the app. Apps that allow access to subscriber content through the organization subscription show usage by credits. Additionally, the time frame for the credit usage reporting period can be changed.

Argument

Description

date_range

Optional string. The default is 7d. This is the period to query usage for a given item.

24H

Past 24 hours

7D

Past 7 days (default)

14D

Past 14 days

30D

Past 30 days

60D

Past 60 days

6M

Past 6 months

1Y

Past 12 months

as_df

Optional boolean. Returns a Pandas DataFrame when True, returns data as a dictionary when False

Returns

Pandas DataFrame or Dictionary

User

class arcgis.gis.User(gis, username, userdict=None)

Bases: dict

The User class represents a registered user of the GIS system, either ArcGIS Online or ArcGIS Enterprise. The User class has a myriad of properties that are specific to a particular user - these properties are enumerated in the table below.

Property

Details

username

The username of the user.

fullName

The user’s full name

availableCredits

The number of credits available to the user.

assignedCredits

The number of credits allocated to the user.

firstName

The user’s first name.

lastName

The user’s last name.

preferredView

The user’s preferred view for content, either web or GIS.

description

A description of the user.

email

The user’s e-mail address.

idpUsername

The original username if using enterprise logins.

favGroupId

The user’s favorites group and is created automatically for each user.

lastLogin

The last login date of the user in milliseconds since the Unix epoch.

mfaEnabled

Indicates if the user’s account has multifactor authentication set up.

access

Indicates the level of access of the user: private, org, or public. If private, the user descriptive information will not be available to others nor will the username be searchable.

storageUsage

The amount of storage used for the entire organization.

NOTE: This value is an estimate for the organization, not the specific user. For storage estimate of a user’s items, see code example in the items method.

storageQuota

Applicable to public users as it sets the total amount of storage available for a subscription. The maximum quota is 2GB.

orgId

The ID of the organization the user belongs to.

role

Defines the user’s role in the organization.
Values:
  • org_admin - administrator or custom role with administrative privileges

  • org_publisher - publisher or custom role with publisher privileges

  • org_user - user or custom role with user privileges)

privileges

A JSON array of strings with predefined permissions in each. For a complete listing, see Privileges.

roleId

(Optional) The ID of the user’s role if it is a custom one.

level

The level of the user.

disabled

The login access to the organization for the user.

units

User-defined units for measurement.

tags

User-defined tags that describe the user.

culture

The user locale information (language and country).

cultureFormat

The user preferred number and date format defined in CLDR (only applicable for English, Spanish, French, German, and italian: i.e. when culture is en, es, fr, de, or it).

Note

See Languages for supported formats. It will inherit from organization cultureFormat if undefined.

region

The user preferred region, used to set the featured maps on the home page, content in the gallery, and the default extent of new maps in the Viewer.

thumbnail

The file name of the thumbnail used for the user.

created

The date the user was created. Shown in milliseconds since the Unix epoch.

modified

The date the user was last modified. Shown in milliseconds since the Unix epoch.

groups

A JSON array of groups the user belongs to. See Group for properties of a group.

provider

The identity provider for the organization.<br>Values: arcgis (for built-in users) ,enterprise (for external users managed by an enterprise identity store), facebook (for public accounts in ArcGIS Online), google (for public accounts in ArcGIS Online)

id

(optional) The unique identifier of the user used in ArcGIS Online or ArcGIS Enterprise 10.7+

property bundles

The bundles method provides the current user’s assigned application bundles.

Note

The bundles method is available in ArcGIS Online and Portal 10.7+.

Returns

A List of Bundle objects

delete(reassign_to=None)

The delete method deletes this user from the portal, optionally deleting or reassigning groups and items.

Note

You can not delete a user in Portal if that user owns groups or items and/or is assigned an application bundle. If you specify a user in the reassign_to argument, then items and groups will be transferred to that user. If that argument is not set, the method will fail provided the user has items or groups that need to be reassigned. Additionally, see the reassign_to method for more information on reassignment.

Argument

Description

reassign_to

Optional string. The new owner of the items and groups that belong to the user being deleted.

# Usage Example

user.delete(reassign_to="User1234")
Returns

A boolean indicating success (True) or failure (False).

delete_thumbnail()

The delete_thumbnail removes the thumbnail from the user’s profile.

Returns

A boolean indicating success (True) or failure (False).

disable()

The disable method disables login access for the user.

Note

The disable method is only available to the administrator of the organization.

Returns

A boolean indicating success (True) or failure (False).

download_thumbnail(save_folder=None)

The download_thumbnail method downloads the item thumbnail for this user and saves it in the folder that is passed when download_thumbnail is called.

Argument

Description

save_folder

Optional string. The desired folder name to download the thumbnail to.

Returns

The file path of the downloaded thumbnail.

enable()

The enable method enables login access for the user.

Note

enable is only available to the administrator of the organization.

property esri_access

The esri_access property will return a string describing the current user’s Esri access. When setting, supply a boolean to enable or disable esri_access for that User object.

Note

Administrator privileges are required to enable or disable Esri access

A member whose account has Esri access enabled can use My Esri and Community and Forums (GeoNet), access e-Learning on the Training website, and manage email communications from Esri. The member cannot enable or disable their own access to these Esri resources.

Warning

Trial accounts cannot modify esri_access property.

Please see the Enable Esri access section in the Manage members page in ArcGIS Online Resources for more information.

Argument

Description

value

Required boolean. The current user will be allowed to use the username for other Esri/ArcGIS logins when the value is set to True. If false, the account can only be used to access a given individual’s organization.

expire_password(temporary_password=None)

Expires the current user’s Password.

Argument

Description

temporary_password

Optional String. Allows the administrator to set a new temporary password for a given user. This is available on ArcGIS Enterprise Only.

Returns

Boolean

property folders

The folders property, when called, retrieves the list of the user’s folders.

Returns

List of folders represented as dictionaries. Dictionary keys include: username, folder id (id), title, and date created (created)

# Example to get name of all folders

user = User(gis, username)
folders = user.folders
for folder in folders:
    print(folder["title"])

# Example to get id of all folders

user = User(gis, username)
folders = user.folders
for folder in folders:
    print(folder["id"])

generate_direct_access_url(store_type)

The generate_direct_access_url method creates a direct access URL that is ideal for uploading large files to datafile share, notebook workspaces or raster stores.

Note

The generate_direct_access_url is available in ArcGIS Online Only

Argument

Description

store_type

Optional String. The type of upload URL to generate. Types: big_data_file, ‘notebook’, or ‘raster`.

Returns

A string representing a direct access URL

# Usage Example

>>> user.generate_direct_access_url(store_type="notebook")
get_thumbnail()

The get_thumbnail method returns the bytes that make up the thumbnail for this user.

Returns

Bytes that represent the image.

Usage Example:

response = user.get_thumbnail()
f = open(filename, 'wb')
f.write(response)

The get_thumbnail_link method retrieves the URL to the thumbnail image.

Returns

The thumbnail’s URL.

property groups

The groups property retrieves a List of Group objects the current user belongs to.

property homepage

The homepage property retrieves the URL to the HTML page for the user.

property invitations

Provides a list of invitations for a given user

Returns

UserInvitationManager

items(folder=None, max_items=100)

The item method provides a list of Item objects in the specified folder. For content in the root folder, use the default value of None for the folder argument. For other folders, pass in the folder name as a string, or as a dictionary containing the folder ID, such as the dictionary obtained from the folders property.

Argument

Description

folder

Optional string. The specifc folder (as a string or dictionary) to get a list of items in.

max_items

Optional integer. The maximum number of items to be returned. The default is 100.

Returns

The list of Item objects in the specified folder.

# Example to **estimate** storage for a user's items

storage = 0
for item in user.items():
    storage += item.size
try:
    for f in user.folders:
        for f_item in user.folders(folder=f):
            storage += f_item.size
    print(f"{user.username} using {storage} bytes")
except Exception as e:
    print(f"{user.username} using {storage} bytes")
# Example get items in each folder that is not root

user = User(gis, username)
folders = user.folders
for folder in folders:
    items = user.items(folder=folder["title"])
    for item in items:
        print(item, folder)
property landing_page

Gets or sets the User’s login page,

Argument

Description

value

Required string. The values are home, gallery, map, scene, groups, content, or organization

Returns

str

# Usage example: Setting login page

>>> user1 = gis.users.get("org_data_viewer") # approach 1: set via landing_page

>>> user1.landing_page = "map"

>>> us = user.user_settings # approach 2: set via user_settings

>>> us['landingPage']['url'] = "webmap/viewer.html"

>>> user1.user_settings = us

The link_account method allows a user to link several accounts to gether and share information between them. For example, if you use multiple accounts for ArcGIS Online and Esri websites, you can link them so you can switch between accounts and share your Esri customer information with My Esri, e-Learning, and GeoNet. You can link your organizational, public, enterprise, and social login accounts. Your content and privileges are unique to each account. From Esri websites, only Esri access-enabled accounts appear in your list of linked accounts. See the unlink_account method for more information on how to unlink linked accounts that have been produced using the link_account method.

See the Sign in page in ArcGIS Online Resources for addtional information.

Argument

Description

username

required string/User. This is the username or User object that a user wants to link to.

user_gis

required GIS. This is the GIS object for the username. In order to link an account, a user must be able to login to that account. The GIS object is the entry into that account.

# Usage Example

>>> gis = GIS("https://www.arcgis.com", "username1", "password123")
>>> user = gis.users.get('username')
>>> user.link_account("User1234", gis)

returns: A boolean indicating success (True) or failure (False).

property linked_accounts

The linked_accounts method retrieves all linked accounts for the current user as User objects

Returns

A list of User objects

property notifications

The notifications property retrieves the list of notifications available for the given user.

Returns

A list containing available notifications

property provisions

The provisions property returns a list of all provisioned licenses for the current user.

Note

The provisions method is only available in ArcGIS Enterprise 10.7+.

Returns

A list contaning provisional licenses

reassign_to(target_username)

The reassign_to method reassigns all of this user’s items and groups to another user.

Items are transferred to the target user into a folder named <user>_<folder> where user corresponds to the user whose items were moved and folder corresponds to the folder that was moved.

Note

This method must be executed as an administrator. This method also can not be undone. The changes are immediately made and permanent.

Argument

Description

target_username

Required string. The user who will be the new owner of the items and groups from which these are being reassigned from.

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> user.reassign_to(target_username="User1234")
report(report_type, start_time, *, duration='weekly')

The reports operation is to generate the reports of the overall usage of the organizations. Reports define organization usage metrics in one place for the day, week, or month. Administrators can monitor who is using which services, consuming how much credits and storage within certain time period. Reports also include current state of the organization such as number of items, groups, users, level 1s vs level 2s, App license assignments and public items.

Argument

Description

report_type

Required String. The type of organizational report to generated. The allowed report types are: credits, content, users, and activity.

start_time

Required Datetime. The day on which the report is generated. Each report must start on a Sunday or Monday for the start date for weekly and monthly reports. All datetimes must be in GMT timezone. Passing in None for the start_time will use the closest Sunday to the date for weekly and monthly reports. For daily reports, the current day/time will be used in GMT.

duration

Optional String. The time frame on which the reports are ran. The allowed values are: monthly, weekly, daily. For activity and credits a start_time is required.

# Usage Example

import datetime as _dt
seven_days_ago = _dt.datetime.now(_dt.timezone.utc) - _dt.timedelta(days=7)
item = user.report("content",
                   seven_days_ago,
                   duration="weekly")
Returns

Item

reset(password=None, new_password=None, new_security_question=None, new_security_answer=None, reset_by_email=False)

The reset method resets a user’s password, security question, and/or security answer. If a new security question is specified, a new security answer should be provided.

Note

This function does not apply to those using enterprise accounts that come from an enterprise such as ActiveDirectory, LDAP, or SAML. It only has an effect on built-in users.

Note

To reset the password by email, set reset_by_email to True and password to None.

Argument

Description

password

Required string. The current password.

new_password

Optional string. The new password if resetting password.

new_security_question

Optional string. The new security question if desired.

new_security_answer

Optional string. The new security question answer if desired.

reset_by_email

Optional Boolean. If True, the user will be reset by email. The default is False.

NOTE: Not available with ArcGIS on Kubernetes.

Warning

This function does not apply to those using enterprise accounts that come from an enterprise such as ActiveDirectory, LDAP, or SAML. It only has an effect on built-in users.

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> user.reset("password123",new_password="passWORD1234",reset_by_email=True)
property tasks

The tasks property retrieves the users tasks, effectively serving as sesource manager for user’s tasks. See TaskManager for more information on task managers.

The unlink_account method allows for the removal of linked accounts when a user wishes to no longer have a linked account. See the link_account method for more information on how accounts are linked together.

See the Sign in page in ArcGIS Online Resources for addtional information.

Argument

Description

username

required string/User. This is the username or User object that a user wants to unlink.

# Usage Example

>>> user.unlink_account("User1234")

returns: A boolean indicating success (True) or failure (False).

update(access=None, preferred_view=None, description=None, tags=None, thumbnail=None, fullname=None, email=None, culture=None, region=None, first_name=None, last_name=None, security_question=None, security_answer=None, culture_format=None)

The update method updates this user’s properties based on the arguments passed when calling update.

Note

Only pass in arguments for properties you want to update. All other properties will be left as they are. If you want to update the description, then only provide the description argument.

When updating the security question, you must provide a security_answer as well.

Argument

Description

access

Optional string. The access level for the user, values allowed are private, org, public.

preferred_view

Optional string. The preferred view for the user, values allowed are Web, GIS, null.

description

Optional string. A description of the user.

tags

Optional string. Tags listed as comma-separated values, or a list of strings.

thumbnail

Optional string. The path or url to a file of type PNG, GIF, or JPEG. Maximum allowed size is 1 MB.

fullname

Optional string. The full name of this user, only for built-in users.

email

Optional string. The e-mail address of this user, only for built-in users.

culture

Optional string. The two-letter language code, fr for example.

region

Optional string. The two-letter country code, FR for example.

first_name

Optional string. User’s first name.

last_name

Optional string. User’s first name.

security_question

Optional integer. The is a number from 1-14. The questions are as follows:

  1. What city were you born in?

  2. What was your high school mascot?

  3. What is your mother’s maden name?

  4. What was the make of your first car?

  5. What high school did you got to?

  6. What is the last name of your best friend?

  7. What is the middle name of your youngest sibling?

  8. What is the name of the street on which your grew up?

  9. What is the name of your favorite fictional character?

  10. What is the name of your favorite pet?

  11. What is the name of your favorite restaurant?

  12. What is the title of your facorite book?

  13. What is your dream job?

  14. Where did you go on your first date?

Usage Example:

security_question=13

security_answer

Optional string. This is the answer to security question. If you are changing a user’s question, an answer must be provided.

Usage example:

security_answer=”Working on the Python API”

culture_format

Optional String. Specifies user-preferred number and date format

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> user.update(description="Aggregated US Hurricane Data", tags = "Hurricanes,USA, 2020")
update_level(level)

The update_level allows administrators of an organization to update the level of a user. Administrators can leverage two levels of membership when assigning roles and privileges to members. Membership levels allow organizations to control access to some ArcGIS capabilities for some members while granting more complete access to other members.

Note

Level 1 membership is designed for members who need privileges to view and interact with existing content, while Level 2 membership is for those who contribute, create, and share content and groups, in addition to other tasks.

Maximum user quota of an organization at the given level is checked before allowing the update.

Built-in roles including organization administrator, publisher, and user are assigned as Level 2, members with custom roles can be assigned as Level 1, 1PlusEdit, or Level 2.

Level 1 membership allows for limited capabilities given through a maximum of 8 privileges: portal:user:joinGroup, portal:user:viewOrgGroups, portal:user:viewOrgItems, portal:user:viewOrgUsers, premium:user:geocode, premium:user:networkanalysis, premium:user:demographics, and premium:user:elevation. If updating the role of a Level 1 user with a custom role that has more privileges than the eight, additional privileges will be disabled for the user to ensure restriction.

Note

Level 1 users are not allowed to own any content or group which can be reassigned to other users through the Reassign Item and Reassign Group operations before downgrading them. The operation will also fail if the user being updated has got licenses assigned to premium apps that are not allowed at the targeting level.

Argument

Description

level

Required int. The values of 1 or 2. This is the user level for the given user.

  • 1 - View only

  • 2 - Content creator

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> user.update_level(2)
update_license_type(user_type)

The update_license_type method is primarily used to update the user’s licensing type. This allows administrators to change a user from a creator to a viewer or any other custom user license type.

Note

The update_license_type method is available in ArcGIS Online and Portal 10.7+.

Argument

Description

user_type

Required string. The user license type to assign a user.

Built-in Types: creator or viewer

Returns

A boolean indicating success (True) or failure (False).

update_role(role)

The update_role method updates this user’s role to org_user, org_publisher, org_admin, viewer, view_only, viewplusedit, or a custom role.

Note

There are four types of roles in Portal - user, publisher, administrator and custom roles. A user can share items, create maps, create groups, etc. A publisher can do everything a user can do and additionally create hosted services. An administrator can do everything that is possible in Portal. A custom roles privileges can be customized.

Argument

Description

role

Required string. Value must be either org_user, org_publisher, org_admin, viewer, view_only, viewplusedit or a custom role object (from gis.users.roles).

Returns

A boolean indicating success (True) or failure (False).

property user_settings

Get/set the current user’s settings that are defined in the user profile.

Argument

Description

value

Required dict. The landingPage and appLauncher settings.

Returns

dict

# Usage example: Getting the current user settings

>>> us = user.user_settings # similar to setting the landing_page property

>>> us['landingPage']['url'] = "webmap/viewer.html"

>>> user1.user_settings = us
user_types()

The user_types method is used to retrieve the user type and any assigned applications of the user.

Note

The user_types method is available in Portal 10.7+.

Group

class arcgis.gis.Group(gis, groupid, groupdict=None)

Bases: dict

The Group class is an object that represents a group within the GIS, either ArcGIS Online or ArcGIS Enterprise.

add_users(usernames=None, admins=None)

The adds_users method adds users to this group.

Note

The add_users method will only work if the user for the Portal object is either an administrator for the entire Portal or the owner of the group.

Argument

Description

usernames

Optional list of strings or single string. The list of usernames or single username to be added.

admins

Optional List of String, or Single String. This is a list of users to be an administrator of the group.

Returns

A dictionary containing the users that were not added to the group.

# Usage Example

>>> group.add_users(usernames=["User1234","User5678"], admin="Admin9012")
application(user)

The application method retrieves one group application for the given group.

Argument

Description

user

Required String. The username of the user applying to join the group.

Note

The application method is available to administrators of the group or administrators of an organization if the group is part of one.

property applications

The applications property retrieves the group applications for the given group as a list.

Note

The applications method is available to administrators of the group or administrators of an organization if the group is part of one.

property categories

The categories property serves as the category manager for groups. See CategorySchemaManager for more information on category managers.

content(max_items=1000)

The content method retrieves the list of items shared with this group.

Argument

Description

max_items

Required integer. The maximum number of items to be returned, defaults to 1000.

Returns

The list of items that are shared.

delete()

The delete method deletes this group permanently.

Returns

A boolean indicating success (True) or failure (False).

delete_group_thumbnail()

The delete_group_thumbnail method deletes the group’s thumbnail.

Returns

A boolean indicating success (True) or failure (False).

download_thumbnail(save_folder=None)

The download_thumbnail method downloads the item thumbnail for this user and saves it in the folder that is passed when download_thumbnail is called.

Argument

Description

save_folder

Optional string. The file path to where the group thumbnail will be downloaded.

Returns

The file path to which the group thumbnail is downloaded.

get_members()

The get_members method retrieves the members of this group.

Key

Value

owner

The group’s owner (string).

admins

The group’s admins (list of strings). Typically this is the same as the owner.

users

The members of the group (list of strings).

Returns

A dictionary with keys: owner, admins, and users.

# Usage Example: To print users in a group

response = group.get_members()
for user in response['users'] :
    print(user)
get_thumbnail()

The get_thumbnail method retrieves the bytes that make up the thumbnail for this group.

Returns

Bytes that represent the image.

Example

response = group.get_thumbnail()
f = open(filename, 'wb')
f.write(response)

The get_thumbnail_link method retrieves the URL to the thumbnail image.

Returns

A URL linked to the thumbnail image.

property homepage

The homepage method retrieves the URL to the HTML page for the group.

Returns

A URL linking to the group HTML page.

invite_by_email(email, message, role='member', expiration='1 Day')

Deprecated since version v1.5.1: Use Group.invite instead.

Warning

Deprecated: The invite_by_email function is no longer supported.

The invite_by_email method invites a user by email to the existing group.

Argument

Description

email

Required string. The user to send join email to.

message

Required string. The message to send to the user.

role

Optional string. Either member (the default) or admin.

expiration

Optional string. The is the time out of the invite. The values are: 1 Day (default), 3 Days, 1 Week, or 2 Weeks.

Returns

A boolean indicating success (True) or failure (False)

invite_users(usernames, role='group_member', expiration=10080)

The invite_users method invites existing users to this group.

Note

The user executing the invite_users command must be the owner of the group.

Argument

Description

usernames

Required list of strings. The users to invite.

role

Optional string. Either group_member (the default) or group_admin.

expiration

Optional integer. Specifies how long the invitation is valid for in minutes. Default is 10,080 minutes (7 days).

Note

A user who is invited to this group will see a list of invitations in the “Groups” tab of Portal listing invitations. The user can either accept or reject the invitation.

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> group.invite_users(usernames=["User1234","User5678"], role="group_admin")
join()

Users apply to join a group using the join operation. This creates a new group application, which the group administrators accept or decline. This operation also creates a notification for the user indicating that they have applied to join this group.

Note

Available only to authenticated users. Users can only apply to join groups to which they have access - if the group is private, users will not be able to find it to ask to join it.

Information pertaining to the applying user, such as their full name and username, can be sent as part of the group application.

Returns

A boolean indicating success (True) or failure (False).

leave()

The leave method removes the logged in user from this group.

Note

The user must be logged in to use the leave command.

Returns

A boolean indicating success (True) or failure (False).

property migration

The migration method allows users and groups to migrate content of a Group to a new Organaization or Portal.

notify(users, subject, message, method='email', client_id=None)

The notify method creates a group notification that sends a message to all users within the group.

Argument

Description

users

Required List. A list of users or user names.

subject

Required String. The subject of the notification.

message

Required String. The message body that will be sent to the group’s users.

method

Optional String. This is the form for which users will be contacted. The allowed values are: email, push, and builtin.

  • email - sent a message via smtp.

  • push - pushes a message out.

  • builtin - creates a user notification.

client_id

Optional String. The client id of the application for the push operation.

Returns

A boolean indicating success (True), or failure (False).

# Usage Example

>>> group.notify(users="User1234", subject= "Test Message", message="Testing the notification system",
>>>              method="email"
property protected

Indicates if the group is protected from deletion.

Argument

Description

value

Required bool. Values: True (protect group) | False (unprotect)

Returns

True if group currently protected, False if unprotected

reassign_to(target_owner)

The reassign_to method reassigns this group from its current owner to another owner.

Argument

Description

target_owner

Required string or User. The username of the new group owner.

Returns

A boolean indicating success (True) or failure (False).

remove_users(usernames)

The remove_users method is used to remove users from this group.

Argument

Description

usernames

Required list of strings. A comma-separated list of users to be removed.

Returns

A dictionary with a key notRemoved that is a list of users not removed.

search(query, return_count=False, max_items=100, bbox=None, categories=None, category_filter=None, start=1, sort_field='title', sort_order='ASC', as_dict=False)

The search operation allows users to find content within the specific group.

Argument

Description

query

Required String. The search query. When the search filters contain two or more clauses, the recommended schema is to have clauses separated by blank, or AND, e.g.

Usage Example

group.search(query=’owner:USERNAME type:map’) # or group.search(query=’type:map AND owner:USERNAME’)

When the clauses are separated by comma, the filtering condition for owner should not be placed at the first position, e.g. group.search(query=’type:map, owner:USERNAME’) is allowed, while group.search(query=’owner:USERNAME, type:map’) is not. For more, please check https://developers.arcgis.com/rest/users-groups-and-items/search-reference.htm

bbox

Optional String/List. This is the xmin,ymin,xmax,ymax bounding box to limit the search in. Items like documents do not have bounding boxes and will not be included in the search.

categories

Optional String. A comma separated list of up to 8 org content categories to search items. Exact full path of each category is required, OR relationship between the categories specified.

Each request allows a maximum of 8 categories parameters with AND relationship between the different categories parameters called.

category_filters

Optional String. A comma separated list of up to 3 category terms to search items that have matching categories. Up to 2 category_filters parameter are allowed per request. It can not be used together with categories to search in a request.

start

Optional Int. The starting position to search from. This is only required if paging is needed.

sort_field

Optional String. Responses from the search operation can be sorted on various fields. avgrating is the default.

sort_order

Optional String. The sequence into which a collection of records are arranged after they have been sorted. The allowed values are: asc for ascending and desc for descending.

as_dict

Required Boolean. If True, the response comes back as a dictionary.

Returns

List of Item objects

# Usage Example

>>> group.search("Hurricane Data", category_filters =["Natural_Disasters", "Hurricanes", "USA"])
update(title=None, tags=None, description=None, snippet=None, access=None, is_invitation_only=None, sort_field=None, sort_order=None, is_view_only=None, thumbnail=None, max_file_size=None, users_update_items=False, clear_empty_fields=False, display_settings=None, is_open_data=False, leaving_disallowed=False)

The update method updates the group’s properties with the values supplied for particular arguments.

Note

If a value is not supplied for a particular argument, the corresponding property will not be updated.

Argument

Description

title

Optional string. The new name of the group.

tags

Optional string. A comma-delimited list of new tags, or a list of tags as strings.

description

Optional string. The new description for the group.

snippet

Optional string. A new short snippet (<250 characters) that summarizes the group.

access

Optional string. Choices are private, public, or org.

is_invitation_only

Optional boolean. Defines whether users can join by request. True means an invitation is required.

sort_field

Optional string. Specifies how shared items with the group are sorted.

sort_order

Optional string. Choices are asc or desc for ascending or descending, respectively.

is_view_only

Optional boolean. Defines whether the group is searchable. True means the group is searchable.

thumbnail

Optional string. URL or file location to a new group image.

max_file_size

Optional integer. This is the maximum file size allowed be uploaded/shared to a group. Default value is: 1024000

users_update_items

Optional boolean. Members can update all items in this group. Updates to an item can include changes to the item’s description, tags, metadata, as well as content. This option can’t be disabled once the group has been created. Default is False.

clear_empty_fields

Optional Boolean. If True, the user can set values to empty string, else, None values will be ignored.

display_settings

Optional String. Defines the default display for the group page to show a certain type of items. The allowed values are: apps, all, files, maps, layers, scenes, tools. The default value is all.

is_open_data

Optional Boolean. Defines whether the group can be used in the Open Data capabilities of ArcGIS Hub. The default is False.

leaving_disallowed

Optional boolean. Defines whether users are restricted from choosing to leave the group. If True, only an administrator can remove them from the group. The default is False.

Returns

A boolean indicating success (True) or failure (False).

# Usage Example

>>> user.update(description="Aggregated US Hurricane Data", tags = "Hurricanes,USA, 2020")
update_users_roles(managers=None, users=None)

The update_users_roles upgrades a set of users to become either Group Members or Group Managers.

Argument

Description

managers

Required List. A comma-separated array of User objects to upgrade to a group manager role.

users

Required List. A comma-separated array of User objects to make group member roles.

Returns

List[dictionary]

user_list()

The user_list method returns a dictionary listing users and owners for the group.

Note

The user_list method is only available on ArcGIS Online and ArcGIS Enterprise 10.9+.

Returns

A dictionary of users and owners for the group

Datastore

class arcgis.gis.Datastore(datastore, path)

Bases: dict

The Datastore class represents a datastore (folder, database or bigdata fileshare) within the GIS’s data store. See the Datastore for more information on datastores.

property datasets

The datasets property retrieves the datasets in the data store, returning them as a dictionary (currently implemented for big data file shares).

Returns

A dictionary

delete()

The delete method unregisters this data item from the datastore.

# Usage Example

>>> datastore.delete()
Returns

A boolean indicating success (True) or failure (False).

property manifest

The manifest property retrieves or sets the manifest resource for bigdata fileshares, as a dictionary.

property ref_count

The ref_count property gets the total number of references to this data item that exists on the server. This property can be used to determine if this data item can be safely deleted or taken down for maintenance.

regenerate()

The regenerate method is used to regenerate the manifest for a big data file share. You can regenerate a manifest if you have added new data or if you have uploaded a hints file using the edit resource.

Returns

A boolean indicating success (True), or failure (False)

update(item)

The update method edits this data item to update its connection information.

Argument

Description

item

Required dictionary. The representation of the updated item.

Returns

A boolean indicating success (True) or failure (False).

validate()

The validate method is used to validate that this data item’s path (for file shares) or connection string (for databases) is accessible to every server node in the site.

Returns

A boolean indicating success (True) or failure (False).

Role

class arcgis.gis.Role(gis, role_id, role)

Bases: object

The Role class is used to represent a role in a GIS, either ArcGIS Online or ArcGIS Enterprise.

delete()

The delete method is called to deletes the current role.

# Usage Example

>>> role.delete()
Returns

A boolean indicating success (True) or failure (False).

property description

The description method retrieves and sets the description of the custom role.

property name

The name method retrieves and sets the name of the custom role.

property privileges

The privileges method retrieves and sets the privileges for the custom role as a list of strings.

Supported Administrator Privileges with predefined permissions for:

Members

  1. portal:admin:viewUsers: grants the ability to view full member account information within organization.

  2. portal:admin:updateUsers: grants the ability to update member account information within organization.

  3. portal:admin:deleteUsers: grants the ability to delete member accounts within organization.

  4. portal:admin:inviteUsers: grants the ability to invite members to organization. (This privilege is only applicable to ArcGIS Online.)

  5. portal:admin:disableUsers: grants the ability to enable and disable member accounts within organization.

  6. portal:admin:changeUserRoles: grants the ability to change the role a member is assigned within organization; however, it does not grant the ability to promote a member to, or demote a member from, the Administrator role. That privilege is reserved for the Administrator role alone.

  7. portal:admin:manageLicenses: grants the ability to assign licenses to members of organization.

  8. portal:admin:reassignUsers: grants the ability to assign all groups and content of a member to another within organization.

Groups

  1. portal:admin:viewGroups: grants the ability to view all groups within organization.

  2. portal:admin:updateGroups: grants the ability to update groups within organization.

  3. portal:admin:deleteGroups: grants the ability to delete groups within organization.

  4. portal:admin:reassignGroups: grants the ability to reassign groups to other members within organization.

  5. portal:admin:assignToGroups: grants the ability to assign members to, and remove members from, groups within organization.

  6. portal:admin:manageEnterpriseGroups: grants the ability to link group membership to an enterprise group. (This privilege is only applicable to ArcGIS Enterprise.)

Content

  1. portal:admin:viewItems: grants the ability to view all content within organization.

  2. portal:admin:updateItems: grants the ability to update content within organization.

  3. portal:admin:deleteItems: grants the ability to delete content within organization.

  4. portal:admin:reassignItems: grants the ability to reassign content to other members within organization.

  5. portal:admin:shareToGroup: grants the ability to share other member’s content to groups the user belongs to.

  6. portal:admin:shareToOrg: grants the ability to share other member’s content to organization.

  7. portal:admin:shareToPublic: grants the ability to share other member’s content to all users of the portal.

ArcGIS Marketplace Subscriptions

  1. marketplace:admin:purchase: grants the ability to request purchase information about apps and data in ArcGIS Marketplace. (This privilege is only applicable to ArcGIS Online.)

  2. marketplace:admin:startTrial: grants the ability to start trial subscriptions in ArcGIS Marketplace. (This privilege is only applicable to ArcGIS Online.)

  3. marketplace:admin:manage: grants the ability to create listings, list items and manage subscriptions in ArcGIS Marketplace. (This privilege is only applicable to ArcGIS Online.)

Publisher Privileges:

Content

  1. portal:publisher:publishFeatures: grants the ability to publish hosted feature layers from shapefiles, CSVs, etc.

  2. portal:publisher:publishTiles: grants the ability to publish hosted tile layers from tile packages, features, etc.

  3. portal:publisher:publishScenes: grants the ability to publish hosted scene layers.

User Privileges:

Groups

  1. portal:user:createGroup: grants the ability for a member to create, edit, and delete their own groups.

  2. portal:user:joinGroup: grants the ability to join groups within organization.

  3. portal:user:joinNonOrgGroup: grants the ability to join groups external to the organization. (This privilege is only applicable to ArcGIS Online.)

Content

  1. portal:user:createItem: grants the ability for a member to create, edit, and delete their own content.

Sharing

  1. portal:user:shareToGroup: grants the ability to share content to groups.

  2. portal:user:shareToOrg: grants the ability to share content to organization.

  3. portal:user:shareToPublic: grants the ability to share content to all users of portal.

  4. portal:user:shareGroupToOrg: grants the ability to make groups discoverable by the organization.

  5. portal:user:shareGroupToPublic: grants the ability to make groups discoverable by all users of portal.

Premium Content

  1. premium:user:geocode: grants the ability to perform large-volume geocoding tasks with the Esri World Geocoder such as publishing a CSV of addresses as hosted feature layer.

  2. premium:user:networkanalysis: grants the ability to perform network analysis tasks such as routing and drive-time areas.

  3. premium:user:geoenrichment: grants the ability to geoenrich features.

  4. premium:user:demographics: grants the ability to make use of premium demographic data.

  5. premium:user:spatialanalysis: grants the ability to perform spatial analysis tasks.

  6. premium:user:elevation: grants the ability to perform analytical tasks on elevation data.

Features

  1. features:user:edit: grants the ability to edit features in editable layers, according to the edit options enabled on the layer.

  2. features:user:fullEdit: grants the ability to add, delete, and update features in a hosted feature layer regardless of the editing options enabled on the layer.

Open Data

  1. opendata:user:openDataAdmin: grants the ability to manage Open Data Sites for the organization. (This privilege is only applicable to ArcGIS Online.)

  2. opendata:user:designateGroup: grants the ability to designate groups within organization as being available for use in Open Data. (This privilege is only applicable to ArcGIS Online.)

Layer

class arcgis.gis.Layer(url, gis=None)

Bases: arcgis.gis._GISResource

The Layer class is a primary concept for working with data in a GIS.

Users create, import, export, analyze, edit, and visualize layers.

Layers can be added to and visualized using maps. They act as inputs to and outputs from analysis tools.

Layers are created by publishing data to a GIS, and are exposed as a broader resource (Item) in the GIS. Layer objects can be obtained through the layers attribute on layer Item objects in the GIS.

classmethod fromitem(item, index=0)

The fromitem method returns the layer at the specified index from a layer Item object.

Argument

Description

item

Required string. An item ID representing a layer.

index

Optional int. The index of the layer amongst the item’s layers

Returns

The layer at the specified index.

# Usage Example

>>> layer.fromitem(item="9311d21a9a2047d19c0faaebd6f2cca6", index=3)

GroupApplication

class arcgis.gis.GroupApplication(url, gis, **kwargs)

Bases: object

The GroupApplication class represents a single group application on the GIS, either ArcGIS Online or ArcGIS Enterprise.

accept()

The accept method is used to manage a User application. When a User applies to join a Group, a GroupApplication object is created. Group administrators choose to accept this application using the accept operation. This operation adds the applying user to the group then deletes the application. This operation also creates a notification for the user indicating that the user’s group application was accepted. This method is very similar to the decline method, which declines rather than accepts the application to join a group.

Note

The accept method is only available to group owners and administrators.

# Usage Example

>>> group1 = gis.groups.get('name')
>>> group_app = group1.applications[0]
>>> group_app.accept()
Returns

A boolean indicating success (True) or failure (False).

decline()

The decline method is used to manage a User application. When a User asks to join a Group, a GroupApplication object is created. Group administrators choose to decline this application using the decline operation. This operation deletes the application and creates a notification for the user indicating that the user’s group application was declined. This method is very similar to the accept method, which accepts rather than declines the application to join a group.

Note

The decline method is only available to group owners and administrators.

# Usage Example

>>> group_app = group.applications[0]
>>> groupapplication.decline()
Returns

A boolean indicating success (True) or failure (False).

property properties

The properties operation retrevies the properties of the GroupApplication.

CategorySchemaManager

class arcgis.gis.CategorySchemaManager(base_url, gis=None)

The CategorySchemaHelper class is for managing category schemas. An instance of this class, called categories, is available as a property in the ContentManager and the Group class. See categories and categories for more information.

Note

This class is not created by users directly.

assign_to_items(items)

The assign_to_items function adds group content categories to the portal items specified in the items argument (see below). For assigning categories to items in a group, you must be the group owner/manager. For assigning organization content categories on items, you must be the item owner or an administrator who has the portal:admin:updateItems privilege.

Note

A maximum of 100 items can be bulk updated per request.

Argument

Description

items

Required List. A JSON array of item objects. Each is specified with the item ID that consists of a categories object. categories is specified with an array that lists all content categories to update on the item, each with full hierarchical path prefixed with /.

Each item can be categorized to a maximum of 20 categories.

Returns

A dict of item_id : status, with status being whether the content categories were successfully added. If the status is unsuccessfully updated, a message will provide information to help you debug the issue.

# Usage Example

>>> gis.content.categories.assign_to_items(items = [{"2678d3002eea4e4a825e3bdf10016e61": {
                                                     "categories": ["/Categories/Geology",
                                                                    "/Categories/Elevation"]}},
                                                    {"c3ad4ed8bcf04d619537cfe252a1760d": {
                                                     "categories": ["/Categories/Geology",
                                                                    "/Categories/Land cover/Forest/Deciduous Forest"]}},
                                                     {"9ced00fdce3e4b20bb4b05155acbe817": {
                                                     "categories": []}}])
delete()

The delete function allows group owner or managers to remove the category schema set on a group.

# Usage Example

>>> gis.content.categories.delete()
Returns

A boolean indicating success (True), or failure (False)

property properties

The properties method retrieves the properties of the schema.

property schema

The schema property allows group owners/managers to manage the content categories for a group. These content categories are a hierarchical set of classes to help organize and browse group content.

Note

Each group can have a maximum of 5 category trees with each category schema can have up to 4 hierarchical levels. The maximum number of categories a group can have in total is 200 with each category of less than 100 characters title and 300 characters description.

When getting schema, returns the content category schema set on a group.

When setting schema, will update the group category schema based on the dict this property is set to. See below.

Argument

Description

categories

Required Dict. A category schema object consists of an array of dict objects representing top level categories. Each object has title, description and categories properties where categories consists of an array of objects with each having the same properties and represents the descendant categories or subcategories and so on.

ContentManager

class arcgis.gis.ContentManager(gis)

The ContentManager class is a helper class for managing content in ArcGIS Online or ArcGIS Enterprise. An instance of this class, called ‘content’, is available as a property of the GIS object. Users call methods on this ‘content’ object to manipulate (create, get, search, etc) items. See content for more information.

Note

The class is not created by the user.

add(item_properties, data=None, thumbnail=None, metadata=None, owner=None, folder=None, item_id=None, **kwargs)

The add method adds content to the GIS by creating an Item.

Note

Content can be a file (such as a service definition, shapefile, CSV, layer package, file geodatabase, geoprocessing package, map package) or it can be a URL (to an ArcGIS Server service, WMS service, or an application).

If you are uploading a package or other file, provide a path or URL to the file in the data argument.

From a technical perspective, none of the item_properties (see table below Key:Value Dictionary Options for Argument item_properties) are required. However, it is strongly recommended that arguments title, type, typeKeywords, tags, snippet, and description be provided.

Argument

Description

item_properties

Required dictionary. See table below for the keys and values.

data

Optional string, io.StringIO, or io.BytesIO. Either a path or URL to the data or an instance of StringIO or BytesIO objects.

thumbnail

Optional string. Either a path or URL to a thumbnail image.

metadata

Optional string. Either a path or URL to the metadata.

owner

Optional string. Defaults to the logged in user.

folder

Optional string. Name of the folder where placing item.

item_id

Optional string. Available in ArcGIS Enterprise 10.8.1+. Not available in ArcGIS Online. This parameter allows the desired item id to be specified during creation which can be useful for cloning and automated content creation scenarios. The specified id must be a 32 character GUID string without any special characters.

If the item_id is already being used, an error will be raised during the add process.

Example: item_id=9311d21a9a2047d19c0faaebd6f2cca6

Optional Input Parameters for the `add` method

Optional Argument

Description

upload_size

Optional float. The default value is 1e7 bytes or ~10 MBs. This the minimum default value for the size of the file when uploading by parts.

Key:Value Dictionary Options for Argument item_properties

Key

Value

type

Optional string. Indicates type of item, see URL 1 below for valid values.

dataUrl

Optional string. The Url of the data stored on cloud storage. If given, filename is required.

filename

Optional string. The name of the file on cloud storage. This is required is dataUrl is used.

typeKeywords

Optional string. Provide a lists all sub-types, see URL below for valid values.

description

Optional string. Description of the item.

title

Optional string. Name label of the item.

url

Optional string. URL to item that are based on URLs.

text

Optional string. For text based items such as Feature Collections & WebMaps

tags

Optional string. Tags listed as comma-separated values, or a list of strings. Used for searches on items.

snippet

Optional string. Provide a short summary (limit to max 250 characters) of the what the item is.

extent

Optional string. Provide comma-separated values for min x, min y, max x, max y.

spatialReference

Optional string. Coordinate system that the item is in.

accessInformation

Optional string. Information on the source of the content.

licenseInfo

Optional string. Any license information or restrictions regarding the content.

culture

Optional string. Locale, country and language information.

commentsEnabled

Optional boolean. Default is true, controls whether comments are allowed (true) or not allowed (false).

culture

Optional string. Language and country information.

overwrite

Optional boolean. Default is false. Controls whether item can be overwritten.

See Item and Item Types in the ArcGIS REST API for more information.

Returns

The Item if successfully added, None if unsuccessful.

# Usage Example

>>> gis.content.add(item_properties = {
>>>                                         "type": "Feature Collection",
>>>                                         "title" : "US Hurricane Data",
>>>                                         "tags": "Hurricanes, Natural Disasters, USA",
>>>                                         "description" : "Aggregated USA Hurricane Data for 2020",
>>>                                         "commentsEnabled" : False
>>>                                        } , owner = "User1234")

The advanced_search method allows the ability to fully customize the search experience. The advanced_search method allows users to control of the finer grained parameters not exposed by the ContentManager method. Additionally, it allows for the manual paging of information and how the data is returned.

Argument

Description

query

Required String. The search query. When the search filters contain two or more clauses, the recommended schema is to have clauses separated by blank, or AND, e.g.

Usage Example

gis.content.advanced_search(query=’owner:USERNAME type:map’) # or gis.content.advanced_search(query=’type:map AND owner:USERNAME’)

When the clauses are separated by comma, the filtering condition for owner should not be placed at the first position, e.g. gis.content.advanced_search(query=’type:map, owner:USERNAME’) is allowed, while gis.content.advanced_search(query=’owner:USERNAME, type:map’) is not. For more, please check https://developers.arcgis.com/rest/users-groups-and-items/search-reference.htm

bbox

Optional String/List. This is the xmin,ymin,xmax,ymax bounding box to limit the search in. Items like documents do not have bounding boxes and will not be included in the search.

categories

Optional String. A comma separated list of up to 8 org content categories to search items. Exact full path of each category is required, OR relationship between the categories specified.

Each request allows a maximum of 8 categories parameters with AND relationship between the different categories parameters called.

category_filters

Optional String. A comma separated list of up to 3 category terms to search items that have matching categories. Up to 2 category_filters parameter are allowed per request. It can not be used together with categories to search in a request.

start

Optional Int. The starting position to search from. This is only required if paging is needed.

sort_field

Optional String. Responses from the search operation can be sorted on various fields. avgrating is the default.

sort_order

Optional String. The sequence into which a collection of records are arranged after they have been sorted. The allowed values are: asc for ascending and desc for descending.

count_fields

Optional String. A comma separated list of fields to count. Maximum count fields allowed per request is 3. Supported count fields: tags, type, access, contentstatus, and categories.

count_size

Optional Int. The maximum number of field values to count for each count_fields. The default value is None, and maximum size allowed is 200.

as_dict

Required Boolean. If True, the response comes back as a dictionary.

Returns

Depends on the inputs:
  1. Dictionary for a standard search

  2. `return_count`=True an integer is returned

  3. count_fields is specified a list of dicts for each field specified

# Usage Example

>>> gis.content.advanced_search(query ="Hurricanes", categories = "Hurricanes, USA, Natural Disasters",
>>>                                sort_order = "asc", count_fields = "tags, type", as_dict = True)
analyze(url=None, item=None, file_path=None, text=None, file_type=None, source_locale='en', geocoding_service=None, location_type=None, source_country='world', country_hint=None)

The analyze method helps a client analyze a CSV or Excel file (.xlsx, .xls) prior to publishing or generating features using the Publish or Generate operation, respectively.

analyze returns information about the file including the fields present as well as sample records. analyze attempts to detect the presence of location fields that may be present as either X,Y fields or address fields.

analyze packages its result so that publishParameters within the JSON response contains information that can be passed back to the server in a subsequent call to Publish or Generate. The publishParameters subobject contains properties that describe the resulting layer after publishing, including its fields, the desired renderer, and so on. analyze will suggest defaults for the renderer.

In a typical workflow, the client will present portions of the analyze results to the user for editing before making the call to generate or publish.

Note

The maximum upload size for shapefiles is now 2 Mb and 10 Mb for all other supported file types.

Note

If the file to be analyzed currently exists in the portal as an item, callers can pass in its itemId. Callers can also directly post the file. In this case, the request must be a multipart post request pursuant to IETF RFC1867. The third option for text files is to pass the text in as the value of the text parameter.

Argument

Description

url

Optional string. The URL of the csv file.

item

Optional string/Item . The ID or Item of the item to be analyzed.

file_path

Optional string. The file to be analyzed.

text

Optional string. The text in the file to be analyzed.

file_type

Optional string. The type of the input file: shapefile, csv, excel, or geoPackage (Added ArcGIS API for Python 1.8.3+).

source_locale

Optional string. The locale used for the geocoding service source.

geocoding_service

Optional string/geocoder. The URL of the service.

location_type

Optional string. Indicates the type of spatial information stored in the dataset.

Values for CSV: coordinates | address | lookup | none Values for Excel: coordinates | address | none

source_country

Optional string. The two character country code associated with the geocoding service, default is “world”.

country_hint

Optional string. If first time analyzing, the hint is used. If source country is already specified than sourcecountry is used.

Returns

dictionary

# Usage Example

>>> gis.content.analyze(item = "9311d21a9a2047d19c0faaebd6f2cca6", file_type = "csv")
bulk_update(itemids, properties)

The bulk_update method updates a collection of items’ properties.

Note

bulk_update only works with content categories at this time.

Argument

Description

itemids

Required list of string or Item. The collection of Items to update.

properties

Required dictionary. The Item’s properties to update.

Returns

A List of results

# Usage Example
>>> itemsids = gis.content.search("owner: TestUser12399")
>>> properties = {'categories' : ["clothes","formal_wear/socks"]}
>>> gis.content.bulk_update(itemids, properties)
[{'results' : [{'itemid' : 'id', 'success' : "True/False" }]}]
can_delete(item)

The can_delete method indicates whether an Item can be erased or not. When the returned response from can_delete is true, the item can be safely removed. When the returned response is false, the item cannot be deleted due to a dependency or protection setting.

Argument

Description

item

Required Item. The Item to be erased.

Returns

A dictionary - see the table below for examples of a successful call of can_delete and a failed call of can_delete.

# Usage Example
>>> gis.content.can_delete("9311d21a9a2047d19c0faaebd6f2cca6")

Status

Response

success

{ “itemId”: “e03f626be86946f997c29d6dfc7a9666”, “success”: True }

failure

{ “itemId”: “a34c2e6711494e62b3b8d7452d4d6235”, “success”: false, “reason”: { “message”: “Unable to delete item. Delete protection is turned on.” } }

property categories

The categories property is category manager for an Item object. See CategorySchemaManager.

check_url(url)

To verify a URL is accessible by the Organization, provide the url and the system will check if the location is valid and reachable. This method is useful when checking service URLs or validating that URLs can be reached.

Returns

Dict[str, Any]

clone_items(items, folder=None, item_extent=None, use_org_basemap=False, copy_data=True, copy_global_ids=False, search_existing_items=True, item_mapping=None, group_mapping=None, owner=None, preserve_item_id=False)

The clone_items method is used to clone content to the GIS by creating new Item objects.

Note

Cloning an item will create a copy of the item and for certain item types a copy of the item dependencies in the GIS.

For example, a web application created using Web AppBuilder or a Configurable App Template which is built from a web map that references one or more hosted feature layers. This function will clone all of these items to the GIS and swizzle the paths in the web map and web application to point to the new layers.

Note

The actions in the example above create an exact copy of the application, map, and layers in the GIS.

Argument

Description

items

Required list. Collection of Item objects to clone.

folder

Optional string. Name of the folder where placing item.

item_extent

Optional Envelope. Extent set for any cloned items. Default is None, extent will remain unchanged. Spatial reference of the envelope will be used for any cloned feature layers.

use_org_basemap

Optional boolean. Indicating whether the basemap in any cloned web maps should be updated to the organizations default basemap. Default is False, basemap will not change.

copy_data

Optional boolean. If False, the data is put by reference rather than by copy. Default is True, data will be copied. This creates a Hosted Feature Collection or Feature Layer.

copy_global_ids

Optional boolean. Assumes previous parameter is set to True. If True, features copied will preserve their global IDs. Default is False

search_existing_items

Optional boolean. Indicating whether items that have already been cloned should be searched for in the GIS and reused rather than cloned again.

item_mapping

Optional dictionary. Can be used to associate an item id in the source GIS (key) to an item id in the target GIS (value). The target item will be used rather than cloning the source item.

group_mapping

Optional dictionary. Can be used to associate a group id in the source GIS (key) to a group id in the target GIS (value). The target group will be used rather than cloning the source group.

owner

Optional string. Defaults to the logged in user.

preserve_item_id

Optional Boolean. When true and the destination GIS is not ArcGIS Online, the clone item will attempt to keep the same item ids for the items if available. ArcGIS Enterprise must be 10.9+.

Returns

A list of Item objects created during the clone.

# Usage Example
>>> gis.content.clone_items(items= ["item1", "item2", "item3", "item4", "item5"],
                            folder ="/", owner = 'User1234')
cost(tile_storage=None, file_storage=None, feature_storage=None, generate_tile_count=None, loaded_tile_count=None, enrich_variable_count=None, enrich_report_count=None, service_area_count=None, geocode_count=None)

The cost allows for the estimation of amount of credits an operation will be required. For vector and tile storage, a user can estimate the cost to cook tile and the cost of storage. This operation allows users to plan for future costs effeciently to best serve their organization and clients.

Note

This operation is only supported on ArcGIS Online.

Argument

Description

tile_storage

Optional Float. The size of the uncompressed tiles in MBs.

file_storage

Optional Float. Estimates the credit cost of MB file storage.

feature_storage

Optional Float. Estimates the cost of feature storage per feature.

generate_tile_count

Optional Int. Estimates the credit cost per tile.

loaded_tile_count

Optional Int. Estimates the credit cost of pregenerated tile storage.

enrich_variable_count

Optional Int. Estimates the credit cost er geoenrichment variable.

enrich_report_count

Optional Int. Estimates the credit cost of running reports.

service_area_count

Optional Int. Estimates the credit cost per service area generation.

geocode_count

Optional Int. Estimates the credit cost per record for geocoding.

Returns

dict[str, float]

create_folder(folder, owner=None)

The create_folder method creates a folder with the given folder name, for the given owner.

Note

The create_folder method does nothing if the folder already exists. Additionally, if owner is not specified, owner is set as the logged in user.

Argument

Description

folder

Required string. The name of the folder to create for the owner.

owner

Optional string. User, folder owner, None for logged in user.

Returns

A json object like the following if the folder was created: {“username” : “portaladmin”,”id” : “bff13218991c4485a62c81db3512396f”,”title” : “testcreate”}; None otherwise.

# Usage Example
>>> gis.content.create_folder("Hurricane_Data", owner= "User1234")
create_service(name, service_description='', has_static_data=False, max_record_count=1000, supported_query_formats='JSON', capabilities=None, description='', copyright_text='', wkid=102100, create_params=None, service_type='featureService', owner=None, folder=None, item_properties=None, is_view=False, tags=None, snippet=None, item_id=None)

The create_service method creates a service in the Portal. See the table below for a list of arguments passed when calling create_service.

Argument

Description

name

Required string. The unique name of the service.

service_description

Optional string. Description of the service.

has_static_data

Optional boolean. Indicating whether the data can change. Default is True, data is not allowed to change.

max_record_count

Optional integer. Maximum number of records in query operations.

supported_query_formats

Optional string. Formats in which query results are returned.

capabilities

Optional string. Specify service capabilities. If left unspecified, ‘Image,Catalog,Metadata,Download,Pixels’ are used for image services, and ‘Query’ is used for feature services, and ‘Query’ otherwise

description

Optional string. A user-friendly description for the published dataset.

copyright_text

Optional string. The copyright information associated with the dataset.

wkid

Optional integer. The well known id (WKID) of the spatial reference for the service. All layers added to a hosted feature service need to have the same spatial reference defined for the feature service. When creating a new empty service without specifying its spatial reference, the spatial reference of the hosted feature service is set to the first layer added to that feature service.

create_params

Optional dictionary. Add all create_service parameters into a dictionary. If this parameter is used, all the parameters above are ignored.

service_type

Optional string. The type of service to be created. Currently the options are imageService or featureService.

owner

Optional string. The username of the owner of the service being created.

folder

Optional string. The name of folder in which to create the service.

item_properties

Optional dictionary. See below for the keys and values

is_view

Optional boolean. Indicating if the service is a hosted feature layer view

item_id

Optional string. Available in ArcGIS Enterprise 10.8.1+. Not available in ArcGIS Online. This parameter allows the desired item id to be specified during creation which can be useful for cloning and automated content creation scenarios. The specified id must be a 32 character GUID string without any special characters.

If the item_id is already being used, an error will be raised during the add process.

Example: item_id=9311d21a9a2047d19c0faaebd6f2cca6

tags

Optional string. Tags listed as comma-separated values, or a list of strings. Used for searches on items.

snippet

Optional string. Provide a short summary (limit to max 250 characters) of the what the item is.

Key:Value Dictionary Options for Argument item_properties

Key

Value

type

Optional string. Indicates type of item, see URL 1 below for valid values.

typeKeywords

Optional string. Provide a lists all sub-types, see URL 1 below for valid values.

description

Optional string. Description of the item.

title

Optional string. Name label of the item.

url

Optional string. URL to item that are based on URLs.

tags

Optional string. Tags listed as comma-separated values, or a list of strings. Used for searches on items.

snippet

Optional string. Provide a short summary (limit to max 250 characters) of the what the item is.

extent

Optional string. Provide comma-separated values for min x, min y, max x, max y.

spatialReference

Optional string. Coordinate system that the item is in.

accessInformation

Optional string. Information on the source of the content.

licenseInfo

Optional string. Any license information or restrictions regarding the content.

culture

Optional string. Locale, country and language information.

access

Optional string. Valid values are private, shared, org, or public.

commentsEnabled

Optional boolean. Default is true, controls whether comments are allowed (true) or not allowed (false).

culture

Optional string. Language and country information.

Returns

The Item for the service if successfully created, None if unsuccessful.

# Usage Example
>>> gis.content.create_service("Hurricane Collection")
delete_folder(folder, owner=None)

The delete_folder method deletes a folder for the given owner with the given folder name.

Note

If the an owner is note specified in the delete_folder call, the method defaults to the logged in user.

Argument

Description

folder

Required string. The name of the folder to delete.

owner

Optional string. User, folder owner, None for logged in user is the default.

Returns

A boolean indicating success if the folder was deleted (True), or failure if the folder was not deleted (False)

# Usage Example
>>> gis.content.delete_folder("Hurricane_Data", owner= "User1234")
delete_items(items)

The delete_items method deletes a collection of Item objects from a users content.

Argument

Description

items

list of Item objects or Item Ids. This is an array of items to be deleted from the current user’s content

Returns

A boolean indicating success if the items were deleted (True), or failure if the items were not deleted (False)

# Usage Example
>>> gis.content.delete_items(items= ["item1", "item2", "item3", "item4", "item5"])
property dependency_manager

Provides users the ability to manage the Enterprise’s Item Dependencies Database.

Available in ArcGIS Enterprise 10.9.1+

Returns

DependencyManager or None for ArcGIS Online.

generate(item=None, file_path=None, url=None, text=None, publish_parameters=None, future=False)

The generate method helps a client generate features from a CSV file, shapefile, GPX, or GeoJson file types.

Note

The maximum upload size for shapefiles is now 2 Mb and 10 Mb for all other supported file types.

Argument

Description

item

Optional Item. An Item on the current portal.

file_path

Optional String. The file resource location on local disk.

url

Optional String. A web resource of a ‘shapefile’, ‘csv’, ‘gpx’ or ‘geojson’ file.

text

Optional String. The source text.

publish_parameters

Optional Dict. A Python dictionary describing the layer and service to be created as part of the publish operation. The appropriate key-value pairs depend on the file type being published. For a complete description, see the Publish Item documentation in the REST API. Also see the Item publish() method. CSV, Shapefiles and GeoJSON file types must have publish parameters provided.

future

Optional Boolean. This allows the operation to run asynchronously allowing the user to not pause the thread and continue to perform multiple operations. The default is True. When True the result of the method will be a concurrent Future object. The result of the method can be obtained using the result() on the Future object. When False, and Item is returned. Future == True is only supported for ‘shapefiles’ and ‘gpx’ files.

Returns

The method has 3 potential returns:
  1. A Future object when future==True,

  2. An Item object when future==False

  3. A dictionary of error messages when Exceptions are raised

# Usage Example
>>> gis.content.generate(item= item1, future=False)
get(itemid)

The get method returns the Item object for the specified itemid.

Argument

Description

itemid

Required string. The item identifier.

Returns

The item object if the item is found, None if the item is not found.

import_data(df, address_fields=None, folder=None, item_id=None, **kwargs)

The import_data method imports a Pandas DataFrame (that has an address column), or an arcgis spatial DataFrame into the GIS.

Spatial dataframes are imported into the GIS and published as feature layers. Pandas dataframes that have an address column are imported as an in-memory feature collection.

Note

By default, there is a limit of 1,000 rows/features for Pandas dataframes. This limit isn’t there for spatial dataframes.

Argument

Description

df

Required DataFrame. Pandas dataframe

address_fields

Optional dictionary. Dictionary containing mapping of df columns to address fields, eg: { “CountryCode” : “Country”} or { “Address” : “Address” }.

folder

Optional string. Name of the folder where imported data would be stored.

title

Optional string. Title of the item. This is used for spatial dataframe objects.

tags

Optional string. Tags listed as comma-separated values, or a list of strings. Provide tags when publishing a spatial dataframe to the the GIS.

item_id

Optional string. Available in ArcGIS Enterprise 10.8.1+. Not available in ArcGIS Online. This parameter allows the desired item id to be specified during creation which can be useful for cloning and automated content creation scenarios. The specified id must be a 32 character GUID string without any special characters.

If the item_id is already being used, an error will be raised during the add process.

Example: item_id=9311d21a9a2047d19c0faaebd6f2cca6

In addition to the parameters above, you can specify additional information to help publish CSV data.

Optional Argument

Description

location_type

Optional string. Indicates the type of spatial information stored in the dataset.

Values for CSV:

  • coordinates

  • address (default)

  • lookup

  • none

Values for Excel:

  • coordinates

  • address (default)

  • none

When location_type = coordinates, the CSV or Excel data contains x,y information. When location_type = address, the CSV or Excel data contains address fields that will be geocoded to a single point. When location_type = lookup, the CSV or Excel data contains fields that can be mapped to well-known sets of geographies. When location_type = none, the CSV or Excel data contains no spatial content and data will be loaded and subsequently queried as tabular data.

Based on this parameter, additional parameters will be required, for example, when specifying location_type = coordinates, the latitude and longitude field names must be specified.

latitude_field

Optional string. If location_type = coordinates, the name of the field that contains the y coordinate.

longitude_field

Optional string. If location_type = coordinates, the name of the field that contains the x coordinate.

coordinate_field_type

Optional string. Specify the type of coordinates that contain location information. Values: LatitudeAndLongitude (default), MGRS, USNG

coordinate_field_name

Optional string. The name of the field that contains the coordinates specified in coordinate_field_type

lookup_type

Optional string. The type of place to look up.

lookup_fields

Optional string. A JSON object with name value pairs that define the fields used to look up the location.

geocode_url

Optional string. The URL of the geocoding service that supports batch geocoding.

source_locale

Optional string. The locale used for the geocoding service source.

source_country

Optional string. The two character country code associated with the geocoding service, default is ‘world’.

country_hint

Optional string. If first time analyzing, the hint is used. If source country is already specified than source_country is used.

When publishing a Spatial Dataframe, additional options can be given:

Optional Argument

Description

target_sr

optional integer. WKID of the output data. This is used when publishing Spatial Dataframes to Hosted Feature Layers. The default is: 102100

title

optional string. Name of the layer. The default is a random string.

tags

optional string. Comma seperated strings that provide metadata for the items. The default is FGDB.

capabilities

optional string. specifies the operations that can be performed on the feature layer service. The default is Query.

sanitize_columns

Optional boolean. The default is False. When true, the column name will modified in order to allow for successful publishing.

service_name

Optional String. The name for the service that will be added to the Item.

Returns

A feature collection or feature layer that can be used for analysis, visualization, or published to the GIS as an Item.

is_service_name_available(service_name, service_type)

The is_service_name_available method determines if that service name is available for use or not, for the specified service type.

Argument

Description

service_name

Required string. A desired service name.

service_type

Required string. The type of service to be created. Currently the options are imageService or featureService.

Returns

True if the specified service_name is available for the specified service_type, False if the service_name is unavailable.

# Usage Example
>>> gis.content.is_service_name_available("Hurricane Collection", "featureService")
rename_folder(old_folder, new_folder, owner=None)

The rename_folder method renames an existing folder from it’s existing name to a new name.

Note

If owner is not specified, owner is set as the logged in user.

Argument

Description

old_folder

Required string. The name of the folder to rename for the owner.

new_folder

Required string. The new name of the folder.

owner

Optional string. User, folder owner, None for logged in user.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example
>>> gis.content.rename_folder("2020_Hurricane_Data", "2021_Hurricane_Data", "User1234")
replace_service(replace_item, new_item, replaced_service_name=None, replace_metadata=False)

The replace_service operation allows you to replace your production vector tile layers with staging ones. This operation allows you to perform quality control on a staging tile layer and to then replace the production tile layer with the staging with minimal downtime. This operation has the option to keep a backup of the production tile layer.

Note

This functionality is only available for hosted vector tile layers, hosted tile layers and hosted scene layers based on packages. If you are looking to clone services, use the clone_items method instead.

The workflow for the replace_service method is as follows:

1. Publish the staging service to the same system as the production service. Both services are active at the same time. Share the staging service with a smaller set of users and QA the staging service.

2. The item properties (ex: thumbnail, iteminfo, metadata) of the production item will be preserved. If you need to update them use the Item.update() method.

3. Call the replace_service operation. The service running on the hosting server gets replaced (for example, its cache).

Note

It is the responsibility of the user to ensure both services are functionally equivalent for clients consuming them. For example, when replacing a hosted feature service, ensure the new service is constructed with the anticipated layers and fields for its client application.

If you want to retain the replaced production service, for example, to keep an archive of the evolution of the service you can do so by omitting a value for “Replaced Service Name” . If replaced service name is not provided, the production service being replaced will be archived with a time stamp when replace service was executed. You can provide any name for the replaced service as long as it is not pre-existing on your portal content.

Argument

Description

replace_item

Required Item or Item’s Id as string. The service to be replaced

new_item

Required Item or Item’s Id as string. The replacement service.

replaced_service_name

Optional string. The name of the replacement service.

replace_metadata

Optional Boolean. When set to True, the item info {“thumbnail”, “tag”, “description”, “summary”} of the current service is updated to that of the replacement service. The Credits, Terms of use, and Created from details will not be replaced. This option is set to False by default.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example
>>> gis.content.replace_service(replace_item="9311d21a9a2047d19c0faaebd6f2cca6",
                                new_item = "420554d21a9a2047d19c0faaebd6f2cca4")
search(query, item_type=None, sort_field='avgRating', sort_order='desc', max_items=10, outside_org=False, categories=None, category_filters=None)

The search method searches for portal items.

Note

A few things that will be helpful to know…

  1. The query syntax has many features that can’t be adequately described here. Please see the ArcGIS REST API Search Reference for full details on search engine used with this method.

  2. Most of the time when searching for items, you’ll want to search within your organization in ArcGIS Online or within your Portal. As a convenience, the method automatically appends your organization id to the query by default. If you want content from outside your organization set outside_org to True.

Argument

Description

query

Required string. A query string. See notes above. When the search filters contain two or more clauses, the recommended schema is to have clauses separated by blank, or AND, e.g.

Usage Example

gis.content.search(query=’owner:USERNAME type:map’) # or gis.content.search(query=’type:map AND owner:USERNAME’)

When the clauses are separated by comma, the filtering condition for owner should not be placed at the first position, e.g. gis.content.search(query=’type:map, owner:USERNAME’) is recommended, while gis.content.search(query=’owner:USERNAME, type:map’) is not.

item_type

Optional string. The type of item to search. See Items and item types for comprehensive list of values (the type column).

sort_field

Optional string. Valid values can be title, uploaded, type, owner, modified, avgRating, numRatings, numComments, and numViews.

sort_order

Optional string. Valid values are asc or desc.

max_items

Optional integer. Maximum number of items returned, default is 10.

outside_org

Optional boolean. Controls whether to search outside your org (default is False, do not search ourside your org).

categories

Optional string or list. A string of category values.

category_filters

Optional string. A comma separated list of up to 3 category terms to search items that have matching categories.

Up to 2 category_filters parameter are allowed per request. It can not be used together with categories to search in a request.

Returns

A list of items objects matching the specified query.

# Usage Example

>>> gis.content.search(query ="Hurricanes", categories = "Hurricanes, USA, Natural Disasters",
>>>                    item_type = "Feature Collection")
share_items(items, everyone=False, org=False, groups=None, allow_members_to_edit=False)

The shares_items method shares a batch of items with everyone, members of the organization, or specified list of Group. A User can only share items with groups to which they belong. This method is quite similar to the unshare_items method, which achieves the exact opposite of share_items.

Argument

Description

items

Required List. A list of Item or item ids to modify sharing on.

everyone

Optional boolean. Default is False, don’t share with everyone.

org

Optional boolean. Default is False, don’t share with the organization.

groups

Optional list of group names as strings, or a list of arcgis.gis.Group objects, or a comma-separated list of group IDs.

allow_members_to_edit

Optional boolean. Default is False, to allow item to be shared with groups that allow shared update

Returns

A dictionary of shared Item objects

# Usage Example

>>> gis.content.share_items(items=[item1, item2, item3], everyone=True, org=True)
unshare_items(items, groups=None, everyone=None, org=None)

The unshare_items methodUnshares a batch of items with the specified list of groups, everyone, or organization. This method is quite similar to the share_items method, which achieves the exact opposite of unshare_items.

Note

Each item’s current sharing will be overwritten with this method.

Argument

Description

items

Required List. A list of Item or item ids to modify sharing on.

everyone

Required Boolean. If provided, the everyone sharing property will be updated. True means it will share the items with anyone. False means the item will not be shared with all users.

org

Required Boolean. A true value means that the items will be shared with all members of the organization. A false value means that the item will not be shared with all organization users.

groups

Required list of group names as strings, or a list of Group objects, or a list of group IDs.

Returns

A dictionary of unshared Item objects

# Usage Example

>>> gis.content.share_items(items=[item1, item2, item3], everyone=True, org=True,
                            groups = ["Developers", "Engineers", "GIS_Analysts"])

UserManager

class arcgis.gis.UserManager(gis)

Bases: object

The UserManager class is a helper class for managing GIS users. This class is not created by users directly. An instance of this class, called ‘users’, is available as a property of the Gis object. Users call methods on this ‘users’ object to manipulate (create, get, search, etc) users.

The advanced_search method allows for the full control of the query operations by any given user. The searches are performed against a high performance index that indexes the most popular fields of an user. See the Search reference page for information on the fields and the syntax of the query. The advanced_search method is quite similar to the search method, which is less refined.

The search index is updated whenever users is added, updated, or deleted. There can be a lag between the time that the user is updated and the time when it’s reflected in the search results.

Note

The results of a search only contain items that the user has permission to access.

Argument

Description

query

Required String. The search query. When the search filters contain two or more clauses, the recommended schema is to have clauses separated by blank, or AND, e.g.

Usage Example

gis.users.advanced_search(query=’owner:USERNAME type:map’) # or gis.users.advanced_search(query=’type:map AND owner:USERNAME’)

When the clauses are separated by comma, the filtering condition for owner should not be placed at the first position, e.g. gis.users.advanced_search(query=’type:map, owner:USERNAME’) is allowed, while gis.users.advanced_search(query=’owner:USERNAME, type:map’) is not. For more, please check https://developers.arcgis.com/rest/users-groups-and-items/search-reference.htm

return_count

Optional Boolean. If True, the number of users found by the query string is returned.

max_users

Optional Integer. Limits the total number of users returned in a a query. The default is 10 users. If all users is needed, -1 should be used.

start

Optional Int. The starting position to search from. This is only required if paging is needed.

sort_field

Optional String. Responses from the search operation can be sorted on various fields. username is the default.

sort_order

Optional String. The sequence into which a collection of records are arranged after they have been sorted. The allowed values are: asc for ascending and desc for descending.

as_dict

Optional Boolean. If True, the response comes back as a dictionary.

Returns

A dictionary if return_count is False, else an integer

# Usage Example

>>> gis.users.advanced_search(query ="1234", sort_field = "username", max_users=20, as_dict=20)
counts(type='bundles', as_df=True)

The counts method returns a simple report on the number of licenses currently used for a given type. A type can be a role, app, bundle or user license type.

Argument

Description

type

Required String. The type of data to return. The following values are valid:

  • role - returns counts on user roles

  • app - returns counts on registered applications

  • bundles - returns counts on application bundles

  • user_type - returns counts on the user license types

as_df

Optional boolean. If true, the results are returned as a pandas DataFrame, else it is returned as a list of dictionaries.

Returns

Pandas DataFrame if as_df is True. If False, the result is a list of dictionaries.

# Usage Example

>>>gis.users.counts("Role", as_df=True)


**Example as_df=True**

>>> df = gis.users.counts('user_type', True)
>>> df
    count        key
0     12  creatorUT
1      2   viewerUT


**Example as_df=False**


>>> df = gis.users.counts('user_type', False)
>>> df
[{'key': 'creatorUT', 'count': 12}, {'key': 'viewerUT', 'count': 2}]
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)

The create operation is used to pre-create built-in or enterprise accounts within the Enterprise portal, or built-in users in an ArcGIS Online organization account.

Note

Only an administrator can call this method.

A member’s user_type determines the default role that can be assigned to the member. User types compatible with each role are noted in the table below (within the user_type section).

To create a viewer account, choose role=’viewer’ and user_type=’viewer’

Argument

Description

username

Required string. The user name, which must be unique in the Portal, and 6-24 characters long.

password

Required string. The password for the user. It must be at least 8 characters. This is a required parameter only if the provider is arcgis; otherwise, the password parameter is ignored. If creating an account in an ArcGIS Online org, it can be set as None to let the user set their password by clicking on a link that is emailed to him/her. When the provider is enterprise, password is optional.

firstname

Required string. The first name for the user

lastname

Required string. The last name for the user

email

Required string. The email address for the user. This is important to have correct.

description

Optional string. The description of the user account.

thumbnail

Optional string. The URL to user’s image.

role

Optional string. The role for the user account. The default value is org_user. Other possible values are org_publisher, org_admin, viewer, viewplusedit or a custom role_id value obtained from the all() method of the RoleManager class.

provider

Optional string. The provider for the account. The default value is arcgis. The other possible value is enterprise.

idp_username

Optional string. The name of the user as stored by the enterprise user store. This parameter is only required if the provider parameter is enterprise.

level

Optional integer. The account level. (ArcGIS Enterprise prior to version 10.7. See User types, roles, and privileges for full details.) The GIS Professional user_type can be assigned at the following three levels, which correspond to the three license levels of ArcGIS Pro:

  • GIS Professional Basic

  • GIS Professional Standard

  • GIS Professional Advanced

user_type

Required string. The account user type. This can be creator, viewer, etc. The type effects what applications a user can use and what actions they can do in the organization. (ArcGIS Enterprise 10.7+ and ArcGIS Online. See User types, roles, and privileges for full details.)

  • 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

Optional Float. The number of credits to assign a user. The default is None, which means unlimited. (10.7+)

groups

Optional List. An array of Group objects to provide access to for a given user. (10.7+)

Returns

The user if successfully created, None if unsuccessful.

# 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"
disable_users(users)

The disable_users method is a bulk disables user operation that allows administrators to quickly disable large number of users in a single call. It is useful to do this operation if you have multiple users that need to be disabled. disable_users is quite similar to the enable_users method, which enables rather than disables users.

Note

The disable_users method is supported on ArcGIS REST API 6.4+.

Argument

Description

users

Required List. List of user or UserNames to disable

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.users.disable_users(['user1','user1234', 'user123', 'user1234'])
enable_users(users)

Thie enable_users method is a bulk operation that allows administrators to quickly enable large number of users in a single call. It is useful to do this operation if you have multiple users that need to be enabled. enable_users is quite similar to the disable_users method, which disables rather than enables users.

Note

The enable_users method is supported on ArcGIS REST API 6.4+.

Argument

Description

users

Required List. List of user or UserNames to enable

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.users.enable_users(['user1','user1234','user123', 'user1234'])
get(username)

The get method retrieves the User object for the specified username.

Argument

Description

username

Required string. The user to get as a string. This can be the user’s login name or the user’s ID.

Returns

The User object if successfully found, None if unsuccessful.

# Usage Example

>>> gis.users.get("User1234")
property invitations

The invitations property provides access to invitations sent to users using the invite method.

Note : this is only supported by ArcGIS Online

Returns

An InvitationManager object

invite(email, role='org_user', level=2, provider=None, must_approve=False, expiration='1 Day', validate_email=True, message_text=None)

The invite method invites a User object to an organization by email.

Argument

Description

email

Required String. The user’s email that will be invited to the organization.

role

Optional String. The role for the user account. The default value is org_user. Other possible values are org_publisher, org_admin, org_viewer.

level

Optional integer. The account level. The default is 2. See User types, roles, and privileges for full details.

provider

Optional String. The provider for the account. The default value is arcgis. The other possible value is enterprise.

must_approve

Optional boolean. After a user accepts the invite, if True, and administrator must approve of the individual joining the organization. The default is False.

expiration

Optional String. The default is ‘1 Day’. This is the time the emailed user has to accept the invitation request until it expires. The values are: 1 Day (default), 3 Days, 1 Week, or 2 Weeks.

validate_email

Optional boolean. If True (default) the Enterprise will ensure that the email is properly formatted. If false, no check will occur

message_text

Optional String. Added to the message of the invitation and can provide further instructions, a welcome, or any other personalized text to the person invited.

Returns

A boolean indicating success (True), or faliure (False)

# Usage Example

>>> gis.users.invite("user1234@email.com", role=org_admin, provider=enterprise)
property license_types

The license_types method returns a list of available licenses associated with a given GIS.

Note

The information returned can help administrators determine what type of a user should me based on the bundles associated with each user type. Additionally, the license_types is only available on ArcGIS Enterprise 10.7+.**

Returns

A List of available licenses

property me

The me property retrieves the information of the logged in User object.

The org_search method allows users to find users within the organization only. Users can search for details such as provider, fullName and other user properties where the other user searches are limited. This operation will not show any user outside the organization.

Argument

Description

query

Optional string. The query string. See notes above. Pass None to get list of all users in the organization.

sort_field

Optional string. Valid values can be username (the default) or created.

sort_order

Optional string. Valid values are asc (the default) or desc.

Returns

List[User]

property roles

The roles property is a helper object to manage custom roles for users.

Returns

An instance of the RoleManager

search(query=None, sort_field='username', sort_order='asc', max_users=100, outside_org=False, exclude_system=False, user_type=None, role=None)

The search method searches portal users, returning a list of users matching the specified query. The search method is quite similar to the advanced_search method, which is more refined.

Note

A few things that will be helpful to know.

  1. The query syntax has quite a few features that can’t be adequately described here. Please refer to the ArcGIS REST API Search Reference for details on the search engine used with this method.

  2. Searching without specifying a query parameter returns a list of all users in your organization.

  3. Most of the time when searching users you want to search within your organization in ArcGIS Online or within your Portal. As a convenience, the method automatically appends your organization id to the query by default. If you don’t want the API to append to your query set outside_org to True. If you use this feature with an OR clause such as field=x or field=y you should put this into parenthesis when using outside_org.

Argument

Description

query

Optional string. The query string. See notes above. Pass None to get list of all users in the organization.

sort_field

Optional string. Valid values can be username (the default) or created.

sort_order

Optional string. Valid values are asc (the default) or desc.

max_users

Optional integer. The maximum number of users to be returned. The default is 100.

outside_org

Optional boolean. This controls whether to search outside your organization. The default is False (search only within your organization).

exclude_system

Optional boolean. Controls if built-in system accounts are returned or not. True means built-in account are not returned, where as False means that they are.

user_type

Optional String. This parameters allows for the filtering of the users by their assigned type.

role

Optional String. Specify the roleId. This parameter allows for the filting of the users based on a roleId.

Returns

A list of User objects that fit the query parameters.

# Usage Example

>>> gis.users.search(query ="1234", sort_field = "username", max_users=20)
send_notification(users, subject, message, type='builtin', client_id=None)

The send_notification method creates a user notifcation for a list of users.

Argument

Description

users

Required List. A list of strings or User objects to send notifications to.

subject

Required String. The notification subject line.

message

Required String. The notification content. This should be in plain text.

type

Optional String. The notification can be sent various ways. These include:

  • builtin - The enterprise built-in system

  • push - The push notification to send a message to

  • email - a notification sent to the user’s email account

client_id

Optional String. The client id for push notification.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.users.send_notification([user1,user1234,user123, user1234], "testing notification system",
                                "This was a test of the sending notification property")
signup(username, password, fullname, email)

The signup method is used to create a new user account in an ArcGIS Enterprise deployment.

Argument

Description

username

Required string. The desired username, which must be unique in the Portal, and at least 4 characters.

password

Required string. The passowrd, which must be at least 8 characters.

fullname

Required string. The full name of the user.

email

Required string. The email address for the user. This is important to have correct.

Returns

The User object if successfully created, None if unsuccessful.

# Usage Example

>>> gis.users.signup("User1234", "password1234","User User", "User1234@email.com")
user_groups(users, max_results=- 1)

Givens a List of Users, the user_groups method will report back all group ids that each User belongs to. user_groups is designed to be a reporting tool for administrators so they can easily manage a user or users groups.

property user_settings

Gets/sets the user’s settings

The user_settings allows administrators to set, and edit, new member defaults. Members who create their own built-in accounts and members added by an administrator or through automatic account creation will be automatically assigned the new member defaults.

Passing in None to the property will delete all the user settings.

Settings Key/Value Dictionary

Keys

Description

role

String/Role. The role ID. To assign a custom role as the new member default, provide a Role object.

Values: administrator, publisher, editor, viewer or custom Role object

userLicenseType

String. The ID of a user type licensed with your organization. To see which user types are included with your organization’s licensing, see the License resource in the Portal Admin API.

Values: creator, editor, Advanced GIS, Basic GIS, Standard GIS, viewer, or fieldWorker

groups

List of String/Groups. An array of group ID numbers or Group objects that specify the groups new members will be added to.

userType

String. This key only applies to ArcGIS Online. If new members will have Esri access (both) or if Esri access will be disabled (arcgisonly). The default value is arcgisonly.

Values: arcgisonly or both

apps

List of dictionaries. An array of an app’s itemID and, when applicable, entitlement. Example: {“apps” :[{“itemId”: “f761dd0f298944dcab22d1e888c60293”,”entitlements”: [“Insights”]}]}

appBundles

List of dictionaries. An array of an app bundle’s ID.

Example: {“appBundles”:[{“itemId”: “99d7956c7e824ff4ab27422e2a26c2b7}]}

Returns

Dictionary of the user settings

GroupManager

class arcgis.gis.GroupManager(gis)

Bases: object

The GroupManager class is a helper class for managing GIS groups. An instance of this class, called groups, is available as a property of the GIS object. Users call methods on this ‘groups’ object to manipulate (create, get, search, etc) users.

Note

This class is not created by users directly.

create(title, tags, description=None, snippet=None, access='public', thumbnail=None, is_invitation_only=False, sort_field='avgRating', sort_order='desc', is_view_only=False, auto_join=False, provider_group_name=None, provider=None, max_file_size=None, users_update_items=False, display_settings=None, is_open_data=False, leaving_disallowed=False)

The create method creates a group with the values for any particular arguments that are specified.

Note

Only title and tags are required.

Argument

Description

title

Required string. The name of the group.

tags

Required string. A comma-delimited list of tags, or list of tags as strings.

description

Optional string. A detailed description of the group.

snippet

Optional string. A short snippet (<250 characters) that summarizes the group.

access

Optional string. Choices are private, public, or org.

thumbnail

Optional string. URL or file location to a group image.

is_invitation_only

Optional boolean. Defines whether users can join by request. Default is False meaning users can ask to join by request or join by invitation.

sort_field

Optional string. Specifies how shared items with the group are sorted.

sort_order

Optional string. Choices are asc or desc for ascending or descending, respectively.

is_view_only

Optional boolean. Defines whether the group is searchable. Default is False meaning the group is searchable.

auto_join

Optional boolean. Only applies to org accounts. If True, this group will allow joining without requesting membership approval. Default is False.

provider_group_name

Optional string. The name of the domain group. Create an association between a Portal group and an Active Directory or LDAP group.

provider

Optional string. Name of the provider. Required if the parameter provider_group_name is specified. Example of use: provider_group_name = “groupNameTest”, provider = “enterprise”

max_file_size

Optional integer. This is the maximum file size allowed be uploaded/shared to a group. Default value is: 1024000

users_update_items

Optional boolean. Members can update all items in this group. Updates to an item can include changes to the item’s description, tags, metadata, as well as content. This option can’t be disabled once the group has been created. Default is False.

display_settings

Optional String. Defines the default display for the group page to show a certain type of items. The allowed values are: apps, all, files, maps, layers, scenes, tools. The default value is all.

is_open_data

Optional Boolean. Defines whether the group can be used in the Open Data capabilities of ArcGIS Hub. The default is False.

leaving_disallowed

Optional boolean. Defines whether users are restricted from choosing to leave the group. If True, only an administrator can remove them from the group. The default is False.

Returns

The Group if successfully created, None if unsuccessful.

# Usage Example
>>> gis.groups.create(title = "New Group", tags = "new, group, USA",
>>>                     description = "a new group in the USA", access = "public")
create_from_dict(dict)

The create_from_dict method creates a group via a dictionary with the values for any particular arguments that are specified.

Note

Only title and tags are required.

Argument

Description

dict

Required dictionary. A dictionary of entries to create/define the group. See help of the create method for parameters.

Returns

The Group if successfully created, None if unsuccessful.

get(groupid)

The get method retrieves the Group object for the specified groupid.

Argument

Description

groupid

Required string. The group identifier.

Returns

The Group object if the group is found, None if it is not found.

search(query='', sort_field='title', sort_order='asc', max_groups=1000, outside_org=False, categories=None)

The search method searches for portal groups.

Note

A few things that will be helpful to know.

  1. The group search syntax has many features that can’t be adequately described here. See the Search Reference page in the ArcGIS REST API for more information.

  2. Searching without specifying a query parameter returns a list of all groups in your organization.

  3. Most of the time when searching for groups, you’ll want to search within your organization in ArcGIS Online or within your Portal. As a convenience, the method automatically appends your organization id to the query by default. If you don’t want the API to append to your query set outside_org to True.

Argument

Description

query

Optional string on Portal, or required string for ArcGIS Online. If not specified, all groups will be searched. See notes above.

sort_field

Optional string. Valid values can be title, owner, created.

sort_order

Optional string. Valid values are asc or desc.

max_groups

Optional integer. Maximum number of groups returned, default is 1,000.

outside_org

Optional boolean. Controls whether to search outside your org. Default is False, do not search ourside your org.

categories

Optional string or list. A string of category values.

Returns

A List of Group objects matching the specified query.

# Usage Example

>>> gis.groups.search(query ="Hurricane Trackers", categories = "Hurricanes, USA, Natural Disasters",
>>>                   sort_field="title", sort_order = "asc")

GroupMigrationManager

class arcgis.gis.GroupMigrationManager(group)

Bases: object

The GroupMigrationManager class allows groups to export and import data to and from EPK files.

create(items=None, future=True)

The create method exports a Group content to an EPK Package Item. EPK Items are intended to migrate content from an enterprise deployment to a new enterprise. Once an EPK Item is created using this method, you can use the load to ingest the package’s content into the target enterprise. If your package contains web maps, web-mapping applications, and/or associated web layers, during the import operation, the method will takes care of swizzling the service URLs and item IDs correctly. .. note:

There are some limits to this functionality. Packages should be under 10 GB in size
and only hosted feature layers, web maps, web-mapping apps, and other text-based
items are supported. You need to have **administrative** privileges to run this
operation.

Argument

Description

items

Optional List<Item>. A set of items to export from the group. If nothing is given, all items will be attempted to be exported.

future

Optional Boolean. When True, the operation will return a Job object and return the results asynchronously.

Returns

Item –or– StatusJob when future=True

inspect(epk_item)

The inspect method retrieves the contents of the EPK Package ================ =============================================================================== Keys Description —————- ——————————————————————————- epk_item Required Item. A report on the content of the EPK Item. This allows administrators

to view the contents inside a EPK.

load(epk_item, item_ids=None, overwrite=True, future=True, folder_id=None, folder_owner=None)

The load method imports the EPK content into the current Group. .. note:

Administrative privileges are required to run this operation.
Once imported, items will be owned by the importer, and will have
to be manually reassigned to the proper owner if needed.

Keys

Description

epk_item

Required Item. A report on the content of the EPK Item. This allows administrators to view the contents inside a EPK.

item_ids

Optional list. A list of item IDs to import to the organization.

overwrite

Optional bool. If the Items import exist, or the Item ID that is in use already, it will delete the old item and replace it with this one.

future

Optional bool. When True, the load will return a Job object and will not pause the current thread. When False load will occur in a synchronous fashion pausing the thread. If you are loading large amounts of data, set future to True to reduce time.

folder_id

Optional String. In ArcGIS Online and Enterprise 10.9+, a user can specify the destination folder ID for the items.

folder_owner

Optional String. In ArcGIS Online and Enterprise 10.9+, a user name of the folder owner.

Returns

A dictionary –or– StatusJob when future=True

DatastoreManager

class arcgis.gis.DatastoreManager(gis, admin_url, server)

Bases: object

The DatastoreManager class is a helper class for managing the GIS data stores in ArcGIS Enterprise. Instances of this class are returned from get_datastores and Datastore functions to get the corresponding datastores. Users call methods on this Datastore object to manage the datastores in a site federated with the Enterprise portal.

Note

This class is not created by users directly.

add(name, item)

The add method registers a new data Item with the:class:~arcgis.gis.Datastore.

Argument

Description

name

Required string. The name of the item to be added on the server.

item

Required dictionary. The dictionary representing the data item. See Data Item in the ArcGIS REST ApI documentation for more details.

Returns

The new data Item if registered successfully, None otherwise.

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add("name", {})
add_amazon_s3(name, bucket_name, access_key, access_secret, region, folder=None, default_protocal='https')

Allows administrators to registered Amazon S3 Buckets as a Datastore object.

Argument

Description

name

Required string. The name of the Amazon S3 instance.

bucket_name

Required String. The name of the S3 bucket.

access_key

Required String. The key value for the S3 Bucket.

access_secret

Required String. The access secret value for the S3 bucket.

region

Required String. The Amazon region as a string.

folder

Optional String. The S3 folder within the S3 Bucket.

default_protocal

Optional String. The URL scheme to contact the S3 bucket.

Returns

A Datastore object

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_amazon_s3("bucket_name", "access_key", "access_secret", "region")
add_bigdata(name, server_path=None, connection_type='fileShare')

The add_bigdata method registers a bigdata fileshare with the Datastore.

Argument

Description

name

Required string. The unique bigdata fileshare name on the server.

server_path

Optional string. The path to the folder from the server.

connection_type

Optional string. Allows for the setting of the types of big data store. The value ‘fileShare’ is used for local big data stores, and for cloud stores, the connection_type should be ‘dataStore’. The value ‘fileShare’ is the default value.

Returns

The big data fileshare if registered successfully, None otherwise.

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_bigdata("name")
add_cloudstore(name, conn_str, object_store, provider, managed=False, folder=None)

The add_cloudstore method adds a Cloud Store data Item. Cloud Store data item represents a connection to a Amazon or Microsoft Azure store. Connection information for the data store item is stored within conn_str as a stringified JSON. ArcGIS Server encrypts connection string for storage. Connection strings that are encrypted will include a {crypt} prefix.

Note

You can get a Datastore item with decrypted connection string by passing a decrypt=true parameter in the request for a data store item. Data store with decrypted connection string will be returned only for requests made with https. The examples below show data stores with decrypted conn_str. A valid object_store (S3 bucket or Azure Blob store) is required. Folders within an object store are optional.

Argument

Description

name

Required string. The name of the cloud store.

conn_str

Required string. The connection information for the cloud storage product.

object_store

Required string. This is the amazon bucket path or Azuze path.

provider

Required string. Values must be azuredatalakestore, amazon, Alibaba, or azure.

managed

Optional boolean. When the data store is server only, the database is entirely managed and owned by the server and cannot be accessed by the publisher directly. When this option is chosen, the managed property should be set to true. Otherwise it is false.

folder

Optional string. For some Azure cloud stores, an optional folder can be specified.

Returns

A Datastore object

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_cloudstore("name", "connection_info", "path", "provider")
add_database(name, conn_str, client_conn_str=None, conn_type='shared')

The add_database method registers a database with the Datastore.

Argument

Description

name

Required string. The unique database name on the server.

conn_str

Required string. the path to the folder from the server (and client, if shared or serverOnly database).

client_conn_str

Optional string. The connection string for client to connect to replicated enterprise database.

conn_type

Optional string. Choice of “<shared|replicated|serverOnly>”, shared is the default.

Returns

The database if registered successfully, None otherwise.

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_databse("name", "connection_info")
add_folder(name, server_path, client_path=None)

The add_folder method registers a folder with the Datastore.

Argument

Description

name

Required string. The unique fileshare name on the server.

server_path

Required string. The path to the folder from the server (and client, if shared path).

client_path

Optional string. If folder is replicated, the path to the folder from the client.

Returns

The folder if registered successfully, None otherwise.

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_folder("fileshare name", "folder_path", "clienth_path")
add_ms_azure_storage(cloud_storage_name, account_key, account_name, container_name, folder=None)

The add_ms_azure_storage creates a cloud store with Microsoft Azure.

Argument

Description

cloud_storage_name

Required string. The name of the storage entry.

access_key

Required String. The key value for the Azure storage.

access_secret

Required String. The access secret value for the Azure storage.

container_name

Required String. The container holding the data.

folder

Optional String. The Azure folder within the datastore item.

Returns

A Datastore object

# Usage Example
>>> arcgis.geoanalytics.get_datastores.add_ms_azure_storage("name", "key", "secret", "cont_name")
property config

The config method retrieves and sets the data store configuration properties, which affect the behavior of the data holdings of the server. The properties include blockDataCopy. When this property is False, or not set at all, copying data to the site when publishing services from a client application is allowed. This is the default behavior. When this property is True, the client application is not allowed to copy data to the site when publishing. Rather, the publisher is required to register data items through which the service being published can reference data.

Argument

Description

value

Required bool. Values: True | False .. note:

If you specify the property as ``True``, users will not be able
to publish ``geoprocessing services`` and ``geocode services``
from composite locators. These service types require data to be
copied to the server.
As a workaround, you can temporarily set the property to ``False``,
publish the service, and then set the property back to ``True``.
Returns

A Dictionary indicating ‘success’ or ‘error’

get(path)

The get method retrieves the data Item object at the given path.

Argument

Description

path

Required string. The path for the data item.

Returns

The data item object if found, None otherwise.

search(parent_path=None, ancestor_path=None, types=None, id=None)

The search method is used to search through the various data items registered in the server’s data store. Searching without specifying the parent path and other parameters returns a list of all registered data items.

Argument

Description

parentPath

Optional string. The path of the parent under which to find items. Pass ‘/’ to get the root data items.

ancestorPath

Optional string. The path of the ancestor under which to find items.

types

Optional string. A comma separated filter for the type of the items. Types include folder, egdb, bigDataFileShare, datadir.

id

Optional string. A filter to search by the ID of the item.

Returns

A list of data items matching the specified query.

# Usage Example
>>> arcgis.geoanalytics.get_datastores.search(parentPath= "parent_path",
ancestorPath= "ancestor_path", id="id")
validate()

The validate method validates all items in the Datastore. In order for a data item to be registered and used successfully within the GIS’s data store, you need to make sure that the path (for file shares) or connection string (for databases) is accessible to every server node in the site. To validate all registered data items all at once, you can invoke this operation.

Returns

A boolean indicating successful validation (True), or failed validation (False)

RoleManager

class arcgis.gis.RoleManager(gis)

Bases: object

The RoleManager class is a helper class to manage custom roles for User in a GIS. It is available as the roles property of the UserManager

Note

Users don’t create this class directly.

# Usage Example

>>> role_mgr = gis.users.roles
>>> type(role_mgr)

<class 'arcgis.gis.RoleManager'>
all(max_roles=1000)

The all method provides a list containing the default Viewer and Data Editor roles, plus any custom roles defined in the GIS. (The org_admin, org_user, and org_publisher default roles are not returned. See Default roles for detailed descriptions of each role.)

Argument

Description

max_roles

Required integer. The maximum number of roles to be returned, defaults to 1000.

Returns

The list of all custom roles, plus the default Viewer and Data Editor roles defined in the GIS.

 # Usage Example

 >>> primary_default_roles = ['org_admin', 'org_publisher', 'org_user']

 >>> role_mgr = gis.users.roles
 >>> org_roles = role_mgr.all()

 >>> for role in org_roles:
     print(f"{role.name:25}{role.role_id}"

     Viewer                   iAAAAAAAAAAAAAAA
     Data Editor              iBBBBBBBBBBBBBBB
     Analyzer                 8KqWobO1p1vDLZ2O
     Sharing_analyst          ZllNulU2kqaFwsaH
     Group_creator            uT3334C4LtnQ99Cj

 >>> all_org_roles = primary_default_roles + [r.name for r in org_roles]
 >>> print(all_org_roles)

     ['org_admin', 'org_publisher', 'org_user', 'Viewer', 'Data Editor', 'Analyzer', 'Sharing_analyst', 'Group_creator']

See the create method of UserManager for using role information when creating users.

create(name, description, privileges=None)

The create method creates a custom Role with the specified parameters.

Argument

Description

name

Required string. The custom role’s name.

description

Required string. The custom role’s description.

privileges

Optional string. An array of strings with predefined permissions within each privilege. For supported privileges see the Privileges page in the ArcGIS REST API documentation.

Returns

The custom role object if successfully created, None if unsuccessful.

# Usage Example
>>> role_mgr = gis.users.roles
>>> role_mgr.create("name_role", "role_description")
exists(role_name)

The exists method checks to see if a Role object exists given the declared role name.

Argument

Description

role_name

Required string. The name of the role to determine if it exists or not.

Returns

True if the role exists, and False if it does not.

# Usage Example

>>> role_mgr = gis.users.roles
>>> role_mgr.exists("name_role")
get_role(role_id)

The get_role method retrieves the Role object with the specified custom roleId.

Argument

Description

role_id

Required string. The role ID of the custom role to get.

Returns

The Role object associated with the specified role ID

ResourceManager

class arcgis.gis.ResourceManager(item, gis)

Bases: object

The ResourceManager class is a helper class for managing resource files of an item. An instance of this class is available as a property of the Item object (See resources for more information on this property). Users call methods on this resources object to manage (add, remove, update, list, get) item resources.

Note

Users do not create this class directly.

add(file=None, folder_name=None, file_name=None, text=None, archive=False, access=None, properties=None)

The add operation adds new file resources to an existing item. For example, an image that is used as custom logo for Report Template. All the files are added to ‘resources’ folder of the item. File resources use storage space from your quota and are scanned for viruses. The item size is updated to include the size of added resource files.

Note

Each file added should be no more than 25 Mb.

Supported item types that allow adding file resources are: Vector Tile Service, Vector Tile Package, Style, Code Attachment, Report Template, Web Mapping Application, Feature Service, Web Map, Statistical Data Collection, Scene Service, and Web Scene.

Supported file formats are: JSON, XML, TXT, PNG, JPEG, GIF, BMP, PDF, MP3, MP4, and ZIP. This operation is only available to the item owner and the organization administrator.

Argument

Description

file

Optional string. The path to the file that needs to be added.

folder_name

Optional string. Provide a folder name if the file has to be added to a folder under resources.

file_name

Optional string. The file name used to rename an existing file resource uploaded, or to be used together with text as file name for it.

text

Optional string. Text input to be added as a file resource, used together with file_name. If this resource is used, then file_name becomes required.

archive

Optional boolean. Default is False. If True, file resources added are extracted and files are uploaded to respective folders.

access

Optional String. Set file resource to be private regardless of the item access level, or revert it by setting it to inherit which makes the item resource have the same access as the item.

Supported values: private or inherit.

properties

Optional Dictionary. Set the properties for the resources such as the editInfo.

Returns

Python dictionary in the following format (if successful): {

”success”: True, “itemId”: “<item id>”, “owner”: “<owner username>”, “folder”: “<folder id>”}

else like the following if it failed: {“error”: {

”code”: 400, “messageCode”: “CONT_0093”, “message”: “File type not allowed for addResources”, “details”: [] }}

# Usage Example

>>> Item.resources.add("file_path", "folder_name", "file_name", access = "private")

export(save_path=None, file_name=None)

The export method export’s the data’s resources as a zip file

# Usage Example

>>> Item.resources.export("file_name")
Returns

A .zip file containing the data’s resources

get(file, try_json=True, out_folder=None, out_file_name=None)

The get method retrieves a specific file resource of an existing item.

Note

This operation is only available to the item owner and the organization administrator.

Argument

Description

file

Required string. The path to the file to be downloaded. For files in the root, just specify the file name. For files in folders (prefixes), specify using the format <foldername>/<foldername>./../<filename>

try_json

Optional boolean. If True, will attempt to convert JSON files to Python dictionary objects. Default is True.

out_folder

Optional string. Specify the folder into which the file has to be saved. Default is user’s temporary directory.

out_file_name

Optional string. Specify the name to use when downloading the file. Default is the resource file’s name.

Returns

Path to the downloaded file if getting a binary file (like a jpeg or png file) or if try_jon = False when getting a JSON file.

If file is a JSON, returns as a Python dictionary.

# Usage Example

>>> Item.resources.get("file_path", try_json=True, out_folder="out_folder_name")
list()

The list method provides a lists all file resources of an existing item.

Note

This resource is only available to the item owner and the organization administrator.

Returns

A Python list of dictionaries of the form: [

{

“resource”: “<resource1>”

}, {

”resource”: “<resource2>”

}, {

”resource”: “<resource3>”

}

]

remove(file=None)

The remove method removes a single resource file or all resources. The item size is updated once resource files are deleted.

Note

This operation is only available to the item owner and the organization administrator.

Argument

Description

file

Optional string. The path to the file to be removed. For files in the root, just specify the file name. For files in folders (prefixes), specify using the format <foldername>/<foldername>./../<filename>

If not specified, all resource files will be removed.

Returns

If successful, a boolean of True will be returned.

Else, a dictionary with error information will be returned in the following format: {“error”: {“code”: 404,

”message”: “Resource does not exist or is inaccessible.”, “details”: []

}

}

# Usage Example

>>> Item.resources.remove("file_path")
update(file, folder_name=None, file_name=None, text=None)

The update operation allows you to update existing file resources of an item. File resources use storage space from your quota and are scanned for viruses. The item size is updated to include the size of updated resource files.

Supported file formats are: JSON, XML, TXT, PNG, JPEG, GIF, BMP, PDF, and ZIP. This operation is only available to the item owner and the organization administrator.

Argument

Description

file

Required string. The path to the file on disk to be used for overwriting an existing file resource.

folder_name

Optional string. Provide a folder name if the file resource being updated resides in a folder.

file_name

Optional string. The destination name for the file used to update an existing resource, or to be used together with the text parameter as file name for it.

For example, you can use fileName=banner.png to update an existing resource banner.png with a file called billboard.png without renaming the file locally.

text

Optional string. Text input to be added as a file resource, used together with file_name.

Returns

If successful, a dictionary with will be returned in the following format: {

”success”: True, “itemId”: “<item id>”, “owner”: “<owner username>”, “folder”: “<folder id>” }

else a dictionary with error information will be returned in the following format: {“error”: {

”code”: 404, “message”: “Resource does not exist or is inaccessible.”, “details”: [] } }

# Usage Example

>>> Item.resources.add("file_path", "folder_name", "file_name")

APIKeyManager

class arcgis.gis._impl.APIKeyManager(gis)

Bases: object

The APIKeyManager creates, manages and updates APIKey objects for ArcGIS Online.

create(title, tags, description=None, http_referers=None, redirect_uris=None, privileges=None)

The create method generates a new APIKey objects for the Organization.

Parameter

Description

title

Required String. The name of the API Key Item.

tags

Required String. A comma seperated list of descriptive words describing the API Key item.

description

Optional String. A description of what the API Key is going to be used for.

http_referers

Optional List. A list of the http referrers for which usage of the API Key will be restricted to.

Example

` [ "https://foo.com", "https://bar.com" ] `

Note: Http Referrers can be configured for non apiKey type apps as well. The list configured here will be used to validate the app tokens sent in while accessing the sharing API. The referrer checks will not be applied to user tokens.

redirect_uris

Optional list. The URIs where the access_token or authorization code will be delivered upon successful authorization. The redirect_uri specified during authorization must match one of the registered URIs, otherwise authorization will be rejected.

A special value of urn:ietf:wg:oauth:2.0:oob can also be specified for authorization grants. This will result in the authorization code being delivered to a portal URL (/oauth2/approval). This value is typically used by apps that don’t have a web server or a custom URI scheme where the code can be delivered.

The value is a JSON string array.

privileges

Optional List. A list of the privileges that will be available for this API key.

Note

Privileges can be configured for non API Key type apps as well. The list configured here will be used to grant access to items when item endpoint is accessed with app tokens. The checks will not be applied to user tokens and they can continue accessing items based on the current item sharing model. With app tokens, all items of app owner can be accessed if the privileges list is not configured.

Returns

An APIKey object

# Usage Example

>>> gis.api_keys.create(title ="title_name", tags = "tags, apiKey, Manager",
>>>                     http_referers = ["https://foo.com", "https://bar.com"],
>>>                     privleges = ["portal:apikey:basemaps", "portal:app:access:item:itemId",
>>>                                        "premium:user:geocode", "premium:user:networkanalysis"])
get(api_key=None, title=None)

The get method retrieves an APIKey object based on the Key Value or its title.

# Usage Example - Getting API Key using key string

>>> gis.api_keys.get(api_key='key_string')

# Getting api key using key Item's title

>>> gis.api_keys.get(title='project1_key1')
Returns

An APIKey object

property keys

The keys property retrieves a tuple of APIKey objects registered with the Organization.

Returns

A tuple of APIKey objects

validate(api_key, privileges=None)

The validate method checks if an APIKey object has a specific privilege.

Parameter

Description

api_key

Required APIKey. The key to validate against.

privileges

Optional List. The list of the privileges to check for. The list consists of a list of string values.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.APIKeyManager.validate(ApiKey1)

APIKey

class arcgis.gis._impl.APIKey(item, gis)

Bases: object

The APIKey class is a single instance of a registered access key for performing certain operations based on permissions.

Users can create an APIKey instance as shown below:

# Getting from a list of keys
>>> key1 = gis.api_keys.keys[0]

# Getting a key using
>>> key2 = gis.api_keys.get('key_value')
property apikey

The apikey property retrieves the API Key value for the current key.

Returns

String

delete()

The delete method deletes the current APIKey object permanently.

Returns

A boolean indicating success (True), or failure (False)

property properties

The properties property retrieves the properties of the current APIKey object.

Returns

A dictionary containin the properties (if any) of the current APIKey object.

reset()

Resets the API Key for the Item. The call will return the information with the new API Key information.

Returns

A dictionary with the APIKey object information

update(http_referers=None, privileges=None)

The update method updates the current APIKey object’s properties

Parameter

Description

http_referers

Optional List. A list of the http referrers for which usage of the API Key will be restricted to.

Example

` [ "https://foo.com", "https://bar.com" ] `

Note: Http Referrers can be configured for non apiKey type apps as well. The list configured here will be used to validate the app tokens sent in while accessing the sharing API. The referrer checks will not be applied to user tokens.

privileges

Optional List. A list of the privileges that will be available for this API key.

Example

```

[ “portal:apikey:basemaps”, “portal:app:access:item:itemId”, “premium:user:geocode”, “premium:user:networkanalysis” ]

```

Note: Privileges can be configured for non API Key type apps as well. The list configured here will be used to grant access to items when item endpoint is accessed with app tokens. The checks will not be applied to user tokens and they can continue accessing items based on the current item sharing model. With app tokens, all items of app owner can be accessed if the privileges list is not configured.

Returns

A dictionary

# Usage Example

>>> key1 = gis.api_keys.keys[0]
>>> key1.update(http_referers = ["https://foo.com", "https://bar.com"],
>>>                 privileges = ["portal:apikey:basemaps",
>>>                               "portal:app:access:item:itemId",
>>>                               "premium:user:geocode",
>>>                               "premium:user:networkanalysis"])

ProfileManager

class arcgis.gis._impl._profile.ProfileManager

Bases: object

The ProfileManager class allows for the controls and management of the profiles stored on the local operating system.

create(profile, url=None, username=None, password=None, key_file=None, cert_file=None, client_id=None)

The create method adds a new entry into the Profile Store.

Parameter

Description

profile

Required String. The name of the profile to add.

url

Optional String. The site url.

username

Optional String. The login user name.

password

Optional String. The login user password.

key_file

Optional String. The key file for PKI security.

cert_file

Optional String. The cert file for PKI security.

client_id

Optional String. The client ID for oauth login.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.ProfileManager.create("profile_name",
>>>                           url= "www.foo.com",
>>>                           username = "User1234",
>>>                           password = "Password1234",
>>>                           key_file = "key_file",
>>>                           cert_fle = "cert_file_name")
delete(profile)

The delete method deletes a profile permanently from the .arcgisprofile file

Parameter

Description

profile

Required String. The name of the profile to delete.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.ProfileManager.delete("profile_name")
get(profile)

The get method retrieves the profile information for a given entry.

Parameter

Description

profile

Required String. The name of the profile to get the information about.

Returns

A dictionary

# Usage Example

>>> gis.ProfileManager.get("profile_name")
list(as_df=False)

The list method retrieves a list of profile names in the configuration file

Returns

List if as_df=False or Pandas DataFrame if as_df=True

save_as(profile, gis)

The save_as method saves and adds the provided GIS object to the profile.

Parameter

Description

name

Required String. The name of the profile to save.

gis

Required GIS. The connection object to update the profile with.

Returns

Boolean. True if successful else False

# Usage Example

>>> gis = GIS("pro")
>>> gis.ProfileManager.save_as("Profile_name", gis)
update(profile, url=None, username=None, password=None, key_file=None, cert_file=None, client_id=None)

The update method updates an existing profile in the credential manager.

Parameter

Description

profile

Required String. The name of the profile to update.

url

Optional String. The site url.

username

Optional String. The login user name.

password

Optional String. The login user password.

key_file

Optional String. The key file for PKI security.

cert_file

Optional String. The cert file for PKI security.

client_id

Optional String. The client ID for oauth login.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.ProfileManager.update(profile = "profile_name1",
>>>                           username = "User12345",
>>>                           key_file = "new_key_file")

InvitationManager

class arcgis.gis._impl._invitations.InvitationManager(url, gis)

Bases: object

The InvitationManager provides functionality to see the existing invitations set out via email to your organization.

Note

The manager has the ability to delete any invitation sent out by an organization.

delete(invite_id)

The delete method deletes an invitation by ID

Returns

A boolean indicating success (True), or failure (False)

get(invite_id)

The get method retrieves information about a single invitation.

Returns

A dictionary

list()

The list method retrieves all the organization’s invitations.

Returns

A List of the organization’s invitations

manage_invitations(accepts=None, declines=None)

The manage_invitations method allows users to Accept/Decline invitations by providing a list of invitation IDs.

Returns

A List of invitation IDs

CertificateManager

class arcgis.gis._impl.CertificateManager(gis)

Bases: object

The CertificateManager class provides the administrator the ability to register and unregister certificates with the GIS.

Note

This resource is available via HTTPS only.

add(name, domain, certificate)

The add method allows allows administrators to register custom X.509 HTTPS certificates with their ArcGIS Online organizations. This will allow ArcGIS Online organization to trust the custom certificates used by a remote server when making HTTPS requests to it, i.e. store credentials required to access its resource and share with others.

Note

A maximum of 5 certificates can be registered with an organization.

Parameter

Description

name

Required String. The certificate name.

domain

Required String. Server domain that the certificate is used for.

certificate

Required String. Base64-encoded certificate text, enclosed between

—–BEGIN CERTIFICATE—– and —–END CERTIFICATE—–.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.admin.certificates.add(name="certificate_name",
>>>                            domain = "domain_name",
>>>                            certificate = "certificate_text")
property certificates

The certificates property retrieves the list of certificates registered with the organization

Returns

A List containing the information of registered certificates

delete(cert_id)

The delete method unregisters the certificate from the organization.

Parameter

Description

cert_id

Required String. The ID of the certificate to delete.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.admin.certificates.delete(cert_id="certificate_id")
get(cert_id)

The get method retrieves the certificate information for a single certificate

Parameter

Description

cert_id

Required String. The ID of the certificate to delete.

# Usage Example

>>> gis.admin.certificates.get(cert_id= "certificate_id")
Returns

A Dictionary (if found), else None

The dictionary contains the following information:

Key

Value

id

The ID of the registered certificate.

name

The certificate name.

domain

Server domain that the certificate is used for.

sslCertificate

Base64-encoded certificate text, enclosed between —–BEGIN CERTIFICATE—– and —–END CERTIFICATE—–.

property properties

The properties method retrieves the properties of the certificate

Returns

A list of the certificate properties

update(cert_id, name=None, domain=None, certificate=None)

The update operation allows organization’s administrators to update a registered custom X.509 HTTPS certificate.

Parameter

Description

cert_id

Required String. The ID of the certificate to delete.

name

Optional String. The certificate name.

domain

Optional String. Server domain that the certificate is used for.

certificate

Optional String. Base64-encoded certificate text, enclosed between `

—–BEGIN CERTIFICATE—–` and —–END CERTIFICATE—–.

Returns

A boolean indicating success (True), or failure (False)

# Usage Example

>>> gis.admin.certificates.update(cert_id ="certificate_id",
>>>                               name = "certificate_name",
>>>                               domain ="certificate_domain",
>>>                               certificate = "certificate_text")

PortalDataStore

class arcgis.gis._impl._datastores.PortalDataStore(url, gis)

Bases: object

The PortalDatastore provides access to operations that allow you to do the following:

  • Validate a data store against your server.

  • Register a data store to your server.

  • Retrieve a list of servers your data store is registered to.

  • Refresh your data store registration information in the server.

  • Unregister a data store from your server.

Note

Users also have the ability to bulk publish layers from a Datastore object, retrieve a list of previously published layers, and delete bulk-published layers.

delete_layers(item)

The delete_layers method removes all layers published from the Datastore object.

Note

Before a Datastore object can be unregistered from a server, all of its bulk-published layers must be deleted.

Argument

Description

item

Required Item. The Datastore to delete all published layers.

# Usage Example

>>> datastore_manager.delete_layers(datastore_object)
Returns

A boolean indicating success (True), or failure (False)

describe(item, server_id, path, store_type='datastore')

The describe method is used to list the contents of a data store. A client can use it multiple times to discover the contents of the data store incrementally. For example, the client can request a description of the root, and then request sub-folders.

Argument

Description

item

Required Item. The Item to describe.

server_id

Optional String. The unique id of the registered server.

path

Optional String. The path to examine the data in.

store_type

Optional String. For root resource the object type should be datastore, and for sub-folders, the object type should be listed as folder.

# Usage Example

>>> datastore_manager.describe(item= datastore_object1, server_id="server_name", path = "path_name")
Returns

A StatusJob object

layers(item)

The layers operation returns a list of layers bulk published from a Datastore with the publish_layers method.

Note

The layers method returns an list of tuples, with each tuple containing two objects: a layer and the dataset it was published from.

Argument

Description

item

Required Item. The Data Store Item to list all published layers and registered datasets.

# Usage Example

>>> datastore_manager.layers(datastore_object1)
Returns

A List of bulk-published Layer objects

property properties

The properties property retrieves the properties of the current DataStore object

Returns

A list of the DataStore object properties

publish(config, server_id, folder=None, description=None, tags=None)

The publish operation is used to publish scene layers by reference to data in a Datastore.

Argument

Description

config

Required Dictionary. This is the service configuration property and it must contain the reference to the data in the data store. It specifies the data store Id and the path of the data. A client can discover the proper paths of the data by using the describe method.

Example: {“type”:”SceneServer”,”serviceName”:”sonoma”,”properties”:{“pathInCachedStore”:”/v17_i3s/SONOMA_LiDAR.i3srest”,”cacheStoreId”:”d7b0722fb42c494392cb1845dacc00d9”}}

server_id

Required String. The unique Id of the server to publish to.

folder

Optional String. The name of the folder on server to place the service. If none is provided, it is placed in the root.

description

Optional String. An optional string to attached to the Item generated.

tags

Optional list. An array of descriptive words that describes the newly published dataset. This will be added to the Item

# Usage Example

>>> datastore_manager.publish(config= {"required" : "dictionary"}, server_id= "server_name")
Returns

A StatusJob object

publish_layers(item, srv_config, server_id, folder=None, server_folder=None, future=False)

The publish_layers operation publishes, or syncs, the datasets from a DataStore object onto your ArcGIS Server, resulting in at least one Layer per dataset. It is quite similar to the publish method.

Note

When this operation is called for the first time, every parameter in the operation must be passed through. On subsequent calls, publish_layers will synchronize the datasets and created layers, which includes both publishing layers from new datasets and removing layers for datasets no longer found in the data store.

Argument

Description

item

Required Item. The Data Store Item to publish from.

srv_config

Required Dict. The JSON that will be used as a template for all the services that will be published or synced. This JSON can be used to change the properties of the data store’s map and feature services. Only map service configurations with feature services enabled are supported by this parameter.

server_id

Required String. The serverId that the datasets will be published to.

folder

Optional String. The folder to which the datasets will be published.

server_folder

Optional String. The name of the server folder.

future

Optional Boolean. If False, the value is returned, else a StatusJob is returned.

# Usage Example

>>> datastore_manager.publish_layers(datastore_object1, srv_config= {"required" : "dictionary"})
Returns

Boolean when future=False else a StatusJob object

refresh_server(item, server_id)

Th refresh_server method updates the server with newly configured inforamtion.

Note

After a Datastore has been registered, there may be times in which the Datastore object’s registration information may be changed. When changes like these occur, the server will need to be updated with the newly configured information so that your users will still be able to access the data store items without interruption.

Warning

This operation can only be performed after the data store information has been updated.

Argument

Description

item

Required Item/Item Id (as string). The item Id or Item of the data store to register with the server. Note that a data store can be registered on multiple servers.

server_id

Required String. The unique id of the server you want to register the datastore with.

# Usage Example

>>> datastore_manager.refresh_server(datastore_object1, "server_id")
Returns

A boolean indicating success (True), or failure (False)

register(item, server_id, bind=False)

The register method allows for Datastore objects to be added to an ArcGIS Server instance.

Note

Before registering a Datastore, it is recommended that you validate your Datastore with the given server.

Argument

Description

item

Required Item object or Item Id (as string). The item Id or Item of the data store to register with the server. Note that a data store can be registered on multiple servers.

server_id

Required String. The unique id of the server you want to register the datastore with.

bind

Optional Boolean. Specifies whether to bind the data store item to the federated server. For more information about binding a data store to additional federated servers, see the note below. The default value is False.

# Usage Example

>>> datastore_manager.register(datastore_object1, "server_name")
Returns

A boolean indicating success (True), or failure (False)

Note

To create a Datastore object from an existing dataStore, see the Create a data store item from an existing data store page in the ArcGIS Online resources.

servers(item)

The servers property returns a list of your servers that a given data store has been registered to. This operation returns the serverId, the server name, both the server and admin URLs, and whether or not the server is hosted.

Argument

Description

item

Required Item. The DataStore Item object to list all registered servers.

# Usage Example

>>> datastore_manager.servers(datastore_object1)
Returns

A List with the serverID, server name, server URL, and admin URLs

unregister(item, server_id)

The unregister method removes the Datastore association from a server.

# Usage Example

>>> datastore_manager.unregister(datastore_object1, "server_id")
Returns

A boolean indicating success (True), or failure (False)

validate(server_id, item=None, config=None, future=False)

The validate method ensures that your ArcGIS Server can connect and use the datasets stored within a given data store. A Datastore can be validated by using either its datastoreId or the JSON for an unregistered Datastore.

Note

While this operation can be called before or after the Datastore has been registered with your server, it is recommended that the validate operation is performed beforehand.

Argument

Description

server_id

Required String. The unique id of the server you want to register the datastore with.

item

Optional Item/Item Id (as string). The item Id or Item of the data store to register with the server. Note that a data store can be registered on multiple servers.

config

Optional dict. The connection information for a new datastore.

# Usage Example

>>> datastore_manager.validate("server_name")
Returns

A boolean indicating success (True), or failure (False)

Submodules

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.