Chapter 20. Compliance Scan Configuration Service


20.1. Compliance Scan Configuration Service

20.1.1. CreateComplianceScanConfiguration

POST /v2/compliance/scan/configurations

CreateComplianceScanConfiguration creates a compliance scan configuration

20.1.1.1. Description

20.1.1.2. Parameters

20.1.1.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V2ComplianceScanConfiguration

X

  

20.1.1.3. Return Type

V2ComplianceScanConfiguration

20.1.1.4. Content Type

  • application/json

20.1.1.5. Responses

Expand
Table 20.1. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ComplianceScanConfiguration

0

An unexpected error response.

RpcStatus

20.1.1.6. Samples

20.1.2. DeleteComplianceScanConfiguration

DELETE /v2/compliance/scan/configurations/{id}

DeleteComplianceScanConfiguration removes the compliance scan configuration with given Name

20.1.2.1. Description

20.1.2.2. Parameters

20.1.2.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 

20.1.2.3. Return Type

Object

20.1.2.4. Content Type

  • application/json

20.1.2.5. Responses

Expand
Table 20.2. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

20.1.2.6. Samples

20.1.3. DeleteReport

DELETE /v2/compliance/scan/configurations/reports/{id}

DeleteReport deletes a given snapshot (scan execution).

20.1.3.1. Description

20.1.3.2. Parameters

20.1.3.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 

20.1.3.3. Return Type

Object

20.1.3.4. Content Type

  • application/json

20.1.3.5. Responses

Expand
Table 20.3. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

20.1.3.6. Samples

20.1.4. GetComplianceScanConfiguration

GET /v2/compliance/scan/configurations/{id}

GetComplianceScanConfiguration retrieves the specified compliance scan configurations

20.1.4.1. Description

20.1.4.2. Parameters

20.1.4.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 

20.1.4.3. Return Type

V2ComplianceScanConfigurationStatus

20.1.4.4. Content Type

  • application/json

20.1.4.5. Responses

Expand
Table 20.4. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ComplianceScanConfigurationStatus

0

An unexpected error response.

RpcStatus

20.1.4.6. Samples

20.1.5. GetMyReportHistory

GET /v2/compliance/scan/configurations/{id}/reports/my-history

GetMyReportHistory returns a list of snapshots (scan executions) executed by the current user from a given scan configuration.

20.1.5.1. Description

20.1.5.2. Parameters

20.1.5.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 
20.1.5.2.2. Query Parameters
Expand
NameDescriptionRequiredDefaultPattern

reportParamQuery.query

 

-

null

 

reportParamQuery.pagination.limit

 

-

null

 

reportParamQuery.pagination.offset

 

-

null

 

reportParamQuery.pagination.sortOption.field

 

-

null

 

reportParamQuery.pagination.sortOption.reversed

 

-

null

 

reportParamQuery.pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

reportParamQuery.pagination.sortOption.aggregateBy.distinct

 

-

null

 

20.1.5.3. Return Type

V2ComplianceReportHistoryResponse

20.1.5.4. Content Type

  • application/json

20.1.5.5. Responses

Expand
Table 20.5. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ComplianceReportHistoryResponse

0

An unexpected error response.

RpcStatus

20.1.5.6. Samples

20.1.6. GetReportHistory

GET /v2/compliance/scan/configurations/{id}/reports/history

GetReportHistory returns a list of snapshots (scan executions) from a given scan configuration.

20.1.6.1. Description

20.1.6.2. Parameters

20.1.6.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 
20.1.6.2.2. Query Parameters
Expand
NameDescriptionRequiredDefaultPattern

reportParamQuery.query

 

-

null

 

reportParamQuery.pagination.limit

 

-

null

 

reportParamQuery.pagination.offset

 

-

null

 

reportParamQuery.pagination.sortOption.field

 

-

null

 

reportParamQuery.pagination.sortOption.reversed

 

-

null

 

reportParamQuery.pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

reportParamQuery.pagination.sortOption.aggregateBy.distinct

 

-

null

 

20.1.6.3. Return Type

V2ComplianceReportHistoryResponse

20.1.6.4. Content Type

  • application/json

20.1.6.5. Responses

Expand
Table 20.6. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ComplianceReportHistoryResponse

0

An unexpected error response.

RpcStatus

20.1.6.6. Samples

20.1.7. ListComplianceScanConfigClusterProfiles

GET /v2/compliance/scan/configurations/clusters/{clusterId}/profiles/collection

GetComplianceScanConfiguration retrieves the specified compliance scan configurations

20.1.7.1. Description

20.1.7.2. Parameters

20.1.7.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

clusterId

 

X

null

 
20.1.7.2.2. Query Parameters
Expand
NameDescriptionRequiredDefaultPattern

query.query

 

-

null

 

query.pagination.limit

 

-

null

 

query.pagination.offset

 

-

null

 

query.pagination.sortOption.field

 

-

null

 

query.pagination.sortOption.reversed

 

-

null

 

query.pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

query.pagination.sortOption.aggregateBy.distinct

 

-

null

 

20.1.7.3. Return Type

V2ListComplianceScanConfigsClusterProfileResponse

20.1.7.4. Content Type

  • application/json

20.1.7.5. Responses

Expand
Table 20.7. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ListComplianceScanConfigsClusterProfileResponse

0

An unexpected error response.

RpcStatus

20.1.7.6. Samples

20.1.8. ListComplianceScanConfigProfiles

GET /v2/compliance/scan/configurations/profiles/collection

ListComplianceScanConfigurations lists all the compliance operator scan configurations for the secured clusters

20.1.8.1. Description

20.1.8.2. Parameters

20.1.8.2.1. Query Parameters
Expand
NameDescriptionRequiredDefaultPattern

query

 

-

null

 

pagination.limit

 

-

null

 

pagination.offset

 

-

null

 

pagination.sortOption.field

 

-

null

 

pagination.sortOption.reversed

 

-

null

 

pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

pagination.sortOption.aggregateBy.distinct

 

-

null

 

20.1.8.3. Return Type

V2ListComplianceScanConfigsProfileResponse

20.1.8.4. Content Type

  • application/json

20.1.8.5. Responses

Expand
Table 20.8. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ListComplianceScanConfigsProfileResponse

0

An unexpected error response.

RpcStatus

20.1.8.6. Samples

20.1.9. ListComplianceScanConfigurations

GET /v2/compliance/scan/configurations

ListComplianceScanConfigurations lists all the compliance operator scan configurations for the secured clusters

20.1.9.1. Description

20.1.9.2. Parameters

20.1.9.2.1. Query Parameters
Expand
NameDescriptionRequiredDefaultPattern

query

 

-

null

 

pagination.limit

 

-

null

 

pagination.offset

 

-

null

 

pagination.sortOption.field

 

-

null

 

pagination.sortOption.reversed

 

-

null

 

pagination.sortOption.aggregateBy.aggrFunc

 

-

UNSET

 

pagination.sortOption.aggregateBy.distinct

 

-

null

 

20.1.9.3. Return Type

V2ListComplianceScanConfigurationsResponse

20.1.9.4. Content Type

  • application/json

20.1.9.5. Responses

Expand
Table 20.9. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ListComplianceScanConfigurationsResponse

0

An unexpected error response.

RpcStatus

20.1.9.6. Samples

20.1.10. RunComplianceScanConfiguration

POST /v2/compliance/scan/configurations/{id}/run

RunComplianceScanConfiguration launches scan for the specified scan configuration, which will invoke scans to run for the applicable profiles across the configured clusters.

20.1.10.1. Description

20.1.10.2. Parameters

20.1.10.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 

20.1.10.3. Return Type

Object

20.1.10.4. Content Type

  • application/json

20.1.10.5. Responses

Expand
Table 20.10. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

20.1.10.6. Samples

20.1.11. RunReport

POST /v2/compliance/scan/configurations/reports/run

RunReport runs an on demand compliance report for the scan configuration

20.1.11.1. Description

20.1.11.2. Parameters

20.1.11.2.1. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

V2ComplianceRunReportRequest

X

  

20.1.11.3. Return Type

V2ComplianceRunReportResponse

20.1.11.4. Content Type

  • application/json

20.1.11.5. Responses

Expand
Table 20.11. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

V2ComplianceRunReportResponse

0

An unexpected error response.

RpcStatus

20.1.11.6. Samples

20.1.12. UpdateComplianceScanConfiguration

PUT /v2/compliance/scan/configurations/{id}

UpdateComplianceScanConfiguration updates a compliance scan configuration

20.1.12.1. Description

20.1.12.2. Parameters

20.1.12.2.1. Path Parameters
Expand
NameDescriptionRequiredDefaultPattern

id

 

X

null

 
20.1.12.2.2. Body Parameter
Expand
NameDescriptionRequiredDefaultPattern

body

ComplianceScanConfigurationServiceUpdateComplianceScanConfigurationBody

X

  

20.1.12.3. Return Type

Object

20.1.12.4. Content Type

  • application/json

20.1.12.5. Responses

Expand
Table 20.12. HTTP Response Codes
CodeMessageDatatype

200

A successful response.

Object

0

An unexpected error response.

RpcStatus

20.1.12.6. Samples

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat Documentation

Legal Notice

Theme

© 2026 Red Hat
Back to top