기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# GenerateEmbedUrlForAnonymousUser
<a name="API_GenerateEmbedUrlForAnonymousUser"></a>

Amazon을 임베드하는 데 사용할 수 있는 임베드 URL을 생성합니다. QuickSight 독자 사용자를 등록하지 않고도 웹 사이트의 대시 보드를 사용할 수 있습니다. 이 작업을 사용하기 전에 대시보드 및 권한을 구성했는지 확인합니다.

생성된 URL에는 다음 규칙이 적용됩니다.
+ 여기에는 임시 베어러 토큰이 포함되어 있습니다. 생성 후 5분 동안 유효합니다. 이 기간 내에 사용한 후에는 다시 사용할 수 없습니다.
+ URL 유효 기간을 사용하여 사용자 지정할 수 있는 실제 세션 수명과 혼동해서는 안 됩니다.` [SessionLifetimeInMinutes](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html#QS-GenerateEmbedUrlForAnonymousUser-request-SessionLifetimeInMinutes) `파라미터. 결과 사용자 세션은 15분 (최소) 에서 10시간 (최대) 까지 유효합니다. 기본 세션 지속 시간은 10시간입니다.
+ URL이 사용되거나 Amazon과 상호 작용할 때만 요금이 부과됩니다. QuickSight.

자세한 내용은 단원을 참조하십시오.[내장 분석](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics.html)의*아마존 QuickSight 사용 설명서*.

임베딩을 위한 개략적인 단계에 대한 자세한 내용과 임베딩을 사용자 지정하는 방법에 대한 대화형 데모를 보려면[아마존 QuickSight 개발자 포털](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-portal.html).

## 요청 구문
<a name="API_GenerateEmbedUrlForAnonymousUser_RequestSyntax"></a>

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

{
   "AllowedDomains": [ "string" ],
   "AuthorizedResourceArns": [ "string" ],
   "ExperienceConfiguration": { 
      "Dashboard": { 
         "InitialDashboardId": "string"
      }
   },
   "Namespace": "string",
   "SessionLifetimeInMinutes": number,
   "SessionTags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}
```

## URI 요청 파라미터
<a name="API_GenerateEmbedUrlForAnonymousUser_RequestParameters"></a>

요청은 다음의 URI 파라미터를 사용합니다.

 ** [AwsAccountId](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AwsAccountId"></a>
의 IDAWS 계정여기에는 내장하려는 대시보드가 포함되어 있습니다.  
길이 제약 조건: 고정 길이는 12입니다.  
패턴: `^[0-9]{12}$`   
: 예

## 요청 본문
<a name="API_GenerateEmbedUrlForAnonymousUser_RequestBody"></a>

요청은 JSON 형식의 다음 데이터를 받습니다.

 ** [AuthorizedResourceArns](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AuthorizedResourceArns"></a>
Amazon 리소스 이름 (ARN) QuickSight 사용자가 세션 수명 동안 액세스할 수 있는 권한이 있는 리소스 선택 항목`Dashboard`내장 경험에서 사용자가 볼 수 있도록 하려는 계정의 대시보드 ARN 목록을 전달합니다. 현재 각 API 호출에서 최대 25개의 대시보드 ARN을 전달할 수 있습니다.  
Type: 문자열 배열  
: 예

 ** [ExperienceConfiguration](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-ExperienceConfiguration"></a>
내장하려는 경험의 구성입니다.  
유형: [AnonymousUserEmbeddingExperienceConfiguration](API_AnonymousUserEmbeddingExperienceConfiguration.md) 객체  
: 예

 ** [Namespace](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-Namespace"></a>
더 Amazon QuickSight 익명 사용자가 가상으로 속한 네임스페이스입니다. 아마존을 사용하지 않는 경우 QuickSight 사용자 지정 네임스페이스, 설정`default`.  
Type: 문자열  
길이 제약 조건: 최대 길이 64.  
패턴: `^[a-zA-Z0-9._-]*$`   
: 예

 ** [AllowedDomains](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-AllowedDomains"></a>
생성된 URL에 액세스하기 위해 허용 목록에 추가할 도메인입니다. 이 선택적 매개 변수는 Manage에서 구성된 정적 도메인을 재정의합니다. QuickSight 아마존 메뉴 QuickSight 콘솔. 대신 이 매개 변수에 포함하는 도메인만 허용합니다. 각 API 호출에 최대 3개의 도메인 또는 하위 도메인을 나열할 수 있습니다.  
특정 도메인 아래의 모든 하위 도메인을 허용 목록에 포함하려면`*`. 예,`https://*.sapp.amazon.com`아래에 모든 하위 도메인 포함`https://sapp.amazon.com`.  
Type: 문자열 배열  
: 아니요

 ** [SessionLifetimeInMinutes](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-SessionLifetimeInMinutes"></a>
세션이 유효한 시간 (분) 입니다. 세션 수명은 [15-600] 분 범위여야 합니다.  
Type: Long  
유효 범위: 최소값 15입니다. 최대값 600입니다.  
: 아니요

 ** [SessionTags](#API_GenerateEmbedUrlForAnonymousUser_RequestSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-request-SessionTags"></a>
행 수준 보안에 사용되는 세션 태그. 이 매개 변수를 사용하기 전에 다음 사항을 사용하여 관련 데이터 세트를 구성했는지 확인합니다.`DataSet$RowLevelPermissionTagConfiguration`매개 변수를 사용하여 세션 태그를 사용하여 행 수준 보안을 제공할 수 있습니다.  
다음에 사용되는 태그가 아닙니다.AWS리소스 태그 지정 기능. 자세한 내용은 단원을 참조하십시오.[태그로 행 수준 보안 (RLS) 사용](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-rls-tags.html)의*아마존 QuickSight 사용 설명서*.  
Type: 어레이[SessionTag](API_SessionTag.md)사물  
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수 50개.  
: 아니요

## 응답 구문
<a name="API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax"></a>

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

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

## 응답 요소
<a name="API_GenerateEmbedUrlForAnonymousUser_ResponseElements"></a>

작업이 성공하면 서비스가 다음 HTTP 응답을 다시 전송합니다.

 ** [Status](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-response-Status"></a>
요청의 HTTP 상태입니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

 ** [EmbedUrl](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-response-EmbedUrl"></a>
대시보드의 임베드 URL입니다.  
Type: 문자열

 ** [RequestId](#API_GenerateEmbedUrlForAnonymousUser_ResponseSyntax) **   <a name="QS-GenerateEmbedUrlForAnonymousUser-response-RequestId"></a>
이AWS작업에 대한 요청 ID.  
Type: 문자열

## 오류
<a name="API_GenerateEmbedUrlForAnonymousUser_Errors"></a>

모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.[일반적인 오류](CommonErrors.md).

 ** AccessDeniedException **   
이 항목에 액세스할 수 없습니다. 제공된 자격 증명을 검증할 수 없습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 서비스, 정책 및 올바른 액세스 키를 사용하고 있는지 확인합니다.  
HTTP 상태 코드: 401

 ** InternalFailureException **   
내부 실패가 발생했습니다.  
HTTP 상태 코드: 500

 ** InvalidParameterValueException **   
하나 이상의 매개변수에 유효하지 않은 값이 있습니다.  
HTTP 상태 코드: 400

 ** ResourceNotFoundException **   
하나 이상의 리소스를 찾을 수 없습니다.  
HTTP 상태 코드: 404

 ** SessionLifetimeInMinutesInvalidException **   
세션 수명 동안 지정된 시간 (분) 이 유효하지 않습니다. 세션 수명은 15-600분이어야 합니다.  
HTTP 상태 코드: 400

 ** ThrottlingException **   
액세스가 제한되었습니다.  
HTTP 상태 코드: 429

 ** UnsupportedPricingPlanException **   
이 오류는 Amazon에서 임베딩 작업을 호출하고 있음을 나타냅니다. QuickSight필요한 요금제 없이AWS계정. 익명 사용자에 대해 임베딩을 사용하기 전에 QuickSight 관리자가 Amazon에 용량 요금을 추가해야 함 QuickSight. 이 작업을 수행할 수 있습니다.**Amazon 관리 QuickSight**페이지.  
용량 가격이 추가된 후 다음을 사용할 수 있습니다.` [GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html) `API 연산`--identity-type ANONYMOUS`옵션.  
HTTP 상태 코드: 403

 ** UnsupportedUserEditionException **   
이 오류는 아마존에서 작업을 호출하고 있음을 나타냅니다. QuickSight구독: 에디션에는 해당 작업에 대한 지원이 포함되어 있지 않습니다. Amazon Amazon QuickSight 현재 스탠다드 에디션과 엔터프라이즈 에디션이 있습니다. 모든 에디션에서 모든 작동 및 기능을 사용할 수 있는 것은 아닙니다.  
HTTP 상태 코드: 403

## 참고 항목
<a name="API_GenerateEmbedUrlForAnonymousUser_SeeAlso"></a>

이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWSSDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GenerateEmbedUrlForAnonymousUser)