Getting a Time Period

Request: http://<PPM_Server_IP>:<port>/itg/rest/tm/timePeriods/{id}

HTTP Method: GET

Description: Get a time period specified by the time period ID.

Request path variables:

Attribute Description Required
id The id of the time period Yes

Response entity body:

  • on success: Return an XML object of the time period with the following format:

    <ns2:period xmlns:ns2="http://www.hp.com/ppm/tm/">
       <id>30274</id>
       <preId>30273</preId>
       <nexId>30275</nexId>
       <sequence>275</sequence>
       <type>1</type>
       <startDate>1350230400000</startDate>
       <endDate>1350835199000</endDate>
    </ns2:period>
  • on failure: The following message codes are returned if the operation fails:

    Message Code

    HTTP Return Code

    Message

    Cause

    Possible Corrective Action

    PPM_WSE000

    500

    Internal Error

    There was an internal error when you executed the operation.

    N/A

    PPM_WSE001

    503

    Cannot Get Internal Server Connection.

    There was an error when you tried to connect to PPM Server.

    N/A

    PPM_WSE506

    400

    The input date or type is invalid, for the data supports the format yyyy-MM-ddTHH:mm:ssZ, and the type is defined as 1, 2, 3, or 4.

    The input date or type is incorrect.

    Input correct query parameters.