Integration Guides › BFC API Reference Guide › Tag URIs

Tag URIs

This section contains the following topics:

Retrieve Tags

You can retrieve information about the set of tags defined in this BFC. Information about both dumb and smart tags is returned. You can also retrieve a single tag.

Retrieve information about the set of tags defined in the BFC:

GET BFC/tags

Result

HTTP return code 200 and a payload that is a list of tag records on success. Returns an HTTP error code and the associated fault information on error.

Description

Retrieves information about the current set of tags in the system as a list of tag records

Example JSON Payload

In this example, the BFC has a single dumb tag named gold:

[{u’tag’:{u’comp_id’:1420,u’name’:u’gold’,u’state’:u’resource_running_state’,u’required’:false,u’is_system’:false,u’read_only’:false,u’hosts’:[],u’has_expression’:false,u’expression’:null}}]

In the following example, you retrieve a single tag:

BFC/tags/<tagname>

A single tag record is returned.

Retrieve a Count of Matching Servers

You can retrieve the count of available servers that match the input server selection criteria.

Payload: A server_selection record that optionally specifies a CA AppLogic version name and a user-specified server selection criteria expression in Conjunctive Normal Form (CNF). If an empty record (both fields set to JSON null) is supplied, then a count of all available servers returns. If just the CA AppLogic version name is supplied, then the system tags associated with that version are applied and the count of matching servers are returned. If just the user-specified criteria is specified then a count of servers matching just that criteria expression are returned. If both the CA AppLogic version name and a user-specified criteria are specified, then a count of servers that meet the both the system requirements of the CA AppLogic version and the user-specified criteria will be returned.
Result: HTTP return code 200 and a payload that is an integer count of matching servers on success. Returns an HTTP error code and the associated fault information on error.
Description: Use this operation to retrieve the count of servers matching the input server selection criteria.

Example POST

POST /BFC/admin/tags/operations/matchingServerCount