Kurz: Vytvorenie zostáv o izolácii medzi nájomníkmi (verzia Preview)

Článok
07/26/2024

[Tento článok je predbežnou dokumentáciou a môže sa zmeniť.]

Tento tutoriál ukazuje, ako používať Power Platform API (verzia Preview) na vytváranie krížových prehľadov izolácia nájomníka.

V tomto návode sa dozviete, ako:

Overte sa pomocou Power Platform API
Vytvorte prehľad
Uveďte všetky prehľady pre nájomcu
Získajte jeden prehľad

Dôležité

Toto je ukážková funkcia.
Funkcie verzie Preview nie sú určené na produkčné účely a môžu mať obmedzenú funkčnosť. Tieto funkcie sú k dispozícii pred oficiálnym vydaním, aby k nim mohli zákazníci získať rýchly prístup a poskytnúť odozvu.
Názov hostiteľa a zmluvy o údajoch sa môžu počas tohto obdobia verzia Preview zmeniť.
Ďalšie podrobnosti o izolácia nájomníka nájdete v časti Obmedzenia prichádzajúcich a odchádzajúcich medzi viacerými nájomníkmi.

Krok č. 1: Overte sa pomocou Power Platform API

Na overenie pomocou rozhrania Power Platform API použite nasledujúci skript PowerShell.

Poznámka

Používatelia s rolou Power Platform administrátora Entra ID majú povolenie spustiť správu o vplyve izolácia nájomníka.

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. Vytvorte prehľad

Na vytvorenie zostavy použite nasledujúci skript PowerShell.

Poznámka

Môžete vytvoriť iba jednu zostavu na nájomníka za kalendárny deň.

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 Odkaz na rozhranie API: Vytvorte správu o pripojení medzi nájomníkmi

Krok č. 3. Uveďte všetky prehľady pre nájomcu

Pomocou nasledujúceho skriptu PowerShell zobrazíte zoznam všetkých dostupných zostáv pre vášho nájomníka.

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 Odkaz na rozhranie API: Získajte správu o pripojení medzi nájomníkmi

Krok č. 4. Získajte jeden prehľad

Pomocou nasledujúceho skriptu PowerShell načítajte pre svojho nájomníka jednu správu o pripojeniach používaných v rámci nájomníka.

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 Odkaz na rozhranie API: Vypíšte prehľady o pripojení medzi nájomníkmi

Pozrite si tiež

Power Platform Referenčné rozhranie API – Správy o pripojení medzi nájomníkmi

Zdieľať cez