Find Items

URL:
https://<root>/data/findItems
Methods:
POST
Required Capability:
Access allowed with the "Update" privilege, or the Publisher role
Version Introduced:
10.9

Description

The findItems operation searches the various data items registered to the data store and returns a list of items found at a specified location. The list of items is dynamic, as the results can be fine-tuned to return items with a certain item type or item ID. At least one of the parameters below must be defined for this operation to run successfully.

Request parameters

ParameterDetails

parentPath

(Optional)

The main path used to find items.

ancestorPath

(Optional)

The related path used to find items.

types

(Optional)

A filter to search by the types of items.

id

(Optional)

A filter to search by the ID of an item.

isManaged

(Optional)

Specifies whether the data store is system managed (true).

Values: true | false

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the findItems operation:

1
2
3
4
5
6
POST /context/admin/datas/findItems HTTP/1.1
Host: organization.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

parentPath=&ancestorPath=&types=egdb&id=&isManaged=true&f=pjson&token=Mb0ORrkLObNO2Q8FZoUCHHzSMzZi0CbhLHNRYMqqa6URG_ojQJF3rNsJAfRB23MyCrLwSmuaHPUo4AEIrUuoH1-4Ot5xh4565FtlQahXAhK2C7Sy0oydZhBwD8KdFSnVlnLr-e9uI5ovSWZ2lGNn9SwoV2MPMzeAh_5r-q-wgwF8DTT_nhuCXJGkMRy-48jjGS2aN5FI18STHZ8RAuKxGasH90SI3C7njZzlGCUrY5m6BDhCMsdpZA14GwNX8Cis

The following is a sample GET request for the findItems operation:

1
https://organization.domain.com/context/admin/data/findItems?types=egdb&f=pjson

JSON Response example

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
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
{
  "items": [
    {
      "id": "ed243751-49ff-48c6-9c38-21880621a4a0",
      "name": "relds-ayvvq",
      "description": "Managed relation data store for site gis",
      "provider": "ArcGIS Data Store",
      "type": "egdb",
      "systemManaged": true,
      "purposes": [
        "configure",
        "feature"
      ],
      "revision": "3",
      "path": "/enterpriseDatabases/ed243751-49ff-48c6-9c38-21880621a4a0",
      "encryptAttributes": [
        "info.JDBCConnection.username",
        "info.JDBCConnection.password"
      ],
      "info": {
        "provider": "ArcGIS Data Store",
        "isManaged": true,
        "systemManaged": true,
        "isManagedData": true,
        "category": "database",
        "implementation": "PostgreSQL",
        "factory": "egdb",
        "purposes": [
          "configure",
          "feature"
        ],
        "dsFeature": "relational",
        "dbType": "managedPostgres",
        "dataStoreConnectionType": "serverOnly",
        "JDBCConnection": {...},
        "machines": [
          {
            "name": "machine-primary",
            "dbPort": 7654,
            "platform": "Linux",
            "role": "PRIMARY"
          },
          {
            "name": "machine-standby",
            "dbPort": 7654,
            "platform": "Linux",
            "role": "STANDBY"
          }
        ],
        "connectionString": "ENCRYPTED_PASSWORD=00022e6859334a323438527770496d4752776153354e77716258443238596e6c5062304571337141734859543957453d2a00;SERVER=gis-rdbms-v1o45-primary,gis-rdbms-v1o45-standby;INSTANCE=sde:postgresql:gis-rdbms-v1o45-primary,7654;DBCLIENT=postgresql;DB_CONNECTION_PROPERTIES=gis-rdbms-v1o45-primary,7654;DATABASE=hgdb_ayvvq;USER=mu_qlkbp;VERSION=sde.DEFAULT;AUTHENTICATION_MODE=DBMS",
        "connectionStringHA": "ENCRYPTED_PASSWORD=00022e683279464246757a6b6d48722f34625a385456655457464e795147644d376c6b566c79516963414f577359413d2a00;SERVER=relds-ayvvq;INSTANCE=\"sde:postgresql:DSID=relds-ayvvq\";DBCLIENT=postgresql;DATABASE=hgdb_ayvvq;USER=mu_qlkbp;VERSION=sde.DEFAULT;AUTHENTICATION_MODE=DBMS"
      },
      "encryptedAttributes": [],
      "meta": {
        "created": 1598306821,
        "modified": 1598307592
      }
    }
  ]
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close