Use the following product API operations to retrieve products.
GET /v2/offerings/{offeringId}/products/{productId}Gets a specific product.
This operation retrieves a specific product.
Request
The request has the following URI and header parameters.
| Name | Type | Description |
|---|---|---|
X-Auth-Token | Header string (Required) | A valid authentication token. |
Content-type | Header string | Value: application/json. |
Accept | Header string | Value: application/json. |
{offeringId} | String (Required) | The ID for the offering. Example: fd2c2294-0498-3791-9df7-1d4ed883a939. |
{productId} | String (Required) | The ID for the product. Example: 0a1239ca-19ae-39e7-a7a3-887dfcc8ea85. |
This operation does not accept a request body.
Example request: header
The following example shows the header information.
X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/jsonResponse
The response has the following body parameters.
Name | Type | Description |
|---|---|---|
product | Object | An info block that contains details about the product. |
product.name | String | The name of the product. |
product.id | String | The universally unique identifier (UUID) for the product. |
product.description | String | The description of the product. |
product.productCode | String | A business identifier for the product. This identifier remains consistent when a new version of the product is introduced. It is unique across all of the products within an offering. |
product.productOfferingPrice | Complex type | Provides pricing information specific to a product in an offering through a nested structure. |
product.productOfferingPrice.description | String | The description of the price. |
product.productOfferingPrice.priceType | String |
|
product.productOfferingPrice.priceDetails | Complex type | A collection that provides details about pricing for the product. |
product.productOfferingPrice.priceDetails.priceCharacteristic | Array | An array of JSON strings that contains a collection of characteristics that provide additional information about the price. Format is |
product.productOfferingPrice.priceDetails.prices | Array | An info block that contains information about product prices. |
product.productOfferingPrice.priceDetails.prices.unitOfMeasure | String |
|
product.productOfferingPrice.priceDetails.prices.price | Complex type | An info block that contains information about a price. |
product.productOfferingPrice.priceDetails.prices.price.amount | String | The price of the product. |
product.productOfferingPrice.priceDetails.prices.price.currency | String | The monetary currency that is associated with the price. |
product.productOfferingPrice.priceDetails.prices.price.geo | String | The geographic region that is associated with the price. |
product.productCharacteristic | Array | An array of key-value pairs that contains info on the operating system and flavor that are associated with the product. This information is primarily used to configure information from external applications that drive product and pricing. Example: |
product.status | String |
|
Service plan details
The following table shows the service level and service type that is associated with each Rackspace service plan.
| Service plan | Service level | Service type |
|---|---|---|
| Infrastructure | Infrastructure | Legacy |
| Managed Cloud | Managed | Legacy |
| Managed Infrastructure | Infrastructure | SysOps |
| Managed Operations | Managed | SysOps |
| DevOps | Managed | DevOps |
Example response
The following example shows the response for the request.
Status Code: 200 OK
Content-Length: 4543
Content-Type: application/json
Date: Wed, 03 Dec 2014 17:13:30 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)
Via: 1.1 Repose (Repose/2.12)
x-compute-request-id: req-7b7ffed2-9b1f-46a8-a478-315518d35387
{
"product": {
"name": "Windows - 30720 MB High Performance I/O 2 Server Instance",
"id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
"description": "Windows - 30720 MB High Performance I/O 2 Server Instance",
"productCode": "UPTIME_HIGH_IO_2_WIN_30720MB",
"productOfferingPrice": {
"description": "Windows - 30720 MB High Performance I/O 2 Server Instance Price",
"priceType": "Usage",
"priceDetails": [
{
"priceCharacteristic": [
{
"name": "serviceLevel",
"value": "MANAGED"
},
{
"name": "serviceType",
"value": "LEGACY"
},
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"amount": "1.480",
"currency": "GBP",
"geo": "UK"
},
{
"amount": "2.000",
"currency": "USD",
"geo": "USA"
},
{
"amount": "2.000",
"currency": "USD",
"geo": "APAC"
},
{
"amount": "2.000",
"currency": "USD",
"geo": "AUS"
}
]
}
]
},
{
"priceCharacteristic": [
{
"name": "serviceLevel",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceType",
"value": "LEGACY"
},
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"amount": "1.180",
"currency": "GBP",
"geo": "UK"
},
{
"amount": "1.600",
"currency": "USD",
"geo": "USA"
},
{
"amount": "1.600",
"currency": "USD",
"geo": "APAC"
},
{
"amount": "1.600",
"currency": "USD",
"geo": "AUS"
}
]
}
]
}
]
},
"productCharacteristic": [
{
"name": "os_type",
"value": "windows"
},
{
"name": "FLAVOR_ID",
"value": "performance2-30"
}
],
"status": "ACTIVE"
}
}Response codes
This operation can have the following response codes.
| Code | Name | Description |
|---|---|---|
| 200 | Success | The request succeeded. |
| 400 | Error | A general error has occurred. |
| 404 | Not Found | The requested resource is not found. |
| 405 | Method Not Allowed | The method received in the request line is known by the origin server but is not supported by the target resource. |
| 406 | Not Acceptable | The value in the Accept header is not supported. |
| 500 | API Fault | The server encountered an unexpected condition that prevented it from fulfilling the request. |
GET /v2/offerings/{offeringId}/productsGets the products for a Rackspace offering.
This operation retrieves all of the products that are associated with a Rackspace offering.
Request
The request has the following URI and header parameters.
Name | Type | Description |
|---|---|---|
| Header string (Required) | A valid authentication token. |
| Header string | Value: |
| Header string | Value: |
| String (Required) | The ID for the offering. Example: |
| String | The maximum number of items to return. The default value is |
| String | The starting point for the return data. This parameter controls pagination. |
| String |
|
| String |
|
| String |
|
| String |
|
| String |
|
This operation does not accept a request body.
Example request: header
The following example shows the header information.
X-Auth-Token: f064c46a782c444cb4ba4b6434288f7c
Content-Type: application/json
Accept: application/jsonResponse
The response has the following body parameters.
Name | Type | Description |
|---|---|---|
products | Array | An array of products. |
products.product | Array | An info block that contains details about a specific product. |
products.product.name | String | The name of the product. |
products.product.description | String | The description of the product. |
products.product.productOfferingPrice | Complex type | Provides pricing information specific to a product in an offering through a nested structure. |
products.product.productOfferingPrice.description | String | A description of the product offering price. |
products.product.productOfferingPrice.priceDetails | Complex type | A collection that provides details about pricing for the product. |
products.product.productOfferingPrice.priceDetails.priceCharacteristic | Array | An array of JSON strings that contains a collection of characteristics that provide additional information about the price. Format is |
products.product.productOfferingPrice.priceDetails.prices | Array | An info block that contains information about prices for the product. |
products.product.productOfferingPrice.priceDetails.prices.unitOfMeasure | String |
|
products.product.productOfferingPrice.priceDetails.prices.price | Complex type | An info block that contains information about a price for the product. |
products.product.productOfferingPrice.priceDetails.prices.price.currency | String |
|
products.product.productOfferingPrice.priceDetails.prices.price.amount | String | The price of the product. |
products.product.productOfferingPrice.priceDetails.prices.price.geo | String |
|
products.product.productOfferingPrice.priceType | String |
|
products.product.productCharacteristic | String | An array of key-value pairs that contains info on the operating system and flavor that are associated with the product. This information is primarily used to configure information from external applications that drive product and pricing. Example: |
products.product.link | Object | An info block that contains details about the link for the product. |
products.product.link.rel | String | The relationship between the current document and the linked document. |
products.product.link.href | String | The URL for the product. |
products.product.id | String | The universally unique identifier (UUID) for the product. |
products.product.status | String |
|
products.product.productCode | String | A business identifier for the product. This identifier remains consistent when a new version of the product is introduced. It is unique across all of the products within an offering. |
products.product.salesChannel | String |
|
products.link | Object | An info block that contains details about the link for the results. |
products.rel | String | The relationship between the current document and the linked document. |
products.href | String | The URL for a set of results. |
Service plan details
The following table shows the service level and service type that is associated with each Rackspace service plan.
| Service plan | Service level | Service type |
|---|---|---|
| Infrastructure | Infrastructure | Legacy |
| Managed Cloud | Managed | Legacy |
| Managed Infrastructure | Infrastructure | SysOps |
| Managed Operations | Managed | SysOps |
| DevOps | Managed | DevOps |
Example response
The following example shows the response for a request to retrieve the Cloud Databases products for an offering. To view responses relating to other types of products, see the Responses by product section of this guide.
Status Code: 200 OK
Content-Length: 4543
Content-Type: application/json
Date: Wed, 03 Dec 2014 17:13:30 GMT
Server: Jetty(8.0.y.z-SNAPSHOT)
Via: 1.1 Repose (Repose/2.12)
x-compute-request-id: req-7b7ffed2-9b1f-46a8-a478-315518d35387
{
"products": {
"product": [
{
"name": "Uptime - Hamysql - 98304 MB",
"description": "Uptime - Hamysql - 98304 MB",
"productOfferingPrice": {
"description": "Uptime - Hamysql - 98304 MB Price",
"priceDetails": [
{
"priceCharacteristic": [
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceLevel",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceType",
"value": "LEGACY"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"currency": "GBP",
"amount": "4.4",
"geo": "UK"
},
{
"currency": "USD",
"amount": "5.75",
"geo": "USA"
}
]
}
]
},
{
"priceCharacteristic": [
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceLevel",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceType",
"value": "SYSOPS"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"currency": "AUD",
"amount": "8.964955",
"geo": "UK"
},
{
"currency": "EUR",
"amount": "6.078239",
"geo": "UK"
},
{
"currency": "GBP",
"amount": "4.4",
"geo": "UK"
},
{
"currency": "USD",
"amount": "7.171964",
"geo": "UK"
},
{
"currency": "AUD",
"amount": "7.1875",
"geo": "USA"
},
{
"currency": "EUR",
"amount": "4.873125",
"geo": "USA"
},
{
"currency": "GBP",
"amount": "3.527625",
"geo": "USA"
},
{
"currency": "USD",
"amount": "5.75",
"geo": "USA"
}
]
}
]
},
{
"priceCharacteristic": [
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceLevel",
"value": "MANAGED"
},
{
"name": "serviceType",
"value": "DEVOPS"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"currency": "AUD",
"amount": "8.964955",
"geo": "UK"
},
{
"currency": "EUR",
"amount": "6.078239",
"geo": "UK"
},
{
"currency": "GBP",
"amount": "4.4",
"geo": "UK"
},
{
"currency": "USD",
"amount": "7.171964",
"geo": "UK"
},
{
"currency": "AUD",
"amount": "7.1875",
"geo": "USA"
},
{
"currency": "EUR",
"amount": "4.873125",
"geo": "USA"
},
{
"currency": "GBP",
"amount": "3.527625",
"geo": "USA"
},
{
"currency": "USD",
"amount": "5.75",
"geo": "USA"
}
]
}
]
},
{
"priceCharacteristic": [
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceLevel",
"value": "MANAGED"
},
{
"name": "serviceType",
"value": "LEGACY"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"currency": "GBP",
"amount": "4.4",
"geo": "UK"
},
{
"currency": "USD",
"amount": "5.75",
"geo": "USA"
}
]
}
]
},
{
"priceCharacteristic": [
{
"name": "chargeType",
"value": "INFRASTRUCTURE"
},
{
"name": "serviceLevel",
"value": "MANAGED"
},
{
"name": "serviceType",
"value": "SYSOPS"
}
],
"prices": [
{
"unitOfMeasure": "per Hour",
"price": [
{
"currency": "AUD",
"amount": "8.964955",
"geo": "UK"
},
{
"currency": "EUR",
"amount": "6.078239",
"geo": "UK"
},
{
"currency": "GBP",
"amount": "4.4",
"geo": "UK"
},
{
"currency": "USD",
"amount": "7.171964",
"geo": "UK"
},
{
"currency": "AUD",
"amount": "7.1875",
"geo": "USA"
},
{
"currency": "EUR",
"amount": "4.873125",
"geo": "USA"
},
{
"currency": "GBP",
"amount": "3.527625",
"geo": "USA"
},
{
"currency": "USD",
"amount": "5.75",
"geo": "USA"
}
]
}
]
}
],
"priceType": "Usage"
},
"productCharacteristic": [
{
"name": "db_type",
"value": "hamysql"
},
{
"name": "product_category",
"value": "UPTIME"
},
{
"name": "ram_in_mb",
"value": "98304 MB"
}
],
"link": {
"rel": "SELF",
"href": "https://staging.offer.api.rackspacecloud.com/v2/offerings/fd2c2294-0498-3791-9df7-1d4ed883a939/products/0a1239ca-19ae-39e7-a7a3-887dfcc8ea85"
},
"id": "0a1239ca-19ae-39e7-a7a3-887dfcc8ea85",
"status": "ACTIVE",
"productCode": "UPTIME_hamysql_98304MB",
"salesChannel": "PUBLIC"
}
],
"link": [
{
"rel": "NEXT",
"href": "https://staging.offer.api.rackspacecloud.com/v2/offerings/fd2c2294-0498-3791-9df7-1d4ed883a939/products?marker=1&limit=1"
}
]
}
}Response codes
This operation can have the following response codes.
| Code | Name | Description |
|---|---|---|
| 200 | Success | The request succeeded. |
| 400 | Error | A general error has occurred. |
| 404 | Not Found | The requested resource is not found. |
| 405 | Method Not Allowed | The method received in the request line is known by the origin server but is not supported by the target resource. |
| 406 | Not Acceptable | The value in the Accept header is not supported. |
| 500 | API Fault | The server encountered an unexpected condition that prevented it from fulfilling the request. |