Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# GenerateEmbedUrlForRegisteredUser
<a name="API_GenerateEmbedUrlForRegisteredUser"></a>

Genera una URL de inserción que puedes usar para insertar un Amazon QuickSight experiencia en tu sitio web. Esta acción se puede utilizar para cualquier tipo de usuario registrado en Amazon QuickSight account. Antes de realizar esta acción, asegúrese de que ha configurado Amazon correspondiente QuickSight recursos y permisos.

Las siguientes reglas se aplican a la URL generada:
+ Contiene un token de portador temporal. Es válido durante 5 minutos después de su generación. Una vez canjeado dentro de este período, no se puede volver a utilizar.
+ El período de validez de la URL no debe confundirse con la duración real de la sesión, que se puede personalizar mediante la` [SessionLifetimeInMinutes](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html#QS-GenerateEmbedUrlForRegisteredUser-request-SessionLifetimeInMinutes) `parámetro.

  La sesión de usuario resultante es válida durante 15 minutos (mínimo) a 10 horas (máximo). La duración predeterminada de la sesión es de 10 horas.
+ Solo se te cobrará cuando se utilice la URL o haya interacción con Amazon QuickSight.

Para obtener más información, consulte[Análisis incrustados](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics.html)en la*Amazon QuickSight Guía del usuario de*.

Para obtener más información sobre los pasos de alto nivel para la incrustación y para obtener una demostración interactiva de las formas en que puede personalizar la incrustación, visite la[Amazon QuickSight Portal para desarrolladores](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-portal.html).

## Sintaxis de la solicitud
<a name="API_GenerateEmbedUrlForRegisteredUser_RequestSyntax"></a>

```
POST /accounts/AwsAccountId/embed-url/registered-user HTTP/1.1
Content-type: application/json

{
   "AllowedDomains": [ "string" ],
   "ExperienceConfiguration": { 
      "Dashboard": { 
         "InitialDashboardId": "string"
      },
      "QSearchBar": { 
         "InitialTopicId": "string"
      },
      "QuickSightConsole": { 
         "InitialPath": "string"
      }
   },
   "SessionLifetimeInMinutes": number,
   "UserArn": "string"
}
```

## Parámetros de solicitud del URI
<a name="API_GenerateEmbedUrlForRegisteredUser_RequestParameters"></a>

La solicitud utiliza los siguientes parámetros URI.

 ** [AwsAccountId](#API_GenerateEmbedUrlForRegisteredUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-request-AwsAccountId"></a>
El ID para elCuenta de AWSque contiene el panel que va a insertar.  
Requisitos de longitud: Longitud fija de 12 caracteres.  
Patrón: `^[0-9]{12}$`   
Obligatorio: Sí

## Cuerpo de la solicitud
<a name="API_GenerateEmbedUrlForRegisteredUser_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ExperienceConfiguration](#API_GenerateEmbedUrlForRegisteredUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-request-ExperienceConfiguration"></a>
La experiencia que está incorporando. Para los usuarios registrados, puede incrustar Amazon QuickSight paneles de control o toda la Amazonía QuickSight consola de .  
Tipo: objeto [RegisteredUserEmbeddingExperienceConfiguration](API_RegisteredUserEmbeddingExperienceConfiguration.md)  
Obligatorio: Sí

 ** [UserArn](#API_GenerateEmbedUrlForRegisteredUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-request-UserArn"></a>
El nombre del recurso de Amazon para el usuario registrado.  
Type: Cadena  
Obligatorio: Sí

 ** [AllowedDomains](#API_GenerateEmbedUrlForRegisteredUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-request-AllowedDomains"></a>
Los dominios que desea agregar a la lista de permitidos para acceder a la URL generada que luego se incrusta. Este parámetro opcional anula los dominios estáticos que se configuran en Administrar QuickSight menú en el Amazonas QuickSight consola de . En cambio, solo permite los dominios que se incluyen en este parámetro. Puedes enumerar hasta tres dominios o subdominios en cada llamada a la API.  
Para incluir todos los subdominios de un dominio específico en la lista de permitidos, usa`*`. Por ejemplo,`https://*.sapp.amazon.com`incluye todos los subdominios en`https://sapp.amazon.com`.  
Type: Matriz de cadenas  
Obligatorio: No

 ** [SessionLifetimeInMinutes](#API_GenerateEmbedUrlForRegisteredUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-request-SessionLifetimeInMinutes"></a>
Cuántos minutos es válida la sesión. La vida útil de la sesión debe ser un valor comprendido entre 15 y 600 minutos.  
Type: Largo  
Rango válido: Valor mínimo de 15. Valor máximo de 600.  
Obligatorio: No

## Sintaxis de la respuesta
<a name="API_GenerateEmbedUrlForRegisteredUser_ResponseSyntax"></a>

```
HTTP/1.1 Status
Content-type: application/json

{
   "EmbedUrl": "string",
   "RequestId": "string"
}
```

## Elementos de respuesta
<a name="API_GenerateEmbedUrlForRegisteredUser_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve la siguiente respuesta HTTP.

 ** [Status](#API_GenerateEmbedUrlForRegisteredUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-response-Status"></a>
El estado HTTP de la solicitud.

El servicio devuelve los datos siguientes en formato JSON.

 ** [EmbedUrl](#API_GenerateEmbedUrlForRegisteredUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-response-EmbedUrl"></a>
La URL incrustada de Amazon QuickSight tablero o consola.  
Type: Cadena

 ** [RequestId](#API_GenerateEmbedUrlForRegisteredUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForRegisteredUser-response-RequestId"></a>
LaAWSID de solicitud para esta operación.  
Type: Cadena

## Errores
<a name="API_GenerateEmbedUrlForRegisteredUser_Errors"></a>

Para obtener información sobre errores que son comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
No tiene permiso de acceso. La credenciales proporcionadas no se pudieron validar. Es posible que no tenga autorización para realizar la solicitud. Asegúrese de que su cuenta esté autorizada para usar Amazon QuickSight , que sus políticas tienen los permisos correctos y que está utilizando las claves de acceso correctas.  
Código de estado HTTP: 401

 ** InternalFailureException **   
Se produjo un error interno.  
Código de estado HTTP: 500

 ** InvalidParameterValueException **   
Uno o más parámetros tienen un valor que no es válido.  
Código de estado HTTP: 400

 ** QuickSightUserNotFoundException **   
No se encuentra el usuario con el nombre proporcionado. Este error puede ocurrir en cualquier operación que requiera la búsqueda de un usuario en función del nombre de usuario proporcionado, como`DeleteUser`,`DescribeUser`y así sucesivamente.  
Código de estado HTTP: 404

 ** ResourceNotFoundException **   
No se encontraron uno o varios recursos.  
Código de estado HTTP: 404

 ** SessionLifetimeInMinutesInvalidException **   
El número de minutos especificado para la vida útil de una sesión no es válido. La vida útil de la sesión debe ser un valor comprendido entre 15 y  
Código de estado HTTP: 400

 ** ThrottlingException **   
El acceso está limitado.  
Código de estado HTTP: 429

 ** UnsupportedPricingPlanException **   
Este error indica que estás llamando a una operación de incrustación en Amazon QuickSightsin el plan de precios exigido en tuAWSaccount. Antes de poder usar la incrustación para usuarios anónimos, se debe QuickSight el administrador necesita añadir precios por capacidad a Amazon QuickSight. Puede hacer esto en la página**Administrar Amazon QuickSight**(Se ha creado el certificado).   
Una vez añadidos los precios de capacidad, puede usar el` [GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html) `Operación API con el`--identity-type ANONYMOUS`opción.  
Código de estado HTTP: 403

 ** UnsupportedUserEditionException **   
Este error indica que está llamando a una operación en Amazon QuickSighten la que la edición no incluye soporte para esa operación. Amazon Amazon Amazon QuickSight actualmente tiene Standard Edition y Enterprise Edition. No todas las operaciones y funciones están disponibles en todas las ediciones.  
Código de estado HTTP: 403

## Véase también
<a name="API_GenerateEmbedUrlForRegisteredUser_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [SDK para Java V2 de AWS](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GenerateEmbedUrlForRegisteredUser)