POST api/v1/link/permission/query

特定のリンクのサマリーを取得します。

要求の例

http://hostname:port/api/v1/link/permission/query

 

{

SiteUrls: [Site URL 1, Site URL 2],

Token: null,

PageSize: 10,

LinkType: 32,

Language: en-US

}

応答の例

{

results: [

        {

            id: ID,

            siteId: SiteID,

            selfId: SelfID,

            linkId: LinkID,

            loginName: sharinglinks.selfID.flexible.linkID,

            createTime: 2022-05-30T08:17:52.001Z,

            expireTime: null,

            name: Object01,

            objectUrl: https://tenantname.sharepoint.com/sites/site01/shared documents/general/Object01,

            linkType: Links for Specific External Users,

            shareBy: FNU LNU,

            inheritFrom: null,

            inherittype: Unique,

            shareWith: 1,

            linkUrl: linkUrl: https://tenantname.sharepoint.com/:f:/s/site01/xxx,

            permission: Edit,

            fileType: Folder,

            sensitivityLevel: N/A

        }

],

status: 200,

message: “”,

content: null,

nextToken: {Next Token}

}

要求情報

要素

説明

種類

必須

Language

取得しようとしている情報の言語を設定します。

String

有効な値は次のとおりです。

en-US (英語) (既定)

ja-JP (日本語)

fr-FR (フランス語)

いいえ

SiteUrl

サマリー情報を取得するサイト コレクションの URL を設定します。

String Array

いいえ

Token

100 件以上の結果が出たリクエストの残りの結果を取得するかどうかを設定します。

String

いいえ

PageSize

結果の各ページに表示するリンクの数を設定します。その数は 100 以内で設定する必要があります。

Int

いいえ

LinkType

取得しようとしているリンク タイプを設定します。

Int

有効な値は次のとおりです。

32 (柔軟なリンク)

64 (組織リンク)

128 (匿名リンク)

はい

応答情報

要素

説明

種類

results

id

リンク サマリーの ID

String

siteId

リンクによって共有されているオブジェクトのサイト ID

String

selfId

リンクによって共有されているオブジェクトの selfID

String

linkId

リンク ID

String

loginName

リンクのログイン名

String

createTime

リンクが作成された日時

DateTime

expireTime

リンクの有効期限が切れた日時

匿名リンクでのみ使用できます。

DateTime

name

リンクによって共有されているオブジェクトの名前

String

objectUrl

リンクによって共有されているオブジェクトの URL

String

linkType

リンク タイプ

有効な値は次のとおりです。

32 (柔軟なリンク)

64 (組織リンク)

128 (匿名リンク)

String

shareBy

リンクを作成したユーザー

String

inheritFrom

権限の継承元である親

String

inheritType

権限が継承されているかどうかの状態

String

shareWith

リンクが共有されているユーザーおよびグループの数

Int

linkUrl

リンク URL

String

permission

リンクを共有する権限

String

fileType

リンクで共有されているオブジェクトのタイプ

String

sensitivityLevel

リンクで共有されているオブジェクトの秘密度レベル

String

status

HTTP の応答状態コード

Int

message

エラー メッセージ

String

content

備考です。この要素はこの API で使用されません。既定は null が応答されます。

String

nextToken

このリクエストの残りの結果を得るために使用されるトークンです。

String