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>