Opetusohjelma: Vuokraajien välisten eristysraporttien luominen (esiversio)

Artikkeli
10/16/2024

[Tämä artikkeli sisältää julkaisua edeltävää materiaalia ja voi muuttua.]

Tässä opetusohjelmassa näet, miten luodaan vuokraajien välisiä eristysraportteja Power Platform -ohjelmointirajapinnan (esiversio) avulla.

Tässä opetusohjelmassa opit tekemään seuraavat toiminnot:

Todennus API:n avulla Power Platform
Raportin luominen
Luettele kaikki vuokraajan raportit
Yhden raportin noutaminen

Tärkeää

Tämä on esiversiotoiminto.
Esiversiotoimintoja ei ole tarkoitettu tuotantokäyttöön, ja niiden toiminnot voivat olla rajoitettuja. Nämä toiminnot ovat käytettävissä ennen virallista julkaisua, jotta asiakkaat voivat käyttää niiden ennakkojulkaisua ja antaa palautetta.
Isäntänimi ja tietosopimukset voivat muuttua tämän ominaisuuden esiversiojakson aikana.
Lisätietoja vuokraajan eristyksestä: Vuokraajien välisen saapuvan ja lähtevän liikenteen rajoitukset.

Vaihe 1. Todenna käyttäen Power Platform -ohjelmointirajapintaa

Voit todentaa Power Platform -ohjelmointirajapinnan avulla seuraavan PowerShell-skriptin avulla.

Muistiinpano

Käyttäjillä Järjestelmänvalvoja joilla on Entra ID -rooli, Power Platform on oikeus suorittaa vuokraajan eristys vaikutusraportti.

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

Vaihe 2. Raportin luominen

Luo raportti seuraavan PowerShell-skriptin avulla.

Huomautus

Voit luoda vain yhden raportin vuokraajaa ja kalenteripäivää kohti.

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 -ohjelmointirajapinnan viite: Vuokraajien välisen yhteysraportin luominen

Vaihe 3. Vuokraajan kaikkien raporttien luettelo

Seuraavan PowerShell-komentosarjan avulla voit luetteloida kaikki vuokraajan käytettävissä olevat raportit.

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 -ohjelmointirajapinnan viite: Vuokraajien välisen yhteysraportin hakeminen

Vaihe 4. Yksittäisen raportin hakeminen

Seuraavan PowerShell-komentosarjan avulla voit noutaa vuokraajan yksittäisen raportin vuokraajan yhteyksistä.

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 -ohjelmointirajapinnan viite: Vuokraajien välisten yhteysraporttien listaus

Katso myös

Power Platform API-viite – vuokraajien välisten yhteyksien raportit

Jaa