Broadcom API Gateway - List Identity Provider groups using the Gateway Migration Utility

by
Jeremy Canfield |
Updated: February 23 2022
| Broadcom API Gateway articles
This assumes you are familiar with the basic usage of the Gateway Migration Utility. Following is an example of how to list the groups in the Identity Provider with ID da698409abc96df215cf2f80b2175a41.
/path/to/GatewayMigrationUtility.sh restman
-host apig.example.com
-port 8443
-username john.doe
-password f5VPX0yUJPg.m4BrjdgMv84UgktddJD3xA
-method GET
-path '1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups'
Or the -argFile option can be used, to reduce the number of options that are used on the command line.
/path/to/GatewayMigrationUtility.sh restman
-argFile example.properties
-method GET
-path '1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups'
Or, a single group can be returned by including the group ID.
/path/to/GatewayMigrationUtility.sh restman
-argFile example.properties
-method GET
-path '1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups/a51237cc16c31b69edd66bb1e7243219'
Or, you can use the -query option to return a single group by including the name of the group.
/path/to/GatewayMigrationUtility.sh restman
-argFile example.properties
-method GET
-path '1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups'
-query 'name=Example Group'
The -response option can be used to output the XML to a file.
/path/to/GatewayMigrationUtility.sh restman
-argFile example.properties
-method GET
-path '1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups'
-response /path/to/idp_groups.xml
Something like this should be returned.
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<l7:List xmlns:l7="http://ns.l7tech.com/2010/04/gateway-management">
<l7:Name>GROUP List</l7:Name>
<l7:Type>List</l7:Type>
<l7:TimeStamp>2020-08-28T06:20:35.478-05:00</l7:TimeStamp>
<l7:Link rel="self" uri="https://api.example.com:8443/restman/1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups"/>
<l7:Link rel="template" uri="https://api.example.com:8443/restman/1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups/template"/>
<l7:Item>
<l7:Name>Example Group</l7:Name>
<l7:Id>a51237cc16c31b69edd66bb1e7243219</l7:Id>
<l7:Type>GROUP</l7:Type>
<l7:TimeStamp>2020-08-28T06:20:35.478-05:00</l7:TimeStamp>
<l7:Link rel="self" uri="https://api.example.com:8443/restman/1.0/identityProviders/da698409abc96df215cf2f80b2175a41/groups/a51237cc16c31b69edd66bb1e7243219"/>
<l7:Resource>
<l7:Group providerId="da698409abc96df215cf2f80b2175a41" id="a51237cc16c31b69edd66bb1e7243219">
<l7:Name>Example Group</l7:Name>
</l7:Group>
</l7:Resource>
</l7:Item>
</l7:List>
Did you find this article helpful?
If so, consider buying me a coffee over at