-
Notifications
You must be signed in to change notification settings - Fork 112
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[api] API v2.3.0 Documentation #176
Conversation
abellotti
commented
Nov 16, 2016
- Updated Versioning page to talk about v2.3.0 and its features
- /api/automate model queries
- /api/automate_domains queries and related actions
- OPTIONS on /api/:collection for fetching collection metadata
- Service Power operations
- Picture Creation via /api/pictures
- Deleting Service Dialogs
- Bulk Queries
- /api/notifications Support
- /api/blueprints Support and Tagging
- Provider custom attributes
- Entrypoint Details
- /api/arbitration_profiles CRUD
- /api/arbitration_rules CRUD
- /api/arbitration_settings CRUD
- /api/virtual_templates Queries
- Cloud Networks subcollection of Providers
- Service Creation
- /api/orchestration_templates CRUD
- Renamed/Removed Deprecated Attributes
- Approving/Denying service requests
- /api/requests Create/Edit/Approve/Deny
@imtayadeway @mfeifer please review content/english when you get a chance. /cc @Fryguy @gtanzillo |
The following is an example for the *groups* collection: | ||
|
||
---- | ||
OPTIONS /api/:collection |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should this be OPTIONS /api/groups
?
"users", | ||
"vms" | ||
], | ||
"data": { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we have an example of what data
is used for?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've added a Optional Metadata section in this page
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
👍
"EQUAL" : { | ||
"field" : "User-userid", | ||
"value" : "admin" | ||
" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm unfamiliar with this markup, but is this supposed to be }
?
Thanks @imtayadeway updated as per your comments and pushed updated PR. |
@abellotti content looks good. Great effort! I avoided looking at English as @mfeifer is better qualified to do that 👍 |
Thanks @imtayadeway @mfeifer when you get a chance for ye-old English. |
|======================================================================= | ||
|
||
Select other attributes can also be used as identifying attributes | ||
as shown in the following table: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do you mean "Some attributes can also be used....."?
---- | ||
|
||
Syntax for a filter is as follows: | ||
|
||
---- | ||
filter[]="attribute op value" | ||
filter[]=attribute op value | ||
---- | ||
|
||
By default, filters are logically anded together, for a logical or, prefix the attribute with "or" as follows: | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Might want to italicize, quote, or bold "anded" and "or".
Thanks @mfeifer for the review, I've updated and re-pushed the PR. |
LGTM |
@adahms Hi Andrew, we need this PR merged when you get a chance. Thanks!! /cc @mfeifer @imtayadeway |
- Updated Versioning page to talk about v2.3.0 and its features - /api/automate model queries - /api/automate_domains queries and related actions - OPTIONS on /api/:collection for fetching collection metadata - Service Power operations - Picture Creation via /api/pictures - Deleting Service Dialogs - Bulk Queries - /api/notifications Support - /api/blueprints Support and Tagging - Provider custom attributes - Entrypoint Details - /api/arbitration_profiles CRUD - /api/arbitration_rules CRUD - /api/arbitration_settings CRUD - /api/virtual_templates Queries - Cloud Networks subcollection of Providers - Service Creation - /api/orchestration_templates CRUD - Renamed/Removed Deprecated Attributes - Approving/Denying service requests - /api/requests Create/Edit/Approve/Deny
- JSON syntax fix - Options metadata details
- Incorrect wording in bulk query page - Italicized anded and or in filtering page
ping @adahms |
Looks good to me; merging! |