A list of servers. Each server contains IDs, names,
and links. Other attributes are omitted.The tenant ID in a multi-tenancy
cloud.Lists IDs, names, and links for all
servers.A time/date stamp for when the server last
changed status.Name of the image in URL
format.Name of the flavor in URL
format.Name of the server as a
string; can be queried with regular
expressions. Realize that ?name=bob returns both
bob and bobb. If you need to match bob only, you can use
a regular expression matching the syntax of the
underlying database server implemented for
Compute (such as MySQL or PostgreSQL).UUID of the server at which you want to set
a marker.Integer value for the limit of values to
return.Value of the status of the server so that
you can filter on "ACTIVE" for
example.Name of the host as a
string.{
"servers": [
{
"id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
"links": [
{
"href": "http://openstack.example.com/v2/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19",
"rel": "self"
},
{
"href": "http://openstack.example.com/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19",
"rel": "bookmark"
}
],
"name": "new-server-test"
}
]
}<?xml version='1.0' encoding='UTF-8'?>
<servers xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1">
<server name="new-server-test" id="b626796d-d585-4874-b178-78c65289bba4">
<atom:link href="http://openstack.example.com/v2/openstack/servers/b626796d-d585-4874-b178-78c65289bba4" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/servers/b626796d-d585-4874-b178-78c65289bba4" rel="bookmark"/>
</server>
</servers>List of servers.Moves to the next item in
the list.Moves to the previous item
in the list.Creates a server with a block
device mapping.{
"server": {
"name": "new-server-test",
"imageRef": "http://openstack.example.com/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b",
"flavorRef": "http://openstack.example.com/openstack/flavors/1",
"metadata": {
"My Server Name": "Apache1"
},
"personality": [
{
"path": "/etc/banner.txt",
"contents": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA=="
}
],
"block_device_mapping_v2": [
{
"device_name": "/dev/sdb1",
"source_type": "blank",
"destination_type": "local",
"delete_on_termination": "True",
"guest_format": "swap",
"boot_index": "-1"
},
{
"device_name": "/dev/sda1",
"source_type": "volume",
"destination_type": "volume",
"uuid": "fake-volume-id-1",
"boot_index": "0"
}
]
}
}<?xml version="1.0" encoding="UTF-8"?>
<server xmlns="http://docs.openstack.org/compute/api/v1.1" imageRef="http://openstack.example.com/openstack/images/70a599e0-31e7-49b7-b260-868f441e862b" flavorRef="http://openstack.example.com/openstack/flavors/1" name="new-server-test">
<metadata>
<meta key="My Server Name">Apache1</meta>
</metadata>
<personality>
<file path="/etc/banner.txt">
ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBp
dCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5k
IGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVs
c2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4g
QnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRo
ZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlv
dSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vy
c2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6
b25zLiINCg0KLVJpY2hhcmQgQmFjaA==
</file>
</personality>
<block_device_mapping_v2>
<mapping device_name="/dev/sdb1" source_type="blank" destination_type="local" delete_on_termination="True" guest_format="swap" boot_index="-1"></mapping>
<mapping device_name="/dev/sda1" source_type="volume" destination_type="volume" uuid="fake-volume-id-1" boot_index="0"></mapping>
</block_device_mapping_v2>
</server>A security_groups
object.One or more
security_group objects.
Specify the name of the security group in the
name attribute. If you omit
this attribute, the server is created in the
default security
group.Configuration information or
scripts to use upon launch. Must be Base64
encoded.The availability zone in which
to launch the server.server.The image reference for the desired image
for your server instance.Specify as an ID or full
URL.The flavor reference for the desired flavor
for your server instance.Specify as an ID or full
URL.A networks object. By default,
the server instance is provisioned with all
isolated networks for the tenant.Optionally, you can create one or more NICs
on the server.To provision the server instance with a NIC
for a network, specify the UUID of the network
in the uuid attribute in a
networks object.To provision the server instance with a NIC
for an already existing port, specify the
port-id in the port attribute in
a networks object.You can specify multiple NICs on the
server.To provision the server instance with a NIC
for a network, specify the UUID of the network
in the uuid attribute in a
networks object. Required if you
omit the port attribute.To provision the server instance with a NIC
for an already existing port, specify the
port-id in the port attribute in
a networks object. Required if
you omit the uuid
attribute.A fixed IPv4 address for the NIC. Valid with
a neutron or
nova-networks network.The server name.Metadata key and value pairs. The maximum
size of the metadata key and value is 255
bytes each.File path and contents (text only) to inject
into the server at launch. The maximum size of
the file path data is 255 bytes. The maximum
limit refers to the number of bytes in the
decoded data and not the number of characters
in the encoded data.Enables booting the server from a volume
when additional parameters are given.Describes a path to the device for the
volume you want to use to boot the
server.Describes the volume source type for the
volume. Choices are "blank", "snapshot", "volume", or "image".Describes where the volume comes from.
Choices are "local" or "volume". When using
"volume" the volume ID To delete the boot volume when the server stops, specify
true. Otherwise, specify false.Specifies the guest server disk file system format, such
as "ephemeral" or "swap".To delete the boot volume when the server stops, specify
true. Otherwise, specify false.Indicates a number designating the boot order of the
device. Use -1 for the boot volume, choose 0 for
an attached volume.Enables metadata injection in a server through a
configuration drive.To enable a configuration drive, specify
true. Otherwise, specify false.
block_device_mapping_v2.A device name where the volume is
attached in the system at /dev/dev_name.
This value is typically vda.Either snap or any other
value, including a blank string.
snap means that the
volume was created from a snapshot.Either snap or any other
value, including a blank string.
snap means that the
volume was created from a snapshot.Set to True (or 1) to delete the volume
when the instance is deleted. Set to False
(or 0) to retain the volume when the
instance is deleted.Guest format.The device ID.The boot index.{
"server": {
"adminPass": "N4x7wFX6iN8D",
"id": "babd1af0-4fc6-4529-b32f-aad69811ccf5",
"links": [
{
"href": "http://openstack.example.com/v2/openstack/servers/babd1af0-4fc6-4529-b32f-aad69811ccf5",
"rel": "self"
},
{
"href": "http://openstack.example.com/openstack/servers/babd1af0-4fc6-4529-b32f-aad69811ccf5",
"rel": "bookmark"
}
]
}
}<?xml version='1.0' encoding='UTF-8'?>
<server xmlns:atom="http://www.w3.org/2005/Atom" xmlns="http://docs.openstack.org/compute/api/v1.1" id="fdbce07b-097e-4ab1-8141-b1c847861aa1" adminPass="zA62GVkFvN74">
<metadata/>
<atom:link href="http://openstack.example.com/v2/openstack/servers/fdbce07b-097e-4ab1-8141-b1c847861aa1" rel="self"/>
<atom:link href="http://openstack.example.com/openstack/servers/fdbce07b-097e-4ab1-8141-b1c847861aa1" rel="bookmark"/>
</server>A security_groups
object.One or more
security_group objects.
Specify the name of the security group in the
name attribute. If you omit
this attribute, the server is created in the
default security
group.Configuration information or
scripts to use upon launch. Must be Base64
encoded.The availability zone in which
to launch the server.server.The image reference for the desired image
for your server instance.Specify as an ID or full
URL.The flavor reference for the desired flavor
for your server instance.Specify as an ID or full
URL.A networks object. By default,
the server instance is provisioned with all
isolated networks for the tenant.Optionally, you can create one or more NICs
on the server.To provision the server instance with a NIC
for a network, specify the UUID of the network
in the uuid attribute in a
networks object.To provision the server instance with a NIC
for an already existing port, specify the
port-id in the port attribute in
a networks object.You can specify multiple NICs on the
server.To provision the server instance with a NIC
for a network, specify the UUID of the network
in the uuid attribute in a
networks object. Required if you
omit the port attribute.To provision the server instance with a NIC
for an already existing port, specify the
port-id in the port attribute in
a networks object. Required if
you omit the uuid
attribute.A fixed IPv4 address for the NIC. Valid with
a neutron or
nova-networks network.The server name.Metadata key and value pairs. The maximum
size of the metadata key and value is 255
bytes each.File path and contents (text only) to inject
into the server at launch. The maximum size of
the file path data is 255 bytes. The maximum
limit refers to the number of bytes in the
decoded data and not the number of characters
in the encoded data.Enables booting the server from a volume
when additional parameters are given.Describes a path to the device for the
volume you want to use to boot the
server.Describes the volume source type for the
volume. Choices are "blank", "snapshot", "volume", or "image".Describes where the volume comes from.
Choices are "local" or "volume". When using
"volume" the volume ID To delete the boot volume when the server stops, specify
true. Otherwise, specify false.Specifies the guest server disk file system format, such
as "ephemeral" or "swap".To delete the boot volume when the server stops, specify
true. Otherwise, specify false.Indicates a number designating the boot order of the
device. Use -1 for the boot volume, choose 0 for
an attached volume.Enables metadata injection in a server through a
configuration drive.To enable a configuration drive, specify
true. Otherwise, specify false.