Unicode C AWS IAM: List Groups

Back to Index

Lists the IAM groups that have the specified path prefix.

Documentation: https://docs.aws.amazon.com/IAM/latest/APIReference/API_ListGroups.html

CURL Command

curl -X GET https://iam.amazonaws.com/ \
  -d "Action=ListGroups" \
  -d "PathPrefix=/" \
  -d "Version=2010-05-08"

Unicode C Example

#include <C_CkRestW.h>
#include <C_CkAuthAwsW.h>
#include <C_CkStringBuilderW.h>
#include <C_CkXmlW.h>

void ChilkatSample(void)
    {
    HCkRestW rest;
    BOOL success;
    HCkAuthAwsW authAws;
    BOOL bTls;
    int port;
    BOOL bAutoReconnect;
    HCkStringBuilderW sbResponseBody;
    int respStatusCode;
    HCkXmlW xmlResponse;
    int i;
    int count_i;
    const wchar_t *tagPath;
    const wchar_t *Path;
    const wchar_t *GroupName;
    const wchar_t *GroupId;
    const wchar_t *Arn;
    const wchar_t *IsTruncated;
    const wchar_t *RequestId;

    rest = CkRestW_Create();

    authAws = CkAuthAwsW_Create();
    CkAuthAwsW_putAccessKey(authAws,L"AWS_ACCESS_KEY");
    CkAuthAwsW_putSecretKey(authAws,L"AWS_SECRET_KEY");
    CkAuthAwsW_putRegion(authAws,L"us-east-1");
    CkAuthAwsW_putServiceName(authAws,L"iam");
    CkRestW_SetAuthAws(rest,authAws);

    //  URL: https://iam.amazonaws.com/
    bTls = TRUE;
    port = 443;
    bAutoReconnect = TRUE;
    success = CkRestW_Connect(rest,L"iam.amazonaws.com",port,bTls,bAutoReconnect);
    if (success != TRUE) {
        wprintf(L"ConnectFailReason: %d\n",CkRestW_getConnectFailReason(rest));
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkAuthAwsW_Dispose(authAws);
        return;
    }

    CkRestW_AddQueryParam(rest,L"Action",L"ListGroups");
    CkRestW_AddQueryParam(rest,L"PathPrefix",L"/");
    CkRestW_AddQueryParam(rest,L"Version",L"2010-05-08");

    sbResponseBody = CkStringBuilderW_Create();
    success = CkRestW_FullRequestNoBodySb(rest,L"GET",L"/",sbResponseBody);
    if (success != TRUE) {
        wprintf(L"%s\n",CkRestW_lastErrorText(rest));
        CkRestW_Dispose(rest);
        CkAuthAwsW_Dispose(authAws);
        CkStringBuilderW_Dispose(sbResponseBody);
        return;
    }

    respStatusCode = CkRestW_getResponseStatusCode(rest);
    if (respStatusCode >= 400) {
        wprintf(L"Response Status Code = %d\n",respStatusCode);
        wprintf(L"Response Header:\n");
        wprintf(L"%s\n",CkRestW_responseHeader(rest));
        wprintf(L"Response Body:\n");
        wprintf(L"%s\n",CkStringBuilderW_getAsString(sbResponseBody));
        CkRestW_Dispose(rest);
        CkAuthAwsW_Dispose(authAws);
        CkStringBuilderW_Dispose(sbResponseBody);
        return;
    }

    xmlResponse = CkXmlW_Create();
    CkXmlW_LoadSb(xmlResponse,sbResponseBody,TRUE);

    i = 0;
    count_i = CkXmlW_NumChildrenHavingTag(xmlResponse,L"ListGroupsResult|Groups|member");
    while (i < count_i) {
        CkXmlW_putI(xmlResponse,i);
        Path = CkXmlW_getChildContent(xmlResponse,L"ListGroupsResult|Groups|member[i]|Path");
        GroupName = CkXmlW_getChildContent(xmlResponse,L"ListGroupsResult|Groups|member[i]|GroupName");
        GroupId = CkXmlW_getChildContent(xmlResponse,L"ListGroupsResult|Groups|member[i]|GroupId");
        Arn = CkXmlW_getChildContent(xmlResponse,L"ListGroupsResult|Groups|member[i]|Arn");
        i = i + 1;
    }

    IsTruncated = CkXmlW_getChildContent(xmlResponse,L"ListGroupsResult|IsTruncated");
    RequestId = CkXmlW_getChildContent(xmlResponse,L"ResponseMetadata|RequestId");


    CkRestW_Dispose(rest);
    CkAuthAwsW_Dispose(authAws);
    CkStringBuilderW_Dispose(sbResponseBody);
    CkXmlW_Dispose(xmlResponse);

    }

Sample XML Response Body

<?xml version="1.0" encoding="utf-8" ?>
<ListGroupsResponse>
    <ListGroupsResult>
        <Groups>
            <member>
                <Path>/division_abc/subdivision_xyz/</Path>
                <GroupName>Admins</GroupName>
                <GroupId>AGPACKCEVSQ6C2EXAMPLE</GroupId>
                <Arn>arn:aws:iam::123456789012:group/Admins</Arn>
            </member>
            <member>
                <Path>/division_abc/subdivision_xyz/product_1234/engineering/</Path>
                <GroupName>Test</GroupName>
                <GroupId>AGP2MAB8DPLSRHEXAMPLE</GroupId>
                <Arn>arn:aws:iam::123456789012:group
          /division_abc/subdivision_xyz/product_1234/engineering/Test</Arn>
            </member>
            <member>
                <Path>/division_abc/subdivision_xyz/product_1234/</Path>
                <GroupName>Managers</GroupName>
                <GroupId>AGPIODR4TAW7CSEXAMPLE</GroupId>
                <Arn>arn:aws:iam::123456789012
          :group/division_abc/subdivision_xyz/product_1234/Managers</Arn>
            </member>
        </Groups>
        <IsTruncated>false</IsTruncated>
    </ListGroupsResult>
    <ResponseMetadata>
        <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
    </ResponseMetadata>
</ListGroupsResponse>