AWS cli documentation change
Summary
Refined command description to focus on pentest job findings and improved parameter/field documentation with clearer security context
Security assessment
The changes provide clearer documentation about security findings (risk types, levels, confidence) from pentest jobs, improving understanding of security features without addressing vulnerabilities.
Diff
diff --git a/cli/latest/reference/securityagent/list-findings.md b/cli/latest/reference/securityagent/list-findings.md index c65b7c2a6..0b56f16d0 100644 --- a//cli/latest/reference/securityagent/list-findings.md +++ b//cli/latest/reference/securityagent/list-findings.md @@ -15 +15 @@ - * [AWS CLI 2.34.41 Command Reference](../../index.html) » + * [AWS CLI 2.34.44 Command Reference](../../index.html) » @@ -59 +59 @@ First time using the AWS CLI? See the [User Guide](https://docs.aws.amazon.com/c -Lists findings with filtering and pagination support. When filters are applied, the actual number of results returned may be less than the specified limit +Lists the security findings for a pentest job. @@ -106 +106 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Identifier of the pentest job for which to retrieve associated findings +> The unique identifier of the pentest job to list findings for. @@ -110 +110 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> ID of the agent space where the pentest job exists +> The unique identifier of the agent space. @@ -114 +114 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Filter findings by risk type +> Filter findings by risk type. @@ -118 +118 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Filter findings by risk level +> Filter findings by risk level. @@ -133 +133 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Filter findings by status +> Filter findings by status. @@ -146 +146 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Filter findings by confidence level +> Filter findings by confidence level. @@ -160 +160 @@ See also: [AWS API Documentation](https://docs.aws.amazon.com/goto/WebAPI/securi -> Filter findings by name (case-insensitive substring search) +> Filter findings by name. @@ -295 +295 @@ findingsSummaries -> (list) -> List of finding summaries matching the filter criteria +> The list of finding summaries. @@ -299 +299 @@ findingsSummaries -> (list) ->> Summary information for a security finding +>> Contains summary information about a security finding. @@ -303 +303 @@ findingsSummaries -> (list) ->>> Unique identifier for the finding +>>> The unique identifier of the finding. @@ -307 +307 @@ findingsSummaries -> (list) ->>> Identifier of the agent space that created this finding +>>> The unique identifier of the agent space associated with the finding. @@ -311 +311 @@ findingsSummaries -> (list) ->>> Identifier of the parent pentest +>>> The unique identifier of the pentest associated with the finding. @@ -315 +315 @@ findingsSummaries -> (list) ->>> Identifier of the pentest job +>>> The unique identifier of the pentest job that produced the finding. @@ -319 +319 @@ findingsSummaries -> (list) ->>> Name or title of the finding +>>> The name of the finding. @@ -323 +323 @@ findingsSummaries -> (list) ->>> Current status of the finding +>>> The current status of the finding. @@ -336 +336 @@ findingsSummaries -> (list) ->>> Type of security risk identified +>>> The type of security risk identified by the finding. @@ -340 +340 @@ findingsSummaries -> (list) ->>> Severity level of the identified risk +>>> The risk level of the finding. @@ -355 +355 @@ findingsSummaries -> (list) ->>> Confidence level of the finding +>>> The confidence level of the finding. @@ -369 +369 @@ findingsSummaries -> (list) ->>> Timestamp when the finding was created +>>> The date and time the finding was created, in UTC format. @@ -373 +373 @@ findingsSummaries -> (list) ->>> Timestamp when the finding was last updated +>>> The date and time the finding was last updated, in UTC format. @@ -377 +377 @@ nextToken -> (string) -> Token for pagination to retrieve the next set of results +> A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request. For subsequent calls, use the nextToken value returned from the previous request. @@ -389 +389 @@ nextToken -> (string) - * [AWS CLI 2.34.41 Command Reference](../../index.html) » + * [AWS CLI 2.34.44 Command Reference](../../index.html) »