Guía de solución de problemas de conectores de informes de impacto (versión preliminar)

Importante

Creación de informes de impacto de Azure se encuentra actualmente en versión preliminar. Consulte Términos de uso complementarios para las versiones preliminares de Microsoft Azure para conocer los términos legales que se aplican a las características de Azure que se encuentran en la versión beta, en versión preliminar o que todavía no se han publicado para que estén disponibles con carácter general.

En esta guía se describen las soluciones a errores comunes a los que se enfrentan al crear un conector de informes de impacto.

El script de Bash produce un error inmediatamente después de iniciarse

Asegúrese de que el script tiene permisos de ejecución. Use este comando para que sea ejecutable. chmod +x create-impact-reporting-connector.sh

En el script de Bash, se produce un error en el inicio de sesión de Azure (no funciona el comando de inicio de sesión az)

Asegúrese de que la CLI de Azure esté instalada y actualizada a la versión más reciente. Intente iniciar sesión manualmente con az login para comprobar si hay más mensajes o errores.

Error "id. de suscripción o ruta de acceso del archivo con la lista de identificadores de suscripción necesarios"

• Bash: asegúrese de que proporciona el argumento --subscription-id o --file-path al ejecutar el script. No proporciones ambos.
  
• PowerShell: asegúrese de proporcionar el parámetro -SubscriptionId o el parámetro -FilePath al invocar el script. No proporciones ambos.

Error "No se pudo encontrar el archivo: [file_path]"

• Bash: compruebe que la ruta de acceso del archivo proporcionada con --file-path existe y es accesible. Asegúrese de que se ha establecido la ruta de acceso correcta.
  
• PowerShell: compruebe que la ruta de acceso del archivo proporcionada con -FilePath existe y es accesible. Asegúrese de usar la ruta de acceso correcta y de que el archivo no esté bloqueado o en uso por otro proceso.

El script no se puede ejecutar con errores de permiso

Asegúrese de que tiene permiso de Colaborador para iniciar sesión en Azure, registrar proveedores de recursos y crear conectores en las suscripciones de Azure. También debe tener el permiso User Access Administrator para crear y asignar roles personalizados.

La ejecución del script se detiene inesperadamente sin completarse

Compruebe si el módulo de Azure PowerShell está instalado y actualizado. Use Update-Module -Name Az para actualizar el módulo de Azure PowerShell. Asegúrese de que $ErrorActionPreference está establecido en Continue temporalmente para omitir errores no críticos.

El registro de características o el espacio de nombres tarda demasiado tiempo o se produce un error

Estas operaciones pueden tardar varios minutos. Asegúrese de que la cuenta de Azure tiene acceso de Colaborador en las suscripciones. Vuelva a ejecutar el script una vez concedido el acceso necesario. Póngase en contacto con el Equipo de conectores de informes de Impacto si el problema persiste.

Error en la creación o asignación de roles personalizados

1. Asegúrese de que la entidad de servicio de Azure AzureImpactReportingConnector existe escribiendo en el cuadro de búsqueda de recursos de Azure como se muestra en la imagen. Si no, espere unos minutos para que se cree. Si no se crea incluso después de una hora, póngase en contacto con el equipo de conectores de informes de impacto.

2. Compruebe que la cuenta tiene el permiso User Access Administrator para crear roles y asignarlos.

La creación del conector tarda demasiado tiempo

El registro del espacio de nombres puede tardar entre 15 y 20 minutos en permitir que se produzca la creación de recursos del conector. Después de 30 minutos, si el script sigue en ejecución, cancele su ejecución y vuelva a ejecutarlo. Si la segunda ejecución también se bloquea, póngase en contacto con el Equipo de conectores de informes de Impacto.

Error en la creación del conector

1. Asegúrese de que el proveedor de recursos Microsoft.Impact está registrado. Puede registrar la suscripción de dos maneras:

   • Desde Azure Portal, vaya a su Subscription -> Resource Providers.
   • Busque Microsoft.Impact y regístrese.
   • Bash: ejecute az provider show -n "Microsoft.Impact" -o json --query "registrationState".
   • PowerShell: ejecute Get-AzResourceProvider -ProviderNamespace Microsoft.Impact.

2. Asegúrese de que las marcas de características: AllowImpactReporting y AzureImpactReportingConnector están registradas en la característica: Microsoft.Impact.

   • Bash
     • az feature list -o json --query "[?contains(name, 'Microsoft.Impact/AllowImpactReporting')].{Name:name,State:properties.state}"
     • az feature list -o json --query "[?contains(name, 'Microsoft.Impact/AzureImpactReportingConnector')].{Name:name,State:properties.state}"
       
   • PowerShell
     • Get-AzProviderFeature -ProviderNamespace "Microsoft.Impact" -FeatureName AzureImpactReportingConnector"
     • Get-AzProviderFeature -ProviderNamespace "Microsoft.Impact" -FeatureName AllowImpactReporting
       

3. Asegúrese de tener acceso de Colaborador a las suscripciones

Esto abarca los escenarios comunes encontrados al incorporar el conector. Para los problemas que no se tratan aquí, póngase en contacto con el Equipo de conectores de informes de Impacto.