getRoleById
Ruft die angegebene Rolle ab.
Gilt für Clouds (Integration Appliances) sowie für Integrationseinheiten.
Parameter:
- id
- Die angegebene ID der Rolle, die zurückgegeben werden soll.
- Rückgabe:
- Die Rolle für die angegebene ID.
Beispiele:
Beim folgenden Beispiel handelt es sich um eine SOAP-Anforderung zum Abrufen einer Rolle anhand ihrer Rollen-ID.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:sec="http://www.approuter.com/
schemas/2008/1/security">
<soapenv:Header>
<sec:sessionId>A85C21BB99E816D48800C90B2C5547D4</sec:sessionId>
</soapenv:Header>
<soapenv:Body>
<sec:getRoleById>
<sec:id>8F52644BBA2491693D440F2FA12A4B3D</sec:id>
</sec:getRoleById>
</soapenv:Body>
</soapenv:Envelope>
Beim folgenden Beispiel handelt es sich um eine SOAP-Antwort auf die Anforderung.
<S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/">
<S:Body>
<ns2:getRoleByIdResponse 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>8F52644BBA2491693D440F2FA12A4B3D</ns3:id>
<ns3:name>securitymonitor</ns3:name>
<ns3:displayName>monitor</ns3:displayName>
<ns3:isActive>true</ns3:isActive>
<ns3:isMutable>true</ns3:isMutable>
<ns3:isVisible>true</ns3:isVisible>
<ns3:email>security@mycompany.com</ns3:email>
<ns3:createdTime>2010-03-23T19:14:30.066Z</ns3:createdTime>
<ns3:scopeId>A6EFAF24DB7168A4206F605CA6E14B1D</ns3:scopeId>
<ns3:scopeType>Tenant</ns3:scopeType>
<ns3:groupType>Custom</ns3:groupType>
</ns2:group>
</ns2:getRoleByIdResponse>
</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.
- 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.