すべてのプロダクト
Search
ドキュメントセンター

Resource Orchestration Service:ALIYUN::ROS::ResourceCleaner

最終更新日:Jun 17, 2026

ALIYUN::ROS::ResourceCleaner は、リソースをスキャンしてクリーンアップするリソースクリーナーを作成します。

サポートされるリソースタイプ

説明

ROS は継続的にサポートするリソースタイプを追加しています。GetFeatureDetails 操作を呼び出して、サポートされているリソースタイプのリストを取得できます。

Alibaba Cloud サービス

リソースタイプ

ACM

ACM:Namespace

ACTIONTRAIL

ACTIONTRAIL:Trail

ALB

  • ALB:Acl

  • ALB:HealthCheckTemplate

  • ALB:LoadBalancer

  • ALB:SecurityPolicy

  • ALB:ServerGroup

ApiGateway

  • ApiGateway:App

  • ApiGateway:Group

  • ApiGateway:Instance

  • ApiGateway:LogConfig

  • ApiGateway:Plugin

  • ApiGateway:Signature

  • ApiGateway:TrafficControl

ARMS

  • ARMS:AlertContact

  • ARMS:AlertContactGroup

  • ARMS:RetcodeApp

ASM

ASM:ServiceMesh

CAS

CAS:Certificate

CDDC

CDDC:DedicatedHostGroup

CDN

CDN:Domain

ClickHouse

ClickHouse:DBCluster

CloudPhone

CloudPhone:InstanceGroup

CMS

  • CMS:Contact

  • CMS:ContactGroup

  • CMS:MetricRuleTemplate

  • CMS:MonitorGroup

  • CMS:SiteMonitor

CS

CS:Cluster

CR

CR:Instance

DATAHUB

DATAHUB:Project

DCDN

DCDN:Domain

DFS

  • DFS:AccessGroup

  • DFS:FileSystem

DirectMail

  • DirectMail:Domain

  • DirectMail:Ipfilter

DNS

  • DNS:Domain

  • DNS:DomainGroup

DRDS

DRDS:DrdsInstance

ECI

  • ECI:ContainerGroup

  • ECI:ImageCache

ECS

  • ECS:AutoProvisioningGroup

  • ECS:AutoSnapshotPolicy

  • ECS:Command

  • ECS:CustomImage

  • ECS:DedicatedHost

  • ECS:DeploymentSet

  • ECS:Disk

  • ECS:HpcCluster

  • ECS:Instance

  • ECS:LaunchTemplate

  • ECS:NetworkInterface

  • ECS:PrefixList

  • ECS:SSHKeyPair

  • ECS:SecurityGroup

  • ECS:Snapshot

VPC

  • VPC:AnycastEIP

  • VPC:CommonBandwidthPackage

  • VPC:DhcpOptionsSet

  • VPC:EIP

  • VPC:EipSegment

  • VPC:FlowLog

  • VPC:HaVip

  • VPC:Ipv6Gateway

  • VPC:NatGateway

  • VPC:NetworkAcl

  • VPC:RouteTable

  • VPC:VPC

  • VPC:VSwitch

RAM

  • RAM:Group

  • RAM:ManagedPolicy

  • RAM:Role

  • RAM:SAMLProvider

  • RAM:User

RDS

RDS:DBInstance

ROS

ROS:Template

SLB

  • SLB:AccessControl

  • SLB:Certificate

  • SLB:LoadBalancer

ENS

ENS:Instance

ESS

  • ESS:AlarmTask

  • ESS:ScalingGroup

  • ESS:ScheduledTask

ECI

  • ECI:ContainerGroup

  • ECI:ImageCache

FNF

FNF:Flow

GPDB

GPDB:DBInstance

KMS

  • KMS:Key

  • KMS:Secret

KAFKA

KAFKA:Instance

MONGODB

MONGODB:Instance

Memcache

Memcache:Instance

MSE

  • MSE:Cluster

  • MSE:Gateway

MNS

  • MNS:Topic

  • MNS:Queue

REDIS

REDIS:Instance

SLS

SLS:Project

FC

FC:Service

NAS

  • NAS:AccessGroup

  • NAS:FileSystem

NLB

  • NLB:LoadBalancer

  • NLB:ServerGroup

OTS

OTS:Instance

OSS

OSS:Bucket

OOS

  • OOS:Execution

  • OOS:Template

  • OOS:PatchBaseline

  • OOS:Parameter

  • OOS:SecretParameter

POLARDB

POLARDB:DBCluster

PrivateLink

  • PrivateLink:VpcEndpoint

  • PrivateLink:VpcEndpointService

DRDS

DRDS:DrdsInstance

ROCKETMQ

ROCKETMQ:Instance

ADB

ADB:DBCluster

EDAS

  • EDAS:Application

  • EDAS:Cluster

EMR

EMR:Cluster

ElasticSearch

ElasticSearch:Instance

HBR

HBR:DBVault

PVTZ

PVTZ:Zone

SAE

  • SAE:Application

  • SAE:Namespace

SAG

  • SAG:ACL

  • SAG:Qos

TSDB

TSDB:HiTSDBInstance

WAF

WAF:Domain

構文

{
  "Type": "ALIYUN::ROS::ResourceCleaner",
  "Properties": {
    "Action": String,
    "ResourceFilters": List,
    "Resources": List,
    "Mode": String,
    "FailureOption": String,
    "CleanUpRetryCount": Integer,
    "CleanUpTimeout": Number,
    "ExcludedResources": List,
    "CleanUpAlgorithm": String,
    "ResourceTypeOrder": List,
    "DisabledSideEffects": List
  }
}

プロパティ

プロパティ名

必須

更新の許可

説明

制約

Action

String

はい

はい

リソースクリーナーが実行するアクションです。

有効値:

  • Scan:クリーンアップするリソースをスキャンします。

  • CleanUp:スキャンされたリソースをクリーンアップします。最初にスキャンを実行する必要があります。この値は、リソースクリーナーの作成時ではなく、更新時にのみ指定できます。

  • Scan+CleanUp:リソースをスキャンしてからクリーンアップします。

  • ScanWhenCreatingAndUpdating+CleanUpWhenDeleting:リソースクリーナーの作成時または更新時にリソースをスキャンし、リソースクリーナーの削除時にリソースをクリーンアップします。

ResourceFilters

List

いいえ

はい

リソースクリーナーがクリーンアップが必要なリソースをスキャンするために使用するリソースフィルターです。

リストには最大 100 個のフィルターを含めることができます。

ResourceFilters または Resources のいずれかを指定できますが、両方を指定することはできません。

更新中にリソースフィルターのリストが変更された場合、リソースクリーナーはリソースを再スキャンします。Action が CleanUp に設定されている場合、操作は失敗します。

フィルターには Allow と Deny の 2 つの効果があります。これらは次のように機能します (数値が小さいほど優先度が高くなります):

  1. Deny フィルターに一致するリソースはクリーンアップされません。

  2. 少なくとも 1 つの Allow フィルターに一致するリソースのみがクリーンアップされます。

詳細については、「ResourceFilters のプロパティ」をご参照ください。

Resources

List

いいえ

はい

クリーンアップするリソースです。

リストには 1 から 1,000 個のリソースを含めることができます。

ResourceFilters または Resources のいずれかを指定できますが、両方を指定することはできません。

詳細については、「Resources のプロパティ」をご参照ください。

Mode

String

いいえ

はい

リソースクリーナーの実行モードです。

有効値:

  • Strict:リソースのスキャンまたはクリーンアップで何らかの失敗が発生すると、リソースクリーナーは失敗します。

  • Loose (デフォルト):ほとんどのスキャンおよびクリーンアップの失敗は許容されます。スキャンの失敗は ScanErrors と ResourceDetails に記録されます。クリーンアップの失敗は ResourceDetails に記録されます。

FailureOption

String

いいえ

はい

リソースのクリーンアップが失敗した場合の依存リソースの動作です。

有効値:

  • Normal (デフォルト):リソースのクリーンアップの失敗は、依存リソースに影響しません。

  • Fast:リソースのクリーンアップが失敗すると、依存リソースも失敗します。

説明

依存関係は作成時の依存関係ではなく、削除時の依存関係です。

CleanUpRetryCount

Integer

いいえ

はい

クリーンアップのリトライの最大回数です。

有効値:1 から 6。

デフォルト値は 1 で、リトライしないことを意味します。

次のいずれかの条件が満たされた場合にリトライがトリガーされます:

  • リソースのクリーンアップが失敗した場合。

  • クリーンアップがタイムアウトした場合。

CleanUpTimeout

Number

いいえ

はい

リソースのクリーンアップのタイムアウト期間です。

有効値:60 から 14400。

単位:秒。

デフォルト値:3600。

ExcludedResources

List

いいえ

はい

クリーンアップから除外するリソースです。

リストには 1 から 1,000 個のリソースを含めることができます。

各項目は 1 つのリソースのみを除外できます。項目が曖昧で複数のリソースを指している場合、操作は失敗します。曖昧さをなくすために、より多くのフィールドを指定してください。

詳細については、「ExcludedResources のプロパティ」をご参照ください。

CleanUpAlgorithm

String

いいえ

はい

リソースのクリーンアップアルゴリズムです。

有効値:

  • ResourceDependency (デフォルト):リソースは依存関係に基づいてクリーンアップされます。

  • ResourceTypeOrder:リソースはリソースタイプの順序でクリーンアップされます。ResourceTypeOrder プロパティを使用して順序を指定できます。このプロパティを指定しない場合、システムのデフォルトの順序が使用されます。デフォルトの順序には、サポートされているすべてのリソースタイプが含まれます。

ResourceTypeOrder

List

いいえ

はい

リソースタイプのクリーンアップ順序です。

リスト内の項目数は 1 から 1,000 の範囲である必要があります。

このパラメーターは、CleanUpAlgorithm が ResourceTypeOrder に設定されている場合にのみ有効です。

リストで指定されていないタイプのリソースは、スキャンもクリーンアップもされません。

有効なリソースタイプについては、「サポートされるリソースタイプ」をご参照ください。

DisabledSideEffects

List

いいえ

はい

クリーンアップ中に無効にする副作用です。

リストには 1 から 50 個の項目を含めることができます。

各項目は、英字、数字、およびワイルドカード文字で構成できます。各項目の長さは 1 から 100 文字です。

ワイルドカード文字 * および ? のみがサポートされています。

一部のリソースタイプをクリーンアップすると、副作用が発生する可能性があります。GetFeatureDetails 操作を呼び出して、それらをクエリできます。

ResourceFilters の構文

"ResourceFilters": [
  {
    "IncludeDeletionProtection": Boolean,
    "ResourceTypePatterns": List,
    "ResourceIds": List,
    "RegionIds": List,
    "ResourceGroupIds": List,
    "Effect": String,
    "ResourceNamePatterns": List,
    "Tags": List
  }
]

ResourceFilters のプロパティ

プロパティ名

必須

更新の許可

説明

制約

IncludeDeletionProtection

Boolean

いいえ

はい

削除保護が有効になっているリソースを含めるかどうかを指定します。

有効値:

  • false:削除保護が有効になっているリソースは、このフィルターをパスしません。

  • true (デフォルト):削除保護が有効になっているリソースは、このフィルターをパスします。

ResourceTypePatterns

List

いいえ

はい

フィルターするリソースタイプのパターンのリストです。リソースタイプについては、「サポートされるリソースタイプ」をご参照ください。

リストには 1 から 100 個のパターンを含めることができます。

リソースのタイプがリスト内のいずれかのパターンに一致する場合、そのリソースはこのフィルターをパスします。

ワイルドカード文字 * および ? のみがサポートされています。

リスト内の各パターンは Service:Type 形式で、長さは 3 から 100 文字である必要があります。Service は英字とワイルドカード文字で構成できます。Type は英字、数字、およびワイルドカード文字で構成できます。

ResourceIds

List

いいえ

はい

フィルターするリソース ID のリストです。

リストには 1 から 100 個の ID を含めることができます。

リソースの ID がリスト内のいずれかの ID に一致する場合、そのリソースはこのフィルターをパスします。

リスト項目の長さは 1 から 256 文字です。

RegionIds

List

いいえ

はい

フィルターするリージョンのリストです。

リストの長さは 1 から 100 である必要があります。

リソースのリージョンがリスト内のいずれかのリージョンに一致する場合、そのリソースはこのフィルターをパスします。

リスト項目の長さは 1 から 64 文字である必要があります。

ResourceGroupIds

List

いいえ

はい

フィルターするリソースグループのリストです。

リストの長さは 1 から 100 の範囲です。

リソースがリスト内のいずれかのリソースグループに属している場合、そのリソースはこのフィルターをパスします。

リスト項目の長さは 1 から 256 文字である必要があります。

Effect

String

いいえ

はい

フィルターの効果です。

有効値:

  • Deny:すべてのフィルター条件をパスしたリソースはクリーンアップから除外されます。

  • Allow:すべてのフィルター条件に一致するリソースはクリーンアップされます。

    説明

    リソースがこのフィルターをパスしても、Deny フィルターもパスする場合、そのリソースはクリーンアップされません。

ResourceNamePatterns

List

いいえ

はい

フィルターするリソース名のパターンです。

リストには 1 から 100 個のパターンを含めることができます。

リソースの名前がリスト内のいずれかのパターンに一致する場合、そのリソースはこのフィルターをパスします。

ワイルドカード文字 * および ? のみがサポートされています。

リソース名は、英字、数字、漢字、スペース、_-、およびあいまい一致文字のみをサポートします。

リスト項目の長さは 1 から 100 の範囲です。

Tags

List

いいえ

はい

フィルターするタグです。カスタムタグとシステムタグの両方がサポートされています。

リストには 1 から 100 個の項目を含める必要があります。

一致ルール:

  • タグキーとタグ値の両方を指定した場合、タグキーとタグ値が一致するリソースがフィルターされます。

    説明
    1. フィルター内で 1 つのタグキーに複数の値がある場合、リソースのタグ値がそれらの値のいずれかであれば、リソースは一致します。

    2. フィルターがタグキーのみを指定している場合、リソースがそのタグキーを持っていれば一致します。

  • リソースは、指定されたすべてのタグキーのフィルター条件に一致する場合にのみ、タグフィルターをパスします。

詳細については、「Tags のプロパティ」をご参照ください。

Tags の構文

"Tags": [
  {
    "Value": String,
    "Key": String
  }
]

Tags のプロパティ

プロパティ名

必須

更新の許可

説明

制約

Value

String

いいえ

はい

タグ値です。

長さ:0 から 256 文字。

説明

この値を省略することと、空の文字列を指定することは異なります。

Key

String

はい

はい

タグキーです。

長さ:1 から 256 文字。

Resources の構文

"Resources": [
  {
    "ResourceId": String,
    "ResourceType": String,
    "RegionId": String
  }
]

Resources のプロパティ

プロパティ名

必須

更新の許可

説明

制約

ResourceId

String

はい

はい

クリーンアップするリソースの ID です。

長さ:1 から 256 文字。

ResourceType

String

はい

はい

クリーンアップするリソースのタイプです。

詳細については、「サポートされるリソースタイプ」をご参照ください。

RegionId

String

はい

はい

クリーンアップするリソースのリージョン ID です。

長さ:1 から 64 文字。

ExcludedResources の構文

"ExcludedResources": [
  {
    "ResourceId": String,
    "ResourceType": String,
    "RegionId": String
  }
]

ExcludedResources のプロパティ

プロパティ名

必須

更新の許可

説明

制約

ResourceId

String

はい

はい

除外するリソースの ID です。

長さ:1 から 256 文字。

ResourceType

String

いいえ

はい

除外するリソースのタイプです。

詳細については、「サポートされるリソースタイプ」をご参照ください。

RegionId

String

いいえ

はい

除外するリソースのリージョン ID です。

長さ:1 から 64 文字。

戻り値

Fn::GetAtt

  • ResourceDetails:クリーンアップするリソースの詳細です。値は、次のフィールドを持つ辞書のリストです:

    フィールド

    説明

    ResourceType

    String

    リソースタイプです。

    RegionId

    String

    リソースのリージョン ID です。

    ResourceId

    String

    リソース ID です。

    ResourceName

    String

    リソース名です。

    CleanupType

    String

    リソースのクリーンアップタイプです。有効値:

    • Normal:リソースは正常に削除できます。

    • DeleteWithInstance:リソースは、それが属するリソースと一緒に削除されます。それが属するリソースがフィルターまたは除外されている場合、削除が失敗する可能性があります。詳細については、CleanupTypeReasons をご参照ください。

    • UnableToDelete:リソースは削除できません。詳細については、CleanupTypeReasons をご参照ください。

    CleanupTypeReasons

    List

    リソースのクリーンアップタイプの理由のリストです。

    ResourceStatus

    String

    リソースのステータスです。有効値:

    • Deleting:リソースは削除中です。

    • Failure:リソースの削除に失敗しました。

    • Success:リソースは削除されました。

    • Skipped:リソースの削除はスキップされました。

    • Pending:リソースは削除待ちです。

    ResourceStatusReason

    String

    リソースステータスの理由です。

    Dependencies

    List

    リソースの削除依存関係です。値は、次のフィールドを持つ辞書のリストです:

    • ResourceType:依存リソースのリソースタイプです。

    • RegionId:依存リソースのリージョン ID です。

    • ResourceId:依存リソースの ID です。

  • ResourcePartialDetails:ResourceType、RegionId、ResourceId、ResourceName、ResourceStatus、および ResourceStatusReason フィールドのみを含む、ResourceDetails の簡易版です。

  • NoCleanupResourceDetails:スキャンされたがクリーンアップされなかったリソースの詳細です。フォーマットは ResourceDetails と同じです。

  • NoCleanupResourcePartialDetails:ResourceType、RegionId、ResourceId、ResourceName、ResourceStatus、および ResourceStatusReason フィールドのみを含む、NoCleanupResourceDetails の簡易版です。

  • ResourceSummary:クリーンアップするリソースの概要です。値は、次のフィールドを持つ辞書のリストです:

    フィールド

    説明

    ResourceType

    String

    リソースタイプです。

    DeletingCount

    Integer

    削除中のリソースの数です。

    SuccessCount

    Integer

    削除されたリソースの数です。

    FailureCount

    Integer

    削除に失敗したリソースの数です。

    SkippedCount

    Integer

    削除がスキップされたリソースの数です。

    PendingCount

    Integer

    削除待ちのリソースの数です。

    OtherCount

    Integer

    その他の状態のリソース数。

    TotalCount

    Integer

    リソースの総数です。

  • ScanErrors:スキャン中に発生したエラーです。このパラメーターは、Mode が Loose に設定されている場合にのみ返されます。値は、次のフィールドを持つ辞書のリストです:

    フィールド

    説明

    ResourceType

    String

    リソースタイプです。

    RegionId

    String

    リージョン ID です。

    ErrorMessage

    String

    指定されたリージョンとリソースタイプのスキャンのエラーメッセージです。

  • CleanResult:全体的なクリーンアップ結果です。有効値:

    • Success:すべてのリソースがクリーンアップされました。

    • ResourceFailure:一部のリソースのクリーンアップに失敗しました。

    • Timeout:クリーンアップがタイムアウトしました。

    • CheckFailure:クリーンアップの事前チェックに失敗しました。

    • UnknownFailure:不明なエラーが発生しました。

    • UserCancelled:操作はユーザーによってキャンセルされました。

    • None:クリーンアップはトリガーされませんでした。

  • YAML フォーマット

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters: {}
    Resources:
      ResourceCleaner:
        Type: ALIYUN::ROS::ResourceCleaner
        Properties:
          FailureOption: Normal
          Action: Scan
          ResourceFilters:
            - ResourceIds:
                - i-bp1h09ipy0atb4kq****
          CleanUpRetryCount: 1
          CleanUpTimeout: 3600
          ExcludedResources:
            - ResourceId: i-bp1h09ipy0atb4kq****
              ResourceType: ECS:Instance
    Outputs: {}
  • JSON フォーマット

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
      },
      "Resources": {
        "ResourceCleaner": {
          "Type": "ALIYUN::ROS::ResourceCleaner",
          "Properties": {
            "FailureOption": "Normal",
            "Action": "Scan",
            "ResourceFilters": [
              {
                "ResourceIds": [
                  "i-bp1h09ipy0atb4kq****"
                ]
              }
            ],
            "CleanUpRetryCount": 1,
            "CleanUpTimeout": 3600,
            "ExcludedResources": [
              {
                "ResourceId": "i-bp1h09ipy0atb4kq****",
                "ResourceType": "ECS:Instance"
              }
            ]
          }
        }
      },
      "Outputs": {
      }
    }