기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # GetDashboardEmbedUrl Amazon을 삽입하는 데 사용할 수 있는 임시 세션 URL 및 승인 코드 (전달자 토큰) 를 생성합니다. QuickSight 웹 사이트 또는 애플리케이션의 읽기 전용 대시보드 이 명령을 사용하기 전에 대시보드와 권한을 구성했는지 확인하십시오. 현재 다음 사항을 사용할 수 있습니다.`GetDashboardEmbedURL`사용자의 브라우저가 아닌 서버에서만 가능합니다. 다음 규칙은 생성된 URL에 적용됩니다. + 두 속성을 함께 사용해야 합니다. + 한 번만 사용할 수 있습니다. + 이 명령어는 이 명령을 실행한 후 5분 동안 유효합니다. + URL이 사용되거나 Amazon과 상호 작용할 때만 요금이 부과됩니다. QuickSight. + 결과 사용자 세션은 15분 (기본값) 에서 최대 10시간 (최대) 까지 유효합니다. 선택 사항을 사용할 수 있습니다.`SessionLifetimeInMinutes`매개 변수를 사용하여 세션 기간을 사용자 정의합니다. 자세한 내용은 단원을 참조하십시오.[다음을 사용하여 분석 임베딩 GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-deprecated.html)의*아마존 QuickSight 사용 설명서*. 임베딩을 위한 개략적인 단계에 대한 자세한 내용과 임베딩을 사용자 지정하는 방법에 대한 대화형 데모를 보려면[아마존 QuickSight 개발자 포털](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-dev-portal.html). ## 요청 구문 ``` GET /accounts/{{AwsAccountId}}/dashboards/{{DashboardId}}/embed-url?additional-dashboard-ids={{AdditionalDashboardIds}}&creds-type={{IdentityType}}&namespace={{Namespace}}&reset-disabled={{ResetDisabled}}&session-lifetime={{SessionLifetimeInMinutes}}&state-persistence-enabled={{StatePersistenceEnabled}}&undo-redo-disabled={{UndoRedoDisabled}}&user-arn={{UserArn}} HTTP/1.1 ``` ## URI 요청 파라미터 요청은 다음의 URI 파라미터를 사용합니다. ** [AdditionalDashboardIds](#API_GetDashboardEmbedUrl_RequestSyntax) ** 익명 사용자가 임시로 액세스할 수 있도록 하려는 하나 이상의 대시보드 ID 목록입니다. 현재,`IdentityType`파라미터를 다음으로 설정해야 합니다.`ANONYMOUS`다른 자격 증명 유형은 Amazon으로 인증되기 때문입니다. QuickSight IAM 사용자. 예를 들어,”`--dashboard-id dash_id1 --dashboard-id dash_id2 dash_id3 identity-type ANONYMOUS`“, 세션은 세 개의 대시보드 모두에 액세스할 수 있습니다. 배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수는 20개입니다. 길이 제약: 최소 길이는 1이고, 최대 길이 2048. 패턴: `[\w\-]+` ** [AwsAccountId](#API_GetDashboardEmbedUrl_RequestSyntax) ** 다음 ID입니다.AWS 계정여기에는 내장하려는 대시보드가 포함되어 있습니다. 길이 제약: 고정 길이는 12입니다. 패턴: `^[0-9]{12}$` 필수 사항: 예 ** [DashboardId](#API_GetDashboardEmbedUrl_RequestSyntax) ** 대시보드의 ID로,AWS Identity and Access Management(IAM) 정책. 길이 제약: 최소 길이는 1이고, 최대 길이 2048. 패턴: `[\w\-]+` 필수 사항: 예 ** [IdentityType](#API_GetDashboardEmbedUrl_RequestSyntax) ** 사용자가 로그인할 때 사용하는 인증 방법입니다. 유효한 값:` IAM | QUICKSIGHT | ANONYMOUS` 필수 사항: 예 ** [Namespace](#API_GetDashboardEmbedUrl_RequestSyntax) ** Amazon QuickSight 이 요청에 대시보드 ID가 포함된 네임스페이스입니다. 사용자 지정 네임스페이스를 사용하지 않는 경우`Namespace = default`. 길이 제약: 최대 길이 64. 패턴: `^[a-zA-Z0-9._-]*$` ** [ResetDisabled](#API_GetDashboardEmbedUrl_RequestSyntax) ** 내장된 대시보드에서 재설정 버튼을 제거합니다. 기본값은 FALSE이며, 이 경우 재설정 버튼이 활성화됩니다. ** [SessionLifetimeInMinutes](#API_GetDashboardEmbedUrl_RequestSyntax) ** 세션이 유효한 시간 (분) 입니다. 세션 수명은 15-600분이어야 합니다. 유효 범위: 최소값 15. 최대값은 600입니다. ** [StatePersistenceEnabled](#API_GetDashboardEmbedUrl_RequestSyntax) ** 내장된 대시보드에서 사용자 세션의 상태 지속성을 추가합니다. 지속성은 시트 및 매개변수 설정에 적용됩니다. 대시보드 구독자 (Amazon) 가 제어하는 설정입니다. QuickSight reader) 를 선택하면 대시보드를 볼 수 있습니다. 로 설정된 경우`TRUE`구독자가 동일한 대시보드 URL을 다시 열 때 설정이 동일합니다. Amazon 저장 상태 QuickSight, 브라우저 쿠키에는 없습니다. FALSE로 설정하면 사용자 세션의 상태가 지속되지 않습니다. 기본값은 `FALSE`입니다. ** [UndoRedoDisabled](#API_GetDashboardEmbedUrl_RequestSyntax) ** 내장된 대시보드에서 실행 취소/다시 실행 버튼을 제거합니다. 기본값은 FALSE이며 실행 취소/다시 실행 버튼을 사용할 수 있습니다. ** [UserArn](#API_GetDashboardEmbedUrl_RequestSyntax) ** Amazon QuickSight 사용자의 Amazon 리소스 이름 (ARN), 와 함께 사용`QUICKSIGHT`자격 증명 유형입니다. 모든 아마존에서 사용할 수 있습니다. QuickSight 다음 중 하나로 인증된 사용자 (독자, 작성자 또는 관리자) 가 될 수 있습니다. + Active Directory(AD) 사용자 또는 그룹 멤버 + 초대된 비연동된 사용자 + SAM 사용자 및 IAM 역할 기반 세션 세 번째 그룹 (IAM 사용자 및 IAM 역할 기반 세션) 의 사용자에 대해서는 이 파라미터를 생략합니다. ## 요청 본문 요청에 요청 본문이 없습니다. ## 응답 구문 ``` HTTP/1.1 {{Status}} Content-type: application/json { "EmbedUrl": "string", "RequestId": "string" } ``` ## 응답 요소 작업이 성공하면 서비스가 다음 HTTP 응답을 다시 전송합니다. ** [Status](#API_GetDashboardEmbedUrl_ResponseSyntax) ** 요청의 HTTP 상태입니다. 다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다. ** [EmbedUrl](#API_GetDashboardEmbedUrl_ResponseSyntax) ** 대시보드를 임베드하기 위해 서버 측 웹 페이지에 넣을 수 있는 일회용 URL입니다. 이 URL은 5분간 유효합니다. API 작업은 다음과 같은 URL을 제공합니다.`auth_code`10시간 동안 유효한 사용자 세션에 대해 한 번만 로그온할 수 있도록 하는 값입니다. Type: 문자열 ** [RequestId](#API_GetDashboardEmbedUrl_ResponseSyntax) ** 이AWS작업에 대한 요청 ID입니다. Type: 문자열 ## 오류 모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.[일반적인 오류](CommonErrors.md). ** AccessDeniedException ** 이 항목에 액세스할 수 없습니다. 제공된 자격 증명을 검증할 수 없습니다. 요청을 수행할 권한이 없을 수도 있습니다. 계정이 Amazon을 사용할 수 있도록 승인되었는지 확인합니다. QuickSight 서비스에 올바른 권한이 있고 올바른 액세스 키를 사용하고 올바른 액세스 키를 사용하는지 확인합니다. HTTP 상태 코드: 401 ** DomainNotWhitelistedException ** 지정된 도메인이 허용 목록에 없습니다. 내장된 대시보드의 모든 도메인은 Amazon에서 승인된 목록에 추가해야 합니다. QuickSight admin. HTTP 상태 코드: 403 ** IdentityTypeNotSupportedException ** 지정한 자격 증명 유형이 지원되지 않습니다. 지원되는 자격 증명 유형에는 다음`IAM`과`QUICKSIGHT`. HTTP 상태 코드: 403 ** InternalFailureException ** 내부 실패가 발생했습니다. HTTP 상태 코드: 500 ** InvalidParameterValueException ** 하나 이상의 매개변수에 유효하지 않은 값이 있습니다. HTTP 상태 코드: 400 ** QuickSightUserNotFoundException ** 입력한 이름을 가진 사용자를 찾을 수 없습니다. 이 오류는 다음과 같이 제공된 사용자 이름을 기반으로 사용자를 찾아야 하는 모든 작업에서 발생할 수 있습니다.`DeleteUser`,`DescribeUser`, 등. HTTP 상태 코드: 404 ** ResourceExistsException ** 지정한 리소스가 이미 존재합니다. HTTP 상태 코드: 409 ** 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 Amazon QuickSight 현재 스탠다드 에디션과 엔터프라이즈 에디션이 있습니다. 모든 에디션에서 모든 작업과 기능을 사용할 수 있는 것은 아닙니다. HTTP 상태 코드: 403 ## 참고 항목 이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요. + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWSSDK 용 JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/quicksight-2018-04-01/GetDashboardEmbedUrl) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/quicksight-2018-04-01/GetDashboardEmbedUrl)