Руководство по созданию отчетов об изоляции между клиентами

В этом руководстве показано, как использовать средства программирования для создания отчетов об изоляции между клиентами.

Из этого руководства вы узнаете, как:

• Создание отчета
• Список всех отчетов для клиента
• Извлечение одного отчета

Внимание!

Дополнительные сведения об изоляции клиентов см. в разделе Ограничения входящего и исходящего трафика между клиентами.

Создание отчета

Используйте следующие сведения, чтобы найти различные способы создания нового отчета.

Заметка

Вы можете создать только один отчет для каждого клиента за календарный день.

Power Automate / Logic Apps

Добавьте новое действие на холст, найдите "Создание запроса для создания отчета о подключении между клиентами или возврата существующего отчета". Нет необходимых параметров.

PowerShell

Используйте следующий сценарий PowerShell, чтобы создать отчет.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

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
}

Справочник по API Power Platform: создание отчета о подключении между клиентами

Список всех отчетов для клиента

Power Automate / Logic Apps

Добавьте новое действие на холст, найдите "Список отчетов о подключении между клиентами". Нет необходимых параметров.

PowerShell

Используйте следующий сценарий PowerShell, чтобы вывести список всех доступных отчетов для вашего клиента.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

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
}

Справочник по API Power Platform: получение отчета о подключении между клиентами

Извлечение одного отчета

Power Automate / Logic Apps

Добавьте новое действие на холст, выполнив поиск по запросу "Получить отчет о подключении между клиентами по идентификатору отчета". Укажите идентификатор отчета из предыдущих шагов.

PowerShell

Используйте следующий сценарий PowerShell, чтобы получить для вашего клиента единый отчет о подключениях, используемых внутри клиента.

Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '<client id of your Microsoft Entra ID application registration>' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}

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
}

Справочник по API Power Platform: вывод списка отчетов о подключении между клиентами

Связанный контент

Справочник по API Power Platform — отчеты о подключении между клиентами