Pamācība: starpīrnieku izolēšanas atskaišu izveide (priekšskatījums)

Raksts
10/23/2023

[Šis raksts ir pirmsizlaides dokumentācija, kas var mainīties.]

Šajā apmācībā ir parādīts, kā izmantot Power Platform API (priekšskatījumu), lai izveidotu nomnieku savstarpējās izolācijas atskaites.

Šajā apmācībā uzziniet, kā:

Autentificēties, izmantojot Power Platform API
Atskaites izveide
Uzskaitiet visas nomnieka atskaites
Iegūstiet vienu atskaiti

Svarīgi

Šis ir priekšskatījuma līdzeklis.
Priekšskatījuma funkcijas nav paredzētas lietošanai ražošanā, un to funkcionalitāte var būt ierobežota. Šie līdzekļi ir pieejami pirms oficiālā laidiena, lai klienti varētu priekšlaikus piekļūt līdzeklim un sniegt atsauksmes.
Resursdatora nosaukums un datu līgumi var mainīties šī līdzekļa priekšskatījuma periodā.
Papildinformāciju par nomnieka izolāciju skatiet rakstā Ienākošie un izejošie ierobežojumi, kas saistīti ar nomniekiem.

1. darbība. Autentificēties, izmantojot Power Platform API

Izmantojiet tālāk norādīto PowerShell skriptu, lai autentificētos, izmantojot Power Platform API.

Piezīmes

Tikai lietotājiem ar globālā administratora un Power Platform administratora Entra ID lomām ir atļauja palaist nomnieka izolācijas ietekmes pārskatu.

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

2. darbība. Atskaites izveide

Lai izveidotu atskaiti, izmantojiet tālāk norādīto PowerShell skriptu.

Piezīmes

Katram nomniekam kalendārajā dienā var izveidot tikai vienu atskaiti.

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 API atsauce: Izveidot starpnomnieku savienojuma atskaiti

3. darbība. Uzskaitiet visas nomnieka atskaites

Izmantojiet šo PowerShell skriptu, lai uzskaitītu visas nomniekam pieejamās atskaites.

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 API atsauce: Iegūt starpnomnieku savienojuma atskaiti

4. darbība. Iegūstiet vienu atskaiti

Izmantojiet šo PowerShell skriptu, lai nomniekam iegūtu vienu atskaiti par nomniekā izmantotajiem savienojumiem.

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 API atsauce: Saraksts starp nomnieku savienojuma atskaitēm

Skatiet arī:

Power Platform API atsauce — nomnieku savstarpējo savienojumu atskaites

Kopīgot, izmantojot