Rackspace API/Cloud Images - Revision history

Christoph at 17:29, 19 September 2019

2019-09-19T17:29:32Z

Christoph at 08:32, 15 December 2014

2014-12-15T08:32:59Z

Christoph at 07:53, 15 December 2014

2014-12-15T07:53:42Z

Christoph: New page: ==HOWTO: share images between Rackspace Cloud accounts== ===Export environment variables=== These are the shell variables we will use in all the subsequent steps (i.e., in our API calls):...

2014-12-10T13:36:52Z

New page: ==HOWTO: share images between Rackspace Cloud accounts== ===Export environment variables=== These are the shell variables we will use in all the subsequent steps (i.e., in our API calls):...

New page

==HOWTO: share images between Rackspace Cloud accounts==

===Export environment variables===
These are the shell variables we will use in all the subsequent steps (i.e., in our API calls):
$ TOKEN_PRODUCER=<Token_of_Producer>
$ TOKEN_CONSUMER=<Token_of_Consumer>
$ ACCOUNT_PRODUCER=000001
$ ACCOUNT_CONSUMER=000002
$ REGION=dfw
$ ENDPOINT_SERVERS_PRODUCER=<nowiki>https://${REGION}.servers.api.rackspacecloud.com/v2/${ACCOUNT_PRODUCER}</nowiki>
$ ENDPOINT_SERVERS_CONSUMER=<nowiki>https://${REGION}.servers.api.rackspacecloud.com/v2/${ACCOUNT_CONSUMER}</nowiki>
$ ENDPOINT_IMAGES_PRODUCER=<nowiki>https://${REGION}.images.api.rackspacecloud.com/v2/${ACCOUNT_PRODUCER}</nowiki>
$ ENDPOINT_IMAGES_CONSUMER=<nowiki>https://${REGION}.images.api.rackspacecloud.com/v2/${ACCOUNT_CONSUMER}</nowiki>

$ IMAGE_NAME_PRODUCER="my-saved-image-name"

===Gather information on image to be shared===
* Get basic information on Producer's saved image (i.e., "my-saved-image-name"):

$ curl -H "X-Auth-Token: $TOKEN_PRODUCER" -H "Content-Type: application/json" \
"${ENDPOINT_SERVERS_PRODUCER}/images?type=SNAPSHOT&name=${IMAGE_NAME_PRODUCER}" |\
python -mjson.tool
$ IMAGE_ID_PRODUCER=fffff # From "id" in above output

* Get detailed information on Producer's saved image:

$ curl -s -H "X-Auth-Token: $TOKEN_PRODUCER" -H "Content-Type: application/json" \
"${ENDPOINT_SERVERS_PRODUCER}/images/${IMAGE_ID_PRODUCER}" |\
python -mjson.tool

* Get all metadata associated with Producer's saved image:

$ curl -s -H "X-Auth-Token: $TOKEN_PRODUCER" -H "Content-Type: application/json" \
"${ENDPOINT_IMAGES_PRODUCER}/images/${IMAGE_ID_PRODUCER}" |\
python -mjson.tool

* Get the members (aka "tenant_id"/account number) associated with Producer's saved image (if the image has never been shared, the "members" value will be empty):

$ curl -s -H "X-Auth-Token: $TOKEN_PRODUCER" -H "Content-Type: application/json" \
"${ENDPOINT_IMAGES_PRODUCER}/images/${IMAGE_ID_PRODUCER}/members" |\
python -mjson.tool
{
"members": [],
"schema": "/v2/schemas/members"
}

===Share the image in question===
$ curl -sXPOST -H "Content-Type: application/json" \
-H "X-Auth-Token: $TOKEN_PRODUCER" \
"${ENDPOINT_IMAGES_PRODUCER}/images/${IMAGE_ID_PRODUCER}/members" \
-d "{\"member\":\"$ACCOUNT_CONSUMER\"}" |\
python -mjson.tool

The image has now been shared to the consumer. However, the status of the share will be in "pending", as the API is waiting on the consumer to accept the shared image.

==See also==
* [[Rackspace API]]

[[Category:Rackspace]]

← Older revision		Revision as of 17:29, 19 September 2019
Line 1:		Line 1:
		+	<div style="margin: 10px; padding: 5px; border: 2px solid red; text-align: center">'''NOTE:''' This article was written in 2014 and is no longer maintained.</div>
		+
	==HOWTO: share images between Rackspace Cloud accounts==		==HOWTO: share images between Rackspace Cloud accounts==

← Older revision		Revision as of 08:32, 15 December 2014
Line 1:		Line 1:
	==HOWTO: share images between Rackspace Cloud accounts==		==HOWTO: share images between Rackspace Cloud accounts==
		+
		+	In this section, I will show you how to share a [http://www.rackspace.com/cloud/images Cloud Image] from one Rackspace account to another. The account doing the sharing will be called the "Producer" and the account receiving the share will be called the "Consumer". Note that the image being shared by the Producer can only be used by the Consumer to build Cloud Servers in the same region/data centre as the Producer's image was created in (e.g., DFW, ORD, SYD, etc.).

	===Export environment variables===		===Export environment variables===

@@ Line 15: / Line 15: @@
   $ IMAGE_NAME_PRODUCER="my-saved-image-name"
-===Gather information on image to be shared===
+===Producer: Gather information on image to be shared===
 * Get basic information on Producer's saved image (i.e., "my-saved-image-name"):
@@ Line 45: / Line 45: @@
+  }
-===Share the image in question===
+===Producer: Share the image in question===
   $ curl -sXPOST -H "Content-Type: application/json" \
          -H "X-Auth-Token: $TOKEN_PRODUCER" \
@@ Line 54: / Line 54: @@
 The image has now been shared to the consumer. However, the status of the share will be in "pending", as the API is waiting on the consumer to accept the shared image.
 ==See also==
 * [[Rackspace API]]
 [[Category:Rackspace]]