Retrieve the deployment script download link

Retrieve the deployment script download link

GET api/edge/uuid/install_script

Returns a presigned AWS download URI for the customer-specific deployment script (install_script.tar.gz) for the node assigned to uuid. The tarball is retrieved from the install_script/install_script.tar.gz path of the customer's S3 bucket.

Request syntax

get api/edge/<uuid>/install_script

Response syntax

{
    "uri": "string",
    "md5": "string"
}

Response parameters

If the action is successful, an HTTP 200 response is returned. The following data is returned in JSON format.

FieldTypeDescription
uriStringA public, presigned URI to download install_script.tar.gz. The URI expires 5 minutes after it's issued. Each request to this endpoint generates a new URI with its own expiration.
md5StringThe md5 checksum for the install_script.tar.gz file.

If the tarball isn't present in the customer's S3 bucket, an HTTP 200 response is still returned, with an error field instead of uri/md5.

{
  "error": "install_script/install_script.tar.gz not found on S3 bucket for <customer_code>"
}

Errors

The following are possible errors returned when making this API call. For more information, see Common errors.

CodeMessageCause
401UnauthorizedThe token is incorrect or improperly formatted.
404Not foundThe token wasn't found.
403Access token expiredThe token's expiration timer has elapsed.
403Access token disabledThe URL was manually disabled.

Examples

curl -sH "Accept: application/vnd.reliantsec-v1+json" https://platform.reliant.io/api/edge/a51d1c80-8bf1-4f2c-984EXAMPLE/install_script

Response

{
  "uri": "https://pfc-em-packages.s3.amazonaws.com/install_script/install_script.tar.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAI4VNQ34WEXAMPLE%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20211210T222507Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=04e3296a6c7a1717c8286c09ab1ab1a2EXAMPLE",
  "md5": "972e7e175917d16ce48EXAMPLE"
}