types

package
v1.16.8 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Sep 23, 2025 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessDeniedException

type AccessDeniedException struct {
	Message *string

	ErrorCodeOverride *string

	ErrorCode_   *string
	ResourceId   *string
	ResourceType *string
	// contains filtered or unexported fields
}

You do not have sufficient access to perform this action.

func (*AccessDeniedException) Error

func (e *AccessDeniedException) Error() string

func (*AccessDeniedException) ErrorCode

func (e *AccessDeniedException) ErrorCode() string

func (*AccessDeniedException) ErrorFault

func (e *AccessDeniedException) ErrorFault() smithy.ErrorFault

func (*AccessDeniedException) ErrorMessage

func (e *AccessDeniedException) ErrorMessage() string

type AccountFindingsMetric

type AccountFindingsMetric struct {

	// The number of closed findings of each severity on the specified date.
	ClosedFindings *FindingMetricsValuePerSeverity

	// The date from which the findings metrics were retrieved.
	Date *time.Time

	// The average time in days it takes to close findings of each severity as of a
	// specified date.
	MeanTimeToClose *FindingMetricsValuePerSeverity

	// The number of new findings of each severity on the specified date.
	NewFindings *FindingMetricsValuePerSeverity

	// The number of open findings of each severity as of the specified date.
	OpenFindings *FindingMetricsValuePerSeverity
	// contains filtered or unexported fields
}

A summary of findings metrics for an account on a specified date.

type AnalysisType

type AnalysisType string
const (
	AnalysisTypeSecurity AnalysisType = "Security"
	AnalysisTypeAll      AnalysisType = "All"
)

Enum values for AnalysisType

func (AnalysisType) Values

func (AnalysisType) Values() []AnalysisType

Values returns all known values for AnalysisType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type BatchGetFindingsError

type BatchGetFindingsError struct {

	// A code associated with the type of error.
	//
	// This member is required.
	ErrorCode ErrorCode

	// The finding ID of the finding that was not fetched.
	//
	// This member is required.
	FindingId *string

	// Describes the error.
	//
	// This member is required.
	Message *string

	// The name of the scan that generated the finding.
	//
	// This member is required.
	ScanName *string
	// contains filtered or unexported fields
}

Contains information about the error that caused a finding to fail to be retrieved.

type CategoryWithFindingNum

type CategoryWithFindingNum struct {

	// The name of the finding category. A finding category is determined by the
	// detector that detected the finding.
	CategoryName *string

	// The number of open findings in the category.
	FindingNumber *int32
	// contains filtered or unexported fields
}

Information about a finding category with open findings.

type CodeLine

type CodeLine struct {

	// The code that contains a vulnerability.
	Content *string

	// The code line number.
	Number *int32
	// contains filtered or unexported fields
}

The line of code where a finding was detected.

type ConflictException

type ConflictException struct {
	Message *string

	ErrorCodeOverride *string

	ErrorCode_   *string
	ResourceId   *string
	ResourceType *string
	// contains filtered or unexported fields
}

The requested operation would cause a conflict with the current state of a service resource associated with the request. Resolve the conflict before retrying this request.

func (*ConflictException) Error

func (e *ConflictException) Error() string

func (*ConflictException) ErrorCode

func (e *ConflictException) ErrorCode() string

func (*ConflictException) ErrorFault

func (e *ConflictException) ErrorFault() smithy.ErrorFault

func (*ConflictException) ErrorMessage

func (e *ConflictException) ErrorMessage() string

type EncryptionConfig

type EncryptionConfig struct {

	// The KMS key ARN that is used for encryption. If an AWS-managed key is used for
	// encryption, returns empty.
	KmsKeyArn *string
	// contains filtered or unexported fields
}

Information about the encryption configuration for an account. Required to call UpdateAccountConfiguration .

type ErrorCode

type ErrorCode string
const (
	ErrorCodeDuplicateIdentifier ErrorCode = "DUPLICATE_IDENTIFIER"
	ErrorCodeItemDoesNotExist    ErrorCode = "ITEM_DOES_NOT_EXIST"
	ErrorCodeInternalError       ErrorCode = "INTERNAL_ERROR"
	ErrorCodeInvalidFindingId    ErrorCode = "INVALID_FINDING_ID"
	ErrorCodeInvalidScanName     ErrorCode = "INVALID_SCAN_NAME"
)

Enum values for ErrorCode

func (ErrorCode) Values

func (ErrorCode) Values() []ErrorCode

Values returns all known values for ErrorCode. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type FilePath

type FilePath struct {

	// A list of CodeLine objects that describe where the security vulnerability
	// appears in your code.
	CodeSnippet []CodeLine

	// The last line number of the code snippet where the security vulnerability
	// appears in your code.
	EndLine *int32

	// The name of the file.
	Name *string

	// The path to the resource with the security vulnerability.
	Path *string

	// The first line number of the code snippet where the security vulnerability
	// appears in your code.
	StartLine *int32
	// contains filtered or unexported fields
}

Information about the location of security vulnerabilities that Amazon CodeGuru Security detected in your code.

type Finding

type Finding struct {

	// The time when the finding was created.
	CreatedAt *time.Time

	// A description of the finding.
	Description *string

	// The identifier for the detector that detected the finding in your code. A
	// detector is a defined rule based on industry standards and AWS best practices.
	DetectorId *string

	// The name of the detector that identified the security vulnerability in your
	// code.
	DetectorName *string

	// One or more tags or categorizations that are associated with a detector. These
	// tags are defined by type, programming language, or other classification such as
	// maintainability or consistency.
	DetectorTags []string

	// The identifier for the component that generated a finding such as
	// AmazonCodeGuruSecurity.
	GeneratorId *string

	// The identifier for a finding.
	Id *string

	// An object that contains the details about how to remediate a finding.
	Remediation *Remediation

	// The resource where Amazon CodeGuru Security detected a finding.
	Resource *Resource

	// The identifier for the rule that generated the finding.
	RuleId *string

	// The severity of the finding. Severity can be critical, high, medium, low, or
	// informational. For information on severity levels, see [Finding severity]in the Amazon CodeGuru
	// Security User Guide.
	//
	// [Finding severity]: https://docs.aws.amazon.com/codeguru/latest/security-ug/findings-overview.html#severity-distribution
	Severity Severity

	// The status of the finding. A finding status can be open or closed.
	Status Status

	// The title of the finding.
	Title *string

	// The type of finding.
	Type *string

	// The time when the finding was last updated. Findings are updated when you
	// remediate them or when the finding code location changes.
	UpdatedAt *time.Time

	// An object that describes the detected security vulnerability.
	Vulnerability *Vulnerability
	// contains filtered or unexported fields
}

Information about a finding that was detected in your code.

type FindingIdentifier

type FindingIdentifier struct {

	// The identifier for a finding.
	//
	// This member is required.
	FindingId *string

	// The name of the scan that generated the finding.
	//
	// This member is required.
	ScanName *string
	// contains filtered or unexported fields
}

An object that contains information about a finding and the scan that generated it.

type FindingMetricsValuePerSeverity

type FindingMetricsValuePerSeverity struct {

	// A numeric value corresponding to a critical finding.
	Critical *float64

	// A numeric value corresponding to a high severity finding.
	High *float64

	// A numeric value corresponding to an informational finding.
	Info *float64

	// A numeric value corresponding to a low severity finding.
	Low *float64

	// A numeric value corresponding to a medium severity finding.
	Medium *float64
	// contains filtered or unexported fields
}

A numeric value corresponding to the severity of a finding, such as the number of open findings or the average time it takes to close findings of a given severity.

type InternalServerException

type InternalServerException struct {
	Message *string

	ErrorCodeOverride *string

	Error_ *string
	// contains filtered or unexported fields
}

The server encountered an internal error and is unable to complete the request.

func (*InternalServerException) Error

func (e *InternalServerException) Error() string

func (*InternalServerException) ErrorCode

func (e *InternalServerException) ErrorCode() string

func (*InternalServerException) ErrorFault

func (e *InternalServerException) ErrorFault() smithy.ErrorFault

func (*InternalServerException) ErrorMessage

func (e *InternalServerException) ErrorMessage() string

type MetricsSummary

type MetricsSummary struct {

	// A list of CategoryWithFindingNum objects for the top 5 finding categories with
	// the most findings.
	CategoriesWithMostFindings []CategoryWithFindingNum

	// The date from which the metrics summary information was retrieved.
	Date *time.Time

	// The number of open findings of each severity.
	OpenFindings *FindingMetricsValuePerSeverity

	// A list of ScanNameWithFindingNum objects for the top 3 scans with the most
	// number of open critical findings.
	ScansWithMostOpenCriticalFindings []ScanNameWithFindingNum

	// A list of ScanNameWithFindingNum objects for the top 3 scans with the most
	// number of open findings.
	ScansWithMostOpenFindings []ScanNameWithFindingNum
	// contains filtered or unexported fields
}

A summary of metrics for an account as of a specified date.

type Recommendation

type Recommendation struct {

	// The recommended course of action to remediate the finding.
	Text *string

	// The URL address to the recommendation for remediating the finding.
	Url *string
	// contains filtered or unexported fields
}

Information about the recommended course of action to remediate a finding.

type Remediation

type Remediation struct {

	// An object that contains information about the recommended course of action to
	// remediate a finding.
	Recommendation *Recommendation

	// A list of SuggestedFix objects. Each object contains information about a
	// suggested code fix to remediate the finding.
	SuggestedFixes []SuggestedFix
	// contains filtered or unexported fields
}

Information about how to remediate a finding.

type Resource

type Resource struct {

	// The scanName of the scan that was run on the resource.
	Id *string

	// The identifier for a section of the resource.
	SubResourceId *string
	// contains filtered or unexported fields
}

Information about a resource that contains a finding.

type ResourceId

type ResourceId interface {
	// contains filtered or unexported methods
}

The identifier for a resource object that contains resources to scan. Specifying a codeArtifactId is required to create a scan.

The following types satisfy this interface:

ResourceIdMemberCodeArtifactId
Example (OutputUsage)
// Code generated by smithy-go-codegen DO NOT EDIT.

package main

import (
	"fmt"
	"github.com/aws/aws-sdk-go-v2/service/codegurusecurity/types"
)

func main() {
	var union types.ResourceId
	// type switches can be used to check the union value
	switch v := union.(type) {
	case *types.ResourceIdMemberCodeArtifactId:
		_ = v.Value // Value is string

	case *types.UnknownUnionMember:
		fmt.Println("unknown tag:", v.Tag)

	default:
		fmt.Println("union is nil or unknown type")

	}
}

var _ *string

type ResourceIdMemberCodeArtifactId

type ResourceIdMemberCodeArtifactId struct {
	Value string
	// contains filtered or unexported fields
}

The identifier for the code file uploaded to the resource object. Returned by CreateUploadUrl when you upload resources to be scanned.

type ResourceNotFoundException

type ResourceNotFoundException struct {
	Message *string

	ErrorCodeOverride *string

	ErrorCode_   *string
	ResourceId   *string
	ResourceType *string
	// contains filtered or unexported fields
}

The resource specified in the request was not found.

func (*ResourceNotFoundException) Error

func (e *ResourceNotFoundException) Error() string

func (*ResourceNotFoundException) ErrorCode

func (e *ResourceNotFoundException) ErrorCode() string

func (*ResourceNotFoundException) ErrorFault

func (*ResourceNotFoundException) ErrorMessage

func (e *ResourceNotFoundException) ErrorMessage() string

type ScanNameWithFindingNum

type ScanNameWithFindingNum struct {

	// The number of findings generated by a scan.
	FindingNumber *int32

	// The name of the scan.
	ScanName *string
	// contains filtered or unexported fields
}

Information about the number of findings generated by a scan.

type ScanState

type ScanState string
const (
	ScanStateInProgress ScanState = "InProgress"
	ScanStateSuccessful ScanState = "Successful"
	ScanStateFailed     ScanState = "Failed"
)

Enum values for ScanState

func (ScanState) Values

func (ScanState) Values() []ScanState

Values returns all known values for ScanState. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type ScanSummary

type ScanSummary struct {

	//  The time when the scan was created.
	//
	// This member is required.
	CreatedAt *time.Time

	// The identifier for the scan run.
	//
	// This member is required.
	RunId *string

	// The name of the scan.
	//
	// This member is required.
	ScanName *string

	// The state of the scan. A scan can be In Progress , Complete , or Failed .
	//
	// This member is required.
	ScanState ScanState

	// The ARN for the scan name.
	ScanNameArn *string

	// The time the scan was last updated. A scan is updated when it is re-run.
	UpdatedAt *time.Time
	// contains filtered or unexported fields
}

Information about a scan.

type ScanType

type ScanType string
const (
	ScanTypeStandard ScanType = "Standard"
	ScanTypeExpress  ScanType = "Express"
)

Enum values for ScanType

func (ScanType) Values

func (ScanType) Values() []ScanType

Values returns all known values for ScanType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type Severity

type Severity string
const (
	SeverityCritical Severity = "Critical"
	SeverityHigh     Severity = "High"
	SeverityMedium   Severity = "Medium"
	SeverityLow      Severity = "Low"
	SeverityInfo     Severity = "Info"
)

Enum values for Severity

func (Severity) Values

func (Severity) Values() []Severity

Values returns all known values for Severity. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type Status

type Status string
const (
	StatusClosed Status = "Closed"
	StatusOpen   Status = "Open"
	StatusAll    Status = "All"
)

Enum values for Status

func (Status) Values

func (Status) Values() []Status

Values returns all known values for Status. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type SuggestedFix

type SuggestedFix struct {

	// The suggested code fix. If applicable, includes code patch to replace your
	// source code.
	Code *string

	// A description of the suggested code fix and why it is being suggested.
	Description *string
	// contains filtered or unexported fields
}

Information about the suggested code fix to remediate a finding.

type ThrottlingException

type ThrottlingException struct {
	Message *string

	ErrorCodeOverride *string

	ErrorCode_  *string
	ServiceCode *string
	QuotaCode   *string
	// contains filtered or unexported fields
}

The request was denied due to request throttling.

func (*ThrottlingException) Error

func (e *ThrottlingException) Error() string

func (*ThrottlingException) ErrorCode

func (e *ThrottlingException) ErrorCode() string

func (*ThrottlingException) ErrorFault

func (e *ThrottlingException) ErrorFault() smithy.ErrorFault

func (*ThrottlingException) ErrorMessage

func (e *ThrottlingException) ErrorMessage() string

type UnknownUnionMember

type UnknownUnionMember struct {
	Tag   string
	Value []byte
	// contains filtered or unexported fields
}

UnknownUnionMember is returned when a union member is returned over the wire, but has an unknown tag.

type ValidationException

type ValidationException struct {
	Message *string

	ErrorCodeOverride *string

	ErrorCode_ *string
	Reason     ValidationExceptionReason
	FieldList  []ValidationExceptionField
	// contains filtered or unexported fields
}

The input fails to satisfy the specified constraints.

func (*ValidationException) Error

func (e *ValidationException) Error() string

func (*ValidationException) ErrorCode

func (e *ValidationException) ErrorCode() string

func (*ValidationException) ErrorFault

func (e *ValidationException) ErrorFault() smithy.ErrorFault

func (*ValidationException) ErrorMessage

func (e *ValidationException) ErrorMessage() string

type ValidationExceptionField

type ValidationExceptionField struct {

	// Describes the exception.
	//
	// This member is required.
	Message *string

	// The name of the exception.
	//
	// This member is required.
	Name *string
	// contains filtered or unexported fields
}

Information about a validation exception.

type ValidationExceptionReason

type ValidationExceptionReason string
const (
	ValidationExceptionReasonUnknownOperation      ValidationExceptionReason = "unknownOperation"
	ValidationExceptionReasonCannotParse           ValidationExceptionReason = "cannotParse"
	ValidationExceptionReasonFieldValidationFailed ValidationExceptionReason = "fieldValidationFailed"
	ValidationExceptionReasonOther                 ValidationExceptionReason = "other"
	ValidationExceptionReasonLambdaCodeShaMismatch ValidationExceptionReason = "lambdaCodeShaMisMatch"
)

Enum values for ValidationExceptionReason

func (ValidationExceptionReason) Values

Values returns all known values for ValidationExceptionReason. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type Vulnerability

type Vulnerability struct {

	//  An object that describes the location of the detected security vulnerability
	// in your code.
	FilePath *FilePath

	// The identifier for the vulnerability.
	Id *string

	// The number of times the vulnerability appears in your code.
	//
	// Deprecated: This shape is not used.
	ItemCount *int32

	// One or more URL addresses that contain details about a vulnerability.
	ReferenceUrls []string

	// One or more vulnerabilities that are related to the vulnerability being
	// described.
	RelatedVulnerabilities []string
	// contains filtered or unexported fields
}

Information about a security vulnerability that Amazon CodeGuru Security detected.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL