Silverlight Streaming HTTP Operations

  • Article

THIS TOPIC IS BEING DEPRECATED, AND MUST BE REMOVED FROM THE TOC.

The Silverlight Streaming REST API supports the following standard HTTP operations:

HTTP request URLs use the following format:

serviceRoot/accountId/fileSetName/fileName?query

Where:

  • serviceRoot is the root of the REST service, currently https://silverlight.services.live.com.
  • accountId is your account name, as described above. Remember, this is your Silverlight Streaming account name, not your Windows Live ID.
  • fileSetName is a name you choose for a set of related files that form an application or a media resource. It must be unique and should only contain letters or numbers and be no longer than 128 characters. This is not present for all requests.
  • fileName is a name for a single file within the file set. The file name may contain further slashes, i.e. hierarchy is allowed within the file set. This is not present for all requests.
  • query contains optional query parameters that modify some requests.

PUT, POST Request

Add a file set to the account. The body of the post must be a ZIP file, mime type "application/zip". It must contain a top-level file named "manifest.xml" If a file set with the same file set name already exists, the operation will fail. In this case a DELETE operation should be performed prior to the PUT or POST.

Note

Because incremental updates are not currently supported, PUT and POST do essentially the same thing.

URL format
serviceRoot/accountId/fileSetName

DELETE Request

Deletes a file set from the account.

URL format
serviceRoot/accountId/fileSetName

GET Request

Retrieves the information specified by the URL. The following variations are supported.

URL format
serviceRoot/accountId/fileSetName/fileName

Retrieve a single file from a file set. There is currently no support for downloading the file set as an archive.

URL format
serviceRoot/accountId?max-items=number&after=fileSetName

Retrieve a list of file sets contained in the account. If max-items= is present, it limits the number of returned file sets. If after= is present, the list begins with the first set name greater than the given name. The list consists of an XML file in the form:

<fileSets>
    <fileSets name="fileset name" isApp="[true | false]"/>     ...
<fileSets>
URL format
serviceRoot/accountId/fileSetName

Retrieve a list of files contained in the file set. The list consists of an XML file in the form:

<fileSet>
    <file name="file name" size="length in bytes" mimeType="file mime type attribute" />
    ...
</fileSet>
URL format
serviceRoot/accountId/fileSetName/fileName

Retrieve a stream that contains the specified file. The form that is returned depends on the original file format. Text-based files can be parsed as a standard HTTP response.