Template Apps - Create Install Ticket

참조

Service:: Power BI REST APIs

API Version:: v1.0

지정된 템플릿 앱의 자동화된 설치 흐름 에 대한 설치 티켓을 생성합니다.

사용 권한

호출자는 인증에 서비스 주체를 사용해야 합니다. 자세한 내용은 서비스 주체 및 고려 사항 및 제한 사항이 포함된 Power BI 콘텐츠 포함을 참조하세요.

제한 사항

이 API 호출을 만드는 테넌트는 지정된 템플릿 앱을 소유 해야 합니다 .
템플릿 앱을 Microsoft AppSource에 게시하거나 티켓 작성자와 티켓으로 설치하는 최종 사용자 모두 앱에 대한 명시적 액세스 권한이 있어야 합니다.
설치 티켓의 모든 쿼리 매개 변수를 구성 해야 합니다 .

POST https://api.powerbi.com/v1.0/myorg/CreateTemplateAppInstallTicket

요청 본문

Name	형식	Description
installDetails	TemplateAppInstallDetails[]	설치 세부 정보 목록

응답

Name	형식	Description
200 OK	InstallTicket	정상

예제

Create an install ticket for a template app, specifying two query parameters example.

Sample Request

POST https://api.powerbi.com/v1.0/myorg/CreateTemplateAppInstallTicket

Request Body

{
  "appId": "91ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
  "packageKey": "g632bb64...OfsoqT56xEM=",
  "ownerTenantId": "d43e3248-3d83-44aa-a94d-c836bd7f9b79",
  "config": {
    "configuration": {
      "param1": "value1",
      "param2": "value2"
    }
  }
}

Sample Response

Status code:: 200

{
  "ticket": "H4sI....AAA=",
  "ticketId": "4b76f5ed-5a06-4150-8d1b-60f8e4c186f4",
  "expiration": "2020-07-29T17:58:19Z"
}

Status code:: 401

{
  "error": {
    "code": "ServiceAppApplicationOwnershipValidationFailed",
    "pbi.error": {
      "code": "ServiceAppApplicationOwnershipValidationFailed",
      "parameters": {},
      "details": [],
      "exceptionCulprit": 1
    }
  }
}

Status code:: 400

{
  "error": {
    "code": "ServiceAppInstallTicketInvalidConfiguration",
    "pbi.error": {
      "code": "ServiceAppInstallTicketInvalidConfiguration",
      "parameters": {},
      "details": [],
      "exceptionCulprit": 1
    }
  }
}

정의

Name	Description
CreateInstallTicketRequest	Power BI 설치 티켓 만들기 요청
InstallTicket	Power BI 템플릿 앱에 대한 자동화된 설치 티켓
TemplateAppConfigurationRequest	Power BI 템플릿 앱에 대한 자동화된 설치 구성(이름-값 쌍 사전)
TemplateAppInstallDetails	Power BI 템플릿 앱에 대한 설치 세부 정보

CreateInstallTicketRequest

Power BI 설치 티켓 만들기 요청

Name	형식	Description
installDetails	TemplateAppInstallDetails[]	설치 세부 정보 목록

InstallTicket

Power BI 템플릿 앱에 대한 자동화된 설치 티켓

Name	형식	Description
expiration	string	티켓의 만료 날짜 및 시간(UTC)
ticket	string	티켓 설치
ticketId	string	설치 티켓의 고유 ID입니다. 감사 로그를 사용하여 이 티켓을 사용하는 작업과 티켓 생성 작업의 상관 관계를 지정할 수 있습니다.

TemplateAppConfigurationRequest

Power BI 템플릿 앱에 대한 자동화된 설치 구성(이름-값 쌍 사전)

Name	형식	Description
configuration	object

TemplateAppInstallDetails

Power BI 템플릿 앱에 대한 설치 세부 정보

Name	형식	Description
appId	string	Power BI 템플릿 앱의 고유 ID
config	TemplateAppConfigurationRequest	자동화된 설치 구성
ownerTenantId	string	Power BI 템플릿 앱 소유자의 테넌트 ID
packageKey	string	Power BI 템플릿 앱 버전의 보안 키

Share via