[プレビュー] 特定のグループを削除する

組織およびグループ ID に基づいて、組織内の指定したグループを削除します。

API エンドポイント

https://{yourDomain}/identity/api/Group/{partitionGlobalId}/{groupId}

スコープ

次のスコープが必要です。

• PM.Group
• PM.Group.Write

要求ヘッダー

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'

注: {access_token} を取得するには、必ずこちらで説明するいずれかの方法で認証を行ってください。

パス パラメーター

パス パラメーター	データ型	説明
partitionGlobalId (必須)	文字列	グループの削除元の組織の ID です。
groupId (必須)	文字列	削除するグループの ID です。

応答

204 Success

指定したグループが組織から削除されます。

要求の例

API 呼び出しの構築に必要な情報をすべて収集したとします。

• {baseURL} は https://{yourDomain}/{organizationName}/{tenantName}/ です。
• {access_token} は 1234 です (長さを考慮)。
• {partitionGlobalId} は magic-7 です。
• {groupId} は 2512 です。

呼び出しは以下のようになります (cURL)。

curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/Group/magic-7/2512' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'