blob: 68afbbc1b7d4a2301e899b33a1c369426436a1ef [file] [log] [blame]
{
"$id": "http://redfish.dmtf.org/schemas/v1/Session.v1_6_0.json",
"$ref": "#/definitions/Session",
"$schema": "http://redfish.dmtf.org/schemas/v1/redfish-schema-v1.json",
"copyright": "Copyright 2014-2022 DMTF. For the full DMTF copyright policy, see http://www.dmtf.org/about/policies/copyright",
"definitions": {
"Actions": {
"additionalProperties": false,
"description": "The available actions for this resource.",
"longDescription": "This type shall contain the available actions for this resource.",
"patternProperties": {
"^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
"description": "This property shall specify a valid odata or Redfish property.",
"type": [
"array",
"boolean",
"integer",
"number",
"null",
"object",
"string"
]
}
},
"properties": {
"Oem": {
"$ref": "#/definitions/OemActions",
"description": "The available OEM-specific actions for this resource.",
"longDescription": "This property shall contain the available OEM-specific actions for this resource.",
"versionAdded": "v1_1_0"
}
},
"type": "object"
},
"OemActions": {
"additionalProperties": true,
"description": "The available OEM-specific actions for this resource.",
"longDescription": "This type shall contain the available OEM-specific actions for this resource.",
"patternProperties": {
"^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
"description": "This property shall specify a valid odata or Redfish property.",
"type": [
"array",
"boolean",
"integer",
"number",
"null",
"object",
"string"
]
}
},
"properties": {},
"type": "object"
},
"Session": {
"additionalProperties": false,
"description": "The Session resource describes a single connection (session) between a client and a Redfish service instance.",
"longDescription": "This resource shall represent a session for a Redfish implementation.",
"patternProperties": {
"^([a-zA-Z_][a-zA-Z0-9_]*)?@(odata|Redfish|Message)\\.[a-zA-Z_][a-zA-Z0-9_]*$": {
"description": "This property shall specify a valid odata or Redfish property.",
"type": [
"array",
"boolean",
"integer",
"number",
"null",
"object",
"string"
]
}
},
"properties": {
"@odata.context": {
"$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/context"
},
"@odata.etag": {
"$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/etag"
},
"@odata.id": {
"$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/id"
},
"@odata.type": {
"$ref": "http://redfish.dmtf.org/schemas/v1/odata-v4.json#/definitions/type"
},
"Actions": {
"$ref": "#/definitions/Actions",
"description": "The available actions for this resource.",
"longDescription": "This property shall contain the available actions for this resource.",
"versionAdded": "v1_1_0"
},
"ClientOriginIPAddress": {
"description": "The IP address of the client that created the session.",
"longDescription": "This property shall contain the IP address of the client that created the session.",
"readonly": true,
"type": [
"string",
"null"
],
"versionAdded": "v1_3_0"
},
"Context": {
"description": "A client-supplied string that is stored with the session.",
"longDescription": "This property shall contain a client-supplied context that remains with the session through the session's lifetime.",
"readonly": true,
"type": [
"string",
"null"
],
"versionAdded": "v1_5_0"
},
"CreatedTime": {
"description": "The date and time when the session was created.",
"format": "date-time",
"longDescription": "This property shall contain the date and time when the session was created.",
"readonly": true,
"type": [
"string",
"null"
],
"versionAdded": "v1_4_0"
},
"Description": {
"anyOf": [
{
"$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Description"
},
{
"type": "null"
}
],
"readonly": true
},
"Id": {
"$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Id",
"readonly": true
},
"Name": {
"$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Name",
"readonly": true
},
"Oem": {
"$ref": "http://redfish.dmtf.org/schemas/v1/Resource.json#/definitions/Oem",
"description": "The OEM extension property.",
"longDescription": "This property shall contain the OEM extensions. All values for properties that this object contains shall conform to the Redfish Specification-described requirements."
},
"OemSessionType": {
"description": "The active OEM-defined session type.",
"longDescription": "This property shall contain the OEM-specific session type that is currently active if SessionType contains `OEM`.",
"readonly": true,
"type": [
"string",
"null"
],
"versionAdded": "v1_2_0"
},
"Password": {
"description": "The password for this session. The value is `null` in responses.",
"longDescription": "This property shall contain the password for this session. The value shall be `null` in responses.",
"readonly": true,
"type": [
"string",
"null"
],
"writeOnly": false
},
"SessionType": {
"anyOf": [
{
"$ref": "#/definitions/SessionTypes"
},
{
"type": "null"
}
],
"description": "The active session type.",
"longDescription": "This property shall represent the type of session that is currently active.",
"readonly": true,
"versionAdded": "v1_2_0"
},
"Token": {
"description": "The multi-factor authentication token for this session. The value is `null` in responses.",
"longDescription": "This property shall contain the multi-factor authentication token for this session. The value shall be `null` in responses.",
"readonly": true,
"type": [
"string",
"null"
],
"versionAdded": "v1_6_0",
"writeOnly": false
},
"UserName": {
"description": "The username for the account for this session.",
"longDescription": "This property shall contain the username that matches an account recognized by the account service.",
"readonly": true,
"type": [
"string",
"null"
]
}
},
"required": [
"@odata.id",
"@odata.type",
"Id",
"Name"
],
"requiredOnCreate": [
"UserName",
"Password"
],
"type": "object"
},
"SessionTypes": {
"enum": [
"HostConsole",
"ManagerConsole",
"IPMI",
"KVMIP",
"OEM",
"Redfish",
"VirtualMedia",
"WebUI"
],
"enumDescriptions": {
"HostConsole": "The host's console, which could be connected through Telnet, SSH, or other protocol.",
"IPMI": "Intelligent Platform Management Interface.",
"KVMIP": "Keyboard-Video-Mouse over IP Session.",
"ManagerConsole": "The manager's console, which could be connected through Telnet, SSH, SM CLP, or other protocol.",
"OEM": "OEM type. For OEM session types, see the OemSessionType property.",
"Redfish": "A Redfish session.",
"VirtualMedia": "Virtual media.",
"WebUI": "A non-Redfish web user interface session, such as a graphical interface or another web-based protocol."
},
"type": "string"
}
},
"owningEntity": "DMTF",
"release": "2022.3",
"title": "#Session.v1_6_0.Session"
}