orchestration api tests, docstring cleanups

Cosmetic cleanups to some minor spelling and phrasing/format issues

Change-Id: I3fef164bf7fb623734dd8dca1509d20b9865a0ad
orchestration add resource limit API test

Add test_limits check that heat rejects stacks with more than
the allowed maximum number of resources

Change-Id: I84eaf11b88f36b79221a99b87c5beb98f121c6e4
Disable other suspend/resume tests if not supported

Change I6ec48d29 introduced compute-feature-enabled.suspend to disable
suspend/resume tests if the backing nova virt driver doesn't support
those APIs, but missed quite a few tests.

Partial-Bug: #1296858

Change-Id: I8258d5b67a93e8bb728b4221ebe03bc9eceb441e
Move suspend_available class variable into skip decorators

We shouldn't do a getattr on CONF in the class definition. It will cause
import errors if there isn't a config file. Just use
CONF.compute_feature_enabled.suspend in the skip decorator.

Change-Id: Ic3dc344affe6fd7d2fa102b5af53e36e79098263
Move pause_available class variable into skip decorators

We shouldn't do a getattr on CONF in the class definition. It will cause
import errors if there isn't a config file. Just use
CONF.compute_feature_enabled.pause in the skip decorator.

Change-Id: If24c45eba0ee466a00589806b27c736c0e8dba54
Move resize_available class variable into skip decorators

We shouldn't do a getattr on CONF in the class definition. It will cause
import errors if there isn't a config file. Just use
CONF.compute_feature_enabled.resize in the skip decorator.

Change-Id: I6361ceb45b1e2796e00bb94279b5437c8902294d
Merge "orchestration api tests, docstring cleanups"
Merge "Disable other suspend/resume tests if not supported"
Merge "Move suspend_available class variable into skip decorators"
Merge "Move pause_available class variable into skip decorators"
Merge "Move resize_available class variable into skip decorators"
Merge "orchestration add resource limit API test"