Capacities - List Capacities

Returnerer en liste over kapaciteter, som hovedkontoen har adgang til (enten administrator eller bidragyder).
Denne API understøtter sideinddeling.

Påkrævede delegerede områder

Capacity.Read.All eller Capacity.ReadWrite.All

Microsoft Entra-understøttede identiteter

Denne API understøtter de Microsoft -identiteter, der angivet i dette afsnit.

Identitet Støtte
Bruger Ja
tjenesteprincipal og administrerede identiteter Ja

Grænseflade

GET https://api.fabric.microsoft.com/v1/capacities
GET https://api.fabric.microsoft.com/v1/capacities?continuationToken={continuationToken}

URI-parametre

Navn I Påkrævet Type Beskrivelse
continuationToken
query

string

Et token til hentning af den næste side med resultater.

Svar

Navn Type Beskrivelse
200 OK

Capacities

Anmodningen blev fuldført.

429 Too Many Requests

ErrorResponse

Grænsen for tjenestetakst blev overskredet. Serveren returnerer en Retry-After header, der angiver, i sekunder, hvor længe klienten skal vente, før der sendes yderligere anmodninger.

Headere

Retry-After: integer

Other Status Codes

ErrorResponse

Almindelige fejlkoder:

  • UnknownError – Der opstod en fejl.

Eksempler

List capacities example
List capacities with continuation example

List capacities example

Eksempelanmodning

GET https://api.fabric.microsoft.com/v1/capacities

Eksempelsvar

{
  "value": [
    {
      "id": "96f3f0ff-4fe2-4712-b61b-05a456ba9357",
      "displayName": "F4 Capacity",
      "sku": "F4",
      "region": "West Central US",
      "state": "Active"
    },
    {
      "id": "0b9a4952-b5e7-4a55-8739-3e7251a2fd43",
      "displayName": "F8 Capacity",
      "sku": "F8",
      "region": "West Central US",
      "state": "Inactive"
    },
    {
      "id": "af196b7b-0bf8-4430-b383-ad48d14f4edf",
      "displayName": "F16 Capacity",
      "sku": "F16",
      "region": "West Central US",
      "state": "Active"
    }
  ]
}

List capacities with continuation example

Eksempelanmodning

GET https://api.fabric.microsoft.com/v1/capacities

Eksempelsvar

{
  "value": [
    {
      "id": "96f3f0ff-4fe2-4712-b61b-05a456ba9357",
      "displayName": "F4 Capacity",
      "sku": "F4",
      "region": "West Central US",
      "state": "Active"
    },
    {
      "id": "0b9a4952-b5e7-4a55-8739-3e7251a2fd43",
      "displayName": "F8 Capacity",
      "sku": "F8",
      "region": "West Central US",
      "state": "Inactive"
    },
    {
      "id": "af196b7b-0bf8-4430-b383-ad48d14f4edf",
      "displayName": "F16 Capacity",
      "sku": "F16",
      "region": "West Central US",
      "state": "Active"
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/capacities?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Definitioner

Navn Beskrivelse
Capacities
Capacity

Et kapacitetsobjekt.

CapacityState

En kapacitetstilstand. Der kan tilføjes yderligere kapacitetstilstande over tid.

ErrorParameter

En struktureret parameter, der giver yderligere kontekst, der kan læses af computeren, om en fejl.

ErrorRelatedResource

Objektet med fejlrelaterede ressourceoplysninger.

ErrorResponse

Fejlsvaret.

ErrorResponseDetails

Oplysninger om fejlsvar.

Capacities

Navn Type Beskrivelse
continuationToken

string

Tokenet for det næste resultatsætbatch. Hvis der ikke er flere poster, fjernes de fra svaret.

continuationUri

string

URI'en for det næste resultatsætbatch. Hvis der ikke er flere poster, fjernes de fra svaret.

value

Capacity[]

En liste over kapaciteter.

Capacity

Et kapacitetsobjekt.

Navn Type Beskrivelse
displayName

string

Det viste navn på kapaciteten.

id

string (uuid)

Kapacitets-id'et.

region

string

Det Azure-område, hvor kapaciteten blev klargjort.

sku

string

Kapacitets-SKU'en.

state

CapacityState

Kapacitetstilstanden.

CapacityState

En kapacitetstilstand. Der kan tilføjes yderligere kapacitetstilstande over tid.

Værdi Beskrivelse
Active

Kapaciteten er klar til brug.

Inactive

Kapaciteten kan ikke bruges.

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 Retry-After til at bestemme forsinkelsen, hvis den er tilgængelig.

message

string

En menneskelig læsbar gengivelse af fejlen.

moreDetails

ErrorResponseDetails[]

Liste over yderligere oplysninger om fejl.

parameters

ErrorParameter[]

Strukturerede parametre, der giver yderligere kontekst, der kan læses af computeren, om fejlen.

relatedResource

ErrorRelatedResource

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

ErrorParameter[]

Strukturerede parametre, der giver yderligere kontekst, der kan læses af computeren, om fejlen.

relatedResource

ErrorRelatedResource

De fejlrelaterede ressourceoplysninger.