Skip to main content

DeleteGroup

Deletes the specified IAM group. The group must not contain any users or have any attached policies.

Permissions​

ActionDescriptionResource
DeleteGroupGrants permission to delete the specified IAM groupgroup

Request Parameters​

For information about the parameters that are common to all actions, see Common Parameters.

GroupName

The name of the IAM group to delete.

This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [\w+=,.@-]+

Required: Yes

Errors​

DeleteConflict

The request was rejected because it attempted to delete a resource that has attached subordinate entities. The error message describes these entities.

HTTP Status Code: 409

LimitExceeded

The request was rejected because it attempted to create resources beyond the current AWS account limits. The error message describes the limit exceeded.

HTTP Status Code: 409

NoSuchEntity

The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.

HTTP Status Code: 404

ServiceFailure

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

Examples​

Example​

This example illustrates one usage of DeleteGroup.

https://<partition>.iam.astran.io/?Action=DeleteGroup
&GroupName=Test
&Version=2010-05-08
&AUTHPARAMS
<DeleteGroupResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
  <ResponseMetadata>
    <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
  </ResponseMetadata>
</DeleteGroupResponse>

See Also​

For more information about using this API in one of the language-specific AWS SDKs, see the following: