/repository
Methods
GET |
|---|
Gets the list of Repositories. NOTE: The field 'transfer' will only be returned if the type is "remote", running is "true", and the field is requested. Fields Parameter Request ParametersExpand Parametersmdm (only applies to Mobile repositories. 'typeFields' must be requested) Example Response |
POST |
|---|
Adds a Repository. NOTE: See Lumin REST Reference for Lumin synchronization settings. NOTE: The fields related to data expiration (activeVulnsLifetime, passiveVulnsLifetime, lceVulnsLifetime, complianceVulnsLifetime, mitigatedVulnsLifetime) only apply to repositories of type "Local". NOTE: The dataFormat parameter is required NOTE: Beginning in SC 6.8.0 for Local repositories, the only allowed dataFormat when creating a new repository is mobile or universal. Request ParametersExample Response |
/repository/{id}
/repository/{uuid}
Methods
GET |
|---|
Gets the Repository associated with {id} or {uuid}. NOTE: The field 'transfer' will only be returned if the type is "remote", running is "true", and the field is requested. Fields ParameterRequest ParametersNone Expand Parametersmdm (only applies to Mobile repositories. 'typeFields' must be requested) Example Response |
PATCH |
|---|
Edits the Repository associated with {id} or {uuid}, changing only the passed in fields. NOTE: Parameters 'type', 'dataFormat', and 'mdm' may not be modified on PATCH. Request Parameters(All fields are optional) See /repository::POST for parameters. Example Response |
DELETE |
|---|
Deletes the Repository associated with {id} or {uuid}, depending on access and permissions. Request ParametersNone Example Response |
/repository/{id}/acceptRiskRule
/repository/{uuid}/acceptRiskRule
Methods
GET |
|---|
Gets the list of Accept Risk Rules in the Repository associated with {id} or {uuid}, unless filters are provided. Fields ParameterFiltersExample Response |
/repository/{id}/recastRiskRule
/repository/{uuid}/recastRiskRule
POST |
|---|
Downloads the report associated with {id}. Request ParametersNone Example ResponseNone given. The response will be a PDF, RTF, CSV, ASR, ARF, or LASR file in binary or ascii format. |
/repository/{id}/recastRiskRule
/repository/{uuid}/recastRiskRule
Methods
GET |
|---|
Gets the list of Recast Risk Rules in the Repository associated with {id} or {uuid}, unless filters are provided. Fields ParameterFiltersExample Response |
/repository/{id}/assetIntersections
/repository/{uuid}/assetIntersections
GET |
|---|
Gets the ip, uuid, or hostUUID intersections of an Asset. Request ParametersExample Response |
/repository/{id}/import
/repository/{uuid}/import
The /repository/import resource.
POST |
|---|
Starts an on-demand, import for the Repository associated with {id} or {uuid}. The data is specified by a previously uploaded, gzipped tarball of Repository data obtained using /repository/{id}/export or /repository/{uuid}/export. NOTE: The file field should contain the value of the same parameter passed back on /file/upload::POST. Request ParametersExample Response |
/repository/{id}/export
/repository/{uuid}/export
The /repository/export resource.
GET |
|---|
Exports the Repository associated with {id} or {uuid} as a gzipped tar file. Request ParametersNone Example ResponseNone given. The response will be a gzipped file containing a tarball of the Repository files. The tarball will contain the following contents:
|
/repository/{id}/sync
/repository/{uuid}/sync
The /repository/sync resource.
POST |
|---|
Starts an on-demand synchronization of local data for the remote Repository associated with {id} or {uuid}. Request ParametersNone Example Response |
/repository/{id}/updateMobileData
/repository/{uuid}/updateMobileData
The /repository/updateMobileData resource.
POST |
|---|
Starts an on-demand process to update the mobile data for the Repository associated with {id} or {uuid}. This is considered a mobile scan process by Tenable.sc. Request ParametersNone Example Response |
/repository/{id}/deviceInfo
/repository/{uuid}/deviceInfo
GET |
|---|
Gets the device information for the Repository associated with {id} or {uuid}, or {hostUUID}. Fields ParameterRequest ParametersExample Response |
/repository/{id}/attachment/{attachmentID}
/repository/{uuid}/attachment/{attachmentID}
GET |
|---|
Downloads the attachment with the given {attachmentID} from the provided repository. Request ParametersNone Example ResponseNone given. The response will be the downloaded file in binary or ascii format. |
/repository/authorize
POST |
|---|
Authorizes communication with the remote machine associated with the provided host ip. Request ParametersExample Response |
/repository/fetchRemote
The /repository/download resource.
GET |
|---|
Gets a list of Repositories at the specified location. NOTE: The /sshKey/installRemoteKey command may need to be used to gain access to the list of repositories at the remote host if it has not been done so previously. An error code of 63 (RESPONSE_DENIED) will indicate if such a request is required. Request ParametersExample Response |
Expand Items: details, shares
details
Show specific details (such as vulnerability count, nessus schedule information, etc.)
shares
Show the organizations granted access to the Repository.