Workspaces - Update Workspace

Tjeneste:
Core
API-versjon:
v1

Oppdaterer de angitte arbeidsområdeegenskapene.

Tillatelser

Innringeren må ha arbeidsområderolle for administratorer .

Nødvendige delegerte omfang

Workspace.ReadWrite.All

Begrensningsgrenser

Grensetype Verdi
Enhetlig kvote for plattform-API-er 200 samtaler/min
API-grense 200 samtaler/min

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identity Support
User Yes
tjenestekontohaver og administrerte identiteter Yes

Interface

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

URI-parametere

Navn I Obligatorisk Type Beskrivelse
workspaceId
 path True

string (uuid)

Arbeidsområde-ID-en.

Brødtekst for forespørsel

Navn Type Beskrivelse
description

string

Beskrivelsen av arbeidsområdet.
Beskrivelsen kan ikke inneholde mer enn 4000 tegn.
displayName

string

Visningsnavnet for arbeidsområdet.
Visningsnavnet kan ikke inneholde mer enn 256 tegn.
Arbeidsområdenavn må være unike i leieren.
Administratorovervåking er et reservert arbeidsområdenavn.

Svar

Navn Type Beskrivelse
200 OK

Workspace

Forespørselen er fullført.
429 Too Many Requests

ErrorResponse

Grensen for tjenestesats ble overskredet. Serveren returnerer en Retry-After topptekst som angir, i sekunder, hvor lenge klienten må vente før du sender flere forespørsler.

Overskrifter

Retry-After: integer
Other Status Codes

ErrorResponse

Vanlige feilkoder:

  • UnknownError - Det oppstod en feil.

Eksempler

Update a workspace example

Eksempelforespørsel

PATCH https://api.fabric.microsoft.com/v1/workspaces/33bae707-5fe7-4352-89bd-061a1318b60a

{
  "displayName": "Workspace New displayName",
  "description": "Workspace New description"
}

Eksempelsvar

Statuskode:
200 
{
  "id": "33bae707-5fe7-4352-89bd-061a1318b60a",
  "displayName": "Workspace New displayName",
  "description": "Workspace New description",
  "type": "Workspace",
  "domainId": "686177b9-ef29-45e4-a5db-1786ca6dbb9f",
  "capacityRegion": "East US"
}

Definisjoner

Navn Beskrivelse
CapacityRegion

Området for kapasiteten som er knyttet til dette arbeidsområdet. Flere kapasitetsområdeverdier kan legges til over tid.
ErrorRelatedResource

Objektet for feilrelaterte ressursdetaljer.
ErrorResponse

Feilsvaret.
ErrorResponseDetails

Feilsvardetaljene.
UpdateWorkspaceRequest

Oppdater nyttelast for arbeidsområdeforespørsel.
Workspace

Et arbeidsområdeobjekt.
WorkspaceAppliedTag

Representerer en brukt kode.
WorkspaceType

En arbeidsområdetype. Flere arbeidsområdetyper kan legges til over tid.

CapacityRegion

Opplisting

Området for kapasiteten som er knyttet til dette arbeidsområdet. Flere kapasitetsområdeverdier kan legges til over tid.

Verdi Beskrivelse
Australia East

Australia Øst-regionen
Australia Southeast

Australia sørøst-regionen
Brazil South

Brasil Sør-regionen
Brazil Southeast

Brasil, sørøst-området
Canada Central

Canada, sentralt område
Canada East

Canada, østområde
Central India

Sentral-India-regionen
Central US

Sentral-USA-område
Central US EUAP

EUAP-område sentralt i USA
East Asia

Øst-Asia-regionen
East US

Øst-USA-område
East US 2

Øst-USA 2-område
France Central

Frankrike, sentralt område
France South

Frankrike, sør
Germany Central

Tyskland, sentralområde
Germany Northeast

Nordøst-regionen i Tyskland
Israel Central

Israel, sentralregion
Italy North

Italia Nord-regionen
Japan East

Japan Øst-regionen
Japan West

Japan, vestområde
Korea Central

Korea, sentralt område
Korea South

Korea Sør-regionen
Mexico Central

Mexico, sentralt område
North Central US

Usa,nord-sentralt-område
North Europe

Nord-Europa-regionen
Norway East

Norges østområde
Norway West

Norge Vest-regionen
Poland Central

Polen, sentralt område
South Africa North

Sør-Afrika Nord-regionen
South Africa West

Sør-Afrika Vest-regionen
South Central US

Usa,sør-sentralt-område
South India

Sør-India-regionen
Southeast Asia

Sørøst-Asia-regionen
Spain Central

Spania, sentralt område
Sweden Central

Sveriges sentrale region
Switzerland North

Sveits, nordområde
Switzerland West

Sveits, vestområde
West Europe

Vest-Europa-regionen
West India

Vest-India-regionen
West US

Usa,vest
West US 2

Vest-USA 2-område
West US 3

Vest-USA 3-område
West Central US

USA-området vest-sentralt
UAE Central

UAE, sentralt område
UAE North

UAE Nord-regionen
Qatar Central

Qatar, sentralregion
Germany West Central

Tyskland, vest, sentralt område
Germany North

Tyskland Nord-regionen
UK South

Storbritannia sør-regionen
UK West

Uk West region
China North

Kina Nord-regionen
China East

Kina øst-regionen
China East 2

Kina Øst 2-regionen
China East 3

Kina Øst 3-regionen
China North 2

Kina Nord 2-regionen
China North 3

Kina Nord 3-regionen

ErrorRelatedResource

Objekt

Objektet for feilrelaterte ressursdetaljer.

Navn Type Beskrivelse
resourceId

string

Ressurs-ID-en som er involvert i feilen.
resourceType

string

Typen ressurs som er involvert i feilen.

ErrorResponse

Objekt

Feilsvaret.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
isRetriable

boolean

Når sann, kan forespørselen prøves på nytt. Retry-After Bruk svarhodet til å fastslå forsinkelsen, hvis tilgjengelig.
message

string

En menneskelig lesbar representasjon av feilen.
moreDetails

ErrorResponseDetails[]

Liste over flere feildetaljer.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.
requestId

string (uuid)

ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Objekt

Feilsvardetaljene.

Navn Type Beskrivelse
errorCode

string

En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message

string

En menneskelig lesbar representasjon av feilen.
relatedResource

ErrorRelatedResource

Feilrelaterte ressursdetaljer.

UpdateWorkspaceRequest

Objekt

Oppdater nyttelast for arbeidsområdeforespørsel.

Navn Type Beskrivelse
description

string

Beskrivelsen av arbeidsområdet.
Beskrivelsen kan ikke inneholde mer enn 4000 tegn.
displayName

string

Visningsnavnet for arbeidsområdet.
Visningsnavnet kan ikke inneholde mer enn 256 tegn.
Arbeidsområdenavn må være unike i leieren.
Administratorovervåking er et reservert arbeidsområdenavn.

Workspace

Objekt

Et arbeidsområdeobjekt.

Navn Type Beskrivelse
apiEndpoint

string (uri)

HTTP URL-adresse som representerer API-endepunktet som er spesifikt for arbeidsområdet. Denne endepunktverdien returneres når brukeren aktiverer preferWorkspaceSpecificEndpoints. Det gir tilgang til API over private koblinger.
capacityId

string (uuid)

ID-en for kapasiteten arbeidsområdet er tilordnet til.
capacityRegion

CapacityRegion

Området for kapasiteten som er knyttet til dette arbeidsområdet.
description

string

Beskrivelsen av arbeidsområdet.
displayName

string

Visningsnavnet for arbeidsområdet.
domainId

string (uuid)

ID-en for domenet arbeidsområdet er tilordnet til.
id

string (uuid)

Arbeidsområde-ID-en.
tags

WorkspaceAppliedTag[]

Liste over brukte merker.
type

WorkspaceType

Arbeidsområdetypen.

WorkspaceAppliedTag

Objekt

Representerer en brukt kode.

Navn Type Beskrivelse
displayName

string

Navnet på koden.
id

string (uuid)

Kode-ID-en.

WorkspaceType

Opplisting

En arbeidsområdetype. Flere arbeidsområdetyper kan legges til over tid.

Verdi Beskrivelse
Personal

Min mappe eller Mitt arbeidsområde brukes til å administrere brukerelementer.
Workspace

Arbeidsområde som brukes til å administrere stoffelementene.
AdminWorkspace

Arbeidsområde for administratorovervåking. Inneholder administratorrapporter som revisjonsrapporten og bruks- og innføringsrapporten.