Unicode C AWS IAM: Create Role

Back to Index

Creates a new role for your AWS account.

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

CURL Command

curl -X GET https://iam.amazonaws.com/ \
  -d "Action=CreateRole" \
  -d "RoleName=S3Access" \
  -d "PathPrefix=/" \
  -d 'AssumeRolePolicyDocument={"Version":"2012-10-17","Statement":[{"Effect":"Allow","Principal":{"Service":["ec2.amazonaws.com"]},"Action":["sts:AssumeRole"]}]}' \
  -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 *CreateRoleResponse_xmlns;
    const wchar_t *tagPath;
    const wchar_t *Path;
    const wchar_t *AssumeRolePolicyDocument;
    const wchar_t *RoleId;
    const wchar_t *RoleName;
    const wchar_t *Arn;
    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"CreateRole");
    CkRestW_AddQueryParam(rest,L"RoleName",L"S3Access");
    CkRestW_AddQueryParam(rest,L"PathPrefix",L"/");
    CkRestW_AddQueryParam(rest,L"AssumeRolePolicyDocument",L"{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"Service\":[\"ec2.amazonaws.com\"]},\"Action\":[\"sts:AssumeRole\"]}]}");
    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);

    CreateRoleResponse_xmlns = CkXmlW_getAttrValue(xmlResponse,L"xmlns");
    Path = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|Path");
    AssumeRolePolicyDocument = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|AssumeRolePolicyDocument");
    RoleId = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|RoleId");
    RoleName = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|RoleName");
    Arn = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|Arn");
    CreateDate = CkXmlW_getChildContent(xmlResponse,L"CreateRoleResult|Role|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" ?>
<CreateRoleResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
    <CreateRoleResult>
        <Role>
            <Path>/</Path>
            <AssumeRolePolicyDocument>%7B%22Version%22%3A%222012-10-17%22%2C%22Statement%22%3A%5B%7B%22Effect%22%3A%22Allow%22%2C%22Principal%22%3A%7B%22Service%22%3A%5B%22ec2.amazonaws.com%22%5D%7D%2C%22Action%22%3A%5B%22sts%3AAssumeRole%22%5D%7D%5D%7D</AssumeRolePolicyDocument>
            <RoleId>AROAINN6SXEVNWCLTXEZK</RoleId>
            <RoleName>S3Access</RoleName>
            <Arn>arn:aws:iam::954491834127:role/S3Access</Arn>
            <CreateDate>2018-05-20T12:50:13.634Z</CreateDate>
        </Role>
    </CreateRoleResult>
    <ResponseMetadata>
        <RequestId>5699b365-5c2c-11e8-8b73-3b21c350d521</RequestId>
    </ResponseMetadata>
</CreateRoleResponse>