getRoleById

指定された役割を取得します。

Cloud および 統合アプライアンス に適用されます。

パラメーター:

id
返される役割の指定された ID。
戻り:
指定された ID の役割。

例:

以下の例は、役割の ID によって役割を取得するための SOAP 要求です。
<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>
以下は、要求に対する SOAP 応答の例です。
<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>
役割ごとに、以下の情報が返されます。
id
役割の ID。
name
役割の名前。
displayName
WMC での役割の表示名。
isActive
役割がアクティブかどうかによって、true または false になります。
isMutable
true または false。True は、オブジェクトが更新可能なことを意味します。
isVisible
true または false。True は、オブジェクトが WMC に表示されることを意味します。
email
役割の E メール・アドレス。
createdTime
役割が作成された日付および時刻。時刻は ISO 8601 に準拠します。
scopeId
役割が検出されたスコープの ID。(Cloud のみ。)
scopeType
スコープのタイプ (テナントまたは環境のいずれか)。(Cloud のみ。)
groupType
役割が属するグループのタイプ。