다음을 통해 공유


Embed Token - Datasets GenerateTokenInGroup

지정된 작업 영역에서 지정된 데이터 세트를 기반으로 포함 토큰을 생성합니다.

팁 (조언)

포함 토큰을 만들려면 최신 API를 사용하는 토큰생성하는 것이 좋습니다. 토큰 생성은 여러 항목에 대한 토큰 만들기와 같은 추가 함수를 지원합니다.

비고

포함 토큰을 사용하여 애플리케이션 내에서 Q&A 포함하는 수 있습니다.

중요합니다

이 API 호출은 고객 시나리오에 대한 포함과만 관련이 있습니다. 이 API 사용에 대한 자세한 내용은 포함 토큰 생성할 때고려 사항을 참조하세요.

권한

  • 인증에 서비스 주체를 사용하는 경우 서비스 주체 Power BI 콘텐츠 포함 및 고려 사항 및 제한 사항참조하세요.
  • 이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/GenerateToken

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
path True

string

데이터 세트 ID

groupId
path True

string (uuid)

작업 영역 ID

요청 본문

Name 형식 Description
accessLevel

TokenAccessLevel

포함 토큰 생성에 필요한 액세스 수준

allowSaveAs

boolean

포함된 보고서를 새 보고서로 저장할 수 있는지 여부입니다. 기본값은 false입니다. 보고서 포함에 대한 포함 토큰을 생성할 때만 적용됩니다.

datasetId

string

보고서 만들기에 사용되는 데이터 세트 ID입니다. 보고서 만들기를 위해 embed 토큰을 생성할 때만 적용됩니다.

identities

EffectiveIdentity[]

행 수준 보안 규칙에 사용할 ID 목록

lifetimeInMinutes

integer

토큰이 생성된 시간부터 시작하여 토큰의 최대 수명(분)입니다. 토큰의 만료 시간을 단축하는 데 사용할 수 있지만 확장할 수는 없습니다. 값은 양의 정수 여야 합니다. 0은 null과 동일하며 무시되므로 기본 만료 시간이 발생합니다.

응답

Name 형식 Description
200 OK

EmbedToken

그래

예제

Example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/GenerateToken
{
  "accessLevel": "View"
}

샘플 응답

{
  "token": "H4sI....AAA=",
  "tokenId": "49ae3742-54c0-4c29-af52-619ff93b5c80",
  "expiration": "2018-07-29T17:58:19Z"
}

정의

Name Description
EffectiveIdentity

사용자 ID 및 역할을 정의합니다. 자세한 내용은 Power BI Embedded 행 수준 보안을 참조하세요.

EmbedToken

Power BI 포함 토큰

GenerateTokenRequest

Power BI 토큰 요청 생성

IdentityBlob

ID를 지정하기 위한 Blob입니다. Azure SQL에 DirectQuery 연결이 있는 데이터 세트에 대해서만 지원됩니다.

TokenAccessLevel

포함 토큰 생성에 필요한 액세스 수준

EffectiveIdentity

사용자 ID 및 역할을 정의합니다. 자세한 내용은 Power BI Embedded 행 수준 보안을 참조하세요.

Name 형식 Description
auditableContext

string

EffectiveIdentity 감사 가능한 컨텍스트입니다. 이 매개 변수가 제공되고 비어 있지 않으면 EffectiveIdentity에 대한 감사를 사용하도록 설정하고 해당 값은 감사 레코드의 사용자 이름으로 설정됩니다. 그렇지 않으면 EffectiveIdentity 컨텍스트가 GenerateToken 감사 레코드에서 생략됩니다.

customData

string

행 수준 보안 규칙을 적용하는 데 사용되는 사용자 지정 데이터 . Azure Analysis Services 모델 및 클라우드 모델에 대한 라이브 연결에만 지원됩니다.

datasets

string[]

이 ID가 적용되는 데이터 세트의 배열입니다.

identityBlob

IdentityBlob

ID지정하는 Blob입니다. Azure SQL에 DirectQuery 연결이 있는 데이터 세트에 대해서만 지원됩니다.

reports

string[]

이 ID가 적용되는 보고서의 배열입니다. 페이지를 매긴 보고서에 대해서만 지원됩니다.

roles

string[]

RLS 규칙을 적용하는 토큰 내의 RLS(행 수준 보안) 역할 배열입니다. ID에는 최대 50개의 역할이 포함될 수 있습니다. 역할에는 ,제외한 모든 문자가 포함될 수 있으며 길이가 50자를 초과하면 안됩니다.

username

string

행 수준 보안 규칙을 적용하는 토큰 내의 유효 사용자 이름입니다. 온-프레미스 모델의 경우 사용자 이름에는 영숫자 또는 다음 문자 ., -, _, !, #, ^, ~, \\, @포함할 수 있습니다. 클라우드 모델의 경우 사용자 이름에 ASCII 문자가 포함될 수 있습니다. 두 모델 모두 사용자 이름 길이가 256자를 초과하면 안 되며 사용자 이름에 공백이 포함되어서는 안 됩니다.

EmbedToken

Power BI 포함 토큰

Name 형식 Description
expiration

string (date-time)

토큰 만료 날짜 및 시간(UTC)

token

string

포함 토큰

tokenId

string (uuid)

고유한 토큰 ID입니다. 감사 로그를 통해 토큰 ID를 사용하여 토큰을 사용하는 작업과 생성 작업의 상관 관계를 지정할 수 있습니다.

GenerateTokenRequest

Power BI 토큰 요청 생성

Name 형식 Description
accessLevel

TokenAccessLevel

포함 토큰 생성에 필요한 액세스 수준

allowSaveAs

boolean

포함된 보고서를 새 보고서로 저장할 수 있는지 여부입니다. 기본값은 false입니다. 보고서 포함에 대한 포함 토큰을 생성할 때만 적용됩니다.

datasetId

string

보고서 만들기에 사용되는 데이터 세트 ID입니다. 보고서 만들기를 위해 embed 토큰을 생성할 때만 적용됩니다.

identities

EffectiveIdentity[]

행 수준 보안 규칙에 사용할 ID 목록

lifetimeInMinutes

integer

토큰이 생성된 시간부터 시작하여 토큰의 최대 수명(분)입니다. 토큰의 만료 시간을 단축하는 데 사용할 수 있지만 확장할 수는 없습니다. 값은 양의 정수 여야 합니다. 0은 null과 동일하며 무시되므로 기본 만료 시간이 발생합니다.

IdentityBlob

ID를 지정하기 위한 Blob입니다. Azure SQL에 DirectQuery 연결이 있는 데이터 세트에 대해서만 지원됩니다.

Name 형식 Description
value

string

Azure SQL용 OAuth 2.0 액세스 토큰

TokenAccessLevel

포함 토큰 생성에 필요한 액세스 수준

Description
Create

생성된 embed 토큰이 만들기 권한을 부여했음을 나타냅니다. 보고서 만들기를 위해 embed 토큰을 생성할 때만 적용됩니다.

Edit

생성된 포함 토큰이 보기 및 편집 권한을 부여한다는 것을 나타냅니다. 보고서 포함에 대한 포함 토큰을 생성할 때만 적용됩니다.

View

생성된 포함 토큰이 보기 전용 권한을 부여했음을 나타냅니다.