Introduced : BIG-IP_v12.0.0
Adds the metadata for the specified pools. User metadata, also metadata for short, is mainly a name/value pair that is associated with a metadata capable config (MCC) object. Some examples of MCC objects are ltm pool and virtual server. The combination of the MCC object name and the metadata name uniquely identify an instance of the metadata. One MCC object may have multiple instances of metadata associated with it. In addition to name/value pair, metadata also has a persistence attribute. See Common::MetadataPersistence for more information.


    in GlobalLB__PoolID [] pools,
    in String [] [] names,
    in String [] [] values


Parameter Type Description
pools PoolID [] The list of pools with which the metadata are to be associated.
names String [] [] Names of the metadata associated with the pool.
values String [] [] Values of the metadata associated with the pool.

Return Type

Type Description


Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if one of the arguments is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also


The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.