Template Apps - Create Install Ticket

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Belirtilen şablon uygulamasının otomatik yükleme akışı için bir yükleme bileti oluşturur.

İzinler

Çağıranın kimlik doğrulaması için hizmet sorumlusunu kullanması gerekir. Daha fazla bilgi için bkz . Hizmet sorumlusuyla Power BI içeriği ekleme ve Önemli noktalar ve sınırlamalar.

Sınırlamalar

Bu API çağrısını yapan kiracının belirtilen şablon uygulamasına sahip olması gerekir .
Şablon uygulamasının Microsoft AppSource'ta yayımlanması veya biletle yüklenen hem bilet oluşturucunun hem de son kullanıcının uygulamaya açık erişimi olmalıdır.
Yükleme biletindeki tüm sorgu parametreleri yapılandırılmalıdır .

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

İstek Gövdesi

Name	Tür	Description
installDetails	TemplateAppInstallDetails[]	Yükleme ayrıntıları listesi

Yanıtlar

Name	Tür	Description
200 OK	InstallTicket	Tamam

Örnekler

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
    }
  }
}

Tanımlar

Name	Description
CreateInstallTicketRequest	Power BI yükleme bileti oluşturma isteği
InstallTicket	Power BI şablon uygulaması için otomatik yükleme bileti
TemplateAppConfigurationRequest	Power BI şablon uygulaması için otomatik yükleme yapılandırması (ad-değer çiftleri sözlüğü)
TemplateAppInstallDetails	Power BI şablon uygulamasının yükleme ayrıntıları

CreateInstallTicketRequest

Power BI yükleme bileti oluşturma isteği

Name	Tür	Description
installDetails	TemplateAppInstallDetails[]	Yükleme ayrıntıları listesi

InstallTicket

Power BI şablon uygulaması için otomatik yükleme bileti

Name	Tür	Description
expiration	string	Biletin son kullanma tarihi ve saati (UTC)
ticket	string	Yükleme bileti
ticketId	string	Yükleme biletinin benzersiz kimliği. Denetim günlükleri, bu bileti kullanan işlemleri anahtar oluşturma işlemiyle ilişkilendirmek için kullanılabilir.

TemplateAppConfigurationRequest

Power BI şablon uygulaması için otomatik yükleme yapılandırması (ad-değer çiftleri sözlüğü)

Name	Tür	Description
configuration	object

TemplateAppInstallDetails

Power BI şablon uygulamasının yükleme ayrıntıları

Name	Tür	Description
appId	string	Power BI şablon uygulamasının benzersiz kimliği
config	TemplateAppConfigurationRequest	Otomatik yükleme yapılandırması
ownerTenantId	string	Power BI şablon uygulaması sahibinin kiracı kimliği
packageKey	string	Power BI şablon uygulaması sürümü için güvenli anahtar

Aracılığıyla paylaş