org.jclouds.vcloud.director.v1_5.features
Interface MediaApi

public interface MediaApi

Provides synchronous access to Media.

Author:

danikov, Adrian Cole

See Also:

MediaAsyncApi

Method Summary

Media	add(URI uploadHref, Media media) Creates a media (and present upload link for the floppy/iso file).
Media	clone(String mediaUrn, CloneMediaParams params) Clones a media into new one.
Media	clone(URI mediaHref, CloneMediaParams params)
Task	edit(String mediaUrn, Media media) Updates the name/description of a media.
Task	edit(URI mediaHref, Media media)
Media	get(String mediaUrn) Retrieves a media.
Media	get(URI mediaHref)
Owner	getOwner(String mediaUrn) Retrieves an owner.
Owner	getOwner(URI mediaHref)
Task	remove(String mediaUrn) Deletes a media.
Task	remove(URI mediaHref)

Method Detail

get

Media get(String mediaUrn)

Retrieves a media.

Returns:

the media or null if not found

get

Media get(URI mediaHref)

add

Media add(URI uploadHref,
          Media media)

Creates a media (and present upload link for the floppy/iso file).

Returns:

The response will return a link to transfer site to be able to continue with uploading the media.

clone

Media clone(String mediaUrn,
            CloneMediaParams params)

Clones a media into new one. The status of the returned media is UNRESOLVED(0) until the task for cloning finish.

Returns:

a Media resource which will contain a task. The user should monitor the contained task status in order to check when it is completed.

clone

Media clone(URI mediaHref,
            CloneMediaParams params)

edit

Task edit(String mediaUrn,
          Media media)

Updates the name/description of a media.

Returns:

a task. This operation is asynchronous and the user should monitor the returned task status in order to check when it is completed.

edit

Task edit(URI mediaHref,
          Media media)

remove

Task remove(String mediaUrn)

Deletes a media.

remove

Task remove(URI mediaHref)

getOwner

Owner getOwner(String mediaUrn)

Retrieves an owner.

Returns:

the owner or null if not found

getOwner

Owner getOwner(URI mediaHref)