/
GetEnvironmentByShortName (v3)

GetEnvironmentByShortName (v3)

Overview

Reads a tenant based on its short name.

The function is available as a Web Service request.

Request

Parameters of the API request:

ParameterType

Description

Requirements
tokenStringAPI authentication tokenMandatory
shortNameStringEnvironment short name of the tenant we are looking forMandatory

Response

Parameters of the API response in GetEnvironmentByShortName type called return:

ParameterType

Description

statusGetEnvironmentResponse

Possible statusCodes:

    • OK
    • ERROR_GENERAL
    • ERROR_ILLEGAL_ARGUMENT
    • ERROR_UNAUTHORIZED
    • ERROR_NOT_FOUND

Examples


 Example GetEnvironmentByShortName transaction.
Example GetEnvironmentByShortName transaction.
Request:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v3="http://v3.provisioning.ws.web.verba.com/">
   <soapenv:Header/>
   <soapenv:Body>
     <v3:getEnvironmentByShortName>
         <token>xjK9AVj1Lc4ciA4tBxEelKBrC5astJYj</token>
         <shortName>Ref.</shortName>
      </v3:getEnvironmentByShortName>
   </soapenv:Body>
</soapenv:Envelope>

Response:

<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
   <S:Body>
      <ns2:getEnvironmentByShortNameResponse xmlns:ns2="http://v3.provisioning.ws.web.verba.com/">
         <return>
            <environment>
               <displayName>Reference environment</displayName>
               <eid>0000</eid>
               <helpdeskURL>http://valami.hu</helpdeskURL>
               <inactive>false</inactive>
               <shortName>Ref.</shortName>
            </environment>
            <status>
               <statusCode>OK</statusCode>
            </status>
         </return>
      </ns2:getEnvironmentByShortNameResponse>
   </S:Body>
</S:Envelope>




Related content

GetEnvironmentByShortName (v2)
GetEnvironmentByShortName (v2)
More like this
GetEnvironmentByEid (v3)
GetEnvironmentByEid (v3)
More like this
GetEnvironmentByEid (v2)
GetEnvironmentByEid (v2)
More like this
ListEnvironments (v3)
ListEnvironments (v3)
More like this
GetUserByLoginNameAndEnvironment (v3)
GetUserByLoginNameAndEnvironment (v3)
More like this
GetGroupByNameAndEnvironment (v2)
GetGroupByNameAndEnvironment (v2)
More like this