Login | VMware Cloud Director Availability API

This request creates a new Cloud service session. The supported authentication methods are the following:

with SSO credentials

  {
    "type": "ssoCredentials",
    "username": "ssoUser",
    "password": "ssoPass",
    "principal" : null
  }

with SSO SAML token

{
    "type": "ssoToken",
    "samlToken": "<saml2:Assertion xmlns:saml2=...>...</saml2:Assertion>",
    "timestamp": 1465194049081,
    "nonce": "jF845646gJzx734",
    "signature": "c2FtcGxlU2lnbmF0dXJlCg==",
    "principal" : null
}

with VMware Cloud Director credentials

{
    "type": "vcdCredentials",
    "vcdUser": "admin1@org2",
    "vcdPassword": "password"
}

with VMware Cloud Director auth cookie:

{
    "type": "vcdCookie",
    "vcdCookie": "f12977876fef48a6b032ffdb2cdf22d7"
}

with VMware Cloud Director access token (jwt):

{
    "type": "vcdAccessToken",
    "vcdAccessToken": "eyJhbGciOiJSUzI1NiJ9....",
    "context": "acme-dr"
}

OS root credentials:

{
    "type": "localUser",
    "localUser": "root",
    "localPassword": "password"
}

Request

URI

POST

https://{api_host}//sessions

COPY

Header Parameters

string

operationID

Optional

Operation ID for correlating logs across multiple services

Request Body

{
    "type": "vcdCredentials",
    "vcdUser": "admin1@org2",
    "vcdPassword": "password"
}

Authentication

This operation uses the following authentication methods.

ApiKeyAuth

Responses

200

Returns C4SessionDetails of type(s) application/json;charset=UTF-8

This response body class contains all of the following: SessionDetails , InlineC4SessionDetails1

{
    "roles": [
        "EVERYONE"
    ],
    "user": "admin1@Org1",
    "authenticatedSites": [
        {
            "org": "Org1",
            "site": "site1"
        }
    ]
}

401

The returned error codes include (but are not limited to): NotAuthenticated

Returns ApiError of type(s) application/vnd.vmware.h4-v4.5+json;charset=UTF-8

{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}

array of string

args

Optional

Positional arguments.

string

code

Optional

Specific error code.

string

msg

Optional

Detailed error message.

string

stacktrace

Optional

Exception stacktrace.

500

The returned error codes include (but are not limited to): GeneralServerFailure

Returns ApiError of type(s) application/vnd.vmware.h4-v4.5+json;charset=UTF-8

{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}

array of string

args

Optional

Positional arguments.

string

code

Optional

Specific error code.

string

msg

Optional

Detailed error message.