[
https://issues.apache.org/jira/browse/BROOKLYN-460?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15956592#comment-15956592
]
ASF GitHub Bot commented on BROOKLYN-460:
-----------------------------------------
Github user aledsage commented on a diff in the pull request:
https://github.com/apache/brooklyn-server/pull/612#discussion_r109868616
--- Diff:
rest/rest-api/src/main/java/org/apache/brooklyn/rest/api/EntityApi.java ---
@@ -141,7 +141,7 @@ public Response getIcon(
@GET
@Path("/{entity}/tags")
- @ApiOperation(value = "Fetch list of tags on this entity")
+ @ApiOperation(value = "Fetch list of tags on this entity. For
retrieving brooklyn.tags filter only elements such that: an element is a map
AND an element has kind: camp_brooklyn_tags.")
--- End diff --
Not sure we want to include this in the rest call's description. It's very
technical, and doesn't tell people how to use the information (e.g. "filter" is
not something that the rest api supports, it has to be done by the user after
receiving the entire response).
I think this would be better to just include in the docs, with a more
complete example of how to do it.
> Brooklyn Camp syntax for adding tags to an entity spec
> ------------------------------------------------------
>
> Key: BROOKLYN-460
> URL: https://issues.apache.org/jira/browse/BROOKLYN-460
> Project: Brooklyn
> Issue Type: New Feature
> Reporter: Valentin Aitken
> Priority: Minor
>
> Current requirement is to be able to supply String tags in an entity spec in
> YAML so it can be then retrieved via REST API with {{GET
> /v1/applications/<appId>/entities/<entityId>/tags}}.
> Example usage in a YAML blueprint:
> {noformat}
> services:
> - type: org.apache.brooklyn.entity.software.base.VanillaSoftwareProcess
> brooklyn.tags:
> - tag1
> - tag2
> {noformat}
> Please shout if you have further requirements for {{brooklyn.tags}}.
--
This message was sent by Atlassian JIRA
(v6.3.15#6346)
