# 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/ja/releases/cloud-custodian/0.9.48.0)

破壊的変更 13 · 重大な修正 9 · 機能・改善 47 · 依存関係の更新 6 · その他の変更 12

## 破壊的変更 (13)

### Firehose の削除アクションが停止中ストリームの削除も試行

- 影響対象: `SUSPENDED` 状態の AWS Firehose 配信ストリーム

以前は `SUSPENDED` 状態のストリームはアクションの対象外で、削除のステータスチェックを通過するのは `ACTIVE` 状態のストリームだけでした。

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

### GuardDuty 管理者アカウントの参照キーを `Administrator` に変更

- 影響対象: `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 による選択したプロファイルからの認証情報読み込み

- 影響対象: `~/.tencentcloud/credentials` にプロファイルを設定し、`--profile` を使う 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` 形式のキーと値による Directory クエリ

- 影響対象: サーバーサイドクエリパラメーターを使用する 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 のクエリパラメーターで文字列列挙型を使用

- 影響対象: サーバー側のブール型クエリパラメーターを使用する 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 ワークロード ID 認証への対応追加

- 影響対象: `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`

### `gcp.spanner-database-instance` スキーマからの `metrics` フィルターの削除

- 影響対象: `gcp.spanner-database-instance` スキーマを使用する環境、特に `metrics` を参照する設定やバリデーター (推定)

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

## 重大な修正 (9)

### EBS ボリューム取得時のページネーションを修正

- 影響対象: `DescribeVolumes` を使用した AWS EBS ボリュームの取得

EBS ボリューム数の多いアカウントでポリシーを実行すると、クライアント側のフィルタリングによってタイムアウトが発生することがありました。また、`maxResults` を明示的に渡さない限り、`DescribeVolumes` はページネーションを行いませんでした。現在は取得時に `MaxResults` 1000 を渡し、複数回の API 呼び出しでボリュームを取得します。

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

### AWS SSM ドキュメントの `cross-account` フィルターで `everyone_only` を適用

- 影響対象: `everyone_only: true` を指定した AWS SSM ドキュメントの `cross-account` フィルター

以前は、この制限を適用せずに共有アカウントのエントリーを判定していました。現在は、`all` と共有されているドキュメントのみがクロスアカウント違反として選択されます。デフォルトが false の場合の動作に変更はありません。

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

### Artifact ドメインのクロスアカウントフィルターにおける名前参照の修正

- 影響対象: `aws.artifact-domain` リソースで `cross-account` フィルターを使用するポリシー (推定)

フィルターの評価時、ドメイン名を `domainName` の下で検索していましたが、名前は `name` にあります。評価に使うドメイン権限ポリシーの取得には、`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 メトリクスフィルターの Monitor クライアントのサービス名を修正

- 影響対象: TencentCloud メトリクスフィルターを使用する構成 (推定)

Monitor API クライアント経由のリクエストでは、誤ったサービス名 `service` が使われていたため、リクエストが失敗していました。クライアントが `monitor` を使うようになり、こうした失敗が減少します。

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

### TencentCloud メトリクスのリクエストバッチ処理上限の修正

- 影響対象: TencentCloud メトリクスフィルター (推定)

以前は、バッチサイズを1,440データポイントの上限だけを基に計算し、別途設けられた10インスタンスの上限を適用していませんでした。

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

## 機能・改善 (47)

- アカウント全体の AMI Block Public Access フィルタリング
- グローバル 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 Web 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 ドメインリソースの詳細仕様の追加
- Azure コンテナーホストテンプレートの Python ランタイム切り替え
- プロジェクトのガバナンス体制の文書化
- GCP Secret Manager リソースのドキュメントリンク更新
- Dependabot による再利用可能なワークフローディレクトリのスキャン
- CI のキャッシュ確認で不要な依存関係のインストールや更新を回避
- 環境再作成後の CI インストールワークフローによるキャッシュ保存
- GitHub Actions の仮想環境キャッシュを消去するコマンドの追加
- AWSCC ビルドスクリプトによるビルド統計の集計表示
- c7n_mailer のテンプレートアーカイブチェックサムの一貫化

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
