Api Revision - List By Service
Listet alle Revisionen einer API auf
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2022-08-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
api
|
path | True |
string |
API-Bezeichner. Muss im aktuellen API Management-Dienst instance eindeutig sein. |
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
service
|
path | True |
string |
Der Name des API Management-Diensts. RegEx-Muster: |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
$filter
|
query |
string |
| Feld | Nutzung | Unterstützte Operatoren | Unterstützte Funktionen | |
|
$skip
|
query |
integer int32 |
Die Anzahl der zu überspringenden Datensätze. |
|
$top
|
query |
integer int32 |
Die Anzahl der zurückzugebenden Datensätze. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Der Vorgang gibt eine Liste von Revisionsdetails zurück. |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory OAuth2-Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
Name | Beschreibung |
---|---|
user_impersonation | Identitätswechsel Ihres Benutzerkontos |
Beispiele
ApiManagementListApiRevisions
Beispielanforderung
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/revisions?api-version=2022-08-01
Beispiel für eine Antwort
{
"value": [
{
"apiId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/a1;rev=1",
"apiRevision": "1",
"createdDateTime": "2018-02-01T22:21:20.467Z",
"updatedDateTime": "2018-02-01T22:21:20.467Z",
"isOnline": true,
"isCurrent": true
}
],
"count": 1,
"nextLink": ""
}
Definitionen
Name | Beschreibung |
---|---|
Api |
Darstellung der Seiten-API-Revisionsliste. |
Api |
Zusammenfassung der Revisionsmetadaten. |
Error |
Fehler Feldvertrag. |
Error |
Fehlerantwort. |
ApiRevisionCollection
Darstellung der Seiten-API-Revisionsliste.
Name | Typ | Beschreibung |
---|---|---|
count |
integer |
Gesamtzahl der Datensätze auf allen Seiten. |
nextLink |
string |
Link zur nächsten Seite, falls vorhanden. |
value |
Seitenwerte. |
ApiRevisionContract
Zusammenfassung der Revisionsmetadaten.
Name | Typ | Beschreibung |
---|---|---|
apiId |
string |
Bezeichner der API-Revision. |
apiRevision |
string |
Revisionsnummer der API. |
createdDateTime |
string |
Der Zeitpunkt, zu dem die API-Revision erstellt wurde. Das Datum entspricht dem folgenden Format: yyyy-MM-ttTHH:mm:ssZ gemäß der Iso 8601-Norm. |
description |
string |
Beschreibung der API-Revision. |
isCurrent |
boolean |
Gibt an, ob auf die API-Revision über das Gateway zugegriffen werden kann. |
isOnline |
boolean |
Gibt an, ob die API-Revision die aktuelle API-Revision ist. |
privateUrl |
string |
Gateway-URL für den Zugriff auf die nicht aktuelle API-Revision. |
updatedDateTime |
string |
Der Zeitpunkt, zu dem die API-Revision aktualisiert wurde. Das Datum entspricht dem folgenden Format: yyyy-MM-ttTHH:mm:ssZ gemäß der Iso 8601-Norm. |
ErrorFieldContract
Fehler Feldvertrag.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Fehlercode auf Eigenschaftsebene. |
message |
string |
Für Menschen lesbare Darstellung eines Fehlers auf Eigenschaftsebene. |
target |
string |
Der Eigenschaftsname. |
ErrorResponse
Fehlerantwort.
Name | Typ | Beschreibung |
---|---|---|
error.code |
string |
Der vom Dienst definierte Fehlercode. Dieser Code dient als Unterstatus für den in der Antwort angegebenen HTTP-Fehlercode. |
error.details |
Die Liste der ungültigen Felder, die in der Anforderung gesendet werden, im Falle eines Validierungsfehlers. |
|
error.message |
string |
Lesbare Darstellung des Fehlers. |