(#22643) Document the file_metadata endpoint.

This patch documents the file_metadata endpoint (a find operation)
and the file_metadatas endpoint (a search operation).  It includes a
json schema for the returned file_metadata object, and spec tests
for validating some variants of file metadata against that schema.