Skip to content

List Standards Control Associations

securityhub_list_standards_control_associations R Documentation

Specifies whether a control is currently enabled or disabled in each enabled standard in the calling account

Description

Specifies whether a control is currently enabled or disabled in each enabled standard in the calling account.

Usage

securityhub_list_standards_control_associations(SecurityControlId,
  NextToken, MaxResults)

Arguments

SecurityControlId

[required] The identifier of the control (identified with SecurityControlId, SecurityControlArn, or a mix of both parameters) that you want to determine the enablement status of in each enabled standard.

NextToken

Optional pagination parameter.

MaxResults

An optional parameter that limits the total results of the API response to the specified number. If this parameter isn't provided in the request, the results include the first 25 standard and control associations. The results also include a NextToken parameter that you can use in a subsequent API call to get the next 25 associations. This repeats until all associations for the specified control are returned. The number of results is limited by the number of supported Security Hub standards that you've enabled in the calling account.

Value

A list with the following syntax: 

list(
  StandardsControlAssociationSummaries = list(
    list(
      StandardsArn = "string",
      SecurityControlId = "string",
      SecurityControlArn = "string",
      AssociationStatus = "ENABLED"|"DISABLED",
      RelatedRequirements = list(
        "string"
      ),
      UpdatedAt = as.POSIXct(
        "2015-01-01"
      ),
      UpdatedReason = "string",
      StandardsControlTitle = "string",
      StandardsControlDescription = "string"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$list_standards_control_associations(
  SecurityControlId = "string",
  NextToken = "string",
  MaxResults = 123
)

Examples

## Not run: 
# The following example specifies whether a control is currently enabled
# or disabled in each enabled standard in the calling account. The
# response also provides other details about the control.
svc$list_standards_control_associations(
  SecurityControlId = "S3.1"
)

## End(Not run)