Въвеждащ курс: Създаване на кръстосани отчети за изолиране на клиент (преглед)

Статия
10/13/2023

[Тази статия е предварителна версия на документацията и подлежи на промяна.]

Този урок демонстрира как да използвате API (предварителен преглед), за да създадете отчети за изолация на Power Platform кръстосани клиенти.

В този урок научете как да:

Удостоверяване с помощта на Power Platform API
Създаване на отчет
Списък на всички справки за клиента
Извличане на един отчет

Важно

Това е функция за предварителен преглед.
Функциите за предварителен преглед не са предназначени за производствена употреба и може да са с ограничена функционалност. Тези функции са достъпни преди официалното издание, за да могат клиентите да получат ранен достъп и да дадат обратна връзка.
Името на хоста и договорите за данни може да се променят по време на този период на визуализация на функции.
За повече подробности относно изолацията на клиента вижте Ограничения за входяща и изходяща връзка между клиенти.

Стъпка 1. Удостоверяване с помощта на Power Platform API

Използвайте следния скрипт на PowerShell, за да се удостоверите с помощта Power Platform на API.

Бележка

Само потребители с роли на глобален администратор и Power Platform администратор Entra ID имат разрешение да изпълняват отчета за въздействието върху изолацията на клиента.

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. Създаване на отчет

Използвайте следния скрипт на PowerShell, за да създадете отчета.

Бележка

Можете да създадете само една справка за клиент за календарен ден.

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: Създаване на отчет за връзка между клиенти

Стъпка 3. Списък на всички справки за клиента

Използвайте следния скрипт на PowerShell, за да изброите всички налични отчети за вашия клиент.

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: Получаване на отчет за връзка между клиенти

Стъпка 4. Извличане на един отчет

Използвайте следния скрипт на PowerShell, за да извлечете единичен отчет за вашия клиент за връзките, използвани в клиента.

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: Списък с отчети за връзка между клиенти

Вижте също

Power Platform Препратка към API - Отчети за връзка между клиенти

Споделяне чрез