Listing Templates

Function

This API is used to query the list of templates used for creating target servers. You can use this template to create target servers if you choose to create a server as the target server.

URI

GET /v3/vm/templates

**Table 1** Query parameters
Parameter	Mandatory	Type	Description
name	No	String	Specifies the template name. Minimum length: 0 characters Maximum length: 255 characters
availability_zone	No	String	Specifies the AZ of the target server. Minimum length: 0 characters Maximum length: 255 characters
region	No	String	Region ID Minimum length: 0 characters Maximum length: 255 characters
limit	No	Integer	Specifies the number of records displayed on each page. If this parameter is not transferred, the default value 50 is used. Minimum value: 0 Maximum value: 100 Default value: 50
offset	No	Integer	Specifies the offset. If this parameter is not transferred, the default value 0 is used. Minimum value: 0 Maximum value: 65535 Default value: 0

Request

**Table 2** Request header parameter
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Specifies the user token. It can be obtained by calling the IAM API (value of X-Subject-Token in the response header). Minimum length: 1 character Maximum length: 16,384 characters

Response

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
count	Integer	Specifies the number of templates. Minimum value: 0 Maximum value: 65535
templates	Array of TemplateResponse objects	Specifies the template information.

**Table 4** **TemplateResponse** field description
Parameter	Type	Description
template	TemplateResponseBody object	Specifies the template information.

**Table 5** **TemplateResponseBody** field description
Parameter	Type	Description
id	String	Specifies the template ID. Minimum length: 0 characters Maximum length: 255 characters
name	String	Specifies the template name. Minimum length: 0 characters Maximum length: 255 characters
is_template	String	Specifies whether the template is general. If the template is associated with a task, the template is not a general template. Minimum length: 0 characters Maximum length: 255 characters
region	String	Specifies the region where the target server will reside. Minimum length: 0 characters Maximum length: 255 characters
projectid	String	Specifies the project ID. Minimum length: 0 characters Maximum length: 255 characters
target_server_name	String	Specifies the name of the target server. Minimum length: 0 characters Maximum length: 255 characters
availability_zone	String	Specifies the AZ of the target server. Minimum length: 0 characters Maximum length: 255 characters
volumetype	String	Specifies the disk type. The value can be: SAS SSD SATA
flavor	String	Specifies the flavor of the target server. Minimum length: 0 characters Maximum length: 255 characters
vpc	VpcObject object	Specifies the VPC information.
nics	Array of Nics objects	Specifies the NIC information. Multiple NICs are supported. If the target server is automatically created, enter only one NIC and set the ID to autoCreate.
security_groups	Array of SgObject objects	Specifies the security group information. Multiple security groups are supported. If the target server is automatically created, enter only one security group and set the ID to autoCreate.
publicip	PublicIp object	Specifies the information about the public IP address that will be used for migration.
disk	Array of TemplateDisk objects	Specifies the disk information.
data_volume_type	String	Specifies the data disk type. The value can be: SAS SSD SATA
target_password	String	Specifies the password for logging in to the target server. Minimum length: 0 characters Maximum length: 1,024 characters

**Table 6** **VpcObject** field description
Parameter	Type	Description
id	String	Specifies the VPC ID. If the target server is created automatically, set this parameter to autoCreate. Minimum length: 1 character Maximum length: 255 characters
name	String	Specifies the VPC name. Minimum length: 1 character Maximum length: 255 characters
cidr	String	Specifies the VPC CIDR block. The default value is 192.168.0.0/16. Minimum length: 1 character Maximum length: 255 characters

**Table 7** **Nics** field description
Parameter	Type	Description
id	String	Specifies the subnet ID. If the target server is created automatically, set this parameter to autoCreate. Minimum length: 0 characters Maximum length: 255 characters
name	String	Specifies the subnet name. Minimum length: 0 characters Maximum length: 255 characters
cidr	String	Specifies the subnet gateway/mask. Minimum length: 0 characters Maximum length: 255 characters
ip	String	Specifies the IP address of the target server. If this parameter is not specified, the system will automatically assign an IP address. Minimum length: 0 characters Maximum length: 255 characters

**Table 8** **SgObject** field description
Parameter	Type	Description
id	String	Specifies the security group ID. Minimum length: 0 characters Maximum length: 255 characters
name	String	Specifies the security group name. Minimum length: 0 characters Maximum length: 255 characters

**Table 9** **PublicIp** field description
Parameter	Type	Description
type	String	Specifies the EIP type. The default value is 5_bgp. Minimum length: 0 characters Maximum length: 255 characters
bandwidth_size	Integer	Specifies the bandwidth size in Mbit/s. The minimum increment for bandwidth adjustment varies depending on the bandwidth range. The details are as follows: The minimum increment is 1 Mbit/s if the allowed bandwidth ranges from 0 Mbit/s to 300 Mbit/s (with 300 Mbit/s included). The minimum increment is 50 Mbit/s if the allowed bandwidth ranges from 300 Mbit/s to 1,000 Mbit/s. The minimum increment is 500 Mbit/s if the allowed bandwidth is greater than 1,000 Mbit/s. Minimum value: 1 Maximum value: 2000

**Table 10** **TemplateDisk** field description
Parameter	Type	Description
index	Integer	Specifies the disk serial number, starting from 0 Minimum value: 0 Maximum value: 2147483647
name	String	Specifies the disk name. Minimum length: 0 characters Maximum length: 255 characters
disktype	String	Specifies the disk type. The value is the same as that of volumetype. Minimum length: 0 characters Maximum length: 255 characters
size	Long	Specifies the disk size in GB. Minimum value: 0 Maximum value: 9223372036854775807

Example Request

Query the template list.

GET https://{endpoint}/v3/vm/templates

Example Response

Status code: 200

{
  "count" : 9,
  "templates" : [ {
    "id" : "3db302e8-95de-478c-a892-8a083f2d269b",
    "name" : "test",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "c6e3047501b340a4a79fb94dad453676",
    "flavor" : "s2.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "4d329f4b-70ee-4996-ba9a-5b5ec63a7c2e",
      "name" : "vpc-dfdb"
    },
    "nics" : [ {
      "id" : "d807e702-a59a-480c-aa5e-23449775d107",
      "name" : "subnet-dfdb(192.168.1.0/24)",
      "cidr" : "192.168.1.0/24",
      "ip" : ""
    } ],
    "security_groups" : [ {
      "id" : "c922bce4-1892-44bc-a58e-f250a666939a",
      "name" : "default(Inbound:tcp/8900,8899,3389,22; Outbound:--)"
    } ]
  }, {
    "id" : "708847ae-f013-4b1a-8ea8-6cfa1e94237d",
    "name" : "test1",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "05a6d0f34380269c2f02c016826878ea",
    "flavor" : "s6.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "ee756d79-6223-464b-a3f4-a1e048309fdb",
      "name" : "vpc-13d6"
    },
    "nics" : [ {
      "id" : "768b0328-7b01-4d34-9afc-03e88025ff05",
      "name" : "subnet-13d6(192.168.1.0/24)",
      "cidr" : "192.168.1.0/24",
      "ip" : ""
    } ],
    "security_groups" : [ {
      "id" : "bf736dd6-7e7e-42ba-a1d3-b3a9f6a5fda5",
      "name" : "sms-1568190885(Inbound:tcp/8900,8899,3389; Outbound:--)"
    } ]
  }, {
    "id" : "6874cb49-48bb-4875-975d-4bca464d8472",
    "name" : "test2",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "353b5ccc3deb4abc8ac8291bf468f69c",
    "flavor" : "s2.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "a1f9de64-bf00-4c4f-8c97-ebc65f9e1e2e",
      "name" : "vpc-testcloud(192.168.0.0/16)"
    },
    "nics" : [ {
      "id" : "04ba310f-34df-4df3-9385-11552aafff03",
      "name" : "subnet-testcloud(192.168.0.0/24)",
      "cidr" : "192.168.0.0/24",
      "ip" : ""
    } ],
    "security_groups" : [ ]
  }, {
    "id" : "76b8b2b2-b730-4000-b0a3-048f80105dd2",
    "name" : "fdff",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "00924d0ad2df4f21ac476dd9f32888f1",
    "flavor" : "s2.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "d6f34811-1a4d-4686-911a-982c8e2c1f1b",
      "name" : "vpc-migration(192.168.0.0/16)"
    },
    "nics" : [ {
      "id" : "85ca07d5-7d0d-40ce-b1b2-9dd2db14f840",
      "name" : "subnet-cf42(192.168.5.0/24)",
      "cidr" : "192.168.5.0/24",
      "ip" : ""
    } ],
    "security_groups" : [ {
      "id" : "a563735f-4183-40de-854f-5ba2cb26496d",
      "name" : "sg-smt-test(Inbound:tcp/3389,8899,22,8900; Outbound:--)"
    } ]
  }, {
    "id" : "382f66f9-b948-4bee-b2a8-50b9d3461c81",
    "name" : "test3",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "00924d0ad2df4f21ac476dd9f32888f1",
    "flavor" : "s2.medium.2",
    "volumetype" : "",
    "vpc" : { },
    "nics" : [ ],
    "security_groups" : [ ]
  }, {
    "id" : "b3c49d20-720a-486f-9d61-b56e6b5bca39",
    "name" : "test_linux_childproj",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "062b8cb8ec8010dc2f42c0167c4631f9",
    "flavor" : "s2.small.1",
    "volumetype" : "SATA",
    "vpc" : {
      "id" : "b09cebfb-6887-4c58-a353-008dae644f6e",
      "name" : "sms-1567992634(192.168.0.0/16)"
    },
    "nics" : [ {
      "id" : "34688a59-2fd9-422d-a373-87460ef60014",
      "name" : "sms-1567992646(192.168.0.0/16)",
      "cidr" : "192.168.0.0/16",
      "ip" : ""
    } ],
    "security_groups" : [ {
      "id" : "079febf0-cfd2-4722-82d6-a518ea65cd67",
      "name" : "sg-7e50(Inbound:tcp/8900,8899,3389,22; Outbound:--)"
    } ]
  }, {
    "id" : "bda09f7f-3b0c-4bb5-a1ad-3a4d62024774",
    "name" : "12212",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "2c0689c860ad4728a497c91ec0844383",
    "flavor" : "s2.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "4490ab3f-5f0c-42e9-97b7-8b3bc0541e70",
      "name" : "vpc-migration(192.168.0.0/16)"
    },
    "nics" : [ {
      "id" : "350a355b-53db-4e58-80fc-56841ab55021",
      "name" : "subnet-migration(192.168.1.0/24)",
      "cidr" : "192.168.1.0/24",
      "ip" : ""
    } ],
    "security_groups" : [ {
      "id" : "410f9e21-1085-41b8-b5f7-0da0089be8e3",
      "name" : "SMT-Windows(Inbound:tcp/8443,8899,8900,22,3389;icmp; Outbound:--)"
    } ]
  }, {
    "id" : "7d0b56ff-f9c7-478d-9017-120bbdf4b363",
    "name" : "test4",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "00924d0ad2df4f21ac476dd9f32888f1",
    "flavor" : "s2.medium.2",
    "volumetype" : "SATA",
    "vpc" : { },
    "nics" : [ ],
    "security_groups" : [ ]
  }, {
    "id" : "ec4ac7de-dba1-4602-b327-c228243651db",
    "name" : "dddd",
    "region" : "region",
    "availability_zone" : "availability_zone",
    "projectid" : "2c0689c860ad4728a497c91ec0844383",
    "flavor" : "s2.large.2",
    "volumetype" : "",
    "vpc" : {
      "id" : "00cda768-ef7b-40ac-a555-84b0c2b85d89",
      "name" : "sms-1566979232(192.168.0.0/16)"
    },
    "nics" : [ {
      "id" : "b5891372-f48c-4b3c-9f7a-ab58da5baa93",
      "name" : "sms-1566979244(192.168.0.0/16)",
      "cidr" : "192.168.0.0/16",
      "ip" : ""
    } ],
    "security_groups" : [ ]
  } ]
}