Note: Please go to docs.rightscale.com to access the current RightScale documentation set. Also, feel free to Chat with us!
Home > Guides > RightScale API 1.5 > Examples > Users > List Users

List Users

List users available to the account the user is logged into.

Table of Contents

Curl

Example Call

Prerequisite:  Example assumes you have previously authenticated, and your valid session cookie is in 'mycookie'.  Requires 'admin' role.

curl -i -H X_API_VERSION:1.5 -b mycookie -X GET https://my.rightscale.com/api/users.xml

Sample Output

Note:  Truncated XML output without headers included (to save space).

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <last_name>lastname_520081487</last_name>
    <links>
      <link href="/api/users/726395087" rel="self"/>
    </links>
    <first_name>firstname_622638519</first_name>
    <created_at>2012/10/04 19:25:26 +0000</created_at>
    <email>myemail_3000676324@rightscale.com</email>
    <company></company>
    <updated_at>2012/10/04 19:25:26 +0000</updated_at>
    <actions></actions>
    <phone></phone>
  </user>
  <user>
    <last_name>lastname_520081487</last_name>
    <links>
      <link href="/api/users/726395087" rel="self"/>
    </links>
    <first_name>firstname_622638519</first_name>
    <created_at>2012/10/04 19:25:26 +0000</created_at>
    <email>myemail_3000676324@rightscale.com</email>
    <company></company>
    <updated_at>2012/10/04 19:25:26 +0000</updated_at>
    <actions></actions>
    <phone></phone>
  </user>
</users>

Note: Without 'admin' role you will receive an "HTTP 403 Forbidden" and "Permission Denied" message.

Supplemental

You can apply a fliter when listing users to help narrow your search. You can filter by first name, last name, or email.

curl -i -H X_API_VERSION:1.5 -b mycookie -X GET https://my.rightscale.com/api/users.xml -d filter[]="email==john.doe@example.com"
You must to post a comment.
Last modified
23:18, 16 May 2013

Tags

Classifications

This page has no classifications.

Announcements

None


© 2006-2014 RightScale, Inc. All rights reserved.
RightScale is a registered trademark of RightScale, Inc. All other products and services may be trademarks or servicemarks of their respective owners.