Click or drag to resize
CloudServersProviderListServers Method
Returns a list of basic information for servers in the account.

Namespace: net.openstack.Providers.Rackspace
Assembly: openstacknet (in openstacknet.dll) Version: 1.7.7+Branch.master.Sha.25d803f397c8693c2c13777ef6675f796f520f2c
Syntax
public IEnumerable<SimpleServer> ListServers(
	string imageId = null,
	string flavorId = null,
	string name = null,
	ServerState status = null,
	string markerId = null,
	Nullable<int> limit = null,
	Nullable<DateTimeOffset> changesSince = null,
	string region = null,
	CloudIdentity identity = null
)

Parameters

imageId (Optional)
Type: SystemString
The image to filter the returned servers list. If the value is , servers for all images are returned. This is specified as an image ID (see Id) or a full URL.
flavorId (Optional)
Type: SystemString
The flavor to filter the returned servers list. If the value is , servers for all flavors are returned. This is specified as a flavor ID (see Id) or a full URL.
name (Optional)
Type: SystemString
Filters the list to those with a name that matches. If the value is , servers are not filtered by name.
status (Optional)
Type: net.openstack.Core.DomainServerState
Filters the list to those with a status that matches. If the value is , servers are not filtered by status. See ServerState for the allowed values.
markerId (Optional)
Type: SystemString
The Id of the last item in the previous list. Used for pagination. If the value is , the list starts at the beginning.
limit (Optional)
Type: SystemNullableInt32
Indicates the maximum number of items to return. Used for pagination. If the value is , a provider-specific default value is used.
changesSince (Optional)
Type: SystemNullableDateTimeOffset
Filters the list to those that have changed since the given date. If the value is , servers are not filtered by timestamp.
region (Optional)
Type: SystemString
The region in which to execute this action. If not specified, the user's default region will be used.
identity (Optional)
Type: net.openstack.Core.DomainCloudIdentity
The cloud identity to use for this request. If not specified, the default identity for the current provider instance will be used.

Return Value

Type: IEnumerableSimpleServer
A collection of SimpleServer objects describing the requested servers.

Implements

IComputeProviderListServers(String, String, String, ServerState, String, NullableInt32, NullableDateTimeOffset, String, CloudIdentity)
Exceptions
ExceptionCondition
ArgumentOutOfRangeExceptionIf limit is less than 0.
NotSupportedException If the provider does not support the given identity type.

-or-

The specified region is not supported.

InvalidOperationException If identity is and no default identity is available for the provider.

-or-

If region is and no default region is available for the provider.

ResponseExceptionIf the REST API request failed.
Remarks
If the changesSince parameter is specified, servers which have been deleted since the specified time are returned by this method. Otherwise, deleted servers are not included in the list of servers returned by this method.
Version Information

.NET Framework

Supported in: 4.5

openstack.net

Supported in: 1.6, 1.5, 1.4, 1.3.6
See Also