接口描述
您可以根据实例创建自定义镜像。
请求头
| 参数名称 |
类型 |
是否必须 |
描述 |
| X-Version |
String |
是 |
版本号,取值:2020-08-01 |
| X-Action |
String |
是 |
操作接口名,取值:CreateImage |
请求参数
| 参数名称 |
类型 |
是否必须 |
示例值 |
描述 |
| NamespaceID |
String |
是 |
default-UID |
命名空间ID |
| InstanceID |
String |
是 |
i-3422f6efdc3432052421ef67f24b14e1-sxct01 |
实例ID【在镜像制作完成前,请勿再对该实例进行相关操作,以免制作的镜像缺少相应的操作】一次只能传递一个实例ID |
| ImageName |
String |
是 |
70072651-19ad-47ba-9c82-fa2a9727cbe1 |
镜像名称:支持大小写英文字符和数字,支持其他可见的字符。字符长度:8-64 |
返回参数
| 参数名称 |
类型 |
示例值 |
描述 |
| RequestID |
String |
3a87cc31-efe6-487c-b28b-11bec3571e7d |
请求ID |
| Code |
String |
Success |
状态码,有InvalidParameter,Forbidden InternalError,Success四种状态 |
| ImageID |
String |
3a87cc31-efe6-487c-b28b-11bec3571e7d |
镜像ID |
请求示例
入参示例
curl --location --request GET 'kenc.api.ksyun.com?NamespaceID=demo&ImageName=test-image&InstanceID=i-1adb11e38d25e0f2aa23adec45cb77c4-sxct01' \
--header 'X-Action: CreateImage' \
--header 'X-Version: 2020-08-01' \
--header 'X-Amz-Date: 20200826T092325Z' \
--header 'Authorization: AWS4-HMAC-SHA256 Credential=AKLTDOTh-1tDQjSosbliA0SRHQ/20200826/beijing-6/kenc/aws4_request, SignedHeaders=host;x-amz-date;x-ksc-account-id, Signature=xxxxxxxxxx'
成功示例
{
"Code": "Success",
"ImageID": "a784468b-777a-4ffe-8e2c-e923b08ca0cc",
"RequestId": "abcc75b9-62bc-4853-9342-e6d6ad28c3ba"
}
失败示例
{
"RequestId": "1312fefe-ca48-4d72-8521-cf5d2cf06b9c",
"Code": "InvalidParameter",
"Message": "Invalid param ImageName."
}