1. Operations
  2. content
  3. library

content library: find

Returns a list of all the visible (as determined by authorization policy) libraries matching the requested content.library.find_spec.

Request:

HTTP request

POST https://{server}/rest/com/vmware/content/library?~action=find

Request Body Structure:

{
    "spec": {
        "name": "string",
        "type": "LOCAL"
    }
}
<?xml version="1.0" ?>
<ns0:Find-Input xmlns:ns0="http://vmware.com/content/library" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <spec>
    <name>string</name>
    <type>LOCAL</type>
  </spec>
</ns0:Find-Input>

Request Body Parameters:

Name Type Description
bold = required
spec find_spec Specification describing what properties to filter on.
spec.name string Name of the library to search. The name is case-insensitive. See content.library_model.name.

Optional. If not specified any name will be searched.
spec.type string Library type to search. See content.library_model.type.

Optional. If not specified any library type will be searched.

Response:

HTTP Status Code: 200

Representations:

{
    "value": [
        "obj-103",
        "obj-103"
    ]
}
<?xml version="1.0" ?>
<ns0:Find-Result xmlns:ns0="http://vmware.com/content/library" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <value-array>
    <array-item>obj-103</array-item>
    <array-item>obj-103</array-item>
  </value-array>
</ns0:Find-Result>

Response Type:

Name Type Description
bold = required
value string[] The array of identifiers of all the visible libraries matching the given spec.

Errors:

HTTP Status Code Type Description
400 invalid_argument if no properties are specified in the spec.