Data Store:Create Data Store On Commodity

Search (SHIFT+S)

Create Data Store On Commodity

POST /vdc/data-stores/commodity

Creates one or more new commodity data stores. A data store represents a commodity node providing backing storage for the object store. On creating, the data store is associated with the storage pool specified in the request.

Note that the data store creation is an asynchronous operation so a successful invocation of this request does not necessarily mean that the creation has completed.

Required Roles

SYSTEM_ADMIN

Prerequisites

The following conditions must be met in order to call this operation.

The storage pool exists

Request Payload

<commodity_data_store_create>
   <nodes>
      <nodeId></nodeId>
      <name></name>
      <virtual_array></virtual_array>
      <description></description>
   </nodes>
</commodity_data_store_create>

{
  "nodes": [
    {
      "nodeId": "",
      "name": "",
      "virtual_array": "",
      "description": ""
    }
  ]
}

All parameters are required unless otherwise stated.

Field	Description	Type	Notes
commodity_data_store_create
nodes			0-* Elements
nodeId	ID of the commodity node	String
name	User provided name (not verified or unique)	String
virtual_array	Desired storage pool Id for creating the data store	String
description	User provided description (not verified or unique)	String

Response Body

Data store creation task list response

This is an asychronous operation that returns a task object. For information on working with tasks, see Asynchronous Operations.

Field	Description	Type	Notes
tasks
task			0-* Elements
op_id	The task operation id	String
resource
name	The name of the resource	String
id	ECS Id of the related object	URI
link	Hyperlink to the related object
tenant
id	ECS Id of the related object	URI
link	Hyperlink to the related object
associated_resources	A list of links for associated resources
associated_resource			0-* Elements
name	The name of the resource	String
id	ECS Id of the related object	URI
link	Hyperlink to the related object
state	The state of the task	String	Valid Values: pending = task is pending ready = task succeed error = task fails
message	The task detail message	String
description	The description of the task	String
service_error
code	The numerical code associated with the error encountered when processing a service request	Integer
description	The description of the error	String
details	Detailed information concerning the error	String
retryable	Indicates whether the error is retryable which means service is temporarily unavailable and the client could retry after a while.	Boolean	Valid Values: true = it is retryable. false = it is not retryable.
start_time	The date and time of when the task was started	DateTime
end_time	The date and time of when the task ended	DateTime
progress		Integer
workflow
id	ECS Id of the related object	URI
link	Hyperlink to the related object
name	Name assigned to this resource in ECS. The resource name is set by a user and can be changed at any time. It is not a unique identifier.	String
id	Identifier that is generated by ECS when the resource is created. The resource Id is guaranteed to be unique and immutable across all virtual data centers for all time.	URI	Valid Values: urn:storageos:resource-type:UUID:
link	Hyperlink to the details for this resource
creation_time	Timestamp that shows when this resource was created in ECS	DateTime	Valid Values: YYYY-MM-DDTHH:mm:ssZ Unix timestamp
inactive	Indicates whether the resource is inactive. When a user removes a resource, the resource is put in this state before it is removed from the ECS database.	Boolean	Valid Values: true false
global	Indicates whether the resource is global.	Boolean	Valid Values: true false
remote	Indicates whether the resource is remote.	Boolean	Valid Values: true false
vdc
id	ECS Id of the related object	URI
link	Hyperlink to the related object
internal	Indicated whether the resource is an internal resource	Boolean	Valid Values: true false