Query Publishing Point State

The Query Publishing Point State operation retrieves the state for a publishing point.

Restrictions

None. Publishing points can be in any state while performing this operation.

Publishing point state after successful operation

This operation does not change the publishing point state.

Request

The Query Publishing Point State request may be specified as follows:

Method

URI

GET

http(s)://<hostname>/<filepath>/state

URI Parameters

The following table lists URL template segments and parameters.

Parameter

Description

Example

hostname

The host name.

Contoso.com

filepath

The path of the publishing point file.

MyVideos/bunny.isml

Request Body

None.

Response

The response includes an HTTP status code and a response body.

Status Code

A successful operation returns status code 200 (OK). For more information about error status codes, see Service Management Status and Error Codes.

Response Body

The following example shows the format of the response body after the operation has finished. For information of element values and attribute values, see SmoothStreaming Schema Reference.

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom">
  <id>unique ID</id>
  <title>Title</title>
  <author>
    <name />
  </author>
  <updated>time-stamp</updated>
  <link href="http://host-name/.isml-file-path/state" rel="self" type="application/atom+xml" title="State" />
  <link href="http://host-name/.isml-file-path/settings" rel="related" type="application/atom+xml" title="Settings" />

  <content type="application/xml">
    <SmoothStreaming xmlns="http://schemas.microsoft.com/iis/media/2011/03/streaming/management">
      <State>
        <Value>state-value</Value>
      </State>
    </SmoothStreaming>
  </content>
</entry>

The following example shows a response body.

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="http://www.w3.org/2005/Atom">
  <id>http://contoso.com/test1.isml/state</id>
  <title>Bunny</title>
  <author>
    <name />
  </author>
  <updated>2011-06-13T22:08:57.044Z</updated>
  <link href="http://contoso.com/test1.isml/state" rel="self" type="application/atom+xml" title="State" />
  <link href="http://contoso.com/test1.isml/settings" rel="related" type="application/atom+xml" title="Settings" />
  <content type="application/xml">
    <SmoothStreaming xmlns="http://schemas.microsoft.com/iis/media/2011/03/streaming/management">
      <State>
        <Value>Idle</Value>
      </State>
    </SmoothStreaming>
  </content>
</entry>

Authorization

The authenticated user must have read access to the publishing point .isml file.