创建用户组

创建用户组(CreateGroup)

描述

请求参数

名称	类型	必填	长度限制	格式	描述
GroupName	string	是	1-128	[\w+=,[email protected]]+	用户组名称
Description	string	否	1-128		用户组描述

返回元素

错误码

错误码	错误信息	HTTP Status Code
GroupNameInvalidParameterValue	An invalid or out-of-range value was supplied for the ‘GroupName’ parameter.	400
GroupDescInvalidParameterValue	An invalid or out-of-range value was supplied for the ‘Description’ parameter.	400
GroupLimitExceeded	The request was rejected because it attempted to create user group beyond the current KSC account limits. The error message describes the limit exceeded.	409
GroupAlreadyExists	The request was rejected because it attempted to create a group that already exists.	409
ServiceFailure	The request processing has failed because of an unknown error, exception or failure.	500

示例

请求示例

http://10.146.16.202:8008/?Action=CreateGroup&Version=2015-11-01&GroupName=admin&Description=管理组

返回示例

xml格式

<CreateGroupResponse>
    <CreateGroupResult>
        <Group>
            <GroupId>KsHVAnKrT821JsaCgcFIsg</GroupId>
            <Path>/</Path>
            <GroupName>console</GroupName>
            <Description>控制台组</Description>
            <CreateDate>2017-10-31T09:34:22Z</CreateDate>
            <Krn>krn:ksc:iam::2000000719:group/console</Krn>
        </Group>
    </CreateGroupResult>
    <ResponseMetadata>
        <RequestId>b3ef2d87-5599-4487-ab7a-317dc81fe5f0</RequestId>
    </ResponseMetadata>
</CreateGroupResponse>

json格式

{
    "RequestId": "269b29cf-f692-470a-bb3d-ec06cbd42e53",
    "Error": {
        "Type": "sender",
        "Code": "GroupAlreadyExists",
        "Message": "The request was rejected because it attempted to create a group that already exists."
    }
}