blob: fb7cfff77b1fa6aec906c5f175af110be72f76ed [file] [log] [blame]
*** Settings ***
Documentation Verify REST services Get/Put/Post/Delete.
Resource ../lib/rest_client.robot
Resource ../lib/openbmc_ffdc.robot
Resource ../lib/resource.txt
Resource ../lib/utils.robot
Library Collections
Test Teardown FFDC On Test Case Fail
*** Variables ***
*** Test Cases ***
REST Login Session To BMC
[Documentation] Test REST session log-in.
[Tags] REST_Login_Session_To_BMC
Initialize OpenBMC
# Raw GET REST operation to verify session is established.
${resp}= Get Request openbmc /xyz/openbmc_project/
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
REST Logout Session To BMC
[Documentation] Test REST session log-out.
[Tags] REST_Logout_Session_To_BMC
Initialize OpenBMC
Log Out OpenBMC
# Raw GET REST operation to verify session is logout.
${resp}= Get Request openbmc /xyz/openbmc_project/
Should Be Equal As Strings ${resp.status_code} ${HTTP_UNAUTHORIZED}
REST Delete All Sessions And Expect Error
[Documentation] Test REST empty cache using delete operation.
[Tags] REST_Delete_All_Sessions_And_Expect_Error
# Throws exception:
# Non-existing index or alias 'openbmc'.
Initialize OpenBMC
Delete All Sessions
# Raw GET REST operation and expect exception error.
Run Keyword And Expect Error
... Non-existing index or alias 'openbmc'.
... Get Request openbmc /xyz/openbmc_project/
Multiple Requests On BMC Using Single REST Session
[Documentation] Trigger multiple REST operations using an active
... connection session.
[Tags] Multiple_Requests_On_BMC_Using_Single_REST_Session
Initialize OpenBMC
# Session object "openbmc".
${resp}= Get Request openbmc /xyz/openbmc_project/state/
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
${resp}= Get Request openbmc /xyz/openbmc_project/software/enumerate
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
Verify REST JSON Data On Success
[Documentation] Verify JSON data success response messages.
[Tags] Verify_REST_JSON_Data_On_Success
# Example:
# Response code:200, Content:{
# "data": [
# "/xyz/openbmc_project/sensors",
# "/xyz/openbmc_project/inventory",
# "/xyz/openbmc_project/software",
# "/xyz/openbmc_project/object_mapper",
# "/xyz/openbmc_project/logging"
# ],
# "message": "200 OK",
# "status": "ok"
# }
${resp}= OpenBMC Get Request /xyz/openbmc_project/
${jsondata}= To JSON ${resp.content}
Should Not Be Empty ${jsondata["data"]}
Should Be Equal As Strings ${jsondata["message"]} 200 OK
Should Be Equal As Strings ${jsondata["status"]} ok
Verify REST JSON Data On Failure
[Documentation] Verify JSON data failure response messages.
[Tags] Verify_REST_JSON_Data_On_Failure
# Example:
# Response code:404, Content:{
# "data": {
# "description": "org.freedesktop.DBus.Error.FileNotFound: path or object not found:
# /xyz/idont/exist"
# },
# "message": "404 Not Found",
# "status": "error"
# }
${resp}= OpenBMC Get Request /xyz/idont/exist/
${jsondata}= To JSON ${resp.content}
Should Contain ${jsondata["data"]["description"]}
... org.freedesktop.DBus.Error.FileNotFound: path or object not found
Should Be Equal As Strings ${jsondata["message"]} 404 Not Found
Should Be Equal As Strings ${jsondata["status"]} error
Verify REST Get Message JSON Compliant
[Documentation] Verify REST "GET" message is JSON format compliant.
[Tags] Verify_REST_Get_Message_JSON_Compliant
# For testing if the REST message is JSON format compliant using a
# generic BMC state path /xyz/openbmc_project/state object and path
# walking through to ensure the parent object, trailing slash and
# attribute message response are intact.
# Object attribute data.
# Example:
# Response code:200, Content:{
# "data": {
# "CurrentBMCState": "xyz.openbmc_project.State.BMC.BMCState.Ready",
# "RequestedBMCTransition": "xyz.openbmc_project.State.BMC.Transition.None"
# },
# "message": "200 OK",
# "status": "ok"
# }
Verify JSON Response Content
... /xyz/openbmc_project/state/bmc0 DATA_NOT_EMPTY
# Object trailing slash attribute data.
# Example:
# Response code:200, Content:{
# "data": [],
# "message": "200 OK",
# "status": "ok"
# }
Verify JSON Response Content /xyz/openbmc_project/state/bmc0/
# Attribute data.
# Example:
# Response code:200, Content:{
# "data": "xyz.openbmc_project.State.BMC.BMCState.Ready",
# "message": "200 OK",
# "status": "ok"
# }
Verify JSON Response Content
... /xyz/openbmc_project/state/bmc0/attr/CurrentBMCState DATA_NOT_EMPTY
Verify REST Post Message JSON Compliant
[Documentation] Verify REST "POST" message is JSON format compliant.
[Tags] Verify_REST_Post_Message_JSON_Compliant
# Example:
# Response code:200, Content:{
# "data": null,
# "message": "200 OK",
# "status": "ok"
# }
# Clear existing gard records, if any.
${data}= Create Dictionary data=@{EMPTY}
${resp}= Openbmc Post Request ${OPENPOWER_CONTROL}gard/action/Reset
... data=${data}
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
${jsondata}= To JSON ${resp.content}
Should Be Equal ${jsondata["data"]} ${None}
Should Be Equal As Strings ${jsondata["message"]} 200 OK
Should Be Equal As Strings ${jsondata["status"]} ok
Verify REST Bad Request Post Message JSON Compliant
[Documentation] Verify REST "POST" message is JSON format compliant.
[Tags] Verify_REST_Bad_Request_Post_Message_JSON_Compliant
# Example:
# {
# "data": {
# "description": "Version already exists or failed to be extracted"
# },
# "message": "400 Bad Request",
# "status": "error"
# }
# Generate 1KB file size
Run dd if=/dev/zero of=dummyfile bs=1 count=0 seek=1KB
OperatingSystem.File Should Exist dummyfile
# Get the content of the file and upload to BMC
${image_data}= OperatingSystem.Get Binary File dummyfile
# Get REST session to BMC
Initialize OpenBMC
# Create the REST payload headers and data
${data}= Create Dictionary data ${image_data}
${headers}= Create Dictionary Content-Type=application/octet-stream
... Accept=application/octet-stream
Set To Dictionary ${data} headers ${headers}
${resp}= Post Request openbmc /upload/image &{data}
Should Be Equal As Strings ${resp.status_code} ${HTTP_BAD_REQUEST}
${jsondata}= To JSON ${resp.content}
Should Be Equal ${jsondata["data"]["description"]}
... Version already exists or failed to be extracted
Should Be Equal As Strings ${jsondata["message"]} 400 Bad Request
Should Be Equal As Strings ${jsondata["status"]} error
Delete All Error Logs
Verify REST Put Message JSON Compliant
[Documentation] Verify REST "PUT" message is JSON format compliant.
[Tags] REST_Put_Message_JSON_Format_Compliance_Test
# Example:
# Response code:200, Content:{
# "data": null,
# "message": "200 OK",
# "status": "ok"
# }
${dict_data}= Create Dictionary data=${HOST_POWEROFF_TRANS}
${resp}= Openbmc Put Request
... ${HOST_STATE_URI}/attr/RequestedHostTransition data=${dict_data}
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
${jsondata}= To JSON ${resp.content}
Should Be Equal ${jsondata["data"]} ${None}
Should Be Equal As Strings ${jsondata["message"]} 200 OK
Should Be Equal As Strings ${jsondata["status"]} ok
# Intention is not to test poweroff but to check the REST operation
# sink time allowing to kick poweroff.
Sleep 10s
Check Response Codes HTTP_UNSUPPORTED_MEDIA_TYPE
[Documentation] REST "Post" response status test for
... HTTP_UNSUPPORTED_MEDIA_TYPE.
[Tags] Check_Response_Codes_415
# Example:
# Response code:415, Content:{
# "data": {
# "description": "Expecting content type 'application/octet-stream', got 'application/json'"
# },
# "message": "415 Unsupported Media Type",
# "status": "error"
# }
Initialize OpenBMC
# Create the REST payload headers and EMPTY data
${data}= Create Dictionary data ${EMPTY}
${headers}= Create Dictionary Content-Type=application/json
Set To Dictionary ${data} headers ${headers}
${resp}= Post Request openbmc /upload/image &{data}
Should Be Equal As Strings
... ${resp.status_code} ${HTTP_UNSUPPORTED_MEDIA_TYPE}
${jsondata}= To JSON ${resp.content}
Should Be Equal As Strings ${jsondata["data"]["description"]}
... Expecting content type 'application/octet-stream', got 'application/json'
Should Be Equal As Strings
... ${jsondata["message"]} 415 Unsupported Media Type
Should Be Equal As Strings ${jsondata["status"]} error
Get Response Codes
[Documentation] REST "Get" response status test.
[Tags] Get_Response_Codes
[Template] Execute Get And Check Response
# Expect status URL Path
${HTTP_OK} /xyz/openbmc_project/
${HTTP_OK} /xyz/openbmc_project/state/enumerate
${HTTP_NOT_FOUND} /i/dont/exist/
Get Data
[Documentation] REST "Get" request url and expect the
... response OK and data non empty.
[Tags] Get_Data
[Template] Execute Get And Check Data
# URL Path
/xyz/openbmc_project/
/xyz/openbmc_project/list
/xyz/openbmc_project/state/enumerate
Get Data Validation
[Documentation] REST "Get" request url and expect the
... pre-defined string in response data.
[Tags] Get_Data_Validation
[Template] Execute Get And Verify Data
# URL Path Expect Data
/xyz/openbmc_project/ /xyz/openbmc_project/logging
/i/dont/exist/ path or object not found
Put Response Codes
[Documentation] REST "Put" request url and expect the REST pre-defined
... codes.
[Tags] Put_Response_Codes
[Template] Execute Put And Check Response
# Expect status URL Path
${HTTP_METHOD_NOT_ALLOWED} /
${HTTP_METHOD_NOT_ALLOWED} /xyz/
${HTTP_METHOD_NOT_ALLOWED} /i/dont/exist/
Put Data Validation
[Documentation] REST "Put" request url and expect success.
[Tags] Put_Data_Validation
[Template] Execute Put And Expect Success
# URL Path Parm Data
/xyz/openbmc_project/state/host0/attr/RequestedHostTransition
... xyz.openbmc_project.State.Host.Transition.Off
Post Response Code
[Documentation] REST Post request url and expect the
... REST response code pre define.
[Tags] Post_Response_Codes
[Template] Execute Post And Check Response
# Expect status URL Path
${HTTP_METHOD_NOT_ALLOWED} /
${HTTP_METHOD_NOT_ALLOWED} /xyz/
${HTTP_METHOD_NOT_ALLOWED} /i/dont/exist/
${HTTP_METHOD_NOT_ALLOWED} /xyz/login
Delete Response Code
[Documentation] REST "Delete" request url and expect the
... REST response code pre define.
[Tags] Delete_Response_Codes
[Template] Execute Delete And Check Response
# Expect status URL Path
${HTTP_METHOD_NOT_ALLOWED} /
${HTTP_METHOD_NOT_ALLOWED} /xyz/
${HTTP_METHOD_NOT_ALLOWED} /xyz/nothere/
${HTTP_METHOD_NOT_ALLOWED} /xyz/openbmc_project/state/
Verify All REST Objects Are Accessible
[Documentation] Verify all the REST objects are accessible using "GET".
[Tags] Verify_All_REST_Objects_Are_Accessible
${uri_list}= Get Sub URI List ${OPENBMC_BASE_URI}
# URI's which won't support GET request.
Remove Values From List ${uri_list}
... /xyz/openbmc_project/certs/client/ldap
... /xyz/openbmc_project/certs/server/https
... /xyz/openbmc_project/certs/authority/ldap
${error_uri_list}= Create List
:FOR ${uri} IN @{uri_list}
\ ${resp}= Openbmc Get Request ${uri} quiet=${1}
\ Run keyword if '${resp.status_code}' != '${HTTP_OK}'
\ ... Append To List ${error_uri_list} ${uri} : ${resp.status_code}
Should Be Empty ${error_uri_list}
*** Keywords ***
Get Sub URI List
[Documentation] Return list of sub URIs inside the URI sent by caller.
[Arguments] ${uri}
# Description of argument(s):
# uri The URI for which all the sub URIs are returned.
# Example:
# "/xyz/openbmc_project/"
${resp}= Openbmc Get Request ${uri}list quiet=${1}
${sub_uris}= Collections.Get From Dictionary ${resp.json()} data
[Return] ${sub_uris}
Execute Get And Check Response
[Documentation] Request "Get" url path and expect REST response code.
[Arguments] ${expected_response_code} ${url_path}
# Description of arguments:
# expected_response_code Expected REST status codes.
# url_path URL path.
${resp}= Openbmc Get Request ${url_path}
Should Be Equal As Strings ${resp.status_code} ${expected_response_code}
Execute Get And Check Data
[Documentation] Request "Get" url path and expect non empty data.
[Arguments] ${url_path}
# Description of arguments:
# url_path URL path.
${resp}= Openbmc Get Request ${url_path}
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
${jsondata}= To JSON ${resp.content}
Should Not Be Empty ${jsondata["data"]}
Execute Get And Verify Data
[Documentation] Request "Get" url path and verify data.
[Arguments] ${url_path} ${expected_response_code}
# Description of arguments:
# expected_response_code Expected REST status codes.
# url_path URL path.
${resp}= Openbmc Get Request ${url_path}
${jsondata}= To JSON ${resp.content}
Run Keyword If '${resp.status_code}' == '${HTTP_OK}'
... Should Contain ${jsondata["data"]} ${expected_response_code}
... ELSE
... Should Contain ${jsondata["data"]["description"]} ${expected_response_code}
Execute Put And Check Response
[Documentation] Request "Put" url path and expect REST response code.
[Arguments] ${expected_response_code} ${url_path}
# Description of arguments:
# expected_response_code Expected REST status codes.
# url_path URL path.
${resp}= Openbmc Put Request ${url_path}
Should Be Equal As Strings ${resp.status_code} ${expected_response_code}
Execute Put And Expect Success
[Documentation] Request "Put" on url path.
[Arguments] ${url_path} ${parm}
# Description of arguments:
# url_path URL path.
# parm Value/string to be set.
# expected_response_code Expected REST status codes.
${parmDict}= Create Dictionary data=${parm}
${resp}= Openbmc Put Request ${url_path} data=${parmDict}
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
Execute Post And Check Response
[Documentation] Request Post url path and expect REST response code.
[Arguments] ${expected_response_code} ${url_path}
# Description of arguments:
# expected_response_code Expected REST status codes.
# url_path URL path.
${resp}= Openbmc Post Request ${url_path}
Should Be Equal As Strings ${resp.status_code} ${expected_response_code}
Execute Post And Check Data
[Arguments] ${url_path} ${parm}
[Documentation] Request Post on url path and expected non empty data.
# Description of arguments:
# url_path URL path.
${data}= Create Dictionary data=@{parm}
${resp}= Openbmc Post Request ${url_path} data=${data}
Should Be Equal As Strings ${resp.status_code} ${HTTP_OK}
${jsondata}= To JSON ${resp.content}
Should Not Be Empty ${jsondata["data"]}
Execute Delete And Check Response
[Documentation] Request "Delete" url path and expected REST response code.
[Arguments] ${expected_response_code} ${url_path}
# Description of arguments:
# expected_response_code Expected REST status codes.
# url_path URL path.
${data}= Create Dictionary data=@{EMPTY}
${resp}= Openbmc Delete Request ${url_path} data=${data}
Should Be Equal As Strings ${resp.status_code} ${expected_response_code}
Verify JSON Response Content
[Documentation] Verify JSON response data is intact.
[Arguments] ${url_path} ${data_empty}=${EMPTY}
# Description of argument(s):
# url_path URL path.
# data_empty JSON data element.
${resp}= OpenBMC Get Request ${url_path}
${jsondata}= To JSON ${resp.content}
Run Keyword If '${data_empty}' == '${EMPTY}'
... Should Be Empty ${jsondata["data"]}
... ELSE
... Should Not Be Empty ${jsondata["data"]}
Should Be Equal As Strings ${jsondata["message"]} 200 OK
Should Be Equal As Strings ${jsondata["status"]} ok