Samouczek: Tworzenie raportów o izolacji między dzierżawami (wersja zapoznawcza)

Artykuł
10/16/2024

[Ten artykuł stanowi wstępną wersję dokumentacji i może ulec zmianie.]

Ten samouczek przedstawia, jak używać interfejsu API Power Platform (wersja zapoznawcza) do tworzenia raportów o izolacji między dzierżawami.

Z tego samouczka dowiesz się, jak wykonywać następujące czynności:

Uwierzytelnianie przy użyciu Power Platform interfejsu API
Tworzenie raportu
Wyświetlanie listy wszystkich raportów dla dzierżawy
Pobieranie pojedynczego raportu

Ważne

Jest to funkcja w wersji zapoznawczej.
Funkcje w wersji zapoznawczej nie są przeznaczone do użytku w środowiskach produkcyjnych i mogą mieć ograniczoną funkcjonalność. Te funkcje są udostępniane przed oficjalnym wydaniem, dzięki czemu klienci mogą szybciej uzyskać do nich dostęp i przekazać opinie na ich temat.
W tym okresie podglądu funkcji może się zmienić nazwa hosta i kontrakty danych.
Aby uzyskać więcej szczegółowych informacji o izolacji dzierżawcy, zobacz informacje o Ograniczeniach przychodzących i wychodzących między dzierżawami.

Krok 1. Uwierzytelniaj przy użyciu API Power Platform

Do utworzenia adresu API Power Platform może służyć następujący skrypt programu PowerShell.

Uwaga

Użytkownicy z rolą Power Platform identyfikatora administratora Entra mają uprawnienia do uruchamiania raportu o wpływie izolacji dzierżawy.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

Krok 2. Tworzenie raportu

Do utworzenia raportu może służyć następujący skrypt programu PowerShell.

Uwaga

W każdy dzień kalendarza można utworzyć tylko jeden raport dla dzierżawcy.

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
}

Odwołanie do interfejsu API Power Platform: Tworzenie raportu połączenia między dzierżawcami

Krok 3. Zawieranie wszystkich raportów dotyczących dzierżawcy

Poniższy skrypt programu PowerShell zawiera listę wszystkich dostępnych raportów dla dzierżawcy.

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
}

Odwołanie do interfejsu API Power Platform: Pobieranie raportu połączenia między dzierżawcami

Krok 4. Pobierz pojedynczy raport

Poniższy skrypt programu PowerShell służy do pobierania pojedynczego raportu dla dzierżawcy w sprawie połączeń używanych w dzierżawie.

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
}

Odwołanie do interfejsu API Power Platform: Lista raportów połączenia między dzierżawcami

Zobacz także

Power Platform Dokumentacja interfejsu API — raporty o połączeniach między dzierżawami

Udostępnij za pośrednictwem