Tutorial: Crearea rapoartelor de izolare a entităților găzduite (versiune preliminară)

Articol
10/23/2023

[Acest articol este documentație de prelansare și poate suferi modificări.]

Acest tutorial demonstrează cum să utilizați Power Platform API-ul (previzualizare) pentru a crea rapoarte de izolare între locatari.

În acest tutorial, aflați cum să:

Autentificați-vă folosind Power Platform API
Creați un raport
Listați toate rapoartele pentru chiriaș
Preluați un singur raport

Important

Aceasta este o caracteristică de previzualizare.
Caracteristicile în regim de previzualizare nu sunt destinate utilizării în producție și pot avea funcționalități restricționate. Aceste caracteristici sunt disponibile înainte de lansarea oficială, astfel încât clienții să poată obține acces din timp și să poată oferi feedback.
Numele gazdei și contractele de date se pot schimba în această perioadă de previzualizare a caracteristicilor.
Pentru mai multe detalii despre izolarea chiriașilor, consultați Restricții de intrare și de ieșire între chiriași.

Pasul 1. Autentificați-vă folosind Power Platform API

Utilizați următorul script PowerShell pentru a vă autentifica folosind Power Platform API.

Notă

Numai utilizatorii cu rol de administrator global și Power Platform administrator Entra ID au permisiunea de a rula raportul de impact asupra izolării chiriașilor.

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

Pasul 2. Creați un raport

Utilizați următorul script PowerShell pentru a crea raportul.

Notă

Puteți crea doar un raport pentru fiecare chiriaș pe zi calendaristică.

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 Referință API: Creați un raport de conexiune între chiriași

Pasul 3. Listați toate rapoartele pentru chiriaș

Utilizați următorul script PowerShell pentru a lista toate rapoartele disponibile pentru chiriașul dvs.

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 Referință API: Obțineți raportul de conexiune între chiriași

Pasul 4. Preluați un singur raport

Utilizați următorul script PowerShell pentru a obține un singur raport pentru chiriașul dvs. despre conexiunile utilizate în cadrul chiriașului.

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 Referință API: Listați rapoarte de conexiune între chiriași

Consultați și

Power Platform Referință API - Rapoarte de conexiune între chiriași

Share via