Get Feature Info By Id And Version

Get feature download info for the feature type and feature version

Returns the feature download info for the feature type and feature version if exists else response with 404 response code will returned. To get the latest version, pass LATEST for feature_version query parameter for the feature type.

If SSP is in disconnected mode (see field CLOUD_CONNECTIVITY_MODE in SecurityContentConfig) then the response depends on configurations - automatic update and feature version mapping. When automatic update configuration takes precedence over feature version mapping and returns latest feature version. Latest version will be returned when both automatic update and feature version mapping is not set. When automatic update is disabled and feature version mapping is set, then the download info for the mapped version will be returned.

Latest version is determined based on the feature_updated_at timestamp. When VTIS provides an update timestamp for the feature, that is used as the authoritative sort key. When VTIS does not provide an update timestamp, the SSP processing time (when the feature was ingested) is used as a fallback. The feature version with the most recent feature_updated_at is returned as LATEST.

Request

URI

GET

https://{api_host}/ssp/security-content/feature-download-info

COPY

Query Parameters

string

feature_type

Required

Feature type identifier.

string

feature_version

Required

Feature version string. Pass LATEST to retrieve the feature version with the most recent source update timestamp (feature_updated_at from VTIS).

Authentication

This operation uses the following authentication methods.

enterprise_admin

Responses

200

Successful response

Returns FeatureDownloadInfo of type(s) application/json

{
    "version": "1.0",
    "contents": [
        {
            "name": "IDSP_Signatures_1432.zip",
            "sha256_checksum": "3a8456acb858eb7d883caa832a38316dc0f8230e2707ae283d5865e07b1b9277",
            "download_url": "https://cdn.example.com/bundle.zip?X-key=value",
            "_last_modified_time": 1751360294000
        }
    ]
}

string

version

Optional

Feature version

integer As int64 As int64

feature_updated_at

Optional

Timestamp (epoch milliseconds) indicating when this feature version was last updated. Reflects the VTIS source update time when available; falls back to the SSP processing time (when the feature was ingested from the megabundle) when VTIS does not supply an update timestamp. This is the authoritative timestamp used to determine LATEST when feature_version=LATEST is requested.

array of contents

contents

Optional

Contents inside the feature

400

Bad Request

Returns BadRequest of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

401

Unauthorized

Returns Unauthorized of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

403

Forbidden

Returns Forbidden of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

404

Feature not found for the specified type and version

Returns Error of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

412

Precondition Failed

Returns PreconditionFailed of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

428

Precondition Required

Returns PreconditionRequired of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

429

Too Many Requests

Returns TooManyRequests of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

default

Error

Returns Error of type(s) application/json

{
    "error_code": 0,
    "module_name": "string",
    "error_message": "string"
}

integer

error_code

Required

HTTP Status or Application error code.

string

module_name

Optional

Module where the error happened.

string

error_message

Required

Message describing the error.

Code Samples

COPY

                    curl -H 'Authorization: <value>' https://{api_host}/ssp/security-content/feature-download-info?feature_type=value&feature_version=v

On This Page

Description

Request

Query Parameters

Authentication

Response

200 Response Body

Errors

Security Content Operations

PUT

Update Scs Config

GET