Prototype: getbundlemetatags(bundlename, optional_tag)

Return type: slist

Description: Returns the list of meta tags for bundle bundlename.

Arguments:

  • bundlename: string - Variable identifier - in the range: [a-zA-Z0-9_$(){}\[\].:]+

The optional_tag can be used to look up a specific tag's value. If you have cf3 bundle agent example { meta: "tags" slist => { "mykey=myvalue1", "mykey=myvalue2", "yourkey=yourvalue1" }; } then getbundlemetatags( "example", "mykey" ) will return a list with two entries, { "myvalue1", "myvalue2" }.

Example:

code
body common control
{
      bundlesequence => { "example" };
}

bundle agent example
{
  meta:
      "tags" slist => { "autorun", "myOtherTag", "contact=Some Person <some.person@northern.tech>"};

  vars:
      "bundle_tags" slist => getbundlemetatags("default:example");
      "contact_tag" slist => getbundlemetatags("default:example", "contact");

  reports:
      "Found tags: $(bundle_tags)"; 
      "Contact tag: $(contact_tag)";
}

Output:

code
R: Found tags: autorun
R: Found tags: myOtherTag
R: Found tags: contact=Some Person <some.person@northern.tech>
R: Contact tag: Some Person <some.person@northern.tech>

Notes:

See also: getvariablemetatags(), getclassmetatags()

History:

  • Function added in 3.26.0.