グループを削除する
delete
/oaa-policy/group/v1/{groupid}
グループの削除API
リクエスト
パス・パラメータ
- groupid(required): string
グループの一意のグローバル識別子
この操作にはリクエスト本文はありません。
先頭に戻るレスポンス
サポートされるメディア・タイプ
- application/xml
- application/json
200レスポンス
グループが削除されました
ルート・スキーマ: GroupResponse
型:
object
グループのレスポンス・オブジェクト
ソースの表示
-
group: object schema
新しいグループ構造を定義します
-
groupid: string
グループの一意キー。
-
message: string
リクエストのステータスに関連するメッセージ
-
status: string
リクエストのステータス
ネストされたスキーマ: schema
型:
object
新しいグループ構造を定義します
ソースの表示
-
agentid: string
グループを所有するエージェントの識別子。
-
description: string
グループの説明。
-
groupid(required): string
グループの一意の識別子。
-
groupname(required): string
システム内のグループの一意の名前。
-
grouptype(required): string
グループのタイプ。ユーザーID、汎用文字列、アクション、IP範囲、IPのいずれかです
-
values: array values
グループ内の要素の値。値はグループのタイプによって異なります。
ネストされたスキーマ: items
型:
object
401レスポンス
未認可
405レスポンス
無効な入力
ルート・スキーマ: GroupResponse
型:
object
グループのレスポンス・オブジェクト
ソースの表示
-
group: object schema
新しいグループ構造を定義します
-
groupid: string
グループの一意キー。
-
message: string
リクエストのステータスに関連するメッセージ
-
status: string
リクエストのステータス
ネストされたスキーマ: schema
型:
object
新しいグループ構造を定義します
ソースの表示
-
agentid: string
グループを所有するエージェントの識別子。
-
description: string
グループの説明。
-
groupid(required): string
グループの一意の識別子。
-
groupname(required): string
システム内のグループの一意の名前。
-
grouptype(required): string
グループのタイプ。ユーザーID、汎用文字列、アクション、IP範囲、IPのいずれかです
-
values: array values
グループ内の要素の値。値はグループのタイプによって異なります。
ネストされたスキーマ: items
型:
object
500レスポンス
内部サーバー・エラー
503レスポンス
サービス使用不可
例
次の例は、グループを削除するサンプルのリクエストとレスポンスを示します。
JSON形式でグループを削除するcURLコマンド
curl --location --request DELETE '<PolicyUrl>/oaa-policy/group/v1/140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'
JSON形式のサンプル・レスポンス
{ "status": "200", "message": "Group deleted", "groupid": "140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608", "group": { "groupid": "140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608", "agentid": "dede64d3-1d6a-42e9-89e1-714e88f8967c", "grouptype": "Actions", "groupname": "FactorRuleGrp2", "description": "Group to set factors" } }
XML形式でグループを削除するcURLコマンド
curl --location --request DELETE '<PolicyUrl>/oaa-policy/group/v1/140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608' \ --header 'Content-Type: application/xml' \ --header 'Accept: application/xml' \ --header 'Authorization: Basic <Base64Encoded(<username>:<password>)>'
XML形式のサンプル・レスポンス
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <GroupResponse> <status>200</status> <message>Group deleted</message> <groupid>140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608</groupid> <group> <groupid>140_b6b25bc75ffae259297e85b5b0a82483bc4e806dd8c7e278a00a134a0474a608</groupid> <agentid>dede64d3-1d6a-42e9-89e1-714e88f8967c</agentid> <grouptype>Actions</grouptype> <groupname>FactorRuleGrp2</groupname> <description>Group to set factors</description> </group> </GroupResponse>