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 |
|---|---|---|---|---|
|
continuation
|
query |
string |
Et token til hentning af den næste side med resultater. |
Svar
| Navn | Type | Beskrivelse |
|---|---|---|
| 200 OK |
Anmodningen blev fuldført. |
|
| 429 Too Many Requests |
Grænsen for tjenestetakst blev overskredet. Serveren returnerer en Headere Retry-After: integer |
|
| Other Status Codes |
Almindelige fejlkoder:
|
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. |
|
Capacity |
En kapacitetstilstand. Der kan tilføjes yderligere kapacitetstilstande over tid. |
|
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. |
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 |
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 |
| 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. |