阿里云服务器通过API设置自定义镜像的启动模式为UEFI模式-[云淘科技_教程]

如果您需要使用支持UEFI启动模式的自定义镜像，需要参考本文设置该自定义镜像的启动模式为UEFI模式。

背景信息

阿里云支持通过API的方式，设置自定义镜像的启动模式为UEFI模式。当您的业务需要使用支持UEFI启动的自定义镜像时（例如，阿里云的部分实例规格族ebmg6a、ebmc6a、ebmr6a等，要求自定义镜像的启动模式为UEFI模式），可以通过ImportImage或者ModifyImageAttribute接口，为自定义镜像设置UEFI启动模式。

使用限制

设置自定义镜像启动模式时，存在以下限制：

仅支持通过ECS API的方式为自定义镜像设置UEFI启动模式。
镜像的启动模式暂不支持通过ECS控制台或查询类的API（例如DescribeImages）进行查询。

注意事项

您需要注意：

通过ECS API设置自定义镜像为UEFI启动模式后，仅表示通过该自定义镜像的ECS实例会以UEFI模式启动。因此，您需要自行确保该自定义镜像内的配置已经支持了UEFI启动模式，否则ECS实例将会启动失败。
要求自定义镜像启动模式为UEFI模式的实例规格族中，部分处于邀测或公测阶段，如果您在使用UEFI相关的功能或资源时出现异常，建议提交工单反馈。

操作说明

根据实际业务场景不同，您可以通过以下任一方式，为自定义镜像设置UEFI启动模式。


方式	说明
方式一：通过ImportImage导入镜像时设置UEFI启动模式	当您需要把已支持UEFI启动的镜像导入到阿里云作为自定义镜像时，可以调用ImportImage接口导入镜像，并在调用接口时设置`BootMode`参数的值为`UEFI`。关于接口的详细说明与注意事项，请参见ImportImage。
方式二：通过ModifyImageAttribute修改自定义镜像的启动模式为UEFI模式	当您的阿里云账号下存在已支持UEFI启动模式的自定义镜像时，可以调用ModifyImageAttribute修改自定义镜像的属性，并在调用接口时设置`BootMode`参数为`UEFI`。关于接口的详细说明与注意事项，请参见ModifyImageAttribute。