Delen via

Items - Update Report Definition

Service:
Report
API-versie:
v1

Hiermee wordt de definitie voor het opgegeven rapport overschreven.
Deze API ondersteunt langlopende bewerkingen (LRO).

Het bijwerken van de definitie van het rapport heeft geen invloed op het vertrouwelijkheidslabel.

Machtigingen

De beller moet lees- en schrijfmachtigingen voor het rapport hebben.

Vereiste gedelegeerde bereiken

Report.ReadWrite.All of Item.ReadWrite.All

Door Microsoft Entra ondersteunde identiteiten

Deze API ondersteunt de Microsoft-identiteiten die in deze sectie worden vermeld.

Identiteit Ondersteuning
Gebruiker Ja
serviceprincipal en beheerde identiteiten Ja

gebruikersinterface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports/{reportId}/updateDefinition
Met optionele parameters: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/reports/{reportId}/updateDefinition?updateMetadata={updateMetadata}

URI-parameters

Name In Vereist Type Description
reportId
 path True

string (uuid)

De rapport-id.
workspaceId
 path True

string (uuid)

De werkruimte-ID.
updateMetadata
 query

boolean

Als deze is ingesteld op true en het .platform-bestand wordt opgegeven als onderdeel van de definitie, worden de metagegevens van het item bijgewerkt met behulp van de metagegevens in het PLATFORM-bestand

Aanvraagbody

Name Vereist Type Description
definition True

ReportDefinition

Openbaar definitieobject rapporteren. Raadpleeg dit artikel voor meer informatie over het maken van een openbare rapportdefinitie.

Antwoorden

Name Type Description
200 OK

De aanvraag is voltooid.
202 Accepted

Aanvraag geaccepteerd. De definitie van de update wordt uitgevoerd.

Kopteksten

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Veelvoorkomende foutcodes:

  • OperationNotSupportedForItem - Bewerking wordt niet ondersteund voor aangevraagd. artikel

  • CorruptedPayload: de opgegeven nettolading is beschadigd.

Voorbeelden

Update a report definition example

Voorbeeldaanvraag

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/reports/5b218778-e7a5-4d73-8187-f10824047715/updateDefinition?updateMetadata=True

{
  "definition": {
    "parts": [
      {
        "path": "report.json",
        "payload": "QmFzZTY0U3RyaW5n",
        "payloadType": "InlineBase64"
      },
      {
        "path": "definition.pbir",
        "payload": "QW5vdGhlckJhc2U2NFN0cmluZw",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Voorbeeldrespons

Statuscode:
200
Statuscode:
202 
Location: https://api.fabric.microsoft.com/v1/operations/427f6c34-b64e-4ee4-8ea5-b533c0e203ef
x-ms-operation-id: 427f6c34-b64e-4ee4-8ea5-b533c0e203ef
Retry-After: 30

Definities

Name Description
ErrorRelatedResource

Het foutgerelateerde resourcedetailsobject.
ErrorResponse

Het foutbericht.
ErrorResponseDetails

De details van het foutbericht.
PayloadType

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.
ReportDefinition

Openbaar definitieobject rapporteren. Raadpleeg dit artikel voor meer informatie over het maken van een openbare rapportdefinitie.
ReportDefinitionPart

Rapportdefinitieonderdeelobject.
UpdateReportDefinitionRequest

De nettolading van de openbare definitie van het rapport bijwerken.

ErrorRelatedResource

Object

Het foutgerelateerde resourcedetailsobject.

Name Type Description
resourceId

string

De resource-id die betrokken is bij de fout.
resourceType

string

Het type resource dat betrokken is bij de fout.

ErrorResponse

Object

Het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
moreDetails

ErrorResponseDetails[]

Lijst met aanvullende foutdetails.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.
requestId

string

Id van de aanvraag die is gekoppeld aan de fout.

ErrorResponseDetails

Object

De details van het foutbericht.

Name Type Description
errorCode

string

Een specifieke id die informatie biedt over een foutvoorwaarde, waardoor gestandaardiseerde communicatie tussen onze service en de gebruikers mogelijk is.
message

string

Een leesbare weergave van de fout.
relatedResource

ErrorRelatedResource

De foutgerelateerde resourcedetails.

PayloadType

Inventarisatie

Het type nettolading van het definitieonderdeel. Er kunnen in de loop van de tijd extra typen nettoladingen worden toegevoegd.

Waarde Description
InlineBase64

Inline base 64.

ReportDefinition

Object

Openbaar definitieobject rapporteren. Raadpleeg dit artikel voor meer informatie over het maken van een openbare rapportdefinitie.

Name Type Description
format

string

De indeling van de itemdefinitie.
parts

ReportDefinitionPart[]

Een lijst met definitieonderdelen.

ReportDefinitionPart

Object

Rapportdefinitieonderdeelobject.

Name Type Description
path

string

Het pad naar het rapportonderdeel.
payload

string

De nettolading van het rapportonderdeel.
payloadType

PayloadType

Het nettoladingstype.

UpdateReportDefinitionRequest

Object

De nettolading van de openbare definitie van het rapport bijwerken.

Name Type Description
definition

ReportDefinition

Openbaar definitieobject rapporteren. Raadpleeg dit artikel voor meer informatie over het maken van een openbare rapportdefinitie.