다음을 통해 공유


Template Apps - Create Install Ticket

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

사용 권한

호출자는 인증에 서비스 주체를 사용해야 합니다. 자세한 내용은 서비스 주체 및 고려 사항 및 제한 사항이포함된 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
{
  "appId": "91ce06d1-d81b-4ea0-bc6d-2ce3dd2f8e87",
  "packageKey": "g632bb64...OfsoqT56xEM=",
  "ownerTenantId": "d43e3248-3d83-44aa-a94d-c836bd7f9b79",
  "config": {
    "configuration": {
      "param1": "value1",
      "param2": "value2"
    }
  }
}

Sample Response

{
  "ticket": "H4sI....AAA=",
  "ticketId": "4b76f5ed-5a06-4150-8d1b-60f8e4c186f4",
  "expiration": "2020-07-29T17:58:19Z"
}
{
  "error": {
    "code": "ServiceAppApplicationOwnershipValidationFailed",
    "pbi.error": {
      "code": "ServiceAppApplicationOwnershipValidationFailed",
      "parameters": {},
      "details": [],
      "exceptionCulprit": 1
    }
  }
}
{
  "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 템플릿 앱 버전의 보안 키