Tutorial: Crear informes de aislamiento entre inquilinos (versión preliminar)

Artículo
10/16/2024

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Este tutorial demusetra cómo utilizar la Power Platform API (vista previa) para crear informes de aislamiento entre inquilinos.

En este tutorial, aprenderá a:

Autenticar mediante API Power Platform
Crear un informe
Listar todos los informes del inquilino
Obtener un único informe

Importante

Esta es una característica en versión preliminar.
Las vistas previas de características no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
El nombre del host y los contratos de datos pueden cambiar durante este período de vista previa de la función.
Para obtener más detalles sobre el aislamiento de inquilinos, consulte Restricciones de entrada y salida entre inquilinos.

Paso 1. Autenticar usando la API Power Platform

Utilice el siguiente script de PowerShell para autenticarse mediante la API Power Platform.

Nota

Los usuarios con el rol de ID de entrada Administrador tienen permiso para ejecutar el informe de impacto aislamiento de inquilino. Power Platform

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

Paso 2. Crear un informe

Utilice el siguiente script de PowerShell para crear el informe.

Nota

Solo puede crear un informe por inquilino por día calendario.

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 Referencia de API: Crear informe de conexión entre inquilinos

Paso 3. Mostrar todos los informes del inquilino

Utilice el siguiente script de PowerShell para enumerar todos los informes disponibles para su inquilino.

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
}

Referencia de la API de Power Platform: Obtener informe de conexión entre inquilinos

Paso 4. Obtener un único informe

Utilice el siguiente script de PowerShell para obtener un informe único para su inquilino sobre las conexiones utilizadas dentro del inquilino.

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
}

Referencia de la API de Power Platform: Mostrar informes de conexión entre inquilinos

Consultar también

Power Platform Referencia de API: informes de conexión entre inquilinos

Compartir vía