getRole

Ruft die angegebene Rolle ab.

Gilt für Clouds (Integration Appliances) sowie für Integrationseinheiten.

Parameter:

role
Die angegebene Rolle, die zurückgegeben werden soll.
Rückgabe:
Die angegebene Rolle.

Beispiele:

Beim folgenden Beispiel handelt es sich um eine SOAP-Anforderung zum Abrufen einer Rolle.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/schemas/2008/1/security">
 <soapenv:Header>
  <sec:sessionId>BC77BA76E338CFA6B0063218A0AE4656</sec:sessionId>
 </soapenv:Header>
 <soapenv:Body>
  <sec:getRole>
   <sec:name>publisher@A347B0C49C8CFA462D4F28A4C05B47C2</sec:name>
  </sec:getRole>
 </soapenv:Body>
</soapenv:Envelope>
Beim folgenden Beispiel handelt es sich um die SOAP-Antwort auf die Anforderung.
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
 <S:Body>
  <ns2:getRoleResponse xmlns:ns2="http://www.approuter.com/schemas/2008/1/
  security" xmlns:ns3="http://www.approuter.com/schema/router/1000/security/03">
   <ns2:group>
    <ns3:id>903273B869AC8CA9D99F4C8448694680</ns3:id>
    <ns3:name>publisher@A347B0C49C8CFA462D4F28A4C05B47C2</ns3:name>
    <ns3:displayName>Publisher Group</ns3:displayName>
    <ns3:isActive>true</ns3:isActive>
    <ns3:isMutable>false</ns3:isMutable>
    <ns3:isVisible>true</ns3:isVisible>
    <ns3:createdTime>2010-04-10T00:08:23Z</ns3:createdTime>
    <ns3:scopeId>A347B0C49C8CFA462D4F28A4C05B47C2</ns3:scopeId>
    <ns3:scopeType>Environment</ns3:scopeType>
    <ns3:groupType>Publisher</ns3:groupType>
   </ns2:group>
  </ns2:getRoleResponse>
 </S:Body>
</S:Envelope>
Für jede Rolle werden die folgenden Informationen zurückgegeben:
id
Die ID der Rolle.
name
Der Name der Rolle.
displayName
Der Name, der für die Rolle in der WMC (Web Management Console, Webmanagementkonsole) angezeigt wird.
isActive
Entweder 'true' oder 'false', je nachdem, ob die Rolle aktiv oder inaktiv ist.
isMutable
Entweder 'true' oder 'false'. Der Wert 'true' bedeutet, dass das Objekt aktualisiert werden kann.
isVisible
Entweder 'true' oder 'false'. Der Wert 'true' bedeutet, dass das Objekt in der WMC (Web Management Console, Webmanagementkonsole) sichtbar ist.
email
Die E-Mail-Adresse der Rolle.
createdTime
Datum und Uhrzeit der Erstellung der Rolle. Die Angabe der Zeit ist mit ISO 8601 konform.
scopeId
Die ID des Geltungsbereichs, in dem sich die Rolle befindet. (Nur für Clouds.)
scopeType
Der Typ von Geltungsbereich - entweder 'Tenant' (Nutzer) oder 'Environment' (Umgebung). (Nur für Clouds.)
groupType
Der Typ von Gruppe, zu der die Rolle gehört. Wenn Sie eine eigene Gruppe erstellen, handelt es sich hierbei um eine angepasste Gruppe. Informationen zu den integrierten Gruppen finden Sie im WMC-Hilfemenü unter dem Menüpunkt für Berechtigungen und dann den Informationen zu integrierten Gruppen (WMC Help > Permissions > About Built-in Groups).