OneLake Settings - Modify Diagnostics
Aktiverer eller deaktiverer indstillingerne for OneLake-diagnosticering i arbejdsområdet.
Denne API understøtter LRO-handlinger (Long Running Operations).
Rettigheder
Den kaldende skal have en administratorarbejdsområderolle i kildearbejdsområdet.
Den, der ringer op, skal have en bidragyderrolle eller en rolle over arbejdsområdet i destinationsarbejdsområdet.
Påkrævede delegerede områder
OneLake.ReadWrite.All
Microsoft Entra-understøttede identiteter
Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.
| Identity | Støtte |
|---|---|
| User | Ja |
| tjenesteprincipal og administrerede identiteter | Ja |
Interface
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/onelake/settings/modifyDiagnostics
URI-parametre
| Navn | I | Påkrævet | Type | Beskrivelse |
|---|---|---|---|---|
|
workspace
|
path | True |
string (uuid) |
Arbejdsområde-id'et. |
Brødtekst for anmodning
| Navn | Påkrævet | Type | Beskrivelse |
|---|---|---|---|
| status | True |
string |
Status for diagnosticeringsindstillingerne. |
| destination | OneLakeDiagnosticSettingsDestinationInfo: |
Den destination, hvor OneLake-diagnosticeringslogge gemmes. Hvis du deaktiverer, er dette ikke påkrævet. |
Svar
| Navn | Type | Beskrivelse |
|---|---|---|
| 200 OK |
Anmodningen blev fuldført. |
|
| 202 Accepted |
Anmodningen blev accepteret. Ændring af diagnosticeringsindstillinger er i gang. Headere
|
|
| 429 Too Many Requests |
Grænsen for tjenestetakst blev overskredet. Serveren returnerer en Headere Retry-After: integer |
|
| Other Status Codes |
Almindelige fejlkoder:
|
Eksempler
Create OneLake Diagnostic Setting for Workspace example
Eksempelanmodning
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/onelake/settings/modifyDiagnostics
{
"status": "Enabled",
"destination": {
"type": "Lakehouse",
"lakehouse": {
"referenceType": "ById",
"itemId": "eceb53c6-6227-41f1-a649-62ebe7ee9eb1",
"workspaceId": "85173301-af01-49c9-b667-03edc44517da"
}
}
}
Eksempelsvar
Disable OneLake Diagnostic Setting for Workspace example
Eksempelanmodning
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/onelake/settings/modifyDiagnostics
{
"status": "Disabled"
}
Eksempelsvar
Remove OneLake Diagnostic Setting Destination for Workspace example
Eksempelanmodning
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/onelake/settings/modifyDiagnostics
{
"status": "Disabled",
"destination": {
"type": "Lakehouse"
}
}
Eksempelsvar
Replace OneLake Diagnostic Setting Destination for Workspace example
Eksempelanmodning
POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff227/onelake/settings/modifyDiagnostics
{
"status": "Enabled",
"destination": {
"type": "Lakehouse",
"lakehouse": {
"referenceType": "ById",
"itemId": "83b128a3-f58f-4eee-ab0b-e7e25a748f54",
"workspaceId": "6eb233d7-b1c6-4248-9255-5a0d223f3456"
}
}
}
Eksempelsvar
Definitioner
| Navn | Beskrivelse |
|---|---|
|
Error |
En struktureret parameter, der giver yderligere kontekst, der kan læses af computeren, om en fejl. |
|
Error |
Objektet med fejlrelaterede ressourceoplysninger. |
|
Error |
Fejlsvaret. |
|
Error |
Oplysninger om fejlsvar. |
|
Item |
En elementreference efter id-objekt. |
|
Item |
En elementreference efter variabel. |
|
Item |
Elementreferencetypen. Der kan tilføjes flere |
|
Lakehouse |
Lakehouse-destination for OneLake-diagnosticeringslogge. |
|
One |
OneLake-objekt til diagnosticeringsindstillinger. |
ErrorParameter
En struktureret parameter, der giver yderligere kontekst, der kan læses af computeren, om en fejl.
| Navn | Type | Beskrivelse |
|---|---|---|
| message |
string |
En læsevenlig beskrivelse af parameterens betydning. |
| name |
string |
Parameter-id'et. |
| value |
string |
Parameterens værdi. |
ErrorRelatedResource
Objektet med fejlrelaterede ressourceoplysninger.
| Navn | Type | Beskrivelse |
|---|---|---|
| resourceId |
string |
Det ressource-id, der er involveret i fejlen. |
| resourceType |
string |
Typen af ressource, der er involveret i fejlen. |
ErrorResponse
Fejlsvaret.
| Navn | Type | Beskrivelse |
|---|---|---|
| errorCode |
string |
Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere. |
| isRetriable |
boolean |
Når sand, kan anmodningen prøves igen. Brug svarheaderen |
| message |
string |
En menneskelig læsbar gengivelse af fejlen. |
| moreDetails |
Liste over yderligere oplysninger om fejl. |
|
| parameters |
Strukturerede parametre, der giver yderligere kontekst, der kan læses af computeren, om fejlen. |
|
| relatedResource |
De fejlrelaterede ressourceoplysninger. |
|
| requestId |
string (uuid) |
Id'et for den anmodning, der er knyttet til fejlen. |
ErrorResponseDetails
Oplysninger om fejlsvar.
| Navn | Type | Beskrivelse |
|---|---|---|
| errorCode |
string |
Et bestemt id, der indeholder oplysninger om en fejltilstand, der muliggør standardiseret kommunikation mellem vores tjeneste og dens brugere. |
| message |
string |
En menneskelig læsbar gengivelse af fejlen. |
| parameters |
Strukturerede parametre, der giver yderligere kontekst, der kan læses af computeren, om fejlen. |
|
| relatedResource |
De fejlrelaterede ressourceoplysninger. |
ItemReferenceById
En elementreference efter id-objekt.
| Navn | Type | Beskrivelse |
|---|---|---|
| itemId |
string (uuid) |
Id'et for elementet. |
| referenceType |
string:
By |
Elementreferencetypen. |
| workspaceId |
string (uuid) |
Elementets arbejdsområde-id. |
ItemReferenceByVariable
En elementreference efter variabel.
| Navn | Type | Beskrivelse |
|---|---|---|
| referenceType |
string:
By |
Elementreferencetypen. |
| variableReference |
string |
En variabelreferencestreng, der angiver variabelbiblioteket og variabelnavnet i det. Format: |
ItemReferenceType
Elementreferencetypen. Der kan tilføjes flere ItemReferenceType typer over tid.
| Værdi | Beskrivelse |
|---|---|
| ById |
Der refereres til elementet af dets id. |
| ByVariable |
Der refereres til elementet af en variabel. |
LakehouseOneLakeDiagnosticSettingsDestination
Lakehouse-destination for OneLake-diagnosticeringslogge.
| Navn | Type | Beskrivelse |
|---|---|---|
| lakehouse | ItemReference: |
Reference til destinationssøhuset. I øjeblikket understøttes kun ItemReferenceById. |
| type |
string:
Lakehouse |
Destinationens elementtype. |
OneLakeDiagnosticSettings
OneLake-objekt til diagnosticeringsindstillinger.
| Navn | Type | Beskrivelse |
|---|---|---|
| destination | OneLakeDiagnosticSettingsDestinationInfo: |
Den destination, hvor OneLake-diagnosticeringslogge gemmes. Hvis du deaktiverer, er dette ikke påkrævet. |
| status |
string |
Status for diagnosticeringsindstillingerne. |