云服务器 ECS：镜像族系概述

当前仅支持通过API设置镜像族系创建ECS实例，当您通过RunInstances或CreateInstance接口创建ECS实例时，无需设置镜像ID参数ImageId，只需要设置镜像族系参数ImageFamily，系统会自动使用镜像族系中可用的最新镜像创建ECS实例。具体操作，请参见通过镜像族系创建ECS实例。

镜像族系中的自定义镜像可以设置为弃用或恢复可用。如果您需要使用较旧的镜像版本创建ECS实例，只需要将镜像族系内可用的最新自定义镜像设置为弃用或直接删除，然后通过镜像族系创建ECS实例即可实现。您可以通过控制台弃用镜像或恢复可用镜像，或调用API接口ModifyImageAttribute实现。

您可以调用API接口DescribeImageFromFamily查询指定镜像族系内最新的镜像，也可以通过DescribeImages接口查询某个镜像所属的镜像族系名称。

公共镜像、自定义镜像、共享镜像和社区镜像均支持镜像族系，设置方法请参考下表。

共享镜像和社区镜像族系使用示例：

假设有M、N两个用户：用户M为其两个自定义镜像A1、B1指定了镜像族系A，并把A1发布为社区镜像A2，B1共享给了用户N成为N的共享镜像B2。则：

• 社区镜像A2：镜像族系名称为acs:<M用户的UID>:A

• 共享镜像B2：镜像族系名称也是acs:<M用户的UID>:A

示例一：

用户N通过RunInstances或CreateInstance创建ECS实例时，如果指定了镜像族系acs:<M用户的UID>:A，系统会自动选取A2和B2中最新的可用的镜像来创建实例。

示例二：

用户N将共享镜像B2复制为其账号下的自定义镜像B3后，B3不会继承B2的镜像族系值，用户需要重新设置镜像族系。

示例三：

如果A1没有发布为社区镜像，仅共享了B1。则用户N通过引用族系acs:<M用户的UID>:A使用共享镜像创建ECS实例时，只能获取到B2，因为A1并没有共享给用户N。

示例四：

由于自定义镜像的镜像族系不允许以acs开头，因此不存在用户N将其某个自定义镜像的族系设置为acs:<M的UID>:A，与共享镜像、社区镜像隶属于同一个族系的情况。

镜像族系的典型使用流程如下图所示。