Get File

Get File

Returns the signed S3 url to download a file (an artifact or releaseMetadata)

Request
URI
GET
https://{api_host}/v1/catalogs/{catalog_id}/files/{digest}
COPY
Path Parameters
catalog_id
Required

A string as the identifier of a catalog

string
digest
Required

A digest that identifies the file (artifact or releaseMetadata)

digest example
127e6fbfe24a750e72930c220a8e138275656b8e5d8f48a98c3c92df2caba935
Query Parameters
string
filename
Required

The name of the file

filename example
result.json

Authentication
This operation uses the following authentication methods.
Responses
200

S3 signed downloadable url

Returns SignedUrl of type(s) application/json
"SignedUrl Object"
string
url
Required

S3 singed url of artifact or releaseMetadata


400

An error related to the request

Returns ConstraintsViolationsError of type(s) application/problem+json
This response body class contains all of the following: InlineConstraintsViolationsError0
"ConstraintsViolationsError Object"
array of object
violations
Required

It represents a constraints violation error


403

The requesting user is not authorized to get the file

Returns Error403 of type(s) application/problem+json
This response body class contains all of the following: InlineError4030
"Error403 Object"

404

The requested file digest cannot be found

Returns Error404 of type(s) application/problem+json
This response body class contains all of the following: InlineError4040
"Error404 Object"

500

An internal server error object

Returns Error500 of type(s) application/problem+json
This response body class contains all of the following: InlineError5000
"Error500 Object"

503

The server is temporarily unavailable

Returns Error503 of type(s) application/problem+json
This response body class contains all of the following: InlineError5030
"Error503 Object"

Code Samples
COPY
                    curl -H 'Authorization: <value>' https://{api_host}/v1/catalogs/{catalog_id}/files/{digest}?filename=v