Partager via


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 :

  1. Authentifier à l’aide de l’API Power Platform
  2. Créer un rapport
  3. Répertorier tous les rapports pour le client
  4. 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