# Cloud Custodian 0.9.48.0

2025-12-01 · [릴리스 노트 원문](https://github.com/cloud-custodian/cloud-custodian/releases/tag/0.9.48.0) · [전체 정리](https://ratatosk.io/ko/releases/cloud-custodian/0.9.48.0)

호환성 변경 13 · 중요 수정 9 · 기능·개선 47 · 의존성 갱신 6 · 기타 12

## 호환성 변경 (13)

### Firehose 삭제 액션의 일시 중지 스트림 삭제 시도

- 영향 대상: 상태가 SUSPENDED인 AWS Firehose 전송 스트림

이전에는 이 액션이 일시 중지된 스트림을 건너뛰었으며, 상태 검사에서 `ACTIVE` 상태인 스트림만 삭제 대상으로 통과했습니다.

>  - aws - firehose - delete action add support for suspended streams (#10397)

### `Administrator`를 사용하는 GuardDuty 관리자 계정 조회

- 영향 대상: `guard-duty` 필터에서 관리자 계정 속성을 사용하는 AWS GuardDuty 정책 (추정)

필터가 관리자 계정 데이터를 가져올 때 API는 `Administrator`를 반환했지만, 기존 조회는 `Master`를 조회해 예상한 키로 데이터를 가져오지 못했습니다. 이제 필터는 `Administrator`를 읽고 해당 키로 `c7n:guard-duty` 어노테이션에 저장합니다.

근거: “The `get_administrator_account` API returns an `Administrator` key, not `Master`.” https://github.com/cloud-custodian/cloud-custodian/pull/10376

>  - fix(guardduty): use correct key for administrator account (#10376)

### 선택한 프로필에서 인증 정보를 읽는 TencentCloud

- 영향 대상: `--profile`을 사용하고 `~/.tencentcloud/credentials`에 프로필을 둔 TencentCloud 설정 (추정)

인증 정보 파일이 없거나 요청한 프로필을 찾지 못하면 예외가 발생합니다.

근거: “+ raise TencentCloudSDKException( + "Credentials file not found: %s" % config_path + )” https://github.com/cloud-custodian/cloud-custodian/pull/10337

>  - tencentcloud: fix metrics service name, enforce batching limits, and annotate resources with metrics (#10337)

### 디렉터리 쿼리에서 `list_directories` 방식의 키-값 쌍 사용

- 영향 대상: 서버 측 쿼리 매개변수를 사용하는 AWS Directory 정책

기존의 `Name`, `Values` 목록 형식으로 작성한 쿼리는 `Filters`에 전달되어 boto3 `ParamValidationError`를 일으켰습니다. `name` 및 `directoryArn` 쿼리 매개변수는 더 이상 지원되지 않습니다.

근거: “For Directories, name and directoryArn are not valid query parameters. They're from the API response, so they were removed. Additionally, directory queries are bugged in their current implementation as they are placed under a 'Filters' key which causes boto3 to throw `botocore.exceptions.ParamValidationError: Parameter validation failed: Unknown parameter in input: "Filters", must be one of: NextToken, MaxResults, state`, so the current version of directory queries as a list of "Name", "Values" dictionaries will no longer be supported in favor of key value pairs to mirror the list_directories API structure.” https://github.com/cloud-custodian/cloud-custodian/pull/10388

>  - aws - core - consolidated query parsing (#10388)

### EBS Volume 쿼리 파라미터의 문자열 enum 사용

- 영향 대상: 서버 측 불리언 쿼리 파라미터를 사용하는 AWS EBS Volume 정책

이전에는 이 파라미터를 불리언으로 처리했지만, 이제 허용되는 값은 `true`와 `false` 문자열입니다.

근거: “Integrated recent implementation for EBS Volume queries which use the same format as EBS Snapshots. Small breaking change to correct the type of the boolean query params. They are not true booleans. They are string enums with values or 'true' or 'false'” https://github.com/cloud-custodian/cloud-custodian/pull/10388

>  - aws - core - consolidated query parsing (#10388)

### FSx 삭제 액션의 삭제 오류 전파

- 영향 대상: FSx 삭제 액션

삭제 호출에서 `BadRequest`가 발생하면 이전에는 액션이 경고를 로그에 남긴 뒤 예외를 억제해 실패를 알리지 않고 끝날 수 있었습니다. 이제 `BadRequest`를 포함한 모든 삭제 예외를 오류로 로그에 남기고 전파합니다.

근거: “except Exception as e:” https://github.com/cloud-custodian/cloud-custodian/pull/10391

>  - aws - fsx - delete-file-system support other fsx types (#10391)

### 스케줄 모드 Lambda 대상 ARN에서 버전 또는 별칭 한정자 제거

- 영향 대상: 버전 또는 별칭으로 한정된 Lambda 함수 ARN을 사용하는 AWS 스케줄 모드 정책 (추정)

이전에는 스케줄 대상 ARN 끝에 Lambda 버전을 포함할 수 있었습니다.

근거: “When running `custodian run` with a policy that is a schedule, the resulting schedule target ARN can be fully qualified with the version at the end” https://github.com/cloud-custodian/cloud-custodian/pull/10407

>  - aws - schedule mode - strip version from eventbridge schedule target arn (#10407)

### Azure 워크로드 아이덴티티 인증 지원 추가

- 영향 대상: `AZURE_FEDERATED_TOKEN_FILE`로 구성된 Azure 환경
- 필요 조치: 업그레이드 전 `azure-identity` 의존성 버전 1.13.0 이상, 2.0.0 미만

이전에는 Azure 세션에 페더레이션 토큰 파일 인증이 포함되지 않았습니다.

>  - azure - AKS / ACI Azure Container Host Enhancements (#10395)

### `opswork-stack` 조회 및 액션 비활성화

- 영향 대상: `opswork-stack` 리소스를 사용하는 정책 (추정)

이전에는 이 리소스가 OpsWorks 스택을 조회했으며, `delete` 및 `stop` 액션은 OpsWorks API를 호출해 해당 스택을 삭제하거나 중지했습니다.

근거: “"""OpsWorks Stack is no longer an available service. This resource” https://github.com/cloud-custodian/cloud-custodian/pull/10383

>  - releng - 2025/10 increment versions and update dependencies (#10383)

### `opswork-cm`이 리소스를 반환하지 않고 `delete`가 작동하지 않음

- 영향 대상: `opswork-cm` 리소스 또는 해당 `delete` 액션을 사용하는 정책 (추정)

이전에는 해당 리소스가 OpsWorks CM 서버를 조회했고, `delete`는 OpsWorks CM API를 호출해 서버를 삭제했습니다.

근거: “"""OpsWorks CM is no longer an available service. This resource” https://github.com/cloud-custodian/cloud-custodian/pull/10383

>  - releng - 2025/10 increment versions and update dependencies (#10383)

### `aws.opswork-stack`의 `metrics` 필터 제거

- 영향 대상: `aws.opswork-stack` 리소스에서 `metrics` 필터를 사용하는 정책

> - `aws.opswork-stack`
>   - removed filters: `metrics`

### `gcp.spanner-backup` 스키마에서 `metrics` 필터 제거

- 영향 대상: `gcp.spanner-backup` 스키마의 `metrics` 필터를 확인하는 구성 또는 검증기 (추정)

> - `gcp.spanner-backup`
>   - removed filters: `metrics`

### `metrics` 필터, `gcp.spanner-database-instance` 스키마에서 제거

- 영향 대상: `gcp.spanner-database-instance` 스키마를 사용하는 환경, 특히 `metrics`를 참조하는 설정이나 검증기 (추정)

> - `gcp.spanner-database-instance`
>   - removed filters: `metrics`

## 중요 수정 (9)

### EBS 볼륨 조회 페이지네이션 수정

- 영향 대상: AWS `DescribeVolumes`를 사용하는 EBS 볼륨 조회

EBS 볼륨이 많은 계정에서 정책을 실행하면 클라이언트 측 필터링으로 시간 초과가 발생할 수 있었습니다. 또한 `maxResults`를 명시적으로 전달하지 않으면 `DescribeVolumes`가 페이지네이션을 수행하지 않았습니다. 이제 조회 시 `MaxResults`에 1000을 전달해 여러 API 호출에 걸쳐 볼륨을 가져옵니다.

>  - aws - ebs - add Server-Side Query Filtering  (#10393)

### AWS SSM 문서 `cross-account` 필터의 `everyone_only` 적용

- 영향 대상: AWS SSM 문서 `cross-account` 필터에서 `everyone_only: true`를 사용하는 경우

이전에는 필터가 이 제한을 적용하지 않고 공유 계정 항목을 포함했습니다. 이제 `all`과 공유된 문서만 크로스 계정 위반으로 선택됩니다. 기본값이 false인 동작은 바뀌지 않았습니다.

>  - aws - ssm-document - support everyone-only in cross-account filter (#10413)

### Artifact 도메인 교차 계정 필터의 이름 조회 수정

- 영향 대상: `aws.artifact-domain` 리소스에 `cross-account` 필터를 사용하는 정책 (추정)

필터를 평가할 때 도메인 이름이 `name`에 있는데도 `domainName`에서 찾았습니다. 이제 평가에 사용할 도메인 권한 정책을 가져올 때 `name`을 사용합니다.

>  - aws - artifact-domain - fix cross account filter (#10446)

### Comprehend 교차 계정 필터, 정책 없는 리소스 건너뜀

- 영향 대상: 엔터티 인식기 또는 문서 분류기에 적용되는 AWS Comprehend 교차 계정 필터

이전에는 정책이 없는 리소스를 스캔할 때 `KeyError: 'ResourcePolicy'`가 발생해 실행이 중단될 수 있었습니다. 이제 `ResourcePolicy` 키가 없는 리소스를 건너뛰고 스캔을 계속할 수 있습니다.

>  - Fixing KeyError in Comprehend cross-account filter when resource has no policy (#10355)

### `azure.keyvault-key` 정책 필터 수정

- 영향 대상: `azure.keyvault-key` 필터를 사용하는 정책 (추정)

호환되지 않는 SDK 업데이트가 필터에 영향을 주었습니다. 테스트에서 속성 경로를 `attributes.enabled`에서 `attributes.data.enabled`로 변경했습니다.

>  - azure - azure.keyvault-key: fix policy filter due to incompatible sdk update (#10368)

### GCP Spanner 메트릭 필터링 지원 추가

- 영향 대상: 메트릭 필터를 사용하는 GCP Spanner 인스턴스 리소스 (추정)

이전에는 `get_metric_resource_name`을 모든 경우에 사용할 수 없어 메트릭 필터에서 오류가 발생할 수 있었습니다.

>  - gcp - update metric support for spanner resources (#10374)

### Kubernetes `PatchAction`의 리소스 삭제로 발생한 404 오류 처리

- 영향 대상: Kubernetes `PatchAction` 패치 작업

정책 실행 중 리소스가 삭제되어 패치 작업에서 404가 발생하면 오류를 원활하게 처리합니다.

>  - kubernetes - enhanced PatchAction with save/restore functionality and improved error handling (#10288)

### TencentCloud metrics filter의 Monitor 클라이언트 서비스 이름 수정

- 영향 대상: TencentCloud metrics filter를 사용하는 설정 (추정)

Monitor API 클라이언트를 통한 요청에 잘못된 서비스 이름인 `service`를 사용해 요청이 실패했습니다. 이제 클라이언트가 `monitor`를 사용하므로 요청 실패가 줄어듭니다.

>  - tencentcloud: fix metrics service name, enforce batching limits, and annotate resources with metrics (#10337)

### TencentCloud 메트릭 요청 배치 제한 수정

- 영향 대상: TencentCloud 메트릭 필터 (추정)

이전에는 별도의 인스턴스 10개 제한을 적용하지 않고 데이터 포인트 1,440개 제한만으로 배치 크기를 계산했습니다.

>  - tencentcloud: fix metrics service name, enforce batching limits, and annotate resources with metrics (#10337)

## 기능·개선 (47)

- 계정 전체 AMI 퍼블릭 액세스 차단 필터링
- Global AWS `iam-access-key` 리소스 추가
- AWS Secrets Manager 복제본 속성 필터링
- AWS 서브넷용 `delete` 액션
- ElastiCache `cache-cluster` 업그레이드 가용성 필터 (사용 조건: `elasticache:DescribeServiceUpdates` 권한)
- AWS 서버 측 쿼리 지원 확장
- EBS 볼륨의 서버 측 쿼리 필터링 (사용 조건: EBS (`ebs`) 리소스에 `query` 지정)
- FSx 삭제 액션에 종속 리소스 및 생성 불가 Lustre Scratch 백업 강제 처리 추가 (사용 조건: FSx 삭제 액션의 `force: True`)
- FSx 삭제 재시도 설정 (사용 조건: 기본값 재정의를 위한 `retry-delay` 및/또는 `retry-max-attempts` 지정)
- AWS Kafka `cross-account` 리소스 정책 필터
- AWS Kafka 호환 버전 업그레이드 필터 추가
- AWS KMS `last-rotation` 정책 필터
- `lambda-event-source-mapping` 리소스 추가
- Lambda 이벤트 소스 매핑의 KMS 키 필터링
- Secrets Manager `current-version` 필터
- 서비스 쿼터 사용량 메트릭의 선택적 하드 리밋 지원 (사용 조건: `usage-metric` 필터에 선택적 `hard_limit` 매개변수 설정)
- WAFv2 `set-logging` 액션 추가 (사용 조건: `set-logging` 액션에 필요한 `destination`)
- VPC 리졸버 쿼리 로깅 필터 추가
- Connect 인스턴스용 분석 연결 필터 (사용 조건: `connect-instance` 정책의 `analytics-association` 필터)
- AWS VPC Lattice 리소스 및 필터 지원
- Application Load Balancer용 `delete-listener` 액션
- 예약 캐시 노드 조회용 신규 `aws.elasticache-reserved` 리소스
- Microsoft Graph의 `azure.entraid-user` 리소스 지원
- Azure Key Vault 키 속성 업데이트 액션
- GCP Certificate Manager 인증서 리소스 추가
- Kubernetes `PatchAction` 상태 저장 및 복원 옵션 (사용 조건: `save-options-tag` 및/또는 `restore-options-tag` 매개변수)
- TencentCloud 메트릭 필터, 수집된 메트릭을 리소스 출력에 추가
- `aws.elasticache-reserved` 리소스 스키마 추가
- `aws.iam-access-key` 리소스 스키마 추가
- `aws.lambda-event-source-mapping` 리소스 스키마 추가
- `aws.vpc-lattice-service` 리소스 스키마 추가
- `aws.vpc-lattice-service-network` 리소스 스키마 추가
- VPC Lattice 대상 그룹 리소스 스키마 추가
- EntraID 사용자 리소스 스키마 추가
- `gcp.certmanager-certificate` 리소스 스키마 추가
- 새로운 `terraform._` 리소스 스키마
- AWS 계정용 `ami-block-public-access` 필터 추가
- ElastiCache `upgrade-available` 필터 추가
- `aws.connect-instance`에 `analytics-association` 필터 추가
- Kafka 교차 계정 권한 필터
- Kafka `upgrade-available` 필터 추가
- `aws.secrets-manager`용 `current-version` 필터
- `aws.secrets-manager` `replica-attribute` 필터 추가
- `aws.subnet`의 `delete` 액션
- VPC `resolver-query-logging` 필터 추가
- WAFv2 웹 ACL 로깅 액션 추가
- `azure.keyvault-key`용 `update` 액션 추가

## 의존성 갱신 (6)

그 외 6건 · 보안 언급 없음

- `- azure - update azure mgmt keyvault version (#10352)`
- `- azure - update azure mgmt security version (#10351)`
- `- releng - 2025/10 increment versions and update dependencies (#10383)`
- `- releng - :seedling:  bump github-actions group across 4 directories with 12 updates (#10410)`
- `- releng - azure - update azure-mgmt-sql to 3.x (#10421)`
- `- releng - update dependencies 2025/11 (#10417)`

## 기타 (12)

- FSx 삭제 액션의 파일 시스템 유형별 설정 사용
- Route 53 도메인 테스트 픽스처의 결제 연락처 정보에 플레이스홀더 사용
- AWS Route 53 도메인 리소스 상세 spec 추가
- Azure 컨테이너 호스트 템플릿의 Python 런타임 변경
- 프로젝트 거버넌스 구조 문서화
- GCP Secret Manager 리소스 문서 링크 갱신
- Dependabot 재사용 가능한 워크플로 디렉터리 스캔
- CI 캐시 검사에서 불필요한 의존성 설치 방지
- 환경 재생성 후 캐시를 저장하는 CI 설치 워크플로
- GitHub Actions 가상 환경 캐시 삭제 명령 추가
- AWSCC 빌드 스크립트의 빌드 통계 집계 보고
- c7n_mailer 템플릿 아카이브 체크섬 일관성 개선

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
