Didacticiel : Créer des rapports d’isolation entre clients
Ce didacticiel montre comment utiliser l’API Power Platform pour créer des rapports d’isolation entre clients.
Dans ce didacticiel, découvrez comment :
- Authentifier à l’aide de l’API Power Platform
- Créer un rapport
- Répertorier tous les rapports pour le client
- Récupérer un seul rapport
Important
Pour plus de détails sur l’isolation du client, consultez Restrictions entrantes et sortantes entre clients.
Étape 1. Authentifier à l’aide de l’API Power Platform
Utilisez le script PowerShell suivant pour authentifier avec l’API Power Platform.
Note
Les utilisateurs disposant du rôle Entra ID d’administrateur Power Platform sont autorisés à exécuter le rapport sur l’impact de l’isolation du client.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
Étape 2. Créer un état
Utilisez le script PowerShell suivant pour créer le rapport.
Note
Vous ne pouvez créer qu’un seul rapport par client et par jour calendaire.
try
{
# Create a cross tenant connections report
$tenantReportCreateResponse = Invoke-RestMethod -Method Post -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers -Body ""
$reportId = $tenantReportCreateResponse.reportId
$reportStatus = $tenantReportCreateResponse.status
Write-Host "Cross tenant connections report created with ID=$reportId and status=$reportStatus"
} catch {
# Dig into the exception to get the Response details.
Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__
Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
$result = $_.Exception.Response.GetResponseStream()
$reader = New-Object System.IO.StreamReader($result)
$reader.BaseStream.Position = 0
$reader.DiscardBufferedData()
$responseBody = $reader.ReadToEnd();
Write-Host $responseBody
}
Référence de l’API Power Platform : Créer un rapport de connexion entre clients
Étape 3. Répertorier tous les rapports pour le client
Utilisez le script PowerShell suivant pour répertorier tous les rapports disponibles pour votre client.
try
{
# Get all available cross tenant connections reports for a tenant
$tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports?api-version=2022-03-01-preview" -Headers $Headers
$report = $tenantListReportResponse | ConvertTo-Json -Depth 3
Write-Host $report
} catch {
# Dig into the exception to get the Response details.
Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__
Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
$result = $_.Exception.Response.GetResponseStream()
$reader = New-Object System.IO.StreamReader($result)
$reader.BaseStream.Position = 0
$reader.DiscardBufferedData()
$responseBody = $reader.ReadToEnd();
Write-Host $responseBody
}
Référence de l’API Power Platform : Obtenir un rapport de connexion entre clients
Étape 4. Récupérer un seul rapport
Utilisez le script PowerShell suivant pour récupérer un rapport unique pour votre client sur les connexions utilisées au sein du client.
try
{
# Get one cross tenant connections report for a tenant
$tenantListReportResponse = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/governance/crossTenantConnectionReports/{$reportId}?api-version=2022-03-01-preview" -Headers $Headers
$report = $tenantListReportResponse | ConvertTo-Json -Depth 2
Write-Host $report
Write-Host ""
} catch {
# Go through the exception to get the Response details.
Write-Host "Response CorrelationId:" $_.Exception.Response.Headers["x-ms-correlation-id"]
Write-Host "StatusCode:" $_.Exception.Response.StatusCode.value__
Write-Host "StatusDescription:" $_.Exception.Response.StatusDescription
$result = $_.Exception.Response.GetResponseStream()
$reader = New-Object System.IO.StreamReader($result)
$reader.BaseStream.Position = 0
$reader.DiscardBufferedData()
$responseBody = $reader.ReadToEnd();
Write-Host $responseBody
}
Référence de l’API Power Platform : Répertorier les rapports de connexion entre clients
Voir aussi
Référence de l’API Power Platform – Rapports de connexion entre clients