Skip to content
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

Merged
merged 3 commits into from
Jan 16, 2017
Merged

[api] API v2.3.0 Documentation #176

merged 3 commits into from
Jan 16, 2017

Conversation

abellotti
Copy link
Member

  • 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

@abellotti
Copy link
Member Author

@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

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": {

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?

Copy link
Member Author

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

Copy link
Contributor

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"
"

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 }?

@abellotti
Copy link
Member Author

Thanks @imtayadeway updated as per your comments and pushed updated PR.

@imtayadeway
Copy link

@abellotti content looks good. Great effort! I avoided looking at English as @mfeifer is better qualified to do that 👍

@abellotti
Copy link
Member Author

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:
Copy link
Contributor

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:

Copy link
Contributor

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".

@abellotti
Copy link
Member Author

Thanks @mfeifer for the review, I've updated and re-pushed the PR.

@mfeifer
Copy link
Contributor

mfeifer commented Jan 5, 2017

LGTM

@abellotti
Copy link
Member Author

@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
@abellotti
Copy link
Member Author

ping @adahms

@adahms adahms merged commit b120cd1 into ManageIQ:master Jan 16, 2017
@adahms
Copy link
Contributor

adahms commented Jan 16, 2017

@abellotti

Looks good to me; merging!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants