Skip to content

CloudFormation  >  Operations  >  describe_resource_scan

describe_resource_scan

Operation

describe_resource_scan async

describe_resource_scan(input: DescribeResourceScanInput, plugins: list[Plugin] | None = None) -> DescribeResourceScanOutput

Describes details of a resource scan.

Parameters:

Name Type Description Default
input DescribeResourceScanInput

An instance of DescribeResourceScanInput.

required
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
DescribeResourceScanOutput

An instance of DescribeResourceScanOutput.

Input

DescribeResourceScanInput dataclass

Bases: _SerdeShape

Dataclass for DescribeResourceScanInput structure.

Attributes

resource_scan_id class-attribute instance-attribute
resource_scan_id: str | None = ...

The Amazon Resource Name (ARN) of the resource scan.

Output

DescribeResourceScanOutput dataclass

Bases: _SerdeShape

Dataclass for DescribeResourceScanOutput structure.

Attributes

end_time class-attribute instance-attribute
end_time: datetime | None = ...

The time that the resource scan was finished.

percentage_completed class-attribute instance-attribute
percentage_completed: float | None = ...

The percentage of the resource scan that has been completed.

resource_scan_id class-attribute instance-attribute
resource_scan_id: str | None = ...

The Amazon Resource Name (ARN) of the resource scan. The format is arn:${Partition}:cloudformation:${Region}:${Account}:resourceScan/${Id}. An example is arn:aws:cloudformation:us-east-1:123456789012:resourceScan/f5b490f7-7ed4-428a-aa06-31ff25db0772.

resource_types class-attribute instance-attribute
resource_types: list[str] | None = ...

The list of resource types for the specified scan. Resource types are only available for scans with a Status set to COMPLETE or FAILED.

resources_read class-attribute instance-attribute
resources_read: int | None = ...

The number of resources that were read. This is only available for scans with a Status set to COMPLETE, EXPIRED, or FAILED.

Note

This field may be 0 if the resource scan failed with a ResourceScanLimitExceededException.

resources_scanned class-attribute instance-attribute
resources_scanned: int | None = ...

The number of resources that were listed. This is only available for scans with a Status set to COMPLETE, EXPIRED, or FAILED.

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.

scan_filters class-attribute instance-attribute
scan_filters: list[ScanFilter] | None = ...

The scan filters that were used.

start_time class-attribute instance-attribute
start_time: datetime | None = ...

The time that the resource scan was started.

status class-attribute instance-attribute
status: str | None = ...

Status of the resource scan.

IN_PROGRESS

The resource scan is still in progress.

COMPLETE

The resource scan is complete.

EXPIRED

The resource scan has expired.

FAILED

The resource scan has failed.

status_reason class-attribute instance-attribute
status_reason: str | None = ...

The reason for the resource scan status, providing more information if a failure happened.