镜像

更新时间：2024-07-02

创建自定义镜像

该接口用于创建自定义镜像，默认配额每账号每地域20个，创建后的自定义镜像可用于创建实例。
支持通过实例创建和通过快照创建两种方式。
当通过实例创建时，只有 Running 或 Stopped 状态的实例才可以执行成功，否则会提示 409 错误。
仅限通过系统盘快照创建自定义镜像。
当通过快照创建时，只有 Available 状态的快照才可以执行成功，否则会提示 409 错误

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)
	// 待创建的自定义镜像名称，支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65。
	imageName := "image02"
	// 当从快照创建镜像时，此参数是指用于创建镜像的快照ID。可选参数，与 snapshotId 不同时存在，同时存在时只取instanceId
	snapshotId := "m-***"
	// 当从实例创建镜像时，此参数是指用于创建镜像的实例ID。可选参数，与 snapshotId 不同时存在，同时存在时只取instanceId
	instanceId := "i-***"
	// 是否关联CDS，默认为false
	relateCds := false
	args := &api.CreateImageArgs{
		SnapshotId:  snapshotId,
		IsRelateCds: relateCds,
		ImageName:   imageName,
		InstanceId:  instanceId,
	}
	resp, err := bccClient.CreateImage(args)
	fmt.Println(resp, err)
}

注意，创建自定义镜像，默认配额每账号每地域20个。

查询镜像列表

使用以下代码可以查询有权限的镜像列表。
查询的镜像信息中包括公共镜像、自定义镜像和服务集成镜像。
支持按 imageType 来过滤查询，此参数非必需，缺省为 All,即查询所有类型的镜像。
支持按 imageName 来过滤查询自定义镜像，返回名称中包含该字符串的镜像。此参数非必需，设定ImageName时，必须同时指定ImageType为'Custom'。

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	createInstanceArgs := &api.ListImageArgs{
		// 镜像类型
		ImageType: "ALL", 
	}
	images, err := bccClient.ListImage(createInstanceArgs)
	fmt.Println(err)
	fmt.Println(images)
}

具体的镜像类型可详细参考BCC API文档查询镜像列表

查询镜像详情

以下代码可以查询镜像详细信息：

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	imageId := "m-***"
	imageDetail, err := bccClient.GetImageDetail(imageId)
	fmt.Println(err)
	fmt.Println(imageDetail.Image)
}

删除自定义镜像

该接口用于删除用户指定的自定义镜像，仅限自定义镜像，公共镜像和服务集成镜像不能删除。
imageId 所指定的镜像不存在，提示404错误。
镜像删除后无法恢复，不能再用于创建、重置实例。

以下代码可以删除一个自定义镜像：

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	imageId := "m-***"
	err := bccClient.DeleteImage(imageId)
	fmt.Println(err)
}

跨地域复制自定义镜像

用于用户跨地域复制自定义镜像，仅限自定义镜像，公共镜像和服务集成镜像不能复制。
regions如北京"bj",广州"gz",苏州"su"，可多选：

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	imageId := "m-***"
	destinations := &api.RemoteCopyImageArgs{
		Name:       "new-image",
		DestRegion: []string{"hkg"},
	}
	err := bccClient.RemoteCopyImage(imageId, destinations)
	fmt.Println(err)
}

跨地域复制自定义镜像并返回目的region的镜像镜像ID

用于用户跨地域复制自定义镜像，仅限自定义镜像，公共镜像和服务集成镜像不能复制。
regions如北京"bj",广州"gz",苏州"su"，可多选：

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	imageId := "m-***"
	destinations := &api.RemoteCopyImageArgs{
		Name:       "new-image",
		DestRegion: []string{"hkg"},
	}
	imageCopyResult, err := bccClient.RemoteCopyImageReturnImageIds(imageId, destinations)
	fmt.Println(err)
	fmt.Println(imageCopyResult)
}

取消跨地域复制自定义镜像

以下代码用于取消跨地域复制自定义镜像：

package main

import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
)

func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	imageId := "m-***"
	err := bccClient.DeleteImage(imageId)
	fmt.Println(err)
}

共享自定义镜像

该接口用于共享用户自己的指定的自定义镜像，仅限自定义镜像，公共镜像和服务集成镜像不能共享。
imageId 所指定的镜像不存在，提示404错误。
镜像共享后，被共享的用户可以使用此镜像创建、重置实例。
请求参数中的account和accountId均为可选参数，但不能全部为空，当两个参数同时出现时，服务端会自动去重。

package main

import (
    "fmt"
    "github.com/baidubce/bce-sdk-go/services/bcc"
    "github.com/baidubce/bce-sdk-go/services/bcc/api"
)

func main() {
    // 设置您的ak、sk和要访问的endpoint
    ak := "ak"
    sk := "sk"
    endpoint := "bcc.bj.baidubce.com"
    // 创建bcc client
    bccClient, _ := bcc.NewClient(ak, sk, endpoint)

    ShareImageId := "m-***"

	// 请求将镜像分享给指定用户id
	args := &api.SharedUser{
		// 账号ID
		AccountId: "***",     
	}
	err := bccClient.ShareImage(ShareImageId, args)
	fmt.Println(err)
}

取消共享自定义镜像

该接口用于取消共享用户自己的指定的自定义镜像，仅限自定义镜像，公共镜像和服务集成镜像不能共享。
imageId 所指定的镜像不存在，提示404错误。
镜像取消共享后，被取消共享的用户不能再使用此镜像创建、重置实例。
请求参数中的account和accountId均为可选参数，但不能全部为空，当两个参数同时出现时，服务端会自动去重。

package main

import (
    "fmt"
    "github.com/baidubce/bce-sdk-go/services/bcc"
    "github.com/baidubce/bce-sdk-go/services/bcc/api"
)

func main() {
    // 设置您的ak、sk和要访问的endpoint
    ak := "ak"
    sk := "sk"
    endpoint := "bcc.bj.baidubce.com"
    // 创建bcc client
    bccClient, _ := bcc.NewClient(ak, sk, endpoint)

    UnShareImageId := "m-***"

	// 请求取消将镜像分享给指定用户id
	args := &api.SharedUser{
		// 账号ID
		AccountId: "***", 
	}
	err := bccClient.UnShareImage(UnShareImageId, args)
	fmt.Println(err)
}

查询镜像已共享用户列表

imageId 所指定的镜像不存在，提示404错误。如下代码用于查询镜像已共享的用户列表：

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)
	// 镜像id
    imageId := "m-***" 
	result, err := bccClient.GetImageSharedUser(imageId)
	fmt.Println(result)
	fmt.Println(err)
}

根据实例ID批量查询OS信息

如下代码可以根据实例的ID来查询相应OS的信息：

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	args := &api.GetImageOsArgs{
		// 实例ID列表
		InstanceIds: []string{"i-***", "i-***"}, 
	}
	result, err := bccClient.GetImageOS(args)
	fmt.Println(result)
	fmt.Println(err)
}

镜像绑定标签

使用以下代码可以给指定镜像绑定标签：

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/model"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)
	args := &api.BindTagsRequest{
		ChangeTags: []model.TagModel{
			{
				// 标签键
				TagKey:   "Key***",
				// 标签值
				TagValue: "Value***",
			},
			{
				// 标签键
				TagKey:   "Key***",
				// 标签值
				TagValue: "Value***",
			},
		},
	}

	result := bccClient.BindImageToTags("m-***", args)
	fmt.Println(result)
}

镜像解绑标签

使用以下代码可以给指定镜像绑定标签：

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/model"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)
	args := &api.UnBindTagsRequest{
		ChangeTags: []model.TagModel{
			{
				// 标签键
				TagKey:   "Key***",
				// 标签值
				TagValue: "Value***",
			},
		},
	}
	err := bccClient.UnBindImageToTags(
		// 镜像Id
		"m-***", 
		args)
	fmt.Println(err)
}

导入镜像

使用以下代码可以导入镜像：

package main
import (
	"fmt"
	"github.com/baidubce/bce-sdk-go/services/bcc"
	"github.com/baidubce/bce-sdk-go/services/bcc/api"
)
func main() {
	// 设置您的ak、sk和要访问的endpoint
	ak := "ak"
	sk := "sk"
	endpoint := "http://bcc.bj.baidubce.com"
	// 创建bcc client
	bccClient, _ := bcc.NewClient(ak, sk, endpoint)

	args := &api.ImportCustomImageArgs{
		// 操作系统名称
		OsName:    "Centos",
		// 操作系统位数
		OsArch:    "64",
		// 操作系统类型
		OsType:    "linux",
		// 操作系统版本
		OsVersion: "6.5",
		// 镜像名称,支持大小写字母、数字、中文以及-_ /.特殊字符，必须以字母开头，长度1-65。
        Name:      "image-2",
		// bos镜像地址
		BosURL:    "https://bcc-bos.bj.bcebos.com/image_test/CentOS-6-x86_64-GenericCloud.qcow2", 
	}
	result, _ := bccClient.ImportCustomImage(args)
	fmt.Println(result)
}

根据实例规格查询可用公共镜像

使用以下代码可以根据实例规格查询可用的公共镜像：

func TestGetAvailableImagesBySpec(t *testing.T) {

	args := &api.GetAvailableImagesBySpecArg{
		OsName: "Centos",
		Spec:   "bcc.ic4.c1m1",
		MaxKeys: 10,
		Marker: "m-21bmeYvH",
	}

	result, _ := BCC_CLIENT.GetAvailableImagesBySpec(args)
	fmt.Println(result)
}

磁盘

快照

云服务器 BCC

云服务器 BCC

镜像

创建自定义镜像

查询镜像列表

查询镜像详情

删除自定义镜像

跨地域复制自定义镜像

跨地域复制自定义镜像并返回目的region的镜像镜像ID

取消跨地域复制自定义镜像

共享自定义镜像

取消共享自定义镜像

查询镜像已共享用户列表

根据实例ID批量查询OS信息

镜像绑定标签

镜像解绑标签

导入镜像

根据实例规格查询可用公共镜像