Esercitazione: Creazione di report di isolamento tra tenant (anteprima)

Articolo
07/26/2024

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Questa esercitazione dimostra come utilizzare l'API Power Platform (anteprima) per creare report di isolamento tra tenant.

In questa esercitazione, scopri come:

Autenticazione tramite API Power Platform
Crea un report
Elenca tutti i report per l'inquilino
Recupera un singolo report

Importante

Questa è una funzionalità di anteprima.
Le funzionalità di anteprima non sono destinate a essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.
Il nome host e i contratti dati potrebbero cambiare durante questo periodo di anteprima delle funzionalità.
Per ulteriori dettagli sull'isolamento del tenant, vedi Restrizioni in entrata e in uscita tra tenant.

Passaggio 1: Esegui autenticazione tramite API Power Platform

Utilizza il seguente script PowerShell per eseguire l'autenticazione usando l'API Power Platform.

Nota

Gli utenti con il ruolo ID Entra Power Platform amministratore hanno l'autorizzazione a eseguire il report di impatto isolamento del tenant.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '00001111-aaaa-2222-bbbb-3333cccc4444' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Passaggio 2. Creazione di un report

Utilizza il seguente script PowerShell per creare il report.

Nota

Puoi creare un solo report per tenant per giorno di calendario.

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
}

Riferimento API Power Platform: Crea report di connessione tra tenant

Passaggio 3: Elenca tutti i report per il tenant

Utilizza il seguente script di PowerShell per elencare tutti i report disponibili per il tuo tenant.

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
}

Riferimento API Power Platform: Ottieni report di connessione tra tenant

Passaggio 4: Recupera un singolo report

Utilizza il seguente script di PowerShell per recuperare un singolo report per il tuo tenant sulle connessioni utilizzate all'interno del tenant.

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
}

Riferimento API Power Platform: Elenca report di connessione tra tenant

Vedi anche

Power Platform Riferimento API - Rapporti di connessione tra tenant

Condividi tramite