ALIYUN::ROS::ResourceCleaner类型用于创建资源清理器。
支持清理的资源类型
ROS会持续增加支持清理的资源。您可以调用GetFeatureDetails接口获取支持清理的资源列表。
云服务 | 资源类型 |
ACM | ACM:Namespace |
ACTIONTRAIL | ACTIONTRAIL:Trail |
ALB |
|
ApiGateway |
|
ARMS |
|
ASM | ASM:ServiceMesh |
CAS | CAS:Certificate |
CDDC | CDDC:DedicatedHostGroup |
CDN | CDN:Domain |
ClickHouse | ClickHouse:DBCluster |
CloudPhone | CloudPhone:InstanceGroup |
CMS |
|
CS | CS:Cluster |
CR | CR:Instance |
DATAHUB | DATAHUB:Project |
DCDN | DCDN:Domain |
DFS |
|
DirectMail |
|
DNS |
|
DRDS | DRDS:DrdsInstance |
ECI |
|
ECS |
|
VPC |
|
RAM |
|
RDS | RDS:DBInstance |
ROS | ROS:Template |
SLB |
|
ENS | ENS:Instance |
ESS |
|
ECI |
|
FNF | FNF:Flow |
GPDB | GPDB:DBInstance |
KMS |
|
KAFKA | KAFKA:Instance |
MONGODB | MONGODB:Instance |
Memcache | Memcache:Instance |
MSE |
|
MNS |
|
REDIS | REDIS:Instance |
SLS | SLS:Project |
FC | FC:Service |
NAS |
|
NLB |
|
OTS | OTS:Instance |
OSS | OSS:Bucket |
OOS |
|
POLARDB | POLARDB:DBCluster |
PrivateLink |
|
DRDS | DRDS:DrdsInstance |
ROCKETMQ | ROCKETMQ:Instance |
ADB | ADB:DBCluster |
EDAS |
|
EMR | EMR:Cluster |
ElasticSearch | ElasticSearch:Instance |
SearchEngine | SearchEngine:Instance |
HBR | HBR:DBVault |
PVTZ | PVTZ:Zone |
SAE |
|
SAG |
|
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 | 是 | 是 | 资源清理动作。 | 取值:
|
ResourceFilters | List | 否 | 是 | 资源过滤器列表。 资源清理器使用过滤器扫描出所有需要进行清理的资源。 | 过滤器列表最大长度为100。 只能指定ResourceFilters或Resources中的一个。 如果在更新资源清理器时,资源过滤器列表发生改变,则资源清理器会重新进行资源扫描。如果此时Action为CleanUp,则会引发失败。 过滤器有两种过滤行为(Effect):Allow和Deny。其工作方式如下(数字越小优先级越高):
更多信息,请参见ResourceFilters属性。 |
Resources | List | 否 | 是 | 要清理的资源列表。 | 列表长度:1~1000。 只能指定ResourceFilters或Resources中的一个。 更多信息,请参见Resources属性。 |
Mode | String | 否 | 是 | 资源清理器运行模式。 | 取值:
|
FailureOption | String | 否 | 是 | 资源清理失败时依赖资源的选项 | 取值:
说明 依赖是指删除依赖,而非创建依赖。 |
CleanUpRetryCount | Integer | 否 | 是 | 清理资源时的最大重试次数。 | 取值范围:1~6。 默认值为:1,表示不重试。 触发重试条件如下:(满足任意一项)
|
CleanUpTimeout | Number | 否 | 是 | 清理资源时的超时时间。 | 取值范围:60~14400。 单位:秒。 默认值:3600。 |
ExcludedResources | List | 否 | 是 | 待清理资源中要排除的资源列表。 | 列表长度:1~1000。 每一项只能排除一个资源。如果存在歧义,指向了多个资源,则会引发失败。指定更多字段消除歧义。 更多信息,请参见ExcludedResources属性。 |
CleanUpAlgorithm | String | 否 | 是 | 资源清理算法。 | 取值:
|
ResourceTypeOrder | List | 否 | 是 | 资源类型清理顺序。 | 列表长度:1~1000。 当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 | 否 | 是 | 删除保护过滤。 | 取值:
|
ResourceTypePatterns | List | 否 | 是 | 资源类型模糊匹配过滤列表。关于资源类型,请参见支持清理的资源类型。 | 列表长度:1~100。 当资源类型匹配列表中任意一项时,则通过此项过滤。 模糊匹配仅支持 列表中每一项的格式为 |
ResourceIds | List | 否 | 是 | 资源ID过滤列表。 | 列表长度:1~100。 当资源匹配列表中的任意一个资源ID时,则通过此项过滤。 列表项长度范围:1-256。 |
RegionIds | List | 否 | 是 | 地域过滤列表。 | 列表长度:1~100。 当资源所在地域匹配列表中的任意一个地域时,则通过此项过滤。 列表项长度范围:1-64。 |
ResourceGroupIds | List | 否 | 是 | 资源组过滤列表。 | 列表长度:1~100。 当资源属于列表中的任意一项资源组时,则通过此项过滤。 列表项长度范围:1-256。 |
Effect | String | 否 | 是 | 过滤行为。 | 取值:
|
ResourceNamePatterns | List | 否 | 是 | 资源名称模糊匹配过滤列表。 | 列表长度:1~100。 当资源名称匹配列表中任意一项时,则通过此项过滤。 模糊匹配仅支持 资源名称仅支持字母、数字、中文、空格、 列表项长度范围:1-100。 |
Tags | List | 否 | 是 | 标签过滤列表。支持自定义标签和系统标签。 | 列表长度:1~100。 工作方式如下:
更多信息,请参见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:待清理资源的详细信息。取值为dict的列表,dict包含以下字段:
字段
类型
说明
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
资源的删除依赖。取值为dict的列表,dict包含以下字段:
ResourceType:依赖资源的资源类型。
RegionId:依赖资源的地域ID。
ResourceId:依赖资源的ID。
ResourcePartialDetails:简化版本ResourceDetails,只包含ResourceType、RegionId、ResourceId、ResourceName、ResourceStatus、ResourceStatusReason字段。
NoCleanupResourceDetails:扫描过但不进行清理的资源详情。格式与ResourceDetails相同。
NoCleanupResourcePartialDetails:简化版本NoCleanupResourceDetails,只包含ResourceType、RegionId、ResourceId、ResourceName、ResourceStatus、ResourceStatusReason字段。
ResourceSummary:要清理的资源的摘要信息。取值为dict的列表,dict包含以下字段:
字段
类型
说明
ResourceType
String
资源类型。
DeletingCount
Integer
删除中的资源数量。
SuccessCount
Integer
删除成功的资源数量。
FailureCount
Integer
删除失败的资源数量。
SkippedCount
Integer
跳过删除的资源数量。
PendingCount
Integer
待删除的资源数量。
OtherCount
Integer
其他状态的资源数量。
TotalCount
Integer
资源的总数量。
ScanErrors:扫描错误。仅在Mode为Loose时返回。取值为dict的列表,dict包含以下字段:
字段
类型
说明
ResourceType
String
资源类型。
RegionId
String
地域ID。
ErrorMessage
String
相关地域和资源类型扫描错误信息。
CleanResult:清理结果。取值如下:
Success:所有资源清理成功。
ResourceFailure:部分资源清理失败。
Timeout:清理超时。
CheckFailure:清理预检查失败。
UnknownFailure:未知错误。
UserCancelled:用户取消。
None:未触发清理。