Gpfs/trace/{snapPath}: GET

Downloads a trace snap file from the specified location.

Availability

Available on all IBM Storage Scale editions.

Description

The GET scalemgmt/v2/gpfs/trace/snapPath request downloads a trace snap file from the specified location. For more information about the fields in the data structures that are returned, see the topic mmtracectl command.

Request URL

https://<IP address or host name of API server>:<port>/scalemgmt/v2/gpfs/trace/{snapPath}

where

trace/{snapPath}: Specifies the trace snap file that is downloaded.

Parameters

The following parameters can be used in the request URL to customize the request:

Table 1. List of parameters
Parameter name	Description and applicable keywords	Required/optional
snapPath	The snap file path that is provided as an encoded URL.	Required.

Request headers

Accept: application/octet-stream

Request data

No request data.

Response data

No response data

Examples

The following example lists the status of the network configuration and operations.

Request data:

curl -k -u admin:admin001 -X GET --header 'accept:application/json'
'https://198.51.100.1:443/scalemgmt/v2/gpfs/trace/%2Ftmp%2Fmmfs%2Ftrcrpt.2021-10-23_15.28.29.11388.gpfsgui-21.gz'

The request URL with no field or filter parameter returns only the details that uniquely identify the object.

Response data:

The trace snap file is downloaded.

Note: In the JSON data that is returned, the return code indicates whether the command is successful. The response code 200 indicates that the command successfully retrieved the information. Error code 400 represents an invalid request and 500 represents internal server error.