YARN-2678: upgrade "use a URI in the api" from a SHOULD to a MUST; fix examples and tests accordingly