The Rackspace Monitoring permissions matrix displays specific permissions for the following role-based access control (RBAC) roles:
Admin provides full access to create, read, update, and delete.
Creator provides access to create, read, and update.
Observer provides read-only access.
The matrix displays the Rackspace Monitoring methods groups by category, their corresponding RESTful API commands, and the RBAC roles that are supported.
Account Operations
Method
API action
Role
Description
Get account information
GET /v1.0/account
Observer, Creator, Admin
Returns account information.
Update properties on an account
PUT /v1.0/account
Admin
Updates properties on an account.
Get audit information
GET /v1.0/audits
Observer, Creator, Admin
Returns audits information for the account.
Get limits
GET /v1.0/limits
Observer, Creator, Admin
Returns account resource limits.
Get usage
GET /v1.0/usage
Observer, Creator, Admin
Returns resource and rate limits for the account.
Agents Operations
Method
API action
Role
Description
List agents
GET /v1.0/agents
Observer, Creator, Admin
Lists all agents that have connected to the account in the last 30 days.
Get agent by ID
GET /v1.0/agents/{agentId}
Observer, Creator, Admin
Returns information about the specified agent.
List agent connections
GET /v1.0/agents/{agentId}/connections
Observer, Creator, Admin
Lists the connections that are active for the specified agent.
List agent connections
GET /v1.0/agents/{agentId}/connections/:connId
Observer, Creator, Admin
Returns information about the specific connection for the specified agent.
Agent host information operations
Method
API action
Role
Description
Get agent host info types
GET /v1.0/agents/{agentId}/host_info_types
Observer, Creator,Admin
Get information about the types of host information data supported by the agent.
Get information
GET /v1.0/agents/{agentId}/host_info/{type}
Observer, Creator, Admin
Gets the host information specified by {type}. For a complete list of agent host information, see agent host information check.
Agent Targets Operations
Method
API action
Role
Description
List agent check targets for {agentCheckType}
GET /entities/{entityId}/agent/check_types/{agentCheckType}/targets
Observer, Creator, Admin
Enumerates the devices allowed for the specified agent check type on the server where the agent is installed. For complete list of check types, see remote checks and agent checks.
Agent Tokens Operations
Method
API action
Role
Description
List agent tokens
GET /v1.0/agent_tokens
Admin
Lists the agent tokens.
Get agent token by ID
GET /v1.0/agent_tokens/{tokenId}
Observer, Creator, Admin
Gets information for a single agent token.
Update agent token
PUT /v1.0/agent_tokens/{tokenId}
Admin
Updates a token with the specified tokenId (label).
Delete agent token
DELETE /v1.0/agent_tokens/{tokenId}
Admin
Deletes the specified agent token from your account.
Create agent token
POST /v1.0/agent_tokens
Observer, Creator, Admin
Creates a new agent token.
Alarm Operations
Method
API action
Role
Description
List alarms
GET /v1.0/entities/{entityId}/alarms
Observer, Creator, Admin
Lists the alarms on the specified entity.
Get alarm by ID
GET /v1.0/entities/{entityId}/alarms/{alarmId}
Observer, Creator, Admin
Gets information about the specified single alarm.
Update alarm by ID
PUT /v1.0/entities/{entityId}/alarms/{alarmId}
Admin
Updates an alarm with the specified alarmId. Partial updates to an alarm are acceptable. You may specify only the parameters you would like to update.
Delete alarm by ID
DELETE /v1.0/entities/{entityId}/alarms/{alarmId}
Admin
Deletes the specified alarm from the account.
Create an alarm
POST /v1.0/entities/{entityId}/alarms
Creator, Admin
Creates a new alarm for the specified entity.
Test an alarm
POST /v1.0/entities/{entityId}/test-alarm
Observer, Creator, Admin
Tests whether the alarm criteria is valid and shows how the alarm state is evaluated.
Alarm Examples Operations
Method
API action
Role
Description
List alarm examples
GET /v1.0/alarm_examples
Observer, Creator, Admin
Returns a list of alarm examples.
Get alarm example by ID
GET /v1.0/alarm_examples/{alarmExampleId}
Observer, Creator, Admin
Returns information about the specified alarm example.
Evaluate alarm example
POST /v1.0/alarm_examples/{alarmExampleId}
Observer, Creator, Admin
Evaluates a specific alarm example.
Alarm Notification History Operations
Method
API action
Role
Description
List alarm notification history
GET /v1.0/entities/{entityId}/alarms/{alarmId}/notification_history
Observer, Creator, Admin
Lists alarm notification history for the specified alarm.
List alarm notification history by check ID
GET /v1.0/entities/{entityId}/alarms/{alarmId}/notification_history/{checkId}
Observer, Creator, Admin
Lists alarm notification history for the specified entity, alarm and check.
List a single alarm notification
GET /v1.0/entities/{entityId}/alarms/{alarmId}/notification_history/{checkId}/:uuid
Observer, Creator, Admin
Retrieves a single alarm notification history item.
Changelogs Operation
Method
API action
Role
Description
List alarm changelogs
GET /v1.0/changelogs/alarms
Observer, Creator, Admin
Lists alarm changelogs for the account.
Check Operations
Method
API action
Role
Description
List checks for an entity
GET /v1.0/entities/{entityId}/checks
Creator, Admin
Lists the checks associated with a given entityId.
