This API has a deprecated equivalent from v7.0U1.
Find Library
Returns a list of all the visible (as determined by authorization policy) libraries matching the requested Library.FindSpec. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
Request
URLURL
https://{api_host}/api/content/library?action=find
Header Parameters
Header Parameters
string
vmware-api-session-id
Required
Required session ID, acquired from Create Session API under CIS product
vmware-api-session-id example
"b00db39f948d13ea1e59b4d6fce56389"
Request Body
Request Body
LibraryFindSpec of mimetype application/json
Required
Specification describing what properties to filter on.
{
"name": "string",
"type": "LOCAL"
}
string
name
Optional
Name of the library to search. The name is case-insensitive. See LibraryModel.name. If not specified any name will be searched.
type
Optional
The LibraryModel.LibraryType enumerated type defines the type of a LibraryModel.
The type of a library can be used to determine which additional services can be performed with a library.
LOCAL : The library contents are defined and stored by the local Content Library Service installation.
A local library can be retrieved and managed via the LocalLibrary.
SUBSCRIBED : The library synchronizes its items and content from another published library.
A subscribed library can be retrieved and managed via the SubscribedLibrary.
Possible values are: LOCAL , SUBSCRIBED
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK returns
array of
string of type application/json
The list of identifiers of all the visible libraries matching the given spec. The result will contain identifiers for the resource type: com.vmware.content.Library.
Errors
Code SamplesCode Samples
PowerCLI Client SDK Example
$LibraryFindSpec = Initialize-LibraryFindSpec -Name "MyName" -Type "LOCAL"
Invoke-FindContentLibrary -LibraryFindSpec $LibraryFindSpec
cURL Command
curl -X POST -H "vmware-api-session-id: b00db39f948d13ea1e59b4d6fce56389" -H "Content-Type: application/json" -d '{"name":"string","type":"LOCAL"}' https://{api_host}/api/content/library?action=find
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-vmw-doc-deprecated-method: post
x-vmw-doc-deprecated-path: /rest/com/vmware/content/library?~action=find
x-vmw-doc-operation: find
Availability
Added in 7.0U2
