Raster File | ArcGIS REST APIs

URL:: https://<imageservice-url>/file
Methods:: GET
Required Capability:: Catalog, Download
Version Introduced:: 10.0

Description

The Raster File resource represents a single raw raster file. The id required to request the file can be obtained using the Download Rasters operation.

The Raster file resource is only supported on dedicated instance image services.

This resource streams the file contents to the client.

Request parameters

Parameter Details

Parameter	Details
`id` (Required)	Description: The ID of the raster file. This ID is obtained using the Download Rasters operation. Example: Suppose the Download Rasters operation returned the following response: Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 { "rasterFiles": [ { "id": "t1923.png", "rasterIds": [54], "size": 65417 }, { "id": "t1923.pgw", "rasterIds": [54], "size": 765368 }, { "id": "t1923.png.aux.xml", "rasterIds": [54], "size": 853 }, { "id": "t1928", "rasterIds": [60], "size": 786296 } ] }` You can download the second file in this response by specifying its `id` as the query parameter for this resource: `id=t1923.pgw` .
`rasterId` (Required)	Description: The object ID of the raster item. This ID is obtained using the Download Rasters operation. This is required if the source raster is a GRID, WCS, or geodatabase raster. Example: You can download the fourth raster from the example response by specifying its `id` and `rasterId` as the query parameters for this resource: `id=t1928&rasterId=60`.

id

(Required)

Description: The ID of the raster file. This ID is obtained using the Download Rasters operation.

Example: Suppose the Download Rasters operation returned the following response:

Use dark colors for code blocksCopy
{
  "rasterFiles": [
   {
    "id": "t1923.png",
    "rasterIds": [54],
    "size": 65417
   },
   {
    "id": "t1923.pgw",
    "rasterIds": [54],
    "size": 765368
   },
   {
    "id": "t1923.png.aux.xml",
    "rasterIds": [54],
    "size": 853
   },
   {
    "id": "t1928",
    "rasterIds": [60],
    "size": 786296
   }
  ]
}

You can download the second file in this response by specifying its id as the query parameter for this resource: id=t1923.pgw .

rasterId

(Required)

Description: The object ID of the raster item. This ID is obtained using the Download Rasters operation. This is required if the source raster is a GRID, WCS, or geodatabase raster.

Example: You can download the fourth raster from the example response by specifying its id and rasterId as the query parameters for this resource: id=t1928&rasterId=60.

Example usage

Example 1: Access the raster file resource for ID: https://organization.example.com/1n2w13w.jpg.

https://organization.example.com/<context>/rest/services/ImageServiceName/ImageServer/file?id=https://servername/1n2w13w.jpg&rasterId=61

Example 2: Access a geodatabase raster resource.

https://organization.example.com/<context>/rest/services/ImageServiceName/ImageServer/file?id=t1928&rasterId=60