Copy a hosted layer item

You need an access token with the correct privileges for in this tutorial.

1. Go to the Create an API key tutorial and create an API key with the following privilege(s):

   • Privileges

     • Admin privileges > Content > View all
     • Admin privileges > Content > Update

To perform the portal service operation in this tutorial, you need an access token from OAuth 2.0 credentials. It is the only supported form of authentication. The use of API keys is not supported.

1. Go to the Create OAuth credentials for user authentication tutorial to get a set of OAuth 2.0 credentials.

2. Get an access token from the OAuth 2.0 credentials.

3. Copy the access token to your clipboard when prompted.

1. Install the ArcGIS API for Python.
2. Start your Jupyter Notebook environment locally.

1. To get started, use this pen.

1. Add the following import statement to your code.
   rest-js.js

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   
   import { ApiKeyManager } from '@esri/arcgis-rest-request';
   import { getItem, addItem, getItemData, setItemData } from '@esri/arcgis-rest-portal';
   
   
2. Establish a connection to the portal.
   rest-js.js

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   
   import { ApiKeyManager } from '@esri/arcgis-rest-request';
   import { getItem, addItem, getItemData, setItemData } from '@esri/arcgis-rest-portal';
   
   const apiKey = "YOUR_ACCESS_TOKEN";
   const authentication = ApiKeyManager.fromKey(apiKey);
   
   
3. Get the item and associated data.
   rest-js.js

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   
   import { ApiKeyManager } from '@esri/arcgis-rest-request';
   import { getItem, addItem, getItemData, setItemData } from '@esri/arcgis-rest-portal';
   
   const apiKey = "YOUR_ACCESS_TOKEN";
   const authentication = ApiKeyManager.fromKey(apiKey);
   
   // Get the feature layer item details
   const itemDetails = await getItem(featureLayerItemId, { authentication });
   const itemData = await getItemData(featureLayerItemId, { authentication });
   
   
4. Define properties of a new item and add the new item using the addItem method.
   rest-js.js

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   
   import { ApiKeyManager } from '@esri/arcgis-rest-request';
   import { getItem, addItem, getItemData, setItemData } from '@esri/arcgis-rest-portal';
   
   const apiKey = "YOUR_ACCESS_TOKEN";
   const authentication = ApiKeyManager.fromKey(apiKey);
   
   // Get the feature layer item details
   const itemDetails = await getItem(featureLayerItemId, { authentication });
   const itemData = await getItemData(featureLayerItemId, { authentication });
   
   // Create a new item by copying details from the existing item
   const newItem = await addItem({
     item: {
       title: `Copy of ${itemDetails.title}`,
       type: itemDetails.type,
       description: itemDetails.description,
       tags: itemDetails.tags,
       snippet: itemDetails.snippet,
       extent: itemDetails.extent,
       spatialReference: itemDetails.spatialReference,
       typeKeywords: itemDetails.typeKeywords,
       url: itemDetails.url, // Include the URL to retain the feature service URL
     },
     authentication,
   });
   
   
5. Set the underlying data for the newly added item.
   rest-js.js

   Use dark colors for code blocks

   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   
   import { ApiKeyManager } from '@esri/arcgis-rest-request';
   import { getItem, addItem, getItemData, setItemData } from '@esri/arcgis-rest-portal';
   
   const apiKey = "YOUR_ACCESS_TOKEN";
   const authentication = ApiKeyManager.fromKey(apiKey);
   
   // Get the feature layer item details
   const itemDetails = await getItem(featureLayerItemId, { authentication });
   const itemData = await getItemData(featureLayerItemId, { authentication });
   
   // Create a new item by copying details from the existing item
   const newItem = await addItem({
     item: {
       title: `Copy of ${itemDetails.title}`,
       type: itemDetails.type,
       description: itemDetails.description,
       tags: itemDetails.tags,
       snippet: itemDetails.snippet,
       extent: itemDetails.extent,
       spatialReference: itemDetails.spatialReference,
       typeKeywords: itemDetails.typeKeywords,
       url: itemDetails.url, // Include the URL to retain the feature service URL
     },
     authentication,
   });
   
   // Set the data for the new item
   await setItemData({
     id: newItem.id,
     authentication,
     data: itemData,
   });
   console.log(`Successfully cloned the feature layer. New item ID: ${newItem.id}`);