기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
GenerateEmbedUrlForAnonymousUser
Amazon을 임베드하는 데 사용할 수 있는 임베드 URL을 생성합니다. QuickSight 독자 사용자를 등록하지 않고도 웹 사이트의 대시 보드를 사용할 수 있습니다. 이 작업을 사용하기 전에 대시보드 및 권한을 구성했는지 확인합니다.
생성된 URL에는 다음 규칙이 적용됩니다.
-
여기에는 임시 베어러 토큰이 포함되어 있습니다. 생성 후 5분 동안 유효합니다. 이 기간 내에 사용한 후에는 다시 사용할 수 없습니다.
-
URL 유효 기간을 사용하여 사용자 지정할 수 있는 실제 세션 수명과 혼동해서는 안 됩니다.
SessionLifetimeInMinutes파라미터. 결과 사용자 세션은 15분 (최소) 에서 10시간 (최대) 까지 유효합니다. 기본 세션 지속 시간은 10시간입니다. -
URL이 사용되거나 Amazon과 상호 작용할 때만 요금이 부과됩니다. QuickSight.
자세한 내용은 단원을 참조하십시오.내장 분석의아마존 QuickSight 사용 설명서.
임베딩을 위한 개략적인 단계에 대한 자세한 내용과 임베딩을 사용자 지정하는 방법에 대한 대화형 데모를 보려면아마존 QuickSight 개발자 포털.
요청 구문
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 요청 파라미터
요청은 다음의 URI 파라미터를 사용합니다.
- AwsAccountId
-
의 IDAWS 계정여기에는 내장하려는 대시보드가 포함되어 있습니다.
길이 제약 조건: 고정 길이는 12입니다.
패턴:
^[0-9]{12}$: 예
요청 본문
요청은 JSON 형식의 다음 데이터를 받습니다.
- AuthorizedResourceArns
-
Amazon 리소스 이름 (ARN) QuickSight 사용자가 세션 수명 동안 액세스할 수 있는 권한이 있는 리소스 선택 항목
Dashboard내장 경험에서 사용자가 볼 수 있도록 하려는 계정의 대시보드 ARN 목록을 전달합니다. 현재 각 API 호출에서 최대 25개의 대시보드 ARN을 전달할 수 있습니다.Type: 문자열 배열
: 예
- ExperienceConfiguration
-
내장하려는 경험의 구성입니다.
유형: AnonymousUserEmbeddingExperienceConfiguration 객체
: 예
- Namespace
-
더 Amazon QuickSight 익명 사용자가 가상으로 속한 네임스페이스입니다. 아마존을 사용하지 않는 경우 QuickSight 사용자 지정 네임스페이스, 설정
default.Type: 문자열
길이 제약 조건: 최대 길이 64.
패턴:
^[a-zA-Z0-9._-]*$: 예
- AllowedDomains
-
생성된 URL에 액세스하기 위해 허용 목록에 추가할 도메인입니다. 이 선택적 매개 변수는 Manage에서 구성된 정적 도메인을 재정의합니다. QuickSight 아마존 메뉴 QuickSight 콘솔. 대신 이 매개 변수에 포함하는 도메인만 허용합니다. 각 API 호출에 최대 3개의 도메인 또는 하위 도메인을 나열할 수 있습니다.
특정 도메인 아래의 모든 하위 도메인을 허용 목록에 포함하려면
*. 예,https://*.sapp.amazon.com아래에 모든 하위 도메인 포함https://sapp.amazon.com.Type: 문자열 배열
: 아니요
- SessionLifetimeInMinutes
-
세션이 유효한 시간 (분) 입니다. 세션 수명은 [15-600] 분 범위여야 합니다.
Type: Long
유효 범위: 최소값 15입니다. 최대값 600입니다.
: 아니요
- SessionTags
-
행 수준 보안에 사용되는 세션 태그. 이 매개 변수를 사용하기 전에 다음 사항을 사용하여 관련 데이터 세트를 구성했는지 확인합니다.
DataSet$RowLevelPermissionTagConfiguration매개 변수를 사용하여 세션 태그를 사용하여 행 수준 보안을 제공할 수 있습니다.다음에 사용되는 태그가 아닙니다.AWS리소스 태그 지정 기능. 자세한 내용은 단원을 참조하십시오.태그로 행 수준 보안 (RLS) 사용의아마존 QuickSight 사용 설명서.
Type: 어레이SessionTag사물
배열 멤버: 최소 항목 수는 1개입니다. 최대 항목 수 50개.
: 아니요
응답 구문
HTTP/1.1 Status
Content-type: application/json
{
"EmbedUrl": "string",
"RequestId": "string"
}응답 요소
작업이 성공하면 서비스가 다음 HTTP 응답을 다시 전송합니다.
- Status
-
요청의 HTTP 상태입니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
오류
모든 작업에 공통적인 오류에 대한 자세한 내용은 단원을 참조하십시오.일반적인 오류.
- 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페이지.
용량 가격이 추가된 후 다음을 사용할 수 있습니다.
GetDashboardEmbedUrlAPI 연산--identity-type ANONYMOUS옵션.HTTP 상태 코드: 403
- UnsupportedUserEditionException
-
이 오류는 아마존에서 작업을 호출하고 있음을 나타냅니다. QuickSight구독: 에디션에는 해당 작업에 대한 지원이 포함되어 있지 않습니다. Amazon Amazon QuickSight 현재 스탠다드 에디션과 엔터프라이즈 에디션이 있습니다. 모든 에디션에서 모든 작동 및 기능을 사용할 수 있는 것은 아닙니다.
HTTP 상태 코드: 403
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
