チームの permissionGrants を一覧表示する
名前空間: microsoft.graph
チームのすべてのリソース固有のアクセス許可許可を一覧表示します。 この一覧では、チームにアクセスできるMicrosoft Entra アプリと、各アプリの対応する種類のリソース固有のアクセスを指定します。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | TeamsAppInstallation.ReadForTeam、TeamsAppInstallation.ReadWriteSelfForTeam、TeamsAppInstallation.ReadWriteForTeam |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | TeamsAppInstallation.Read.Group*, TeamsAppInstallation.ReadForTeam.All, TeamsAppInstallation.ReadWriteSelfForTeam.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsApp.Read.Group* |
注: * でマークされた権限は、リソース固有の同意を使用します。
HTTP 要求
GET /teams/{team-id}/permissionGrants
オプションのクエリ パラメーター
この操作では、応答をカスタマイズするための OData クエリ パラメーター はサポートされていません。
要求ヘッダー
| ヘッダー | 値 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と承認の詳細については、こちらをご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは 200 OK 応答コードと、応答本文で resourceSpecificPermissionGrant オブジェクトのコレクションを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/teams/14c981a4-dca9-4565-bae6-e13ada8861be/permissionGrants
応答
次の例は応答を示しています。
HTTP/1.1 200 OK
Content-type: application/json
{
"@odata.context": "https://graph.microsoft.com/v1.0/$metadata#permissionGrants",
"value": [
{
"id": "Y2VkZGEyMWUtYTUwZS00ZDI3LWEyZjAtOTk0MTMwMGY3Y2I1IyNDaGF0U2V0dGluZ3MuUmVhZFdyaXRlLkNoYXQjI0FwcGxpY2F0aW9u",
"clientAppId": "fdebf36e-8b3a-4b00-99fb-2e4d1da706d6",
"resourceAppId": "00000003-0000-0000-c000-000000000000",
"clientId": "771b9da9-2260-41eb-a587-4d936e4aa08c",
"permissionType": "Application",
"permission": "TeamMember.Read.Group"
},
{
"id": "Y2VkZGEyMWUtYTUwZS00ZDI3LWEyZjAtOTk0MTMwMGY3Y2I1IyNUZWFtc0FwcEluc3RhbGxhdGlvbi5SZWFkLkNoYXQjI0FwcGxpY2F0aW9u",
"clientAppId": "fdebf36e-8b3a-4b00-99fb-2e4d1da706d6",
"resourceAppId": "00000003-0000-0000-c000-000000000000",
"clientId": "771b9da9-2260-41eb-a587-4d936e4aa08c",
"permissionType": "Application",
"permission": "TeamsTab.Create.Group"
},
{
"id": "ZmNmMGMzNjQtMWY1ZS00MDVjLThiN2QtNjI2YmRmOWQyZjI1IyNDaGF0U2V0dGluZ3MuUmVhZC5DaGF0IyNBcHBsaWNhdGlvbg==",
"clientAppId": "69024002-35ae-4574-a219-f261183580b4",
"resourceAppId": "00000003-0000-0000-c000-000000000000",
"clientId": "74c92190-dc0e-485a-81c6-fdffd4aadfd8",
"permissionType": "Application",
"permission": "TeamMember.Read.Group"
}
]
}