Unicode C AWS IAM: Create Group

Back to Index

Creates a new group.

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

CURL Command

curl -X GET https://iam.amazonaws.com/ \
  -d "Action=CreateGroup" \
  -d "GroupName=Consultants" \
  -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;
    const wchar_t *CreateGroupResponse_xmlns;
    const wchar_t *tagPath;
    const wchar_t *Path;
    const wchar_t *GroupName;
    const wchar_t *Arn;
    const wchar_t *GroupId;
    const wchar_t *CreateDate;
    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"CreateGroup");
    CkRestW_AddQueryParam(rest,L"GroupName",L"Consultants");
    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);

    CreateGroupResponse_xmlns = CkXmlW_getAttrValue(xmlResponse,L"xmlns");
    Path = CkXmlW_getChildContent(xmlResponse,L"CreateGroupResult|Group|Path");
    GroupName = CkXmlW_getChildContent(xmlResponse,L"CreateGroupResult|Group|GroupName");
    Arn = CkXmlW_getChildContent(xmlResponse,L"CreateGroupResult|Group|Arn");
    GroupId = CkXmlW_getChildContent(xmlResponse,L"CreateGroupResult|Group|GroupId");
    CreateDate = CkXmlW_getChildContent(xmlResponse,L"CreateGroupResult|Group|CreateDate");
    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" ?>
<CreateGroupResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
    <CreateGroupResult>
        <Group>
            <Path>/</Path>
            <GroupName>Consultants</GroupName>
            <Arn>arn:aws:iam::954491834127:group/Consultants</Arn>
            <GroupId>AGPAJNGBO5CWC6OJKSWHQ</GroupId>
            <CreateDate>2018-05-19T21:38:34.185Z</CreateDate>
        </Group>
    </CreateGroupResult>
    <ResponseMetadata>
        <RequestId>fb31888b-5bac-11e8-963f-6d117c496f53</RequestId>
    </ResponseMetadata>
</CreateGroupResponse>