For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.
Retrieve Tag (GET)
Retrieves the specified tag in the application.
Roles
Users in the following roles are authorized to perform this operation:
- mfpadmin
- mfpdeployer
- mfpmonitor
- mfpoperator
Method
GET
Path
/management-apis/2.0/runtimes/runtime-name/notifications/applications/application-name/tags/tag-name
Example
https://www.example.com/mfpadmin/management-apis/2.0/runtimes/myruntime/notifications/applications/myapplication/tags/mytag
Path Parameters
- runtime-name
- The name of the runtime. This is the context root of the runtime web application, without the leading slash.
- application-name
- The name of the application.
- tag-name
- The name of the tag.
Produces
application/json, application/xml, text/xml
Response
Retrieves details of a specific tag of the application.
JSON Example
{ "createdMode" : "API", "createdTime" : "2016-03-19T06:34:42Z", "description" : "This is a Sample tag", "lastUpdatedTime" : "2016-03-22T06:34:42Z", "name" : "SampleTag", "productVersion" : "8.0", }
XML Example
<?xml version="1.0" encoding="UTF-8"?> <push-tag createdMode="API" createdTime="2016-03-19T06:34:42Z" description="This is a Sample tag" lastUpdatedTime="2016-03-22T06:34:42Z" name="SampleTag" productVersion="8.0"/>
Response Properties
The response has the following properties:
- createdMode
- How the tag was created. The possible values are UI or API.
- createdTime
- The time at which the tag was created.
- description
- The description of the tag.
- lastUpdatedTime
- The time at which the tag was last updated.
- name
- The name of the tag.
- productVersion
- The exact product version.
Errors
400The request was not understood by the push server.403
The user is not authorized to call this service.404
The corresponding runtime or application is not found or not running.500
An internal error occurred.
Parent topic: REST API for the MobileFirst Server administration service