Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS SDKs 사용하는 Amazon Inspector에 대한 작업
다음 코드 예제에서는 AWS SDKs를 사용하여 개별 Amazon Inspector 작업을 수행하는 방법을 보여줍니다. 각 예시에는 GitHub에 대한 링크가 포함되어 있습니다. 여기에서 코드 설정 및 실행에 대한 지침을 찾을 수 있습니다.
다음 예제에는 가장 일반적으로 사용되는 작업만 포함되어 있습니다. 전체 목록은 [Amazon Inspector API 참조](https://docs.aws.amazon.com/inspector/latest/APIReference/Welcome.html)를 참조하세요.
**Topics**
+ [`BatchGetAccountStatus`](inspector_example_inspector_GetAccountStatus_section.md)
+ [`BatchGetFindingDetails`](inspector_example_inspector_BatchGetFindingDetails_section.md)
+ [`CreateFilter`](inspector_example_inspector_CreateFilter_section.md)
+ [`DeleteFilter`](inspector_example_inspector_DeleteFilter_section.md)
+ [`Disable`](inspector_example_inspector_Disable_section.md)
+ [`Enable`](inspector_example_inspector_Enable_section.md)
+ [`ListCoverage`](inspector_example_inspector_ListCoverage_section.md)
+ [`ListCoverageStatistics`](inspector_example_inspector_ListCoverageStatistics_section.md)
+ [`ListFilters`](inspector_example_inspector_ListFilters_section.md)
+ [`ListFindings`](inspector_example_inspector_ListFindings_section.md)
+ [`ListUsageTotals`](inspector_example_inspector_ListUsageTotals_section.md)
# AWS SDK와 `BatchGetAccountStatus` 함께 사용
다음 코드 예시는 `BatchGetAccountStatus`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Retrieves the account status using the Inspector2Client.
*/
public CompletableFuture getAccountStatusAsync() {
BatchGetAccountStatusRequest request = BatchGetAccountStatusRequest.builder()
.accountIds(Collections.emptyList())
.build();
return getAsyncClient().batchGetAccountStatus(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof AccessDeniedException) {
throw new CompletionException(
"You do not have sufficient access: %s".formatted(cause.getMessage()),
cause
);
}
if (cause instanceof Inspector2Exception) {
Inspector2Exception e = (Inspector2Exception) cause;
throw new CompletionException(
"Inspector2 service error: %s".formatted(e.awsErrorDetails().errorMessage()),
e
);
}
throw new CompletionException(
"Unexpected error getting account status: %s".formatted(exception.getMessage()),
exception
);
}
})
.thenApply(response -> {
StringBuilder sb = new StringBuilder();
List accounts = response.accounts();
if (accounts == null || accounts.isEmpty()) {
sb.append("No account status returned.\n");
return sb.toString();
}
sb.append("Inspector Account Status:\n");
for (AccountState account : accounts) {
String accountId = account.accountId() != null
? account.accountId()
: "Unknown";
sb.append(" Account ID: ").append(accountId).append("\n");
// Overall account state
if (account.state() != null && account.state().status() != null) {
sb.append(" Overall State: ")
.append(account.state().status())
.append("\n");
} else {
sb.append(" Overall State: Unknown\n");
}
// Resource state (only status available)
ResourceState resources = account.resourceState();
if (resources != null) {
sb.append(" Resource Status: available\n");
}
sb.append("\n");
}
return sb.toString();
});
}
```
+ API 세부 정보는 API 참조의 [BatchGetAccountStatus](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/BatchGetAccountStatus)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `BatchGetFindingDetails` 함께 사용
다음 코드 예시는 `BatchGetFindingDetails`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Retrieves detailed information about a specific AWS Inspector2 finding asynchronously.
*
* @param findingArn The ARN of the finding to look up.
* @return A {@link CompletableFuture} that, when completed, provides a formatted string
* containing all available details for the finding.
* @throws RuntimeException if the async call to Inspector2 fails.
*/
public CompletableFuture getFindingDetailsAsync(String findingArn) {
BatchGetFindingDetailsRequest request = BatchGetFindingDetailsRequest.builder()
.findingArns(findingArn)
.build();
return getAsyncClient().batchGetFindingDetails(request)
.thenApply(response -> {
if (response.findingDetails() == null || response.findingDetails().isEmpty()) {
return String.format("No details found for ARN: ", findingArn);
}
StringBuilder sb = new StringBuilder();
response.findingDetails().forEach(detail -> {
sb.append("Finding ARN: ").append(detail.findingArn()).append("\n")
.append("Risk Score: ").append(detail.riskScore()).append("\n");
// ExploitObserved timings
if (detail.exploitObserved() != null) {
sb.append("Exploit First Seen: ").append(detail.exploitObserved().firstSeen()).append("\n")
.append("Exploit Last Seen: ").append(detail.exploitObserved().lastSeen()).append("\n");
}
// Reference URLs
if (detail.hasReferenceUrls()) {
sb.append("Reference URLs:\n");
detail.referenceUrls().forEach(url -> sb.append(" • ").append(url).append("\n"));
}
// Tools
if (detail.hasTools()) {
sb.append("Tools:\n");
detail.tools().forEach(tool -> sb.append(" • ").append(tool).append("\n"));
}
// TTPs
if (detail.hasTtps()) {
sb.append("TTPs:\n");
detail.ttps().forEach(ttp -> sb.append(" • ").append(ttp).append("\n"));
}
// CWEs
if (detail.hasCwes()) {
sb.append("CWEs:\n");
detail.cwes().forEach(cwe -> sb.append(" • ").append(cwe).append("\n"));
}
// Evidence
if (detail.hasEvidences()) {
sb.append("Evidence:\n");
detail.evidences().forEach(ev -> {
sb.append(" - Severity: ").append(ev.severity()).append("\n");
});
}
sb.append("\n");
});
return sb.toString();
})
.exceptionally(ex -> {
Throwable cause = ex.getCause() != null ? ex.getCause() : ex;
if (cause instanceof ResourceNotFoundException rnfe) {
return "Finding not found: %s".formatted(findingArn);
}
// Fallback for other exceptions
throw new RuntimeException("Failed to get finding details for ARN: " + findingArn, cause);
});
}
```
+ API 세부 정보는 API 참조의 [BatchGetFindingDetails](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/BatchGetFindingDetails)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `CreateFilter` 함께 사용
다음 코드 예시는 `CreateFilter`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Creates a new LOW severity filter in AWS Inspector2 to suppress findings.
*
* @param filterName the name of the filter to create
* @param description a descriptive string explaining the purpose of the filter
* @return a CompletableFuture that completes with the ARN of the created filter
* @throws CompletionException wraps any validation, Inspector2 service, or unexpected errors
*/
public CompletableFuture createLowSeverityFilterAsync(
String filterName,
String description) {
// Define a filter to match LOW severity findings.
StringFilter severityFilter = StringFilter.builder()
.value(Severity.LOW.toString())
.comparison(StringComparison.EQUALS)
.build();
// Create filter criteria.
FilterCriteria filterCriteria = FilterCriteria.builder()
.severity(Collections.singletonList(severityFilter))
.build();
// Build the filter creation request.
CreateFilterRequest request = CreateFilterRequest.builder()
.name(filterName)
.filterCriteria(filterCriteria)
.action(FilterAction.SUPPRESS)
.description(description)
.build();
return getAsyncClient().createFilter(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause() != null ? exception.getCause() : exception;
if (cause instanceof ValidationException ve) {
throw new CompletionException(
"Validation error creating filter: %s".formatted(ve.getMessage()),
ve
);
}
if (cause instanceof Inspector2Exception e) {
throw new CompletionException(
"Inspector2 service error: %s".formatted(e.awsErrorDetails().errorMessage()),
e
);
}
// Unexpected async error
throw new CompletionException(
"Unexpected error creating filter: %s".formatted(exception.getMessage()),
exception
);
}
})
// Extract and return the ARN of the created filter.
.thenApply(CreateFilterResponse::arn);
}
```
+ API에 대한 세부 정보는 *AWS SDK for Java 2.x API 참조*의 [CreateFilter](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/CreateFilter)를 참조하세요.
------
# AWS SDK와 `DeleteFilter` 함께 사용
다음 코드 예시는 `DeleteFilter`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Deletes an AWS Inspector2 filter.
*
* @param filterARN The ARN of the filter to delete.
*/
public CompletableFuture deleteFilterAsync(String filterARN) {
return getAsyncClient().deleteFilter(
DeleteFilterRequest.builder()
.arn(filterARN)
.build()
)
.handle((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause() != null ? exception.getCause() : exception;
if (cause instanceof ResourceNotFoundException rnfe) {
String msg = "Filter not found for ARN: %s".formatted(filterARN);
logger.warn(msg, rnfe);
throw new CompletionException(msg, rnfe);
}
throw new RuntimeException("Failed to delete the filter: " + cause, cause);
}
return null;
});
}
```
+ API 세부 정보는 API 참조의 [DeleteFilter](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/DeleteFilter)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `Disable` 함께 사용
다음 코드 예시는 `Disable`의 사용 방법을 보여 줍니다.
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Asynchronously disables AWS Inspector for the specified accounts and resource types.
*
* @param accountIds a {@link List} of AWS account IDs for which to disable Inspector;
* may be {@code null} or empty to target the current account
* @return a {@link CompletableFuture} that, when completed, returns a {@link String}
* summarizing the disable results for each account
* @throws CompletionException if the disable operation fails due to validation errors,
* service errors, or other exceptions
* @see
* AWS Inspector2 Disable API
*/
public CompletableFuture disableInspectorAsync(List accountIds) {
// The resource types to disable.
List resourceTypes = List.of(
ResourceScanType.EC2,
ResourceScanType.ECR,
ResourceScanType.LAMBDA,
ResourceScanType.LAMBDA_CODE
);
// Build the request.
DisableRequest.Builder requestBuilder = DisableRequest.builder()
.resourceTypes(resourceTypes);
if (accountIds != null && !accountIds.isEmpty()) {
requestBuilder.accountIds(accountIds);
}
DisableRequest request = requestBuilder.build();
return getAsyncClient().disable(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof ValidationException) {
throw new CompletionException(
"Inspector may already be disabled for this account: %s".formatted(cause.getMessage()),
cause
);
}
if (cause instanceof Inspector2Exception) {
Inspector2Exception e = (Inspector2Exception) cause;
throw new CompletionException(
"AWS Inspector2 service error: %s".formatted(e.awsErrorDetails().errorMessage()),
cause
);
}
throw new CompletionException(
"Failed to disable Inspector: %s".formatted(exception.getMessage()),
exception
);
}
})
.thenApply(response -> {
StringBuilder summary = new StringBuilder("Disable results:\n");
if (response.accounts() == null || response.accounts().isEmpty()) {
summary.append("Inspector may already be disabled for all target accounts.");
return summary.toString();
}
for (Account account : response.accounts()) {
String accountId = account.accountId() != null ? account.accountId() : "Unknown";
String status = account.status() != null ? account.statusAsString() : "Unknown";
summary.append(" • Account: ").append(accountId)
.append(" → Status: ").append(status).append("\n");
}
return summary.toString();
});
}
```
+ API 세부 정보는 API 참조의 [비활성화](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/Disable)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `Enable` 함께 사용
다음 코드 예시는 `Enable`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Enables AWS Inspector for the provided account(s) and default resource types.
*
* @param accountIds Optional list of AWS account IDs.
*/
public CompletableFuture enableInspectorAsync(List accountIds) {
// The resource types to enable.
List resourceTypes = List.of(
ResourceScanType.EC2,
ResourceScanType.ECR,
ResourceScanType.LAMBDA,
ResourceScanType.LAMBDA_CODE
);
// Build the request.
EnableRequest.Builder requestBuilder = EnableRequest.builder()
.resourceTypes(resourceTypes);
if (accountIds != null && !accountIds.isEmpty()) {
requestBuilder.accountIds(accountIds);
}
EnableRequest request = requestBuilder.build();
return getAsyncClient().enable(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof ValidationException) {
throw new CompletionException(
"Inspector may already be enabled for this account: %s".formatted(cause.getMessage()),
cause
);
}
if (cause instanceof Inspector2Exception) {
Inspector2Exception e = (Inspector2Exception) cause;
throw new CompletionException(
"AWS Inspector2 service error: %s".formatted(e.awsErrorDetails().errorMessage()),
cause
);
}
throw new CompletionException(
"Failed to enable Inspector: %s".formatted(exception.getMessage()),
exception
);
}
})
.thenApply(response -> {
StringBuilder summary = new StringBuilder("Enable results:\n");
if (response.accounts() == null || response.accounts().isEmpty()) {
summary.append("Inspector may already be enabled for all target accounts.");
return summary.toString();
}
for (Account account : response.accounts()) {
String accountId = account.accountId() != null ? account.accountId() : "Unknown";
String status = account.status() != null ? account.statusAsString() : "Unknown";
summary.append(" • Account: ").append(accountId)
.append(" → Status: ").append(status).append("\n");
}
return summary.toString();
});
}
```
+ API 세부 정보는 API 참조의 [활성화](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/Enable)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `ListCoverage` 함께 사용
다음 코드 예시는 `ListCoverage`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Lists AWS Inspector2 coverage details for scanned resources using a paginator.
*
* @param maxResults Maximum number of resources to return.
*/
public CompletableFuture listCoverageAsync(int maxResults) {
ListCoverageRequest initialRequest = ListCoverageRequest.builder()
.maxResults(maxResults)
.build();
ListCoveragePublisher paginator = getAsyncClient().listCoveragePaginator(initialRequest);
StringBuilder summary = new StringBuilder();
return paginator.subscribe(response -> {
List coveredResources = response.coveredResources();
if (coveredResources == null || coveredResources.isEmpty()) {
summary.append("No coverage information available for this page.\n");
return;
}
Map> byType = coveredResources.stream()
.collect(Collectors.groupingBy(CoveredResource::resourceTypeAsString));
byType.forEach((type, list) ->
summary.append(" ").append(type)
.append(": ").append(list.size())
.append(" resource(s)\n")
);
// Include up to 3 sample resources per page
for (int i = 0; i < Math.min(coveredResources.size(), 3); i++) {
CoveredResource r = coveredResources.get(i);
summary.append(" - ").append(r.resourceTypeAsString())
.append(": ").append(r.resourceId()).append("\n");
summary.append(" Scan Type: ").append(r.scanTypeAsString()).append("\n");
if (r.scanStatus() != null) {
summary.append(" Status: ").append(r.scanStatus().statusCodeAsString()).append("\n");
}
if (r.accountId() != null) {
summary.append(" Account ID: ").append(r.accountId()).append("\n");
}
summary.append("\n");
}
}).thenApply(v -> {
if (summary.length() == 0) {
return "No coverage information found across all pages.";
} else {
return "Coverage Information:\n" + summary.toString();
}
}).exceptionally(ex -> {
Throwable cause = ex.getCause();
if (cause instanceof ValidationException) {
throw new CompletionException(
"Validation error listing coverage: " + cause.getMessage(), cause);
} else if (cause instanceof Inspector2Exception e) {
throw new CompletionException(
"Inspector2 service error: " + e.awsErrorDetails().errorMessage(), e);
}
throw new CompletionException("Unexpected error listing coverage: " + ex.getMessage(), ex);
});
}
```
+ API 세부 정보는 API 참조의 [ListCoverage](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListCoverage)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `ListCoverageStatistics` 함께 사용
다음 코드 예시는 `ListCoverageStatistics`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Retrieves and prints the coverage statistics using a paginator.
*/
public CompletableFuture listCoverageStatisticsAsync() {
ListCoverageStatisticsRequest request = ListCoverageStatisticsRequest.builder()
.build();
return getAsyncClient().listCoverageStatistics(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof ValidationException) {
throw new CompletionException(
"Validation error listing coverage statistics: %s".formatted(cause.getMessage()),
cause
);
}
if (cause instanceof Inspector2Exception) {
Inspector2Exception e = (Inspector2Exception) cause;
throw new CompletionException(
"Inspector2 service error: %s".formatted(e.awsErrorDetails().errorMessage()),
e
);
}
throw new CompletionException(
"Unexpected error listing coverage statistics: %s".formatted(exception.getMessage()),
exception
);
}
})
.thenApply(response -> {
List countsList = response.countsByGroup();
StringBuilder sb = new StringBuilder();
if (countsList == null || countsList.isEmpty()) {
sb.append("No coverage statistics available.\n");
return sb.toString();
}
sb.append("Coverage Statistics:\n");
for (Counts c : countsList) {
sb.append(" Group: ").append(c.groupKey()).append("\n")
.append(" Total Count: ").append(c.count()).append("\n\n");
}
return sb.toString();
});
}
```
+ API 세부 정보는 API 참조의 [ListCoverageStatistics](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListCoverageStatistics)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `ListFilters` 함께 사용
다음 코드 예시는 `ListFilters`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Asynchronously lists Inspector2 filters using a paginator.
*
* @param maxResults maximum filters per page (nullable)
* @return CompletableFuture completed with summary text
*/
public CompletableFuture listFiltersAsync(Integer maxResults) {
logger.info("Starting async filters paginator…");
ListFiltersRequest.Builder builder = ListFiltersRequest.builder();
if (maxResults != null) {
builder.maxResults(maxResults);
}
ListFiltersRequest request = builder.build();
// Paginator from SDK
ListFiltersPublisher paginator = getAsyncClient().listFiltersPaginator(request);
StringBuilder collectedFilterIds = new StringBuilder();
return paginator.subscribe(response -> {
response.filters().forEach(filter -> {
logger.info("Filter: " + filter.arn());
collectedFilterIds.append(filter.arn()).append("\n");
});
}).thenApply(v -> {
String result = collectedFilterIds.toString();
logger.info("Successfully listed all filters.");
return result.isEmpty() ? "No filters found." : result;
}).exceptionally(ex -> {
Throwable cause = ex.getCause() != null ? ex.getCause() : ex;
if (cause instanceof ValidationException ve) {
throw new CompletionException(
"Validation error listing filters: %s".formatted(ve.getMessage()),
ve
);
}
throw new RuntimeException("Failed to list filters", ex);
});
}
```
+ API 세부 정보는 API 참조의 [ListFilters](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListFilters)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK 또는 CLI와 `ListFindings` 함께 사용
다음 코드 예시는 `ListFindings`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서는 컨텍스트 내에서 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ CLI ]
**AWS CLI**
**조사 결과를 나열하는 방법**
다음 `list-findings` 명령은 생성된 모든 결과를 나열합니다.
```
aws inspector list-findings
```
출력:
```
{
"findingArns": [
"arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE/finding/0-HwPnsDm4",
"arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-v5D6fI3v/finding/0-tyvmqBLy"
]
}
```
자세한 내용은 *Amazon Inspector* 사용 설명서의 Amazon Inspector Findings를 참조하세요.
+ API 세부 정보는 *AWS CLI 명령 참조*의 [ListFindings](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/inspector/list-findings.html) 섹션을 참조하세요.
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Lists all AWS Inspector findings of LOW severity asynchronously.
*
* @return CompletableFuture containing a List of finding ARNs.
* Returns an empty list if no LOW severity findings are found.
*/
public CompletableFuture> listLowSeverityFindingsAsync() {
logger.info("Starting async LOW severity findings paginator…");
// Build a filter criteria for LOW severity.
StringFilter severityFilter = StringFilter.builder()
.value(Severity.LOW.toString())
.comparison(StringComparison.EQUALS)
.build();
FilterCriteria filterCriteria = FilterCriteria.builder()
.severity(Collections.singletonList(severityFilter))
.build();
// Build the request.
ListFindingsRequest request = ListFindingsRequest.builder()
.filterCriteria(filterCriteria)
.build();
ListFindingsPublisher paginator = getAsyncClient().listFindingsPaginator(request);
List allArns = Collections.synchronizedList(new ArrayList<>());
return paginator.subscribe(response -> {
if (response.findings() != null && !response.findings().isEmpty()) {
response.findings().forEach(finding -> {
logger.info("Finding ARN: {}", finding.findingArn());
allArns.add(finding.findingArn());
});
} else {
logger.info("Page contained no findings.");
}
})
.thenRun(() -> logger.info("Successfully listed all LOW severity findings."))
.thenApply(v -> new ArrayList<>(allArns)) // Return list instead of a formatted string
.exceptionally(ex -> {
Throwable cause = ex.getCause() != null ? ex.getCause() : ex;
if (cause instanceof ValidationException ve) {
throw new CompletionException(
"Validation error listing LOW severity findings: %s".formatted(ve.getMessage()),
ve
);
}
throw new RuntimeException("Failed to list LOW severity findings", ex);
});
}
```
+ API 세부 정보는 API 참조의 [ListFindings](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListFindings)*AWS SDK for Java 2.x 를 참조*하세요.
------
# AWS SDK와 `ListUsageTotals` 함께 사용
다음 코드 예시는 `ListUsageTotals`의 사용 방법을 보여 줍니다.
작업 예제는 대규모 프로그램에서 발췌한 코드이며 컨텍스트에 맞춰 실행해야 합니다. 다음 코드 예제에서 컨텍스트 내 이 작업을 확인할 수 있습니다.
+ [기본 사항 알아보기](inspector_example_inspector_Scenario_section.md)
------
#### [ Java ]
**SDK for Java 2.x**
GitHub에 더 많은 내용이 있습니다. [AWS 코드 예 리포지토리](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/inspector#code-examples)에서 전체 예를 찾고 설정 및 실행하는 방법을 배워보세요.
```
/**
* Asynchronously lists Inspector2 usage totals using a paginator.
*
* @param accountIds optional list of account IDs
* @param maxResults maximum results per page
* @return CompletableFuture completed with formatted summary text
*/
public CompletableFuture listUsageTotalsAsync(
List accountIds,
int maxResults) {
logger.info("Starting usage totals paginator…");
ListUsageTotalsRequest.Builder builder = ListUsageTotalsRequest.builder()
.maxResults(maxResults);
if (accountIds != null && !accountIds.isEmpty()) {
builder.accountIds(accountIds);
}
ListUsageTotalsRequest request = builder.build();
ListUsageTotalsPublisher paginator = getAsyncClient().listUsageTotalsPaginator(request);
StringBuilder summaryBuilder = new StringBuilder();
return paginator.subscribe(response -> {
if (response.totals() != null && !response.totals().isEmpty()) {
response.totals().forEach(total -> {
if (total.usage() != null) {
total.usage().forEach(usage -> {
logger.info("Usage: {} = {}", usage.typeAsString(), usage.total());
summaryBuilder.append(usage.typeAsString())
.append(": ")
.append(usage.total())
.append("\n");
});
}
});
} else {
logger.info("Page contained no usage totals.");
}
}).thenRun(() -> logger.info("Successfully listed usage totals."))
.thenApply(v -> {
String summary = summaryBuilder.toString();
return summary.isEmpty() ? "No usage totals found." : summary;
}).exceptionally(ex -> {
Throwable cause = ex.getCause() != null ? ex.getCause() : ex;
if (cause instanceof ValidationException ve) {
throw new CompletionException(
"Validation error listing usage totals: %s".formatted(ve.getMessage()),
ve
);
}
throw new CompletionException("Failed to list usage totals", cause);
});
}
```
+ API 세부 정보는 API 참조의 *AWS SDK for Java 2.x * [ListUsageTotals](https://docs.aws.amazon.com/goto/SdkForJavaV2/inspector-2016-02-16/ListUsageTotals).
------