file tierstatus

This command does not require a MAST Gateway.

Syntax

CLI

maprcli file tierstatus 
         -name <file_name>

REST

Request Type	GET
Request URL	`http[s]://<host:port>/rest/file/tierstatus?<parameters>`

Parameters

Parameter	Description
`name`	The name (including the path) of the file.

Output

The output of this command varies based on whether or not data is local, was offloaded, or was recalled. The output returns one of the following messages:

Data was completely offloaded:
```
File does not have local data
```
Data could not be completely offloaded or data was recalled:
```
File has local data
```
File is not configured for tiering:
```
File is not on a tiered volume
```

Examples

Retrieve the status of file named new2test4 in volume name testvol2:

maprcli file tierstatus -name /testvol2/new2test4 -json
 File does not have local data.
  {
        "timestamp":1514877988773,
        "timeofday":"2018-01-01 11:26:28.773 GMT-0800",
        "status":"OK",
        "total":1,
        "data":[
                {
                    "status":1,
                    "message":"File does not have local data."
                }
        ]
  }

Send a request of type GET. For example:

curl -k -X GET 'https://abc.sj.us:8443/rest/file/tierstatus?name=/testvol2/new2test4' --user mapr:mapr
 {"timestamp":1514877988773,"timeofday":"2018-01-01 11:26:28.773 GMT-0800","status":"OK","total":1,
  "data":[{"status":1,"message":"File does not have local data."}]}

Retrieve the status of file named new2test3 in volume named testvol2:

maprcli file tierstatus -name /testvol2/new2test3 -json
 File has local data.
  {
        "timestamp":1514878021374,
        "timeofday":"2018-01-01 11:27:01.374 GMT-0800",
        "status":"OK",
        "total":1,
        "data":[
                {
                    "status":0,
                    "message":"File has local data."
                }
        ]
  }

Send a request of type GET. For example:

curl -k -X GET 'https://abc.sj.us:8443/rest/file/tierstatus?name=/testvol2/new2test3' --user mapr:mapr
 {"timestamp":1514878021374,"timeofday":"2018-01-01 11:27:01.374 GMT-0800","status":"OK","total":1,
  "data":[{"status":0,"message":"File has local data."}]}

Retrieve the status of file named file0 in volume named dir1 inside a volume called std_volume:

/opt/mapr/bin/maprcli file tierstatus -name /std_volume/dir1/file0 -json
  File is not on a tiered volume.
 {
  "timestamp":1609831337961,
  "timeofday":"2021-01-04 11:22:17.961 GMT-0800 PM",
  "status":"ERROR",
  "errors":[
            {
             "id":4,
             "desc":"File is not on a tiered volume."
            }
           ]
 }

Send a request of type GET. For example:

curl -k -X GET 'https://abc.sj.us:8443/rest/file/tierstatus?name=/std_volume/dir1/file0' --user mapr:mapr