Tutorial: Criar relatórios de isolamento do locatário (versão preliminar)
[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]
Este tutorial demonstra como usar a API do Power Platform (versão preliminar) para criar relatórios cruzados de isolamento do locatário.
Neste tutorial, você aprenderá a:
- Autenticar usando a API do Power Platform
- Criar um relatório
- Listar todos os relatórios do locatário
- Buscar um único relatório
Importante
- Esse é um recurso de versão preliminar.
- A versão preliminar dos recursos não foi criada para uso em ambientes de produção e pode ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
- O nome do host e os contratos de dados podem mudar durante esse período da versão preliminar do recurso.
- Para obter mais detalhes sobre o isolamento de locatário, consulte Restrições de entrada e saída entre locatários.
Etapa 1. Autenticar usando a API do Power Platform
Use o seguinte script do PowerShell para autenticar usando a API do Power Platform.
Observação
Somente usuários com funções de administrador Global e administrador do Power Platform do Entra ID têm permissão para executar o relatório de impacto de isolamento de locatário.
Import-Module "MSAL.PS"
$AuthResult = Get-MsalToken -ClientId '49676daf-ff23-4aac-adcc-55472d4e2ce0' -Scope 'https://api.powerplatform.com/.default'
$Headers = @{Authorization = "Bearer $($AuthResult.AccessToken)"}
Etapa 2. Criar um relatório
Use o seguinte script do PowerShell para criar o relatório.
Observação
Você só pode criar um relatório por locatário por dia do calendário.
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
}
Referência da API do Power Platform: Criar Relatório de Conexão entre Locatários
Etapa 3. Listar todos os relatórios do locatário
Utilize o seguinte script PowerShell para listar todos os relatórios disponíveis para o seu locatário.
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
}
Referência da API do Power Platform: Obter Relatório de Conexão entre Locatários
Etapa 4. Buscar um único relatório
Utilize o seguinte script PowerShell para obter um único relatório para o seu locatário sobre conexões usadas dentro do locatário.
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
}
Referência da API do Power Platform: Listar Relatórios de Conexão entre Locatários
Consulte também
Referência da API do Power Platform - Relatórios de Conexão entre Locatários