Partager via


Api Revision - List By Service

Répertorie toutes les révisions d’une API.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/revisions?api-version=2021-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=2021-08-01

Paramètres URI

Nom Dans Obligatoire Type Description
apiId
path True

string

Identificateur d'API. Doit être unique dans le instance de service Gestion des API actuel.

resourceGroupName
path True

string

Nom du groupe de ressources.

serviceName
path True

string

Nom du service Gestion des API.

Modèle d’expression régulière: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

api-version
query True

string

Version de l’API à utiliser avec la demande du client.

$filter
query

string

| Champ | Utilisation | Opérateurs pris en charge | Fonctions prises en charge |
|-------------|-------------|-------------|-------------|
| apiRevision | filter | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |

$skip
query

integer

int32

Nombre d'enregistrements à ignorer.

$top
query

integer

int32

Nombre d’enregistrements à renvoyer.

Réponses

Nom Type Description
200 OK

ApiRevisionCollection

L’opération retourne une liste de détails de révision.

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

ApiManagementListApiRevisions

Exemple de requête

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d2ef278aa04f0888cba3f3/revisions?api-version=2021-08-01

Exemple de réponse

{
  "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": ""
}

Définitions

Nom Description
ApiRevisionCollection

Représentation de la liste révision de l’API paginée.

ApiRevisionContract

Résumé des métadonnées de révision.

ErrorFieldContract

Contrat de champ d’erreur.

ErrorResponse

Réponse d’erreur.

ApiRevisionCollection

Représentation de la liste révision de l’API paginée.

Nom Type Description
count

integer

Nombre total d’enregistrements sur toutes les pages.

nextLink

string

Lien de la page suivante, le cas échéant.

value

ApiRevisionContract[]

Valeurs de page.

ApiRevisionContract

Résumé des métadonnées de révision.

Nom Type Description
apiId

string

Identificateur de la révision de l’API.

apiRevision

string

Numéro de révision de l’API.

createdDateTime

string

Heure de création de la révision de l’API. La date est conforme au format suivant : aaaa-MM-jjTHH :mm :ssZ tel que spécifié par la norme ISO 8601.

description

string

Description de la révision de l’API.

isCurrent

boolean

Indique si la révision de l’API est accessible via la passerelle.

isOnline

boolean

Indique si la révision d’API est la révision d’API actuelle.

privateUrl

string

URL de passerelle pour accéder à la révision de l’API non actuelle.

updatedDateTime

string

Heure à laquelle la révision de l’API a été mise à jour. La date est conforme au format suivant : aaaa-MM-jjTHH :mm :ssZ tel que spécifié par la norme ISO 8601.

ErrorFieldContract

Contrat de champ d’erreur.

Nom Type Description
code

string

Code d'erreur de niveau propriété.

message

string

Représentation lisible par l’homme de l’erreur au niveau des propriétés.

target

string

Nom de propriété.

ErrorResponse

Réponse d’erreur.

Nom Type Description
error.code

string

Code d'erreur défini par le service. Ce code sert de sous-état pour le code d'erreur HTTP spécifié dans la réponse.

error.details

ErrorFieldContract[]

Liste des champs non valides envoyés dans la demande, en cas d’erreur de validation.

error.message

string

Représentation contrôlable de visu de l’erreur.