client

package
v1.2.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Dec 6, 2018 License: Apache-2.0 Imports: 4 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type VmClient 

type VmClient struct {
	core.JDCloudClient
}

func NewVmClient 

func NewVmClient(credential *core.Credential) *VmClient

func (*VmClient) AssociateElasticIp 

func (c *VmClient) AssociateElasticIp(request *vm.AssociateElasticIpRequest) (*vm.AssociateElasticIpResponse, error)
为云主机主网卡下的主内网IP绑定弹性公网IP。<br>

一台云主机只能绑定一个弹性公网IP(主网卡)，若主网卡已存在弹性公网IP，会返回错误。<br>

func (*VmClient) AttachDisk 

func (c *VmClient) AttachDisk(request *vm.AttachDiskRequest) (*vm.AttachDiskResponse, error)
为一台云主机挂载一块数据盘(云硬盘)，云主机和云硬盘没有正在进行中的的任务时才可挂载。<br>

云主机状态必须是<b>running</b>或<b>stopped</b>状态。<br> 本地盘(local类型)做系统盘的云主机可挂载8块数据盘，云硬盘(cloud类型)做系统盘的云主机可挂载7块数据盘。

func (*VmClient) AttachNetworkInterface added in v1.0.5 

func (c *VmClient) AttachNetworkInterface(request *vm.AttachNetworkInterfaceRequest) (*vm.AttachNetworkInterfaceResponse, error)
云主机挂载一块弹性网卡。<br>

云主机状态必须为<b>running</b>或<b>stopped</b>状态，并且没有正在进行中的任务才可操作。<br> 弹性网卡上如果绑定了公网IP，那么公网IP所在az需要与云主机的az保持一致，或者公网IP属于全可用区，才可挂载。<br> 云主机挂载弹性网卡的数量，不能超过实例规格的限制。可查询<a href="http://docs.jdcloud.com/virtual-machines/api/describeinstancetypes">DescribeInstanceTypes</a>接口获得指定规格可挂载弹性网卡的数量上限。<br> 弹性网卡与云主机必须在相同vpc下。

func (*VmClient) CopyImages added in v1.0.5 

func (c *VmClient) CopyImages(request *vm.CopyImagesRequest) (*vm.CopyImagesResponse, error)
镜像跨区复制，将私有镜像复制到其它地域下，只允许操作您的个人私有镜像。<br>

只支持rootDeviceType为cloudDisk的云硬盘系统盘镜像操作。

func (*VmClient) CreateImage 

func (c *VmClient) CreateImage(request *vm.CreateImageRequest) (*vm.CreateImageResponse, error)
为云主机创建私有镜像。云主机状态必须为<b>stopped</b>。<br>

云主机没有正在进行中的任务才可制作镜像。<br> 制作镜像以备份系统盘为基础，在此之上可选择全部或部分挂载数据盘制作整机镜像（如不做任何更改将默认制作整机镜像），制作镜像过程会为所挂载云硬盘创建快照并与镜像关联。<br> 调用接口后，需要等待镜像状态变为<b>ready</b>后，才能正常使用镜像。

func (*VmClient) CreateInstances 

func (c *VmClient) CreateInstances(request *vm.CreateInstancesRequest) (*vm.CreateInstancesResponse, error)
创建一台或多台指定配置的云主机，创建模式分为三种：1.普通方式、2.使用高可用组、3.使用启动模板。三种方式创建云主机时参数的必传与非必传是不同的，具体请参考<a href="http://docs.jdcloud.com/virtual-machines/api/create_vm_sample">参数详细说明</a><br>

- 创建云主机需要通过实名认证 - 实例规格

- 镜像

- 网络配置

  • 指定主网卡配置信息
  • 必须指定subnetId
  • 可以指定elasticIp规格来约束创建的弹性IP，带宽取值范围[1-100]Mbps，步进1Mbps
  • 可以指定主网卡的内网主IP(primaryIpAddress)，此时maxCount只能为1
  • 安全组securityGroup需与子网Subnet在同一个私有网络VPC内
  • 一台云主机创建时必须指定一个安全组，至多指定5个安全组，如果没有指定安全组，默认使用默认安全组
  • 主网卡deviceIndex设置为1

- 存储

  • 系统盘
  • 磁盘分类，系统盘支持local或cloud
  • 磁盘大小
  • local：不能指定大小，默认为40GB
  • cloud：取值范围: 40-500GB，并且不能小于镜像的最小系统盘大小，如果没有指定，默认以镜像中的系统盘大小为准
  • 自动删除
  • 如果是local，默认自动删除，不能修改此属性
  • 如果是cloud类型的按配置计费的云硬盘，可以指定为True
  • 数据盘
  • 磁盘分类，数据盘仅支持cloud
  • 云硬盘类型可以选择ssd、premium-hdd
  • 磁盘大小
  • premium-hdd：范围[20,3000]GB，步长为10G
  • ssd：范围[20,1000]GB，步长为10G
  • 自动删除
  • 默认自动删除，如果是包年包月的数据盘或共享型数据盘，此参数不生效
  • 可以指定SnapshotId创建云硬盘
  • 可以从快照创建磁盘
  • local类型系统的云主机可以挂载8块云硬盘
  • cloud类型系统的云主机可以挂载7块云硬盘

- 计费

  • 弹性IP的计费模式，如果选择按用量类型可以单独设置，其它计费模式都以主机为准
  • 云硬盘的计费模式以主机为准

- 其他

  • 创建完成后，主机状态为running
  • 仅Linux系统云主机可以指定密钥
  • maxCount为最大努力，不保证一定能达到maxCount
  • 虚机的az会覆盖磁盘的az属性

- 密码

func (*VmClient) CreateKeypair added in v1.1.0 

func (c *VmClient) CreateKeypair(request *vm.CreateKeypairRequest) (*vm.CreateKeypairResponse, error)
创建ssh密钥对。公钥部分存储在京东云，并返回未加密的 PEM 编码的 PKCS#8 格式私钥，您只有一次机会保存您的私钥。请妥善保管。<br>

若传入已存在的密钥名称，会返回错误。

func (*VmClient) DeleteImage 

func (c *VmClient) DeleteImage(request *vm.DeleteImageRequest) (*vm.DeleteImageResponse, error)
删除一个私有镜像，只允许操作您的个人私有镜像。<br>

若镜像已共享给其他用户，需先取消共享才可删除。

func (*VmClient) DeleteInstance 

func (c *VmClient) DeleteInstance(request *vm.DeleteInstanceRequest) (*vm.DeleteInstanceResponse, error)
删除按配置计费、或包年包月已到期的单个云主机。不能删除没有计费信息的云主机。<br>

云主机状态必须为运行<b>running</b>、停止<b>stopped</b>、错误<b>error</b>，同时云主机没有正在进行中的任务才可删除。<br> 包年包月未到期的云主机不能删除。<br> 如果主机中挂载的数据盘为按配置计费的云硬盘，并且不是共享型云硬盘，并且AutoDelete属性为true，那么数据盘会随主机一起删除。 

[MFA enabled]

func (*VmClient) DeleteKeypair added in v1.1.0 

func (c *VmClient) DeleteKeypair(request *vm.DeleteKeypairRequest) (*vm.DeleteKeypairResponse, error)

删除ssh密钥对。

func (*VmClient) DescribeImage 

func (c *VmClient) DescribeImage(request *vm.DescribeImageRequest) (*vm.DescribeImageResponse, error)

查询镜像详情。

func (*VmClient) DescribeImageConstraints 

func (c *VmClient) DescribeImageConstraints(request *vm.DescribeImageConstraintsRequest) (*vm.DescribeImageConstraintsResponse, error)
查询镜像的实例规格限制。<br>

通过此接口可以查看镜像不支持的实例规格。只有官方镜像、第三方镜像有实例规格的限制，个人的私有镜像没有此限制。

func (*VmClient) DescribeImageConstraintsBatch added in v1.0.4 

func (c *VmClient) DescribeImageConstraintsBatch(request *vm.DescribeImageConstraintsBatchRequest) (*vm.DescribeImageConstraintsBatchResponse, error)
批量查询镜像的实例规格限制。<br>

通过此接口可以查看镜像不支持的实例规格。只有官方镜像、第三方镜像有实例规格的限制，个人的私有镜像没有此限制。

func (*VmClient) DescribeImageMembers 

func (c *VmClient) DescribeImageMembers(request *vm.DescribeImageMembersRequest) (*vm.DescribeImageMembersResponse, error)

查询镜像共享帐户列表，只允许操作您的个人私有镜像。

func (*VmClient) DescribeImages 

func (c *VmClient) DescribeImages(request *vm.DescribeImagesRequest) (*vm.DescribeImagesResponse, error)
查询镜像信息列表。<br>

通过此接口可以查询到京东云官方镜像、第三方镜像、私有镜像、或其他用户共享给您的镜像。<br> 此接口支持分页查询，默认每页20条。

func (*VmClient) DescribeInstance 

func (c *VmClient) DescribeInstance(request *vm.DescribeInstanceRequest) (*vm.DescribeInstanceResponse, error)

查询一台云主机的详细信息

func (*VmClient) DescribeInstancePrivateIpAddress added in v1.0.11 

func (c *VmClient) DescribeInstancePrivateIpAddress(request *vm.DescribeInstancePrivateIpAddressRequest) (*vm.DescribeInstancePrivateIpAddressResponse, error)

批量查询云主机内网IP地址，查询的是主网卡内网主IP地址。

func (*VmClient) DescribeInstanceStatus added in v1.0.4 

func (c *VmClient) DescribeInstanceStatus(request *vm.DescribeInstanceStatusRequest) (*vm.DescribeInstanceStatusResponse, error)

批量查询云主机状态

func (*VmClient) DescribeInstanceTypes 

func (c *VmClient) DescribeInstanceTypes(request *vm.DescribeInstanceTypesRequest) (*vm.DescribeInstanceTypesResponse, error)

查询实例规格信息列表

func (*VmClient) DescribeInstanceVncUrl 

func (c *VmClient) DescribeInstanceVncUrl(request *vm.DescribeInstanceVncUrlRequest) (*vm.DescribeInstanceVncUrlResponse, error)
获取云主机vnc，用于连接管理云主机。<br>

vnc地址的有效期为1个小时，调用接口获取vnc地址后如果1个小时内没有使用，vnc地址自动失效，再次使用需要重新获取。

func (*VmClient) DescribeInstances 

func (c *VmClient) DescribeInstances(request *vm.DescribeInstancesRequest) (*vm.DescribeInstancesResponse, error)
批量查询云主机的详细信息<br>

此接口支持分页查询，默认每页20条。

func (*VmClient) DescribeKeypairs added in v1.1.0 

func (c *VmClient) DescribeKeypairs(request *vm.DescribeKeypairsRequest) (*vm.DescribeKeypairsResponse, error)
批量查询密钥对。<br>

此接口支持分页查询，默认每页20条。

func (*VmClient) DescribeQuotas 

func (c *VmClient) DescribeQuotas(request *vm.DescribeQuotasRequest) (*vm.DescribeQuotasResponse, error)

查询配额，支持：云主机、镜像、密钥、模板、镜像共享

func (*VmClient) DetachDisk 

func (c *VmClient) DetachDisk(request *vm.DetachDiskRequest) (*vm.DetachDiskResponse, error)

云主机缷载数据盘，云主机和云硬盘没有正在进行中的任务时才可缷载。<br>

func (*VmClient) DetachNetworkInterface added in v1.0.5 

func (c *VmClient) DetachNetworkInterface(request *vm.DetachNetworkInterfaceRequest) (*vm.DetachNetworkInterfaceResponse, error)
云主机缷载一块弹性网卡。<br>

云主机状态必须为<b>running</b>或<b>stopped</b>状态，并且没有正在进行中的任务才可操作。<br> 不能缷载主网卡。

func (*VmClient) DisassociateElasticIp 

func (c *VmClient) DisassociateElasticIp(request *vm.DisassociateElasticIpRequest) (*vm.DisassociateElasticIpResponse, error)

云主机解绑弹性公网IP，解绑的是主网卡、内网主IP对应的弹性公网IP。

func (*VmClient) ImportKeypair added in v1.1.0 

func (c *VmClient) ImportKeypair(request *vm.ImportKeypairRequest) (*vm.ImportKeypairResponse, error)
导入由其他工具生成的密钥对的公钥部分。<br>

若传入已存在的密钥名称，会返回错误。

func (*VmClient) ModifyImageAttribute added in v1.0.4 

func (c *VmClient) ModifyImageAttribute(request *vm.ModifyImageAttributeRequest) (*vm.ModifyImageAttributeResponse, error)

修改镜像信息，包括名称、描述；只允许操作您的个人私有镜像。

func (*VmClient) ModifyInstanceAttribute 

func (c *VmClient) ModifyInstanceAttribute(request *vm.ModifyInstanceAttributeRequest) (*vm.ModifyInstanceAttributeResponse, error)

修改云主机部分信息，包括名称、描述。

func (*VmClient) ModifyInstanceDiskAttribute added in v1.0.5 

func (c *VmClient) ModifyInstanceDiskAttribute(request *vm.ModifyInstanceDiskAttributeRequest) (*vm.ModifyInstanceDiskAttributeResponse, error)

修改云主机挂载的数据盘属性，包括是否随主机删除。

func (*VmClient) ModifyInstanceNetworkAttribute added in v1.0.5 

func (c *VmClient) ModifyInstanceNetworkAttribute(request *vm.ModifyInstanceNetworkAttributeRequest) (*vm.ModifyInstanceNetworkAttributeResponse, error)
修改虚机弹性网卡属性，包括是否随云主机一起删除。<br>

不能修改主网卡。

func (*VmClient) ModifyInstancePassword 

func (c *VmClient) ModifyInstancePassword(request *vm.ModifyInstancePasswordRequest) (*vm.ModifyInstancePasswordResponse, error)
修改云主机密码，主机没有正在进行中的任务时才可操作。<br>

修改密码后，需要重启云主机后生效。

func (*VmClient) RebootInstance 

func (c *VmClient) RebootInstance(request *vm.RebootInstanceRequest) (*vm.RebootInstanceResponse, error)

重启单个云主机，只能重启<b>running</b>状态的云主机，云主机没有正在进行中的任务才可重启。

func (*VmClient) RebuildInstance added in v1.0.2 

func (c *VmClient) RebuildInstance(request *vm.RebuildInstanceRequest) (*vm.RebuildInstanceResponse, error)
云主机使用指定镜像重置云主机系统<br>

云主机的状态必须为<b>stopped</b>状态。<br> 若当前云主机的系统盘类型为local类型，那么更换的镜像必须为localDisk类型的镜像；同理若当前云主机的系统盘为cloud类型，那么更换的镜像必须为cloudDisk类型的镜像。可查询<a href="http://docs.jdcloud.com/virtual-machines/api/describeimages">DescribeImages</a>接口获得指定地域的镜像信息。<br> 若不指定镜像ID，默认使用当前主机的原镜像重置系统。<br> 指定的镜像必须能够支持当前主机的实例规格(instanceType)，否则会返回错误。可查询<a href="http://docs.jdcloud.com/virtual-machines/api/describeimageconstraints">DescribeImageConstraints</a>接口获得指定镜像支持的系统盘类型信息。

func (*VmClient) ResizeInstance added in v1.0.2 

func (c *VmClient) ResizeInstance(request *vm.ResizeInstanceRequest) (*vm.ResizeInstanceResponse, error)
云主机变更实例规格<br>

云主机的状态必须为<b>stopped</b>状态。<br> 16年创建的云硬盘做系统盘的主机，一代与二代实例规格不允许相互调整。<br> 本地盘(local类型)做系统盘的主机，一代与二代实例规格不允许相互调整。<br> 使用高可用组(Ag)创建的主机，一代与二代实例规格不允许相互调整。<br> 云硬盘(cloud类型)做系统盘的主机，一代与二代实例规格允许相互调整。<br> 如果当前主机中的弹性网卡数量，大于新实例规格允许的弹性网卡数量，会返回错误。可查询<a href="http://docs.jdcloud.com/virtual-machines/api/describeinstancetypes">DescribeInstanceTypes</a>接口获得指定地域及可用区下的实例规格信息。<br> 当前主机所使用的镜像，需要支持要变更的目标实例规格，否则返回错误。可查询<a href="http://docs.jdcloud.com/virtual-machines/api/describeimageconstraints">DescribeImageConstraints</a>接口获得指定镜像的实例规格限制信息。<br> 云主机欠费或到期时，无法更改实例规格。

func (*VmClient) SetConfig 

func (c *VmClient) SetConfig(config *core.Config)

func (*VmClient) SetLogger 

func (c *VmClient) SetLogger(logger core.Logger)

func (*VmClient) ShareImage 

func (c *VmClient) ShareImage(request *vm.ShareImageRequest) (*vm.ShareImageResponse, error)
共享镜像，只允许操作您的个人私有镜像，单个镜像最多可共享给20个京东云帐户。<br>

整机镜像目前不支持共享。

func (*VmClient) StartInstance 

func (c *VmClient) StartInstance(request *vm.StartInstanceRequest) (*vm.StartInstanceResponse, error)
启动单个云主机，只能启动<b>stopped</b>状态的云主机，云主机没有正在进行中的任务才可启动。<br>

只能启动正常计费状态的云主机。

func (*VmClient) StopInstance 

func (c *VmClient) StopInstance(request *vm.StopInstanceRequest) (*vm.StopInstanceResponse, error)

停止单个云主机，只能停止<b>running</b>状态的云主机，云主机没有正在进行中的任务才可停止

func (*VmClient) UnShareImage 

func (c *VmClient) UnShareImage(request *vm.UnShareImageRequest) (*vm.UnShareImageResponse, error)

取消共享镜像，只允许操作您的个人私有镜像。

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.