Detailed Permissions Matrix for Rackspace Monitoring

  • Last updated on: 2016-01-22
  • Authored by: Megan Meza

The following permissions matrix displays specific permissions for the roles in Rackspace Monitoring. The matrix displays the method names, their corresponding RESTful API commands, and the roles that are supported.

Rackspace Monitoring Developer Guide

Related Knowledge Center Articles

Rackspace Monitoring Terminology

**As of October 8, 2013 **

Method Name API Call Role Description
Account Operations      
Get Account GET /v1.0/account Observer & Creator & Admin Returns account information.
Update Account PUT /v1.0/account Admin Updates properties on an account.
List Audits GET /v1.0/audits Observer & Creator & Admin Lists audits for this account.
Get Limits GET /v1.0/limits Observer & Creator & Admin Returns account resource limits.
Get Usage GET /v1.0/usage Observer & Creator & Admin Retrieves usage information for a given period of time. Defaults to last seven days.
Agents Operations      
List Agents GET /v1.0/agents Observer & Creator & Admin Lists all agents that have connected in the last 30 days.
Fetch Agents GET /v1.0/agents/:agentId Observer & Creator & Admin Lists a single agent.
List Agent Connections GET /v1.0/agents/:agentId/connections Observer & Creator & Admin Lists the connections for a single agent.
Fetch Agent Connection GET /v1.0/agents/:agentId/connections/:connId Observer & Creator & Admin Gets details for a specified image member.
Agent Host Information Operations      
GET Agent CPU Information GET /v1.0/agents/:agentId/host_info/cpus Observer & Creator & Admin Gets information on the host’s CPUs.
GET Agent Memory Information GET /v1.0/agents/:agentId/host_info/memory Observer & Creator & Admin Gets information on the host’s memory.
GET Agent Disk Information GET /v1.0/agents/:agentId/host_info/disks Observer & Creator & Admin Gets information on the host’s disks.
GET Agent Network Information GET /v1.0/agents/:agentId/host_info/network_interfaces Observer & Creator & Admin Gets information on the host’s network interfaces.
GET Agent Filesystem Information GET /v1.0/agents/:agentId/host_info/filesystems Observer & Creator & Admin Gets information on the host’s filesystems.
GET Agent Process Information GET /v1.0/agents/:agentId/host_info/processes Observer & Creator & Admin Gets information on the host’s processes.
GET Agent System Information GET /v1.0/agents/:agentId/host_info/system Observer & Creator & Admin Gets system information for the host.
Get Logged-in User Information GET /v1.0/agents/:agentId/host_info/who Observer & Creator & Admin Gets information on users who are logged into the host.
Get Agent CPU Information by Entity GET /v1.0/entities/:entityId/agent/host_info/cpus Observer & Creator & Admin Gets agent CPU information by entity.
Get Agent Memory Information by Entity GET /v1.0/entities/:entityId/agent/host_info/memory Observer & Creator & Admin Gets agent memory information by entity.
Get Agent Disk Information by Entity GET /v1.0/entities/:entityId/agent/host_info/disks Observer & Creator & Admin Gets agent disk information by entity.
Get Agent Filesystem Information by Entity GET /v1.0/entities/:entityId/agent/host_info/filesystem Observer & Creator & Admin Gets agent filesystem information by entity.
Get Agent network_interfaces Information by Entity GET /v1.0/entities/:entityId/agent/host_info/network Observer & Creator & Admin Gets agent network information by entity.
Get Agent Process Information by Entity GET /v1.0/entities/:entityId/agent/host_info/process Observer & Creator & Admin Gets agent process information by entity.
Get Agent System Information by Entity GET /v1.0/entities/:entityId/agent/host_info/system Observer & Creator & Admin Gets agent system information by entity.
Agent Targets Operations      
List Agent Check Targets 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.
Agent Tokens Operations      
List Agent Tokens GET /v1.0/agent_tokens Admin Lists the agent tokens.
GET Agent Token GET /v1.0/agent_tokens/:tokendId Observer & Creator & Admin Gets information for a single agent token.
Update Agent Token PUT /v1.0/agent_tokens/:tokendId Admin Updates a token with the specified tokenId (label).
Delete Agent Token DELETE /v1.0/agent_tokens/:tokendId 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.
Monitoring Zones Operations      
List Monitoring Zones GET /v1.0/monitoring_zones Observer & Creator & Admin Lists the monitoring zones.
Get Monitoring Zone GET /v1.0/monitoring_zones/:monitoringZoneId Observer & Creator & Admin Gets information for a single monitoring zone.
Execute Traceroute POST /v1.0/monitoring_zones/:monitoringZoneId/traceroute Observer & Creator & Admin Performs a traceroute from a collector in the specified monitoring zones.
Changelog Operations      
List Alarm Changelogs GET /v1.0/changelogs/alarms Observer & Creator & Admin Lists alarm changelogs for this account.
Entities Operations      
List Entities GET /v1.0/entities Observer & Creator & Admin Lists the entities for this particular account.
Get Entity GET /v1.0/entities/:entityId Observer & Creator & Admin Retrieves the current state of an entity.
Update Entity PUT /v1.0/entities/:entityId Admin only Updates an entity specified by the entityId.
Delete Entity DELETE /v1.0/entities/:entityId Admin only Deletes an entity from your account. Also deletes any checks and alarms defined for that entity.
Create Entity POST /v1.0/entities Creator & Admin Creates a new entity.
Checks Operations      
List Checks GET /v1.0/entities/:entityId/checks Creator & Admin Lists the checks associated with a given entityId.
Get Check GET /v1.0/entities/:entityId/checks/:checkId Creator & Admin Returns the specified check.
Update Check PUT /v1.0/entities/:entityId/checks/:checkId Admin only Updates a check with the specified checkId.
Delete Check DELETE /v1.0/entities/:entityId/checks/:checkId Admin only Deletes a check from your account.
Create Check POST /v1.0/entities/:entityId/checks Creator & Admin Creates a new check and associates it with an entity using the parameters listed in Attributes.
Test Existing Check POST /v1.0/entities/:entityId/checks/:checkId/test Observer & Creator & Admin Tests a check inline.
Test New Check POST /v1.0/entities/:entityId/test-check Observer & Creator & Admin Tests a check before creating it.
Alarms Operations      
List Alarms GET /v1.0/entities/:entityId/alarms Observer & Creator & Admin Lists the alarms on the specified entity.
Get Alarm GET /v1.0/entities/:entityId/alarms/:alarmId Observer $ Creator & Admin Gets information for a single alarm.
Update Alarm PUT /v1.0/entities/:entityId/alarms/:alarmId Admin only 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 DELETE /v1.0/entities/:entityId/alarms/:alarmId Admin only Deletes an alarm from your account.
Create Alarm POST /v1.0/entities/:entityId/alarms Creator & Admin Creates a new alarm for the specified entity. Specify the alarm’s characteristics using a valid set of parameters from the table shown in the Attributes section.
Test New Alarm POST /v1.0/entities/:entityId/test-alarm Observer & Creator & Admin Test runs an alarm.
Alarm Notification History Operations      
List Check IDs for Alarms GET /v1.0/entities/:entityId/alarms/:alarmId/notification_history Observer & Creator & Admin List checks for which alarm notification history is available.
List Alarm Notification History GET /v1.0/entities/:entityId/alarms/:alarmId/notification_history/:checkId Observer & Creator & Admin Lists alarm notification history for a given entity, alarm and check.
Get Alarm Notification History GET /v1.0/entities/:entityId/alarms/:alarmId/notification_history/:checkId/:uuid Observer & Creator & Admin Retrieves a single alarm notification history item.
Check Types Operations      
List Check Types GET /v1.0/check_types Observer & Creator & Admin List all the available check types.
Get Check Type GET /v1.0/check_types/:checkTypeId Observer & Creator & Admin Retrieves information for a single check type.
Notification Types Operations      
List Notification Types GET /v1.0/notification_types Observer & Creator & Admin List all the available notification types.
Notification Operations      
Get Notification Type GET /v1.0/notification_types/:notificationTypeId Observer $ Creator & Admin Gets information for a single notification type.
List Notifications GET /v1.0/notifications Observer $ Creator & Admin Lists the notifications for this particular account.
Get Notification GET /v1.0/notifications/:notificationId Observer $ Creator & Admin Gets information for a single notification.
Update Notification PUT /v1.0/notifications/:notificationId Admin only Updates a notification with the specified notificationId.
Delete Notification DELETE /v1.0/notifications/:notificationId Admin only Deletes a notification from your account.
Create Notification POST /v1.0/notifications Creator & Admin Creates a notification.
Test Existing Notification POST /v1.0/notifications/:notificationId/test Observer & Creator & Admin Tests an existing notification.
Test New Notification POST /v1.0/test-notification Observer & Creator & Admin Test runs a notification.
Notification Plans Operations      
List Notification Plans GET /v1.0/notification_plans Observer & Creator & Admin Lists the alarms on the specified entity.
Get Notification Plan GET /v1.0/notification_plans/:notificationPlanId Observer $ Creator & Admin Gets information for a single notification plan.
Update Notification Plans PUT /v1.0/notification_plans/:notificationPlanId Admin only Updates a notification plan with the specified notificationPlanId. Partial updates to a notification plan are acceptable. You may specify only the parameters you would like to update.
Delete Notification Plan DELETE /v1.0/notification_plans/:notificationPlanId Admin only Deletes a notification plan.
Create Notification Plan POST /v1.0/notification_plans Creator & Admin Creates a notification plan.
Metrics Operations      
List Metrics GET /v1.0/entities/entityId/checks/checkId/metrics Observer & Creator & Admin Lists the metrics associated with the specified check.
Get Data Points for Plot GET /v1.0/entities/:entityId/checks/:checkId/metrics/:metricName/plot Observer $ Creator & Admin Queries for all data points of metricName between two points in time.
Alarm Examples Operations      
List Alarm Examples GET /v1.0/alarm_examples Observer & Creator & Admin Returns a list of alarm examples.
Get Alarm Example GET /v1.0/alarm_examples/:alarmExampleId Observer $ Creator & Admin Gets a specific alarm example.
Bind Alarm Example POST /v1.0/alarm_examples/:alarmExampleId Observer & Creator & Admin Evaluates a specific alarm example.
VIEWS Operations      
List Overview GET /v1.0/views/Overview Observer & Creator & Admin Returns the overview view for this account.
Suppressions Operations      
List Suppressions GET /v1.0/suppressions Observer & Creator & Admin Returns a list of suppressions.
Get Suppression GET /v1.0/suppresssions/:suppressionId Observer $ Creator & Admin Gets details for a specific suppression.
Update Suppression PUT /v1.0/suppressions/:suppressionId Admin only Updates a specific suppression.
Delete Suppression DELETE /v1.0/suppressions/:suppressionId Admin only Deletes a specific suppression.
Create Suppression POST /v1.0/suppressions Admin only Creates a suppression.

Cloud Monitoring Terminology

Agent

A monitoring daemon that resides on the server being monitored. The agent gathers metrics based on agent checks and pushes them to Cloud Monitoring.

Agent Token

An authentication token used to identify the agent when it communicates with Cloud Monitoring.

Alarm

An alarm contains a set of rules that determine when a notification is triggered.

Check

Checks explicitly specify how you want to monitor an entity.

Entity

An entity is a resource that you want to monitor. Some examples are a server, a website, or a service.

Notification

A notification is an informational message sent to one or more addresses when an alarm is triggered.

RESTful

A type of web service API that uses Representational State Transfer. REST is the architectural style for hypermedia systems used for the World Wide Web.

Permission Matrices for RBAC

Continue the conversation in the Rackspace Community.