Exporter (0) Imprimer
Développer tout

Référence de l'API REST de gestion des services

Mis à jour: septembre 2014

L'API de gestion des services fournit l'accès par programme à la plupart des fonctionnalités disponibles via le portail de gestion.

L'API de gestion des services est une API REST. Toutes les opérations d'API sont effectuées via le protocole SSL et authentifiées mutuellement à l'aide de certificats X.509 v3.

Un abonnement Microsoft Azure est un compte d'utilisateur unique dans Azure. Toutes les ressources disponibles via l'API de gestion des services sont organisées sous l'abonnement. Lorsque vous créez un abonnement Azure, il est identifié de façon unique par un ID d'abonnement. L'ID d'abonnement forme une partie de l'URI pour chaque appel que vous passez à l'API de gestion des services.

Un compte de stockage est un point de terminaison unique pour les services BLOB, de Table et de File d'attente Azure. Pour plus d'informations sur les services BLOB, de Table et de File d'attente, consultez Référence de l'API REST des services de stockage.

Vous devez créer un compte de stockage pour utiliser les services BLOB, de File d'attente et de Table. Le nom que vous donnez à votre compte de stockage devient le nom d'hôte contenu dans l'URI que vous utilisez pour adresser les ressources d'objet blob, de file d'attente et de table. Par exemple, pour adresser une ressource de conteneur dans le service BLOB, vous utilisez l'URI suivante, où <storage-account> fait référence au nom de votre compte de stockage :

http://<storage-account>.blob.core.windows.net/mycontainer

Chaque compte de stockage a deux clés d'accès associées, une clé d'accès principale et une clé d'accès secondaire. Ces clés sont utilisées pour authentifier les demandes auprès du compte de stockage.

Vous pouvez utiliser l'API de gestion des services pour gérer un compte de stockage existant. L'API comprend des opérations pour répertorier les comptes de stockage dans votre abonnement, pour retourner les propriétés de compte de stockage, pour récupérer la clé d'accès primaire et secondaire, et pour régénérer les clés. Consultez, Opérations sur les comptes de stockage pour une liste complète des opérations d'API.

Un service cloud est un conteneur pour vos déploiements d'applications dans Azure. Le nom que vous donnez à votre service cloud doit être unique sur Azure. Ce nom constitue une partie de l'URI pour les appels que vous passez à l'API de gestion des services pour agir sur ce service cloud.

Plusieurs opérations dans l'API de gestion des services vous permettent de gérer votre service cloud en référençant un déploiement par son nom de déploiement, ou en référençant l'environnement de déploiement (intermédiaire ou de production) dans lequel le déploiement s'exécute.

noteRemarque
Un certain nombre d'opérations de gestion des services sur les services de cloud computing sont asynchrones. Consultez Tracking Asynchronous Service Management Requests pour plus d'informations sur l'appel d'opérations asynchrones.

Consultez, Opérations sur les services de cloud computing pour une liste complète des opérations d'API.

Vous pouvez télécharger des certificats de gestion dans un magasin de certificats Azure pour votre abonnement, à l'aide du portail de gestion. Les certificats sont désormais empaquetés et téléchargés séparément des binaires pour votre service. Cela signifie que les certificats peuvent désormais être gérés par une personne autre que le développeur, par exemple un directeur informatique. Le fichier de définition de service spécifie un nom logique pour le certificat et le nom et l'emplacement du magasin local où il se trouve, et associe le certificat à un point de terminaison du service cloud. Le fichier de configuration de service associe le nom logique du certificat à son empreinte numérique.

Consultez, Opérations sur les certificats des services pour une liste complète des opérations d'API.

Lorsque vous créez un service cloud ou un compte de stockage, vous devez spécifier un emplacement géographique. Pour ce faire, spécifiez un emplacement de centre de données ou indiquez que le service cloud ou le compte de stockage doit faire partie d'un groupe d'affinités. Notez que vous devez choisir l'un ou l'autre – il n'est pas possible de spécifier les deux.

Un groupe d'affinités garantit que vos services de cloud computing sont regroupés dans les centres de données Azure. Si les services de cloud computing dans votre abonnement doivent fonctionner ensemble (par exemple, si votre service cloud stocke des données dans le service BLOB ou de Table ou compte sur le service de File d'attente pour le flux de travail), vous pouvez organiser votre service cloud et le compte de stockage dans un groupe d'affinités pour optimiser les performances.

Un groupe d'affinités est défini au niveau de l'abonnement et est disponible à tous les services de cloud computing ou comptes de stockage que vous créez. Vous pouvez créer un groupe d'affinités lorsque vous créez un compte de stockage ou un service cloud. Vous pouvez ensuite associer d'autres services de cloud computing à votre groupe d'affinités au fur et à mesure que vous les créez.

noteRemarque
Si vous créez un service cloud ou un compte de stockage et ne l'associez pas à un groupe d'affinités lors de la création, vous devrez supprimer et recréer le service si vous souhaitez l'associer à un groupe d'affinités ultérieurement.

Vous pouvez utiliser l'API de gestion des services pour créer, répertorier, supprimer, mettre à jour, et obtenir les propriétés d'un groupe d'affinités et d'emplacements dans votre abonnement. Consultez Opérations sur les groupes d'affinités et Opérations sur les emplacements pour une liste complète des opérations d'API.

Vous pouvez consulter l'historique d'abonnement pour une période donnée à l'aide de l'API de gestion des services. Par exemple, vous pouvez afficher tous les services de cloud computing créés au cours du mois dernier. Consultez, Opérations relatives aux abonnements pour une liste complète des opérations d'API.

Vous pouvez créer et gérer des machines virtuelles à l'aide de l'API de gestion des services. Consultez la liste ci-dessous des opérations d'API :

Vous pouvez définir et gérer la configuration des réseaux virtuels. Consultez Opérations sur les réseaux virtuels et Opérations sur les passerelles de réseau virtuel pour une liste complète des opérations d'API.

Voir aussi

Afficher:
© 2014 Microsoft