PureBasic 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"

PureBasic Example

IncludeFile "CkStringBuilder.pb"
IncludeFile "CkRest.pb"
IncludeFile "CkXml.pb"
IncludeFile "CkAuthAws.pb"

Procedure ChilkatExample()

    rest.i = CkRest::ckCreate()
    If rest.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success.i

    authAws.i = CkAuthAws::ckCreate()
    If authAws.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkAuthAws::setCkAccessKey(authAws, "AWS_ACCESS_KEY")
    CkAuthAws::setCkSecretKey(authAws, "AWS_SECRET_KEY")
    CkAuthAws::setCkRegion(authAws, "us-east-1")
    CkAuthAws::setCkServiceName(authAws, "iam")
    CkRest::ckSetAuthAws(rest,authAws)

    ;  URL: https://iam.amazonaws.com/
    bTls.i = 1
    port.i = 443
    bAutoReconnect.i = 1
    success = CkRest::ckConnect(rest,"iam.amazonaws.com",port,bTls,bAutoReconnect)
    If success <> 1
        Debug "ConnectFailReason: " + Str(CkRest::ckConnectFailReason(rest))
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        ProcedureReturn
    EndIf

    CkRest::ckAddQueryParam(rest,"Action","CreateGroup")
    CkRest::ckAddQueryParam(rest,"GroupName","Consultants")
    CkRest::ckAddQueryParam(rest,"Version","2010-05-08")

    sbResponseBody.i = CkStringBuilder::ckCreate()
    If sbResponseBody.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    success = CkRest::ckFullRequestNoBodySb(rest,"GET","/",sbResponseBody)
    If success <> 1
        Debug CkRest::ckLastErrorText(rest)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        CkStringBuilder::ckDispose(sbResponseBody)
        ProcedureReturn
    EndIf

    respStatusCode.i = CkRest::ckResponseStatusCode(rest)
    If respStatusCode >= 400
        Debug "Response Status Code = " + Str(respStatusCode)
        Debug "Response Header:"
        Debug CkRest::ckResponseHeader(rest)
        Debug "Response Body:"
        Debug CkStringBuilder::ckGetAsString(sbResponseBody)
        CkRest::ckDispose(rest)
        CkAuthAws::ckDispose(authAws)
        CkStringBuilder::ckDispose(sbResponseBody)
        ProcedureReturn
    EndIf

    xmlResponse.i = CkXml::ckCreate()
    If xmlResponse.i = 0
        Debug "Failed to create object."
        ProcedureReturn
    EndIf

    CkXml::ckLoadSb(xmlResponse,sbResponseBody,1)

    CreateGroupResponse_xmlns.s
    tagPath.s
    Path.s
    GroupName.s
    Arn.s
    GroupId.s
    CreateDate.s
    RequestId.s

    CreateGroupResponse_xmlns = CkXml::ckGetAttrValue(xmlResponse,"xmlns")
    Path = CkXml::ckGetChildContent(xmlResponse,"CreateGroupResult|Group|Path")
    GroupName = CkXml::ckGetChildContent(xmlResponse,"CreateGroupResult|Group|GroupName")
    Arn = CkXml::ckGetChildContent(xmlResponse,"CreateGroupResult|Group|Arn")
    GroupId = CkXml::ckGetChildContent(xmlResponse,"CreateGroupResult|Group|GroupId")
    CreateDate = CkXml::ckGetChildContent(xmlResponse,"CreateGroupResult|Group|CreateDate")
    RequestId = CkXml::ckGetChildContent(xmlResponse,"ResponseMetadata|RequestId")


    CkRest::ckDispose(rest)
    CkAuthAws::ckDispose(authAws)
    CkStringBuilder::ckDispose(sbResponseBody)
    CkXml::ckDispose(xmlResponse)


    ProcedureReturn
EndProcedure

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>