Template Apps - Create Install Ticket

Generuje bilet instalacyjny dla zautomatyzowanego przepływu instalacji określonej aplikacji szablonu.

Uprawnienia

Obiekt wywołujący musi używać jednostki usługi do uwierzytelniania. Aby uzyskać więcej informacji, zobacz Osadzanie zawartości usługi Power BI przy użyciu jednostki usługi oraz zagadnienia i ograniczenia .

Ograniczenia

• Dzierżawa wykonująca to wywołanie interfejsu API musi właścicielem określonej aplikacji szablonu.
• Aplikacja szablonu musi zostać opublikowana w usłudze Microsoft AppSource lub zarówno twórca biletu, jak i użytkownik końcowy instalowany za pomocą biletu muszą mieć jawny dostęp do aplikacji.
• Wszystkie parametry zapytania w biletu instalacji muszą być skonfigurowane.
  
  

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

Treść żądania

Odpowiedzi

Przykłady

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

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

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

Definicje

CreateInstallTicketRequest

Żądanie utworzenia biletu instalacji usługi Power BI

InstallTicket

Bilet automatycznej instalacji dla aplikacji szablonu usługi Power BI

TemplateAppConfigurationRequest

Automatyczna konfiguracja instalacji aplikacji szablonu usługi Power BI (słownik par nazwa-wartość)

TemplateAppInstallDetails

Szczegóły instalacji aplikacji szablonu usługi Power BI