Tutorial: Membuat laporan isolasi lintas penyewa (pratinjau)

[Artikel ini adalah dokumentasi prarilis dan dapat berubah.]

Tutorial ini menunjukkan cara menggunakan Power Platform API (pratinjau) untuk membuat laporan isolasi lintas penyewa.

Dalam tutorial ini, pelajari cara:

1. Mengautentikasi menggunakan Power Platform API
2. Membuat laporan
3. Cantumkan semua laporan untuk penyewa
4. Mengambil satu laporan

Penting

• Ini adalah fitur pratinjau.
• Fitur pratinjau tidak dibuat untuk penggunaan produksi dan mungkin memiliki fungsionalitas terbatas. Fitur ini tersedia sebelum rilis resmi agar pelanggan bisa memperoleh akses awal dan memberikan tanggapan.
• Nama host dan kontrak data dapat berubah selama periode pratinjau fitur ini.
• Untuk detail selengkapnya tentang isolasi penyewa, lihat Pembatasan masuk dan keluar lintas penyewa.

Langkah 1. Mengautentikasi menggunakan Power Platform API

Gunakan skrip PowerShell berikut untuk mengautentikasi menggunakan Power Platform API.

Catatan

Hanya pengguna dengan peran Administrator global dan Power Platform administrator Entra ID yang memiliki izin untuk menjalankan laporan dampak isolasi penyewa.

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

Langkah 2. Membuat laporan

Gunakan skrip PowerShell berikut untuk membuat laporan.

Catatan

Anda hanya dapat membuat satu laporan per penyewa per hari kalender.

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
}

Power Platform Referensi API: Membuat Laporan Koneksi Lintas Penyewa

Langkah 3. Cantumkan semua laporan untuk penyewa

Gunakan skrip PowerShell berikut ini untuk mencantumkan semua laporan yang tersedia untuk penyewa Anda.

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
}

Power Platform Referensi API: Dapatkan Laporan Koneksi Lintas Penyewa

Langkah 4. Mengambil satu laporan

Gunakan skrip PowerShell berikut ini untuk mengambil satu laporan untuk penyewa Anda tentang koneksi yang digunakan dalam penyewa.

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
}

Power Platform Referensi API: Daftar Laporan Koneksi Lintas Penyewa

Baca juga

Power Platform Referensi API - Laporan Koneksi Lintas Penyewa