Manage a hosted imagery layer item and service

A hosted imagery layer (item)A hosted imagery layer is a hosted layer (item) in a portal that is used to access and manage the properties and settings of an image service.Learn more can be used to manage the itemAn item, also known as a content item, is a resource stored in a portal such as a web map, hosted layer, style, script tool, file, or notebook.Learn more properties and settings for the corresponding image serviceAn image service is a data service that can store, process, analyze, and share raster data.Learn more. A hosted imagery layer (item) contains content properties such as name and description that describe the item resource in a portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more, and data service properties such as source and URL for the map tile service and the source feature serviceA feature service is a data service that provides access to spatial and non-spatial data in feature layers, feature layer views, and tables.Learn more it was derived from.

You can use the item properties to:

• Update the metadata for the hosted layer such as the name, description, and terms of use.
• Make an item more discoverable in a portal.
• Include important terms of use or credits information.
• Find data service information such as the URL endpoint.
• Change the sharing and security settings.

How to manage a hosted imagery layer (item)

When you create a new data service, the hosted layer and data service sharing level (privacy setting) is set to Owner. The item and data service are only available to you. This setting requires that applications provide a valid access tokenAn access token is an authorization string that provides access to secure ArcGIS content, data, and services. Its capabilities are determined by the privileges it supports. It is obtained by implementing API key authentication, User authentication, or App authentication.Learn more to authenticate requests to view the item or to access the data service.

The steps to change the sharing properties are:

1. Sign in to your portalArcGIS portal, also known as a portal, is a website with applications and tools that can be used to create, manage, access, and share geospatial content and data. It supports security and authentication, developer credentials, content and data service management, user and group management, and site administration. A portal can be hosted in Esri's infrastructure or your own infrastructure.Learn more:

   • ArcGIS Location Platform: Go to https://location.arcgis.com > My portal.
   • ArcGIS Online: Go to https://www.arcgis.com/home/signin.html.
   • ArcGIS Enterprise: Go to your portal URL. Learn more at ArcGIS Enterprise > Use > Get started > Access.
2. Find the item.
3. Use the item page to change the item properties.

Access an item page

You can manage the properties of a hosted layer by accessing the item pageAn item page is a web page in ArcGIS Online or the developer dashboard used to access and manage the properties for an item and the content it references such as a web map, hosted layer, or file.Learn more in a portal. If you are the owner of the item, you can use the item page to update the properties.

1
https://{portal}/home/item.html?{id}

Example: https://www.arcgis.com/home/item.html?id=c7b1872373474e9086259f5796228921

Content properties

The content properties of a hosted layerA hosted layer is an item in a portal that contains the properties and settings for a hosted data service or a layer in a hosted data service.Learn more (item) describe the resource in a portal. These properties uniquely define a data service and allow it to be discoverable in a portal. As an owner, you can set properties such as the name, description, tags, thumbnail, and terms of use to provide details about the underlying data service. Other properties such as id, type, created date, and updated date are read-only and are maintained by the system.

Examples of general properties include the following:

• *ID: The unique identifier for the item.
• *Type: The type of hosted layer.
• *Item created: Date the item was created.
• *Item updated: Date the item was updated.
• *View count: Number of times the item page was viewed.
• *Owner: Name of the owner or publisher of the data.
• Name: The name of the hosted layer.
• Description: Text that describes the layer, what data it contains, and what it is used for.
• Terms of use: Description of usage restrictions for the data.
• Tags: Search text used to find an item in a portal.
• Credits: Attribution for the data.
• Terms of use: The terms and usage restrictions.

*Read-only properties

Data service properties

The service properties of a hosted layerA hosted layer is an item in a portal that contains the properties and settings for a hosted data service or a layer in a hosted data service.Learn more (item) provide information about the underlying data service. For example, it contains the layers, source, and service URL. These are read-only but are useful when you need to find the URL for the underlying data service and layers.

Examples of service properties include the following:

• *Layers: Access to other layers if present.
• *Source: The type of data service (feature service, vector tile service, map service).
• *Size: The size of the data in KB.
• *URL: The URL used to access the layer in the data service.

*Read-only properties

Code examples

You can use data management tools to get the properties of a hosted map tile layerA hosted map tile layer is a hosted layer (item) in a portal that is used to manage the properties and settings of a map tile service.Learn more (item) or you can use the ArcGIS REST APIs. The following examples illustrate how to programmatically get the properties of a hosted imagery layer (item)A hosted imagery layer is a hosted layer (item) in a portal that is used to access and manage the properties and settings of an image service.Learn more and image serviceAn image service is a data service that can store, process, analyze, and share raster data.Learn more.

1
https://www.arcgis.com/sharing/rest/content/items/366d13d521b844119c9052758b33afc9?f=json&token={access_token}

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
61
62
63
64
65
66
67
68
69
70
71
72
{
    "id": "c7b1872373474e9086259f5796228921",
    "owner": "mtorrey_devlabs",
    "created": 1711998781000,
    "isOrgItem": true,
    "modified": 1711998906000,
    "guid": null,
    "name": "Santa_Monica_terrain_10m",
    "title": "Santa Monica terrain 10m (static tiles)",
    "type": "Image Service",
    "typeKeywords": [
        "ArcGIS Server",
        "Data",
        "Image Service",
        "Service",
        "Tiled Imagery",
        "Hosted Service"
    ],
    "description": null,
    "tags": [
        "image",
        "service",
        "santa",
        "monica"
    ],
    "snippet": null,
    "thumbnail": "thumbnail/blob.png",
    "documentation": null,
    "extent": [
        [
            -118.63365297389575,
            33.94067077410918
        ],
        [
            -118.21503805149605,
            34.13525783043728
        ]
    ],
    "categories": [],
    "spatialReference": "102100",
    "accessInformation": null,
    "classification": null,
    "licenseInfo": null,
    "culture": "",
    "properties": {},
    "advancedSettings": null,
    "url": "https://tiledimageservices3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_terrain_10m/ImageServer",
    "proxyFilter": null,
    "access": "private",
    "size": 0,
    "subInfo": 0,
    "appCategories": [],
    "industries": [],
    "languages": [],
    "largeThumbnail": null,
    "banner": null,
    "screenshots": [],
    "listed": false,
    "ownerFolder": null,
    "protected": false,
    "commentsEnabled": true,
    "numComments": 0,
    "numRatings": 0,
    "avgRating": 0,
    "numViews": 1,
    "itemControl": "admin",
    "scoreCompleteness": 50,
    "groupDesignations": null,
    "token1ExpirationDate": -1,
    "token2ExpirationDate": -1,
    "lastViewed": 1712001600000
}

1
https://tiledimageservices3.arcgis.com/GVgbJbqm8hXASVYi/arcgis/rest/services/Santa_Monica_terrain_10m/ImageServer?token={access_token}

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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
{
    "currentVersion": 11.2,
    "name": "Santa_Monica_terrain_10m",
    "serviceDescription": "",
    "description": "",
    "type": "ImageServer",
    "capabilities": "Image,TilesOnly",
    "copyrightText": "",
    "serviceItemId": "c7b1872373474e9086259f5796228921",
    "meanPixelSize": 10,
    "server": "GVgbJbqm8hXASVYi",
    "created": null,
    "modified": null,
    "status": "created",
    "access": "SECURE",
    "allowAnalysis": true,
    "allowCopy": false,
    "serviceSourceType": "esriImageServiceSourceTypeDataset",
    "spatialReference": {
        "wkid": 102100,
        "latestWkid": 3857
    },
    "extent": {
        "xmin": -13206237.84,
        "ymin": 4020838.34,
        "xmax": -13159637.84,
        "ymax": 4046978.34,
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        }
    },
    "initialExtent": {
        "xmin": -13206237.84,
        "ymin": 4020838.34,
        "xmax": -13159637.84,
        "ymax": 4046978.34,
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        }
    },
    "fullExtent": {
        "xmin": -13206237.84,
        "ymin": 4020838.34,
        "xmax": -13159637.84,
        "ymax": 4046978.34,
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        }
    },
    "datasetFormat": "Cache/LERC2D",
    "compressionType": "LERC",
    "uncompressedSize": 48724960,
    "pixelSizeX": 10,
    "pixelSizeY": 10,
    "blockWidth": 256,
    "blockHeight": 256,
    "bandCount": 1,
    "bandNames": [
        "Band 0"
    ],
    "pixelType": "F32",
    "minPixelSize": 10,
    "maxPixelSize": 160,
    "minScale": 604723.2,
    "maxScale": 37795.2,
    "serviceDataType": "esriImageServiceDataTypeElevation",
    "minValues": [
        -1.5030213594436646
    ],
    "maxValues": [
        768.55615234375
    ],
    "meanValues": [
        125.74470303565873
    ],
    "stdvValues": [
        145.06171728828704
    ],
    "objectIdField": "",
    "fields": [],
    "defaultMosaicMethod": "",
    "allowedMosaicMethods": "",
    "sortField": "",
    "sortValue": null,
    "sortAscending": true,
    "singleFusedMapCache": true,
    "tileInfo": {
        "rows": 256,
        "cols": 256,
        "dpi": 96,
        "preciseDpi": 96,
        "format": "LERC2D",
        "storageFormat": "esriMapCacheStorageModeCompactV2",
        "packetSize": 16,
        "compressionQuality": 0,
        "antialiasing": false,
        "origin": {
            "x": -13206237.84,
            "y": 4046978.34
        },
        "spatialReference": {
            "wkid": 102100,
            "latestWkid": 3857
        },
        "lods": [
            {
                "level": 0,
                "resolution": 160,
                "scale": 604723.2
            },
            {
                "level": 1,
                "resolution": 80,
                "scale": 302361.6
            },
            {
                "level": 2,
                "resolution": 40,
                "scale": 151180.8
            },
            {
                "level": 3,
                "resolution": 20,
                "scale": 75590.4
            },
            {
                "level": 4,
                "resolution": 10,
                "scale": 37795.2
            }
        ]
    },
    "cacheType": "Raster",
    "allowRasterFunction": false,
    "hasHistograms": true,
    "hasColormap": false,
    "hasRasterAttributeTable": false,
    "exportTilesAllowed": false,
    "maxExportTilesCount": 100000,
    "hasMultidimensions": false
}

Services

API support

Use data management toolsData management tools are ArcGIS software applications and functionality in portal and ArcGIS Pro that can be used by developers to create, manage, and edit content and data such as web maps, hosted layers, and data services for their applications.Learn more or Client APIsA Client API is a web, native, or scripting Application Programming Interface (including all ArcGIS, open source, and third-party APIs) that has mapping capabilities and can be used to access ArcGIS location services.Learn more to create, manage, and access data servicesData services, also known as hosted data services, are services created dynamically to store and provide access to your data in ArcGIS. Examples are feature services, vector tile services, map tile services, image services, and scene services.Learn more. The table below outlines the level of support for each API.

Tools