Community articleRetrieving a file share
Added by IBM contributorIBM on March 25, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Retrieve an Atom document representation of a file share programmatically.



Retrieve an Atom document representation of a file share programmatically.

This method returns the Atom document of a file share. If you want to retrieve a feed, see Getting a feed of file shares.

See Authenticating requests for information about how to authenticate the request.

Note: {share-id} is the value of the <td:uuid> element in the share's Atom entry document.

You can use one or more of these headers with the request.

Input

None.

Output

An Atom entry document for the file share.

Input
Method URI Description
GET /files/basic/anonymous/api/share/{share-id}/entry Returns a file share Atom document without authenticating the request.
GET /files/basic/api/share/{share-id}/entry Returns a file share Atom document. This request requires authentication.
Name Type Optional Description
share-id
string No {share-id} is the value of the <td:uuid> element in the share's Atom entry document.
Name Type Optional Description
If-Modified-Since
string Yes Used to validate the local cache of the feed and entry documents retrieved previously. If the feed or entry has not been modified since the specified date, HTTP response code 304 (Not Modified) is returned.
If-None-Match
string Yes Contains an ETag response header sent by the server in a previous request to the same URL. If the ETag is still valid for the specified resource, HTTP response code 304 (Not Modified) is returned.
Output
Content Type: application/atom+xml
Code Description
200
OK. Indicates that the file share entry was successfully found and returned. If an error occurs, this header will contain one of the error codes below.
401
Unauthorized.
404
Not Found.
References