機械翻訳について
  1. ドキュメント用REST API
  2. タスク
  3. 共有

ユーザーの失効

delete

/documents/api/1.2/shares/{folderId}/user

共有フォルダに対するユーザーの、またはグループのアクセス権を削除します。

リクエスト

サポートされるメディア・タイプ
パス・パラメータ

  • フォルダのグローバル一意識別子(GUID)。 参照されるフォルダがユーザーのホーム・フォルダの場合、folderIdの値はselfです。

問合せパラメータ
  • ユーザーに送信されるオプションのメッセージ。
  • ユーザーのグローバル一意識別子(GUID)。ユーザーのログイン名、グループのGUID、または前述のカンマ区切りリスト(合計ID 1000以下)です。
トップに戻る

レスポンス

サポートされるメディア・タイプ

200レスポンス

リクエストが処理されました。

本文 ()
ルート・スキーマ: ShareDeleteUserResponse
タイプ: object
レスポンス本文には、ユーザー失効操作に関する情報が含まれます。
ソースを表示
ネストされたスキーマ: members
タイプ: array
現在のリクエストでロールが取り消されるユーザーまたはグループ。
ソースを表示
ネストされたスキーマ: items
タイプ: object
ソースを表示
  • ユーザーまたはグループの区切り名。
  • リクエスト本文userIDパラメータに指定されたユーザーまたはグループ識別子。
  • このメンバーの削除が成功したかどうか。(1)は成功、(0)は失敗を示します。

  • ユーザーのプロビジョニング・ステータス:

    • アクティブ: Oracle Content Managementアプリケーション・ロールが割り当てられたアクティブなユーザー
    • 非アクティブ: 現在コンテンツ管理アプリケーション・ロールが割り当てられていないユーザー。
    • 削除済: IAM/IDCSアイデンティティ・ドメインにすでに存在しないユーザー。
    • 保留中: 招待されたが、IAM/IDCSアイデンティティ・ドメインにまだ存在しない外部ユーザー。

    タイプがgroupの場合、返されません。

  • メンバー・タイプには、userまたはgroupという値があります。
レスポンスの例(application/json)
{
    "errorCode":"0",
    "id":"F1321DC48E3B123D02DBEE88T0000000000100000001",
    "members":[
        {
            "id":"U7ECC74059E0FEDFEC66BF5AT00000000001",
            "displayName":"User BB",
            "type":"user",
            "isSuccessful":"1",
            "provisioningStatus":"active"
        }
    ],
    "type":"share",
    "user":{
        "id":"U7ECC74059E0FEDFEC66BF5AT00000000001",
        "displayName":"User BB",
        "type":"user"
    }
}

400レスポンス

リクエスト・パラメータが正しい形式ではありません。

403レスポンス

ユーザーにマネージャ権限がない場合、または1つ以上のユーザーまたはグループの削除に問題がある場合は禁止されています。

404レスポンス

フォルダIDが見つかりません。

トップに戻る

例

次の例では、指定したユーザーについて、指定したフォルダへのアクセス権を削除します。

DELETE .../shares/F1321DC48E3B123D02DBEE88T0000000000100000001/user?userID=U7ECC74059E0FEDFEC66BF5AT00000000001&message=removing your access to this shared folder

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
  "errorCode": "0",
  "id": "F1321DC48E3B123D02DBEE88T0000000000100000001",
  "members": [
    {
      "id": "U6A0B35B0548F250914D18FDB5D17B95F470",
      "displayName": "User BB",
      "type": "user",
      "isSuccessful": "1",
      "provisioningStatus": "active"
    }
  ],
  "type": "share",
  "user": {
    "displayName": "User BB",
    "loginName": "userBBLoginName",
    "id": "U7ECC74059E0FEDFEC66BF5AT00000000001",
    "type": "user"
  }
}

例2

次の例は、userIDパラメータがリクエスト本文から欠落しているため、エラーを戻します。 

DELETE .../shares/F2CD745706AEC8BD04260B2F45B3E9DD64907CA0D19F/user?message=revoke share

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 400

JSONレスポンス

{
    "errorCode": "-97",
    "errorKey": "!csUnableToRemoveSharedUser!csRequiredServiceParameterMissing,dUserID,REVOKE_SHARED_USER",
    "errorMessage": "Failed to remove shared user on folder. Parameter 'dUserID' required by service REVOKE_SHARED_USER is missing.",
    "errorType": "share",
    "id": "F2CD745706AEC8BD04260B2F45B3E9DD64907CA0D19F",
    "title": "Failed to remove shared user on folder. Parameter 'dUserID' required by service REVOKE_SHARED_USER is missing.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例3

次の例では、フォルダIDが無効なためにエラーが返されます。

DELETE .../shares/FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F/user?userID=U5C4D5FCE14F2B44946FA74745B3E9DD6490

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 404

JSONレスポンス

{
    "errorCode": "-16",
    "errorKey": "!csUnableToRemoveSharedUser!csSecurityValidationFailed!csFldDoesNotExist,FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F!csUnprivilegedSystemError",
    "errorMessage": "Failed to remove shared user on folder. Security validation failed. 'FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F' does not exist. The error was caused by an internally generated issue. The error has been logged.",
    "errorType": "share",
    "id": "FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F",
    "title": "Failed to remove shared user on folder. Security validation failed. 'FDDD745706AEC8BD04260B2F45B3E9DD64907CA0D19F' does not exist. The error was caused by an internally generated issue. The error has been logged.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html",
    "user": {
        "id": "U5C4D5FCE14F2B44946FA74745B3E9DD6490",
        "type": "user"
    }
}

例4

次の例では、指定したユーザーおよびグループの指定したフォルダへのアクセス権を削除します。

DELETE .../shares/F1321DC48E3B123D02DBEE88T0000000000100000001/user?userID=U7ECC74059E0FEDFEC66BF5AT00000000001,GS18003&message=removing your access to this shared folder

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
  "errorCode": "0",
  "id": "F1321DC48E3B123D02DBEE88T0000000000100000001",
  "members": [
    {
      "id": "U6A0B35B0548F250914D18FDB5D17B95F470",
      "displayName": "User BB",
      "type": "user",
      "isSuccessful": "1",
      "provisioningStatus": "active"
    },
    {
      "id": "GS18003",
      "displayName": "Sales Group",
      "type": "group",
      "isSuccessful": "1",
      "provisioningStatus": "active"
    }
  ],
  "type": "share",
  "user": {
    "id": "U6A0B35B0548F250914D18FDB5D17B95F470,GS18003",
    "type": "user"
  }
}
先頭に戻る