インターフェイス説明

特定のグループを削除します。

  • グループを削除する前に、グループに権限付与ポリシーがアタッチされていないことを確認する必要があります。
  • グループを削除する前に、グループにユーザーが含まれていないことを確認する必要があります。

リクエストパラメータ

Action
  • データ型:String
  • 必須項目:はい
  • 説明:操作の名称。 値:
    DeleteGroup
GroupName
  • データ型:String
  • 必須項目:はい
  • 説明:グループの名称。 例:dev。
  • 形式:
    ^[a-zA-Z0-9\-]+$

リターンパラメータ

パブリックパラメーターのみが返されます。 詳細は、次を参照してください。パブリックパラメータ

必要な権限

Action
ram:DeleteGroup
Resource
acs:ram:*:${AccountId}:group/${GroupName}

エラーメッセージ

InvalidParameter.GroupName.InvalidChars
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「GropuName」に無効な文字が含まれています。
InvalidParameter.GroupName.Length
  • HTTPステータスコード: 400
  • エラーメッセージ:パラメータ - 「GroupName」は長さの制限を超えています。
EntityNotExist.Group
  • HTTPステータスコード:404
  • エラーメッセージ:グループは存在しません。
DeleteConflict.Group.User
  • HTTPステータスコード:409
  • エラーメッセージ:グループにユーザーメンバーがいる限り、グループを削除することはできません。
DeleteConflict.Group.Policy
  • HTTPステータスコード:409
  • エンティティにポリシーがアタッチされている限り、グループを削除することはできません。

操作の例

リクエストの例
https://ram.aliyuncs.com/?Action=DeleteGroup
&GroupName=Dev-Team
&<Public request parameters>
戻り値の例
  • XML形式
    <DeleteGroupResponse>
        <RequestId>FCF40AB5-881C-A0F9-334C-B0AD423AA69D</RequestId>
    </DeleteGroupResponse>
  • JSON形式
    
        "RequestId": "FCF40AB5-881C-A0F9-334C-B0AD423AA69D"