GET /session

Operation:

GET /session

Description:

Retrieve a representation of the current session.

A Session object contains one or more URLs from which you can begin browsing, as well as links to the query service and entity resolver. The list of URLs in the Session object is based on the role and privileges of the authenticated user.

A Session object expires after a configurable interval of client inactivity. To change the length of this client inactivity timeout, a system administrator can change the value of SessionTimeoutMinutes in the system's GeneralSettings

Since:

1.5

Input parameters

Consume media type(s):

None

Input type:

None

Output parameters

The current session

Produce media type(s):

application/vnd.vmware.vcloud.session+xml

Output type:

SessionType

Examples

Request

HTTP 1.1
GET /api/session/

Headers:
x-vcloud-authorization: Xg+un2PmA/UnTwbl19Uw4D54Rwx+/lmoFwaKrVm2av8=

Body:

Response

HTTP/1.1 200 OK

Headers:
Content-Length: 1363
Content-Type: application/vnd.vmware.vcloud.session+xml;version=5.5
Vary: Accept-Encoding

Body:

<?xml version="1.0" encoding="UTF-8"?><Session
    xmlns="http://www.vmware.com/vcloud/v1.5"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    href="https://vcloud.example.com/api/session/"
    org="System"
    type="application/vnd.vmware.vcloud.session+xml"
    user="vcloud"
    xsi:schemaLocation="http://www.vmware.com/vcloud/v1.5 http://https://vcloud.example.com/api/v1.5/schema/master.xsd">
    <Link
        href="https://vcloud.example.com/api/org/"
        rel="down"
        type="application/vnd.vmware.vcloud.orgList+xml"/>
    <Link
        href="https://vcloud.example.com/api/session/"
        rel="remove"/>
    <Link
        href="https://vcloud.example.com/api/admin/"
        rel="down"
        type="application/vnd.vmware.admin.vcloud+xml"/>
    <Link
        href="https://vcloud.example.com/api/admin/extension"
        rel="down"
        type="application/vnd.vmware.admin.vmwExtension+xml"/>
    <Link
        href="https://vcloud.example.com/api/org/a93c9db9-7471-3192-8d09-a8f7eeda85f9"
        name="System"
        rel="down"
        type="application/vnd.vmware.vcloud.org+xml"/>
    <Link
        href="https://vcloud.example.com/api/query"
        rel="down"
        type="application/vnd.vmware.vcloud.query.queryList+xml"/>
    <Link
        href="https://vcloud.example.com/api/entity/"
        rel="entityResolver"
        type="application/vnd.vmware.vcloud.entity+xml"/>
    <Link
        href="https://vcloud.example.com/api/extensibility"
        rel="down:extensibility"
        type="application/vnd.vmware.vcloud.apiextensibility+xml"/>
</Session>