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

400

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