Jaa

Items - Create Eventhouse

  • Viite
Palvelu:
Eventhouse
Ohjelmointirajapinnan versio:
v1

Luo tapahtumatalon määritettyyn työtilaan.
Tämä ohjelmointirajapinta tukee pitkäkestoisia toimintoja.

Käyttöoikeudet

Kutsujalla on oltava osallistujan tai suurempi työtilarooli.

Vaaditut delegoidut vaikutusalueet

Eventhouse.ReadWrite.All tai Item.ReadWrite.All

Rajoitukset

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti Tuki
Käyttäjä Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen Kyllä

Rajapinta

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/eventhouses

URI-parametrit

Nimi Kohteessa Pakollinen Tyyppi Description
workspaceId
 path True

string

uuid

Työtilan tunnus.

Pyynnön leipäteksti

Nimi Pakollinen Tyyppi Description
displayName True

string

Tapahtumatalon näyttönimi. Eventhouse-nimi voi sisältää aakkosnumeerisia merkkejä, alaviivoja, pisteitä ja tavuviivoja. Erikoismerkkejä ei tueta.
creationPayload

EventhouseCreationPayload

Tapahtumatalon luomisen tiedot. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
definition

EventhouseDefinition

Tapahtumatalon julkinen määritelmä. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
description

string

Tapahtumatalon kuvaus. Enimmäispituus on 256 merkkiä.

Vastaukset

Nimi Tyyppi Description
201 Created

Eventhouse

Luonti onnistui
202 Accepted

Pyynnön hyväksyminen, tapahtumatalon valmistelu on meneillään

Otsikot

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

ErrorResponse

Yleiset virhekoodit:

  • InvalidItemType – Kohdetyyppi on virheellinen

  • ItemDisplayNameAlreadyInUse – Kohteen näyttönimi on jo käytössä.

  • VioittunutPayload – Annetut tiedot ovat vioittuneet.

Esimerkit

Create an eventhouse example
create an eventhouse with creationPayload example
Create an eventhouse with definition example

Create an eventhouse example

Mallipyyntö

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description."
}

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Tilakoodi:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

create an eventhouse with creationPayload example

Mallipyyntö

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "creationPayload": {
    "minimumConsumptionUnits": 2.25
  }
}

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Tilakoodi:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create an eventhouse with definition example

Mallipyyntö

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/eventhouses

{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "definition": {
    "parts": [
      {
        "path": "EventhouseProperties.json",
        "payload": "e30=",
        "payloadType": "InlineBase64"
      },
      {
        "path": ".platform",
        "payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc=",
        "payloadType": "InlineBase64"
      }
    ]
  }
}

Mallivastaus

Tilakoodi:
201 
{
  "displayName": "Eventhouse_1",
  "description": "An eventhouse description.",
  "type": "Eventhouse",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047655"
}
Tilakoodi:
202 
Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Määritelmät

Nimi Description
CreateEventhouseRequest

Luo eventhouse-pyyntö.
ErrorRelatedResource

Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse

Virhevastaus.
ErrorResponseDetails

Virheen vastauksen tiedot.
Eventhouse

Tapahtumatalo-objekti.
EventhouseCreationPayload

Tapahtumatalonimikkeen tiedot
EventhouseDefinition

Eventhousen julkisen määritelmän objekti.
EventhouseDefinitionPart

Eventhouse-määritelmäosan objekti.
EventhouseProperties

Tapahtumatalon ominaisuudet.
ItemType

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.
PayloadType

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

CreateEventhouseRequest

Object

Luo eventhouse-pyyntö.

Nimi Tyyppi Description
creationPayload

EventhouseCreationPayload

Tapahtumatalon luomisen tiedot. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
definition

EventhouseDefinition

Tapahtumatalon julkinen määritelmä. Käytä definition tai creationPayload. Molempia ei voi käyttää samanaikaisesti.
description

string

Tapahtumatalon kuvaus. Enimmäispituus on 256 merkkiä.
displayName

string

Tapahtumatalon näyttönimi. Eventhouse-nimi voi sisältää aakkosnumeerisia merkkejä, alaviivoja, pisteitä ja tavuviivoja. Erikoismerkkejä ei tueta.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi Tyyppi Description
resourceId

string

Virheestä liittyvä resurssitunnus.
resourceType

string

Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
moreDetails

ErrorResponseDetails[]

Luettelo virheiden lisätiedoista.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.
requestId

string

Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi Tyyppi Description
errorCode

string

Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message

string

Ihmisen luettavissa oleva esitys virheestä.
relatedResource

ErrorRelatedResource

Virheisiin liittyvät resurssitiedot.

Eventhouse

Object

Tapahtumatalo-objekti.

Nimi Tyyppi Description
description

string

Kohteen kuvaus.
displayName

string

Kohteen näyttönimi.
id

string

uuid

Kohdetunnus.
properties

EventhouseProperties

Tapahtumatalon ominaisuudet.
type

ItemType

Kohdetyyppi.
workspaceId

string

uuid

Työtilan tunnus.

EventhouseCreationPayload

Object

Tapahtumatalonimikkeen tiedot

Nimi Tyyppi Default value Description
minimumConsumptionUnits

number

double 		0

Aktivoinnin yhteydessä tapahtumatalo on aina käytettävissä valitulla minimitasolla ja maksat vähintään valitun pienimmän käsittelyn. Tuettuja arvoja ovat [0, 2.25, 4.25, 8.5, 13, 18, 26, 34, 50] tai mikä tahansa luku välillä 51–322. Lisätietoja on kohdassa vähimmäiskulutus

EventhouseDefinition

Object

Eventhousen julkisen määritelmän objekti.

Nimi Tyyppi Description
format

string

Kohteen määrityksen muoto.
parts

EventhouseDefinitionPart[]

Luettelo määritysosista.

EventhouseDefinitionPart

Object

Eventhouse-määritelmäosan objekti.

Nimi Tyyppi Description
path

string

Eventhouse-osan polku.
payload

string

Tapahtumatalon osakuorma.
payloadType

PayloadType

Hyötykuorman tyyppi.

EventhouseProperties

Object

Tapahtumatalon ominaisuudet.

Nimi Tyyppi Description
databasesItemIds

string[]

uuid

Luettelo kaikista KQL-tietokannan alieleluetteloista
ingestionServiceUri

string

Käsittelypalvelun URI.
queryServiceUri

string

Kyselypalvelun URI-osoite.

ItemType

Luettelointi

Kohteen tyyppi. Muita kohdetyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
Dashboard

Power BI -koontinäyttö.
DataPipeline

Tietoputki.
Datamart

PowerBI -tietomarssi.
Environment

Ympäristö.
Eventhouse

Tapahtumatalo.
Eventstream

Tapahtumavirta.
GraphQLApi

Ohjelmointirajapinta GraphQL-kohteelle.
KQLDashboard

KQL-koontinäyttö.
KQLDatabase

KQL-tietokanta.
KQLQueryset

KQL-kyselyjoukko.
Lakehouse

Tämä on lakehouse.
MLExperiment

Koneoppimisen kokeilu.
MLModel

Koneoppimismalli.
MirroredDatabase

Peilattu tietokanta.
MirroredWarehouse

Peilattu varasto.
MountedDataFactory

A MountedDataFactory.
Notebook

Muistikirja.
PaginatedReport

PowerBI:n sivutettu raportti.
Reflex

Refleksi.
Report

PowerBI -raportti.
SQLDatabase

A SQLDatabase.
SQLEndpoint

SQL-päätepiste.
SemanticModel

PowerBI:n semanttinen malli.
SparkJobDefinition

Spark-työn määritelmä.
Warehouse

Varasto.

PayloadType

Luettelointi

Määritelmäosan hyötykuorman tyyppi. Lisää hyötykuormitustyyppejä voidaan lisätä ajan kuluessa.

Arvo Description
InlineBase64

Inline Base 64.