Tutoriel sur la gestion des ressources de votre PaaS Bluemix : environnement Bluemix local et environnement Bluemix dédié

Vous pouvez afficher les notifications pour votre environnement local ou dédié pour surveiller le statut de votre environnement. Reportez-vous au tableau ci-dessous pour plus d'informations sur les différents types de notification et les emplacements où elles sont publiées.

Vous pouvez étendre la fonctionnalité des notifications qui sont envoyées à la page Administration et à la page Statut en utilisant des abonnements à des notifications. Utilisez ces derniers pour configurer un courrier électronique personnalisé ou utiliser des webhooks à intégrer à l'outil de votre choix.

• Si vous sélectionnez l'option de courrier électronique, vos notifications sont envoyées aux adresses électroniques que vous spécifiez. Vous pouvez sélectionner des notifications d'incidents, de mises à jour de maintenance ou de seuils. Une notification par courrier électronique initiale est envoyée. Ensuite, si l'événement est modifié, une autre notification comportant la modification est envoyée à chaque fois qu'une modification est effectuée.

• Si vous sélectionnez l'option webhooks, vos notifications sont acheminées directement à la destination de votre choix, par exemple à un numéro de téléphone (via un message SMS). Vous pouvez personnaliser le type de notification, notamment pour les mises à jour de maintenance, les alertes relatives aux incidents critiques ou les seuils. Vous pouvez indiquer si vous voulez recevoir les nouvelles notifications ou les notifications sur les modifications des abonnements, et quelles informations doivent être incluses dans le corps de chaque notification.

Remarque : seuls les utilisateurs disposant de l'autorisation de superutilisateur (ops.admin) peuvent configurer des abonnements à des notifications.

Pour créer un abonnement par courrier électronique ou webhook depuis la page Abonnements aux notifications, procédez comme suit :

1. Accédez à la page Abonnements aux notifications. Sélectionnez INFORMATIONS SYSTEME > Environnement > Abonnements ;

2. Cliquez sur Ajouter un abonnement ;

3. Remplissez le formulaire d'abonnement aux notifications :

   • pour créer des abonnements à des notifications par courrier électronique sur les mises à jour de maintenance ou les incidents, voir les informations du tableau 3,

   • pour créer des abonnements à des notifications par courrier électronique sur les seuils, voir les informations du tableau 4,

   • pour créer des abonnements à des notifications par webhook sur les mises à jour de maintenance ou les incidents, voir les informations du tableau 5,

   • pour créer des abonnements à des notifications par webhook sur les seuils, voir les informations du tableau 6 ;

4. Une fois que vous avez complété ce formulaire, vous pouvez choisir parmi les options suivantes : :

   • cliquez sur Sauvegarder pour enregistrer l'abonnement dans votre liste d'abonnements à des notifications,

   • cliquez sur Sauvegarder et tester pour enregistrer et tester la notification,

   • cliquez sur Sauvegarder et fermer pour enregistrer l'abonnement dans votre liste d'abonnements à des notifications et revenir à la page précédente.

Les données de seuil sont collectées toutes les six heures. Une notification n'est envoyée qu'une fois lorsque la valeur dépasse ou passe sous la valeur que vous avez définie. Si vous avez choisi la propriété Croissant, aucune nouvelle notification n'est envoyée sauf si la valeur passe sous le seuil, puis dépasse à nouveau le seuil. De même, si vous avez choisi la propriété Décroissant, vous ne recevez une notification que si la valeur dépasse le seuil que vous avez défini, puis passe à nouveau sous le seuil.

Si vous ne voulez pas attendre six heures avant l'envoi de la notification lorsque le seuil est atteint, après avoir rempli les zones du formulaire, vous pouvez cliquer sur Sauvegarder et tester pour recevoir une notification de test avec des exemples de données.

Une notification de seuil de quota inclut uniquement les organisations qui ont dépassé le pourcentage de seuil spécifié au cours de la période de six heures correspondant à cette notification. Les organisations qui ont dépassé un seuil au cours des périodes de six heures précédentes ne seront pas incluses, même si elles sont toujours au-dessus ou au-dessous du seuil. Les trois ressources qui constituent un quota d'organisation (mémoire réservée, services et routes) sont considérées de manière indépendante lorsqu'il s'agit de déterminer si une notification de quota d'organisation doit être envoyée. Par exemple, si la quantité de mémoire réservée utilisée par une organisation dépasse 50 % du quota de l'organisation, un seuil de quota d'organisation configuré avec une valeur de 50 % provoque l'envoi d'une notification. Ultérieurement, si le nombre de services utilisés par la même organisation dépasse 50 % du quota de l'organisation, même si la quantité de mémoire utilisée est inchangée, le même abonnement à un seuil de quota d'organisation provoque également l'envoi d'une notification.

Les données de seuil sont collectées toutes les six heures. Une notification n'est envoyée qu'une fois lorsque la valeur dépasse ou passe sous la valeur que vous avez définie. Aucune nouvelle notification n'est envoyée sauf si la valeur passe sous le seuil, si vous avez choisi la propriété Croissant, puis dépasse à nouveau le seuil. De même, si vous avez choisi la propriété Décroissant, vous ne recevez de nouvelle notification que si la valeur dépasse le seuil que vous avez défini, puis passe à nouveau sous le seuil.

Si vous ne voulez pas attendre six heures avant l'envoi de la notification lorsque le seuil est atteint, après avoir rempli les zones du formulaire, vous pouvez cliquer sur Sauvegarder et tester pour sauvegarder et tester la notification avec des exemples de données.

Une notification de seuil de quota inclut uniquement les organisations qui ont dépassé le pourcentage de seuil spécifié au cours de la période de six heures correspondant à cette notification. Les organisations qui ont dépassé un seuil au cours des périodes de six heures précédentes ne seront pas incluses, même si elles sont toujours au-dessus/au-dessous du seuil. Les trois ressources qui constituent un quota d'organisation (mémoire réservée, services et routes) sont considérées de manière indépendante lorsqu'il s'agit de déterminer si une notification de quota d'organisation doit être envoyée. Par exemple, si la quantité de mémoire réservée utilisée par une organisation dépasse 50 % du quota de l'organisation, un seuil de quota d'organisation configuré avec une valeur de 50 % provoque l'envoi d'une notification. Ultérieurement, si le nombre de services utilisés par la même organisation dépasse 50 % du quota de l'organisation, même si la quantité de mémoire utilisée est inchangée, le même abonnement à un seuil de quota d'organisation provoque également l'envoi d'une notification.

Une fois votre abonnement aux notifications sauvegardé, vous recevrez des notifications via la méthode configurée. Les notifications apparaissent toujours aux emplacements suivants :

• dans la page Statut pour les incidents ;

• dans la page Statut pour les événements de mise à jour de maintenance planifiés avec interruption ;

• dans la zone Notifications de la page Administration pour les mises à jour de maintenance.

Vous pouvez sélectionner n'importe quel abonnement aux notifications sauvegardé, examiner l'activité récente ou l'éditer selon vos besoins. Cliquez sur une entrée d'activité récente pour la développer et visualiser les détails de son historique.

L'exécution des mises à jour de maintenance sans interruption est planifiée au cours d'une fenêtre de temps préalablement approuvée. Par défaut, deux fenêtres de disponibilité pour les mises à jour par semaine sont créées pour votre système. En général, elles sont définies pour se reproduire tous les samedis et dimanches soir. Vous pouvez changer les paramètres par défaut de l'une des façons suivantes :

• éditez les fenêtres de mise à jour par défaut en choisissant un jour différent ou une heure de début différente, ou les deux ;

• créez une fenêtre de mise à jour, puis supprimez la fenêtre de mise à jour par défaut.

Pour sauvegarder vos modifications, vous devez tout de même atteindre le temps minimal requis chaque semaine.

Vous devez définir au minimum douze heures disponibles réparties sur au moins deux jours de la semaine. Par exemple, vous pouvez définir des créneaux de six heures sur deux jours distincts, ou des créneaux de quatre heures sur trois jours distincts. Pour garantir que les créneaux soient assez longs pour l'application d'une mise à jour, la durée de chaque créneau doit être d'au moins quatre heures.

Remarque : seuls les utilisateurs disposant de l'autorisation de superutilisateur (ops.admin) peuvent planifier et approuver des mises à jour de maintenance.

1. Accédez à Administration > Informations système > Nombre en attente > Gérer la disponibilité.

2. Accédez à la section Fenêtres de mise à jour.

3. Cliquez sur Ajouter.

4. Définissez votre première fenêtre de mise à jour en sélectionnant la fréquence, la durée et l'heure de début de la fenêtre.

5. Facultatif : sélectionnez Marquer comme préféré si vous souhaitez définir votre fenêtre de mise à jour récurrente comme période de planification préférée pour vos déploiements. Les fenêtres préférées sont prioritaires, chaque fois que cela est possible.

6. Cliquez sur Soumettre.

7. Répétez ce processus jusqu'à ce que vous ayez rempli les exigences minimales pour les fenêtres hebdomadaires.

Vous pouvez choisir de définir des fenêtres d'indisponibilités spécifiques au cours desquelles votre environnement ne peut pas faire l'objet de mises à jour de maintenance sans interruption. Par exemple, vous pouvez choisir un week-end ou un jour férié pendant lequel l'activité est élevée et vous ne voulez pas appliquer de maintenance, afin de garantir que vos applications seront disponibles pour vos utilisateurs.

1. Accédez à Administration > Informations système > Nombre en attente > Gérer la disponibilité.

2. Accédez à la section Fenêtres d'indisponibilité.

3. Cliquez sur Ajouter.

4. Définissez votre fenêtre d'indisponibilité en sélectionnant la fréquence, la durée et l'heure de début de la fenêtre.

5. Cliquez sur Soumettre.

Les dates d'indisponibilité doivent être approuvées par IBM et le délai d'approbation est variable. Une fois les dates acceptées, IBM annule toutes les mises à jour actuellement prévues dans le cadre de la fenêtre d'indisponibilité. IBM crée également de nouveaux enregistrements pour ces mises à jour et planifie ces dernières en dehors des dates d'indisponibilité approuvées.

Une fois que vous avez défini vos fenêtres de mise à jour, les mises à jour sans interruption sont planifiées automatiquement à ces heures. Votre approbation explicite pour ces types de mises à jour n'est pas requise. Toutefois, vous pouvez afficher les détails de chaque mise à jour de maintenance, notamment les éléments mis à jour, la durée de la mise à jour et l'heure de planification de la mise à jour.

Afin d'afficher les détails d'une mise à jour sans interruption, procédez comme suit :

1. Accédez à Administration > Informations système > Nombre en attente ;

2. Identifiez les lignes pour lesquelles Customer Scheduling Required a pour valeur No ;

3. Sélectionnez la ligne de cette mise à jour pour afficher les détails.

Une mise à jour avec interruption peut avoir un impact sur votre environnement, les applications en cours d'exécution ou l'accès de vos utilisateurs à vos applications. Vous devez planifier et approuver chacune de ces mises à jour de maintenance dans la fenêtre de maintenance de 21 jours allouée. Vous pouvez sélectionner la date et l'heure de déploiement suggérées, l'option pour n'importe laquelle de vos fenêtres préapprouvées, ou bien ouvrir le calendrier afin de sélectionner trois dates et heures spécifiques parmi lesquelles IBM pourra choisir pour planifier la mise à jour.

Pour les mises à jour avec interruption requérant votre approbation, procédez comme suit :

1. Accédez à Administration > Informations système > Nombre en attente ;

2. Identifiez les lignes pour lesquelles Customer Scheduling Required a pour valeur Yes ;

3. Sélectionnez la ligne de cette mise à jour afin de consulter les détails de la mise à jour, notamment sa description, la date et l'heure suggérées pour la mise à jour, les composants affectés et la durée de la mise à jour ;

4. Sélectionnez Planifier et approuver ;

5. Choisissez l'une des options suivantes : Date suggérée, Autres dates ou Toute fenêtre préapprouvée. Si vous sélectionnez Autres dates, vous pouvez ouvrir le calendrier pour sélectionner trois options parmi lesquelles IBM pourra choisir ;

6. Facultatif : dans la liste des autres dates sélectionnées dans le calendrier, sélectionnez celles que vous souhaitez définir comme date préférées pour le déploiement. Chaque date sélectionnée est indiquée comme date préférée pour le déployeur qui planifie le déploiement. IBM essaie de planifier la maintenance dans les fenêtres de mises à jour préférées ;

7. Quand vous avez terminé, cliquez sur Soumettre.

En fonction de votre sélection, la mise à jour est planifiée pour son déploiement à la date suggérée que vous avez acceptée, lors d'une des fenêtres préapprouvées ou à l'une des dates et heures spécifiques que vous avez sélectionnées. Lorsque la mise à jour est planifiée de manière à être déployée par IBM, la date planifiée apparaît dans les détails de la mise à jour sur la page Mises à jour de maintenance. Vous pouvez replanifier un déploiement déjà planifié uniquement si un jour (24 heures) avant la date et l'heure de début planifiées est conservé. Une fois que vous avez replanifié un déploiement, vous ne pouvez plus le redéployer à nouveau.

La section Mises à jour affiche le nombre de notifications relatives à des mises à jour en attente qui requièrent une intervention de votre part. Deux types peuvent s'afficher.

Mises à jour sans interruption

• Une mise à jour sans interruption n'a pas d'impact sur votre environnement, vos applications en cours d'exécution ou l'accès de vos utilisateurs à vos applications. Ce type de mises à jour ne requiert pas d'approbation au cas par cas. Ces mises à jour sont appliquées dans les fenêtres de mise à jour préapprouvées que vous avez définies sur la page Mises à jour du système.

Mises à jour avec interruption

• Une mise à jour avec interruption peut avoir un impact sur votre environnement, les applications en cours d'exécution ou l'accès de vos utilisateurs à vos applications. Vous pouvez planifier et approuver chacune de ces mises à jour de maintenance dans la fenêtre de maintenance de 21 jours allouée pour vous assurer que la mise à jour ne sera pas appliquée pendant les heures de bureau critiques. Vous pouvez sélectionner la date et l'heure de déploiement suggérées en fonction de vos fenêtres de mise à jour préapprouvées ou sélectionner deux combinaisons date-heure supplémentaires parmi lesquelles IBM pourra choisir lors de l'application de la mise à jour.

Pour plus d'informations sur la définition de fenêtres de mise à jour préapprouvées, ainsi que sur la définition de dates d'indisponibilité spécifiques pour la maintenance, voir Mises à jour de maintenance.

Dans la section Informations générales, vous pouvez consulter les informations suivantes :

• des informations de base sur la génération Bluemix ;

• des informations sur les API, notamment la version, l'adresse URL, la région et un lien vers la documentation de l'interface de ligne de commande ;

• des informations sur le domaine partagé concernant votre système et votre service ;

• des statistiques sur le nombre total d'applications, d'utilisateurs et d'organisations.

Dans la section Détails de la configuration LDAP, vous pouvez sélectionner le serveur LDAP et afficher des informations sur les mappages des utilisateurs et des groupes. Si vous utilisez un ID Web IBM®, il est indiqué dans cette section.

Pour afficher des informations relatives à l'utilisation des ressources, cliquez sur ADMINISTRATION > Utilisation des ressources.

Dans la section Utilisation des ressources, vous pouvez consulter les informations suivantes :

• des informations sur l'utilisation des ressources, comme la quantité de mémoire et l'espace disque pouvant être réservés et physiquement disponibles, ainsi que la quantité de mémoire et l'espace disque actuellement réservés et physiquement utilisés. Vous pouvez également consulter des informations sur l'utilisation moyenne de l'unité centrale dans tous les agents DEA. Pour des informations plus détaillées sur l'utilisation de la mémoire, du disque et de l'unité centrale, voir Détails sur la mémoire, le disque et l'unité centrale ;

• des informations sur l'utilisation du réseau relatives à la bande passante entrante et à la bande passante sortante, au cours des six dernières heures ou du dernier jour. Les données affichées dépendent de la somme du trafic entrant et sortant pour les réseaux publics et privés ;

• le temps de réponse moyen pour Bluemix au cours des dix dernières minutes, de la dernière heure et du dernier jour ;

• le nombre moyen de transactions par seconde pour Bluemix au cours des dix minutes précédentes, de l'heure précédente ou du jour précédent.

I-D-1-a. Détails sur la mémoire système, le disque et l'unité centrale▲

I-D-1-b. Détails sur l'utilisation du service▲

Vous pouvez afficher l'utilisation mensuelle pour votre compte, pour votre environnement dédié ou local. Vous pouvez utiliser ces données afin de déterminer les frais à facturer à des organisations spécifiques en fonction de leur consommation. Tous les utilisateurs de la console d'administration qui disposent du droit Utilisateurs avec l'accès Lecture peuvent afficher les données d'utilisation du compte. De plus, les responsables de la facturation des organisations peuvent afficher les données d'utilisation du compte pour leurs organisations, même s'ils ne disposent pas du droit Utilisateurs dans la console d'administration. En tant qu'administrateur de la console (droit de superutilisateur), vous pouvez affecter le rôle de responsable de la facturation pour des organisations en cliquant sur Compte > Gérer les organisations.

Pour afficher les données d'utilisation du compte, procédez comme suit :

1. Cliquez sur Compte > Tableau de bord de l'utilisation ;

2. Sélectionnez l'organisation pour laquelle afficher les données ;

3. Vous pouvez afficher des détails sur l'utilisation pour les catégories suivantes :

   • les applications de contexte d'exécution qui sont utilisées,

   • l'utilisation totale des applications de contexte d'exécution en Go/heure,

   • les instances de service qui sont utilisées ;

4. Facultatif : affichez vos données pour un mois spécifique en utilisant le menu Votre activité de cloud pour sélectionner le mois de votre choix ;

5. Facultatif : cliquez sur EXPORTER DES DONNEES et sélectionnez CSV ou JSON afin d'exporter vos données pour le mois sélectionné dans un fichier CSV ou JSON.

Vous pouvez aussi afficher l'utilisation mensuelle et les frais associés au niveau du compte pour vos contextes d'exécution, vos applications et vos services qui sont mis à disposition depuis l'environnement Bluemix public. Vous pouvez utiliser ces données afin de déterminer les frais à facturer à des organisations spécifiques en fonction de leur consommation :

1. Cliquez sur Compte > Tableau de bord de l'utilisation ;

2. Cliquez sur Public ;

3. Sélectionnez l'organisation pour laquelle afficher les données ;

4. Vous pouvez afficher des détails sur l'utilisation pour les catégories suivantes :

   • les applications de contexte d'exécution qui sont utilisées,

   • l'utilisation totale des applications de contexte d'exécution en Go/heure,

   • les instances de service qui sont utilisées,

   • un récapitulatif des frais pour tous les contextes d'exécution, tous les services et toutes les applications qui sont mis à disposition ;

5. Facultatif : affichez vos données pour un mois spécifique en sélectionnant le mois de votre choix dans le graphique à barres. Les données pour le mois en cours s'affichent par défaut ;

6. Facultatif : cliquez sur EXPORTER DES DONNEES et sélectionnez CSV ou JSON afin d'exporter vos données pour le mois sélectionné dans un fichier CSV ou JSON.

Pour afficher l'utilisation par organisation, cliquez sur ADMINISTRATION > ADMINISTRATION DES ORGANISATIONS, puis sélectionnez une organisation dans Liste des organisations. La page Gérer les organisations de l'organisation sélectionnée affiche les informations suivantes sur l'utilisation :

• le nombre de services utilisés ;

• le nombre de routes utilisées ;

• un graphique du quota de mémoire qui représente le quota utilisé et le quota non utilisé ;

• un graphique de l'allocation des applications qui indique quelles sont les applications incluses dans le quota de mémoire utilisé ;

• un graphique de l'utilisation des applications mesurée qui représente un rapport sur trois mois du nombre de Go/heure consommé par application déployée. Vous pouvez sélectionner la vue Liste pour examiner les données de toutes les applications, notamment l'allocation mémoire par application et l'utilisation mesurée en Go par heure au cours des trois derniers mois.

Pour plus d'informations sur l'affichage de l'utilisation par organisation, l'ajustement des plans d'établissement des quotas et la gestion de vos organisations, voir Administration des organisations.

Vous pouvez afficher des rapports et des journaux de sécurité, comme des rapports DataPower™, de pare-feu et d'audit de connexion, sur votre instance Bluemix. Pour afficher les rapports et les journaux, cliquez sur ADMINISTRATION > RAPPORTS ET JOURNAUX.

Vous pouvez effectuer les tâches suivantes depuis la vignette Rapports et journaux :

• sélectionner des dates de début et de fin dans les zones afin de filtrer les rapports et les journaux à afficher ;

• afficher la liste des rapports que vous avez demandés et des rapports actuellement disponibles ;

• lancer des recherches dans votre collection de rapports et de journaux. La recherche s'applique aux noms de rapport ainsi qu'au contenu textuel des rapports et des journaux. Vous pouvez également choisir de filtrer votre recherche d'après la catégorie ;

• télécharger un rapport en cliquant sur l'icône  ;

• demander la génération d'un rapport si vous disposez d'un accès en écriture sur la demande de rapports. Vous pouvez choisir l'une des six catégories suivantes pour générer un rapport à la demande : gestion des utilisateurs de la console d'administration, administration de la plateforme Bluemix, refus du pare-feu, connexions au pare-feu, connexion au serveur de connexion et connexion au système d'exploitation. Vous pouvez demander des rapports portant sur des données remontant jusqu'à 90 jours.

Remarque : il se peut qu'une demande de fonction de rapport ne soit pas disponible dans tous les environnements à l'heure actuelle.

Le tableau ci-dessous présente la liste des rapports de sécurité qui sont générés pour l'environnement Bluemix local et l'environnement Bluemix dédié. La plupart des rapports sont générés quotidiennement. Toutefois, les rapports sur les événements de gestion des clés et de chiffrement sont générés mensuellement. Tous les rapports sont conservés pendant 90 jours dans la console d'administration, à partir de laquelle vous pouvez y accéder. Au bout de ces 90 jours, Bluemix les tient à disposition hors ligne sur demande pendant 9 mois. Au total, les rapports sont disponibles en vue de leur extraction pendant un an.

Vous pouvez surveiller le statut de votre instance Bluemix à l'aide de la page Statut de Bluemix. Cliquez sur Support > Statut.

La page Statut est l'emplacement central pour rechercher des notifications et des annonces sur les événements clés affectant la plateforme Bluemix et les principaux services dans Bluemix. Vous pouvez vous abonner à un flux RSS pour recevoir les notifications automatiquement et ne pas avoir à les rechercher. Pour plus d'informations sur la page Statut et la configuration du flux RSS, voir Affichage de Bluemix.

Après le déploiement initial de votre environnement Bluemix, une vérification est effectuée automatiquement sur les composants utilisés pour administrer l'environnement. Vous pouvez accéder à la page Vérification de la console d'administration afin de vérifier le statut des composants après l'exécution de la vérification. Pour accéder à la page, accédez à https://console.<sous-domaine>.bluemix.net/check, où <subdomain> est le nom de votre instance locale ou dédiée.

Vous pouvez effectuer une vérification à tout moment. Vous devez être connecté pour pouvoir sélectionner l'option d'exécution de la vérification. Si vous rencontrez des problèmes lors de l'ajout d'un utilisateur, de l'édition d'une organisation ou de la gestion de vos services, exécutez cette vérification afin de déterminer si des composants sont défaillants ou déconnectés. Vous pouvez ouvrir un ticket de demande de service avec les informations générées par la vérification pour une résolution rapide du problème.

Si vous voulez afficher un service dans votre catalogue Bluemix, vous devez implémenter et enregistrer un courtier de services. Une fois votre courtier enregistré, vous pouvez choisir les organisations qui peuvent accéder au service dans votre instance locale ou dédiée.

Les méthodes d'utilisation de votre courtier de services dépendent du nombre de services qu'il gère ou varient selon qu'il a déjà été enregistré dans Bluemix ou non.

• Si votre courtier de services gère un service, vous pouvez vous servir de l'interface utilisateur pour l'enregistrer après avoir implémenté l'API de courtier de services. Voir Enregistrement d'un courtier de services qui gère un service.

• Si votre courtier de services gère plusieurs services, utilisez l'interface de ligne de commande cf avec le plug-in d'interface de ligne de commande d'administration de Bluemix (sous-commande ba), ou utiliser l'API de service personnalisé.

• Si votre courtier de services est déjà enregistré et que vous voulez le mettre à jour ou le supprimer, utilisez l'interface de ligne de commande cf avec le plug-in d'interface de ligne de commande d'administration Bluemix (sous-commande ba) ou utilisez l'API de service personnalisé.

I-F-1-a. Enregistrement d'un courtier de services qui gère un service▲

Prenez connaissance des informations suivantes et effectuez les étapes d'enregistrement de votre courtier de services.

Avant de commencer : implémentez l'API de courtier de services Cloud Foundry pour permettre la communication entre votre service et Bluemix. L'API de courtier de services est un ensemble de nœuds finals REST consommés par Bluemix.

Lorsque vous implémentez le courtier de services, dans la réponse JSON de GET /v2/catalog, vous devez fournir les définitions pour vos services et vos plans de service, notamment les informations relatives au service que vous voulez afficher. Par exemple, examinez l'exemple de code JSON de la réponse du catalogue (GET) :

 

Sélectionnez

{
"services":[
   {
      "bindable":true,
      "description":"Cool Service est une solution d'analyse et d'entreposage de données.",
      "id":"cool-service-id",
      "name":"coolservice",
      "metadata":{
         "displayName":"Cool Service",
         "serviceMonitorApi":"https://myservicesstatus.mybluemix.net/healthcheck/",
         "providerDisplayName":"Société Cool"
         "longDescription":"Cool Service est une solution d'analyse et d'entreposage de données. Vous pouvez placer rapidement vos données dans une base de données de la prochaine génération structurant les données en colonne en mémoire et commencer à exécuter des requêtes analytiques complexes.",
         "bullets":[
            {
               "title":"Rapide et simple",
               "description":"Cool Service utilise des innovations et la technologie structurant les données en colonne en mémoire, comme le traitement vectoriel parallèle et la compression afin d'analyser et de renvoyer rapidement les données pertinentes."
            },
            {
               "title":"Connectivity",
          "description": "Cool Service a été conçu pour vous permettre de vous connecter facilement à tous vos services et à toutes vos applications. Vous pouvez commencer à analyser vos données immédiatement à l'aide d'outils familiers."
         ],
         "featuredImageUrl":"http://chemin/icon_64x64.png",
         "imageUrl":"http://chemin/icon_50x50.png",
         "mediumImageUrl":"http://chemin/icon_32x32.png",
         "smallImageUrl":"http://chemin/icon_24x24.png",
         "documentationUrl":"http://chemin/documentation.html",
         "instructionsUrl":"http://chemin/servicesample.md",
         "termsUrl":"http://chemin/terms_of_agreement.pdf",
         "media":[
            {
               "type":"youtube",
               "thumbnailUrl":"http://chemin/thumbnail.png",
               "url":"http://chemin/video/youtube",
               "caption":"Utilisez Cool Service en 60 secondes"
            },
            {
               "type":"image",
               "thumbnailUrl":"http://chemin/thumbnail.png",
               "url":"http://chemin/image_file.png",
               "caption":"Cool Service connecte des applications"
            },
            {
               "type":"video",
               "thumbnailUrl":"http://chemin/thumb.png",
               "caption":"Cool Service fonctionne avec des tables",
               "source":[
                  {
                     "type":"video/mp4",
                     "url":"http://chemin/video_file.mp4"
                  },
                  {
                     "type":"video/ogg",
                     "url":"http://chemin/video_file.ogg"
                  }
               ]
            }
         ]
      },
      "plans":[
         {
            "name":"smallplan",
            "description":"Schéma et espace table dédiés par instance de service sur un serveur partagé. 1 Go et 10 Go de stockage de base de données compressées peuvent contenir respectivement jusqu'à 5 Go et 50 Go de données non compressées selon des taux de compression standard.",
            "free":false,
            "id":"cool-service-plan-id",
            "metadata":{
               "bullets":[
                  "1 Go minimum par instance. 10 Go maximum par instance."
               ],
               "costs":[
                  {
                     "unitId":"INSTANCES_PAR_MOIS",
                     "unit":"PAR MOIS",
                     "partNumber":"D15UTLL"
                  }
               ],
               "displayName":"Small"
            }
         }
      ]
   }
]
}

Les tableaux ci-dessous peuvent vous aider à remplir le fichier JSON.

Tableau 10. Zones JSON

Zones JSON	Description
bindable	Valeur booléenne qui indique si des instances de service peuvent être liées à des applications.
description	Description du service qui s'affiche lorsque vous utilisez la commande cf marketplace ou passez votre souris sur l'icône de service dans le catalogue de l'interface utilisateur Bluemix. Vous pouvez ajouter une phrase unique comme description.
name	Nom du service qui s'affiche dans l'interface de ligne de commande cf. Il doit être unique dans Bluemix et doit utiliser des minuscules et ne pas contenir d'espace. Vous ne pouvez pas le changer une fois le service enregistré auprès de Bluemix.
id	ID du service. Il doit être unique dans Bluemix et il doit s'agir d'un identificateur global unique. Vous ne pouvez pas le changer une fois le service enregistré auprès de Bluemix.
metadata	Métadonnées du plan de service qui s'affichent dans le catalogue Bluemix et dans la fiche de prix. La zone metadata est facultative. Vous pouvez spécifier d'autres zones pour les métadonnées. Voir le tableau suivant intitulé Zones de métadonnées pour plus d'informations.
plans	Tableau de définitions de plan de service. Voir le tableau suivant intitulé Zones de plan pour plus d'informations.

Tableau 11. Zones de métadonnées

Valeurs des métadonnées	Description
displayName	Nom du plan qui est affiché dans l'interface utilisateur de Bluemix. Il est affiché dans la page des détails du service dans le catalogue ainsi que dans la fiche de prix. La première lettre du plan seulement doit être en majuscule. N'utilisez pas « Default » comme nom de plan par défaut ; utilisez plutôt « Standard ».
providerDisplayName	Nom du fournisseur de services.
longDescription	Description détaillée du service. Envisagez d'utiliser deux phrases au moins pour une description longue.
plans	Tableau de définitions de plan de service. Chaque entrée de tableau dans la zone des plans se compose des zones suivantes : name, description, free, id et metadata. Voir le tableau suivant intitulé Zones de plan pour plus d'informations.
bullets	Tableau de chaînes affichées pour un service. Vous pouvez utiliser des puces pour fournir des informations en plus de la description longue. La zone bullets doit contenir deux éléments de puce au moins. Chaque puce inclut la zone de titre et la zone de description.
imageUrl	Adresse URL d'une grande image PNG (50 x 50 pixels).
smallImageUrl	Adresse URL d'une petite image PNG (24 x 24 pixels).
mediumImageUrl	Adresse URL d'une image moyenne PNG (32 x 32 pixels).
featuredImageUrl	Adresse URL de l'image mise en évidence (64 x 64 pixels).
documentationUrl	Adresse URL de la documentation sur le service.
termsUrl	Adresse URL des fichiers PDF contenant les termes du contrat.
media (facultative)	Tableau d'éléments pour l'affichage des vidéos et des captures d'écran qui présentent le service dans l'interface utilisateur Bluemix. Un élément media peut contenir les zones suivantes : type (image, youtube, video), thumbnailUrl (adresse URL de l'image d'aperçu pour l'élément de support, url (adresse URL de la capture d'écran ou de la vidéo YouTube), source (sources des vidéos qui ne sont pas hébergées sur YouTube. Le « type » de la source de la vidéo doit être pris en charge par HTML5. Incluez les zones « type » et « url » pour la vidéo.), et caption (légende pour l'élément media. Les légendes contribuent à l'accessibilité pour les personnes souffrant de handicaps et leur permettent de comprendre vos éléments support).
serviceKeysSupported	Valeur booléenne qui indique si l'API des clés de service est prise en charge. Celle-ci permet d'activer un service à utiliser hors de Bluemix. La valeur par défaut est false.
plan_updateable	Valeur booléenne qui indique si le service prend en charge les changements de plan. La valeur par défaut est false.
embeddableDashboard (facultative)	Zone qui indique comment le tableau de bord du service est affiché dans l'interface utilisateur de Bluemix. Si vous ne spécifiez pas cette zone, le tableau de bord est imbriqué, mais est limité à une largeur minimale de 960 pixels et présente un remplissage horizontal supplémentaire autour de l'iframe. Vous pouvez utiliser true, false, drilldown ou launch. Vous pouvez utiliser les zones suivantes pour cette valeur : true, false, drilldown et launch.
notCreatable (facultative)	Valeur booléenne qui indique si des instances pour le service peuvent être créées depuis l'interface utilisateur Bluemix et depuis l'interface de ligne de commande cf. La valeur true signifie que les instances de service ne peuvent pas être créées depuis l'interface utilisateur Bluemix ou l'interface de ligne de commande cf. La valeur par défaut est false.
notCreatableMessage (facultative)	Message affiché dans l'interface utilisateur Bluemix si des instances de service ne peuvent pas être créées. Si vous ne spécifiez pas cette zone, le message par défaut suivant est affiché : pour être averti de sa disponibilité, confirmez votre adresse électronique ou entrez une nouvelle adresse.
notCreatableRobotMessage (facultative)	Message affiché dans la bulle de la page des détails du service dans l'interface utilisateur Bluemix. Il indique qu'un service présente un problème ou toute autre raison rendant le service indisponible. Vous pouvez spécifier un message afin d'expliquer la raison. Si vous ne spécifiez pas cette zone, le message par défaut suivant est affiché : ce service n'est pas disponible actuellement.
apiReferenceUrl (facultative)	Adresse URL de l'iframe dans la zone Référence d'API de la page des détails du service dans le catalogue. Si elle n'est pas utilisée pour la page des détails du service dans le catalogue, vous pouvez entrer la valeur numérique affectée à votre documentation d'API REST pour votre service lorsque vous avez enregistré le service dans le microservice de la documentation d'API REST Bluemix. Ainsi, votre documentation d'API REST s'affichera dans le tableau de bord du service.
sdkDownloadUrl (facultative)	Adresse URL de la page Web qui est ouverte lorsque vous cliquez sur le bouton Télécharger les logiciels SDK. Ce dernier se trouve sur la vignette du service dans la page de présentation des applications dans le tableau de bord. La page Web est ouverte dans un nouvel onglet de navigateur.
serviceMonitorApi	Adresse URL d'une API qui renvoie les données JSON indiquant la santé du service, conformément à l'exemple ci-après. La zone serviceMonitorApi ou serviceMonitorApp doit être définie dans vos métadonnées de service. Voir l'exemple de code ci-après.
serviceMonitorApp	Adresse URL d'une application qui peut être déployée dans Bluemix et liée à un service afin de fournir la sortie spécifique de statut du service. L'application doit renvoyer le même format de données JSON que serviceMonitorApi. La zone serviceMonitorApi ou serviceMonitorApp doit être définie dans vos métadonnées de service. Voir l'exemple de code ci-après.

 

Sélectionnez

{
    "service": "nomservice",
    "version": 1,
    "health": [
        {
            "plan": "starter",
            "status": 0,
            "serviceinput": "count(*) from healthcheck",
            "serviceoutput": "10…or error 1234 database not running",
            "responsetime": 4
        },
        {
            "plan": "enterprise",
            "status": 1,
            "serviceinput": "count(*)fromhealthcheck",
            "serviceoutput": "10…orerror1234databasenotrunning",
            "responsetime": 4
        }
    ]
}

L'exemple suivant montre comment la réponse JSON de GET /v2/catalog est mappée à la page des détails du service dans le catalogue Bluemix :

Tableau 12. Zones de plan

Valeurs de plan	Description
name	Nom du service qui est utilisé dans l'interface de ligne de commande cf. Par exemple, le nom du plan est affiché dans la sortie de la commande cf marketplace. Il doit être en minuscules, ne pas contenir d'espace, et être unique dans le service.
description	Description du plan de service. Elle est affichée une fois que vous sélectionnez un plan dans la page des détails du service dans le catalogue Bluemix.
free	Valeur booléenne qui indique si le plan de service est gratuit. La valeur par défaut est true.
id	ID du plan de service. Il doit être unique et il doit s'agir d'un identificateur global unique.
metadata (facultative)	Métadonnées du plan de service qui s'affichent dans le catalogue Bluemix et dans la fiche de prix. La zone metadata est facultative. Vous pouvez spécifier les zones suivantes dans la zone metadata : displayName, type (subscription, reservable, planDetails), bullets, costs (unitId, unit, partNumber) et paidOnly. Voir le tableau ci-après intitulé Zones de métadonnées de plan pour plus d'informations.

Tableau 13. Zones de métadonnées de plan

Valeurs des métadonnées de plan	Description
displayName	Nom du plan qui est affiché dans l'interface utilisateur de Bluemix. Il est affiché dans la page des détails du service dans le catalogue ainsi que dans la fiche de prix.
type	Type de plan. Vous pouvez utiliser les valeurs suivantes pour cette zone : subscription (un plan d'abonnement. La valeur par défaut est false), reservable (un plan réservable. Cette valeur n'est utilisée que lorsque le plan est un plan d'abonnement, c'est-à-dire lorsque la valeur de plan.metadata.subscription est true. La valeur par défaut est false), planDetails (quantité détaillée et description des ressources pouvant être utilisées avec le plan. Cette valeur n'est utilisée que lorsque le plan est réservable, c'est-à-dire lorsque la valeur de plan.metadata.reserveable est true).
bullets	Description des ressources pouvant être utilisées avec le plan. Elle est affichée dans la colonne Fonctions dans la page des détails du service du catalogue et dans la fiche de prix.
costs	Informations sur le cout du service qui sont affichées dans la colonne Prix dans la page des détails du service du catalogue et dans la fiche de prix. Chaque entrée de tableau contient les zones suivantes : unitId (ID de l'unité. Utilisez le pluriel et des majuscules seulement. Pour les plans gratuits, cette zone est facultative), unit (mesure utilisée pour le calcul du prix du service. La valeur de cette zone est utilisée dans l'interface utilisateur Bluemix pour représenter le paramètre de calcul des frais), et partNumber (identificateur part_number utilisé par le système de facturation. Pour les plans gratuits, cette zone est facultative).
paidOnly (facultative)	Valeur booléenne qui indique si ce plan de service est disponible pour les comptes Bluemix payants seulement. Si la valeur est true, le plan de service n'est valable que pour les comptes payants et ne peut pas être ajouté à des comptes d'essai. Si la valeur est false, le plan de service peut être ajouté à des comptes payants et à des comptes d'essai. La valeur par défaut est false.

L'exemple ci-après montre comment la réponse JSON de GET /v2/catalog est mappée à la page des détails du service dans le catalogue Bluemix. Il illustre notamment comment les zones de métadonnées de plan décrites dans le tableau précédent sont mappées à l'interface utilisateur :

1. Après avoir implémenté l'API de courtier de services, accédez à Administration > Gestion du catalogue ;

2. Cliquez sur Enregistrement d'un courtier de services ;

3. Remplissez le formulaire en entrant des valeurs dans les zones suivantes :

   • nom du courtier de services,

   • adresse URL du courtier de services,

   • nom d'utilisateur du courtier de services,

   • mot de passe du courtier de services ;

4. Cliquez sur CONNECTER ;

5. Passez en revue les informations relatives à votre service, notamment les plans disponibles, l'icône et la description du service.

   Remarque : si vous devez changer les informations de catalogue pour le service, mettez à jour votre courtier de services et lancez à nouveau le processus d'enregistrement en remplissant le formulaire ;

6. Cliquez sur ENREGISTRER ;

7. Choisissez d'activer tous les plans ou des plans spécifiques seulement pour le service. Tous les plans sont désactivés par défaut ;

8. Activez l'instance de service pour toutes les organisations ou pour des organisations spécifiques.

À présent, votre service apparaît dans la catégorie Services personnalisés de votre catalogue Bluemix. Accédez à ADMINISTRATION > GESTION DES CATALOGUES et sélectionnez la vignette dans le catalogue. Vous pouvez activer différents plans et éditer la visibilité d'un plan pour vos organisations à tout moment.

Pour créer une organisation et ajouter des responsables, procédez comme suit :

1. Cliquez sur CREATION D'ORGANISATION ;

2. Entrez un nom pour l'organisation ;

3. Entrez le nom ou l'adresse électronique de la personne à ajouter en tant que responsable. Vous pouvez ajouter plusieurs responsables en entrant et en sélectionnant plusieurs noms ;

4. Cliquez sur CREATION D'ORGANISATION pour sauvegarder vos modifications et créer l'organisation.

Vous pouvez créer des espaces dans votre organisation, par exemple un espace dev comme environnement de développement, un espace test comme environnement de test et un espace production comme environnement de production. Ensuite, vous pouvez associer vos applications à des espaces. Procédez comme suit pour créer un espace :

1. Dans la barre de menu, cliquez sur Compte > Gérer les organisations ;

2. Sélectionnez l'organisation à laquelle ajouter un espace ;

3. Cliquez sur Créer un espace ;

4. Entrez un nom d'espace ;

5. Cliquez sur Créer.

Vous pouvez développer la section Surveillance des quotas pour afficher les informations suivantes :

• l'utilisation de la mémoire de l'environnement présente en détail l'utilisation de la mémoire dans l'environnement système complet. Le graphique affiche les informations suivantes :

  • la mémoire physique qui est utilisée et la limite de mémoire physique qui est disponible,

  • le quota de mémoire qui est actuellement réservée et la limite de mémoire qui peut être réservée,

  • le quota total de mémoire pour vos organisations.

  Les types ci-après d'utilisation de la mémoire sont affichés dans le graphique.

  Mémoire physique utilisée

  • Quantité de mémoire physique utilisée par votre environnement.

  Limite physique

  • Quantité de mémoire physique totale qui est disponible dans votre environnement.

  Quota mémoire réservée

  • Quantité de mémoire réservée pour toutes les applications déployées, dans toutes les organisations. La somme du quota qui est réservé peut dépasser la limite physique de mémoire pour votre environnement. Par exemple, si la limite de mémoire physique est de 16 Go, vous pouvez réserver 4 Go de mémoire à chaque application, pour un total de cinq applications différentes. Le quota qui est réservé dépasse la limite physique de mémoire. Cependant, dans la plupart des cas, les applications n'utilisent pas le quota total qui est réservé individuellement pour chaque application. De plus, les applications n'utilisent pas toutes la totalité de leur quota de mémoire réservée simultanément.

  Limite de réservation

  • Mémoire totale pouvant être réservée pour toutes les applications dans votre environnement.

  Quota total

  • Quota total de mémoire dans toutes les organisations.

  Remarque : les données sont actualisées automatiquement toutes les quatre heures. Cliquez sur Recalculer si vous voulez actualiser les données figurant sur la page avant qu'elles ne soient mises à jour automatiquement ;

• utilisation de la mémoire de l'organisation. Cette section détaille l'utilisation de la mémoire au niveau de l'organisation. Vous pouvez afficher le quota total de mémoire, le quota réservé et la mémoire physique utilisée par chaque organisation. Le graphique fournit des informations triées en fonction de la réservation de mémoire la plus élevée par organisation ; par défaut, l'organisation qui réserve la quantité de mémoire la plus élevée est répertoriée en premier. Vous pouvez effectuer un tri en fonction du paramètre.

  Utilisation de la mémoire la plus élevée et du paramètre Allocation de mémoire superflue.

  Utilisation de la mémoire la plus élevée

  • Utilisez cette option pour identifier l'organisation qui a réservé la quantité de mémoire la plus élevée. Effectuez un tri par utilisation de la mémoire la plus élevée pour identifier les organisations qui ont réservé la quantité de mémoire la plus élevée. La liste est triée par quota réservé.

  Allocation de mémoire superflue

  • Utilisez cette option pour identifier les organisations dont le quota total de mémoire est supérieur aux besoins. Effectuez un tri par allocation de mémoire superflue pour identifier les organisations qui utilisent la quantité de mémoire la plus faible par rapport au quota qui leur a été alloué.

Un quota représente les limites de ressources pour les organisations de votre environnement et est affecté lorsque l'organisation est créée. Toute application ou tout service dans un espace de l'organisation contribue à l'utilisation du quota alloué. Pour gérer le quota d'une organisation, procédez comme suit :

1. Cliquez dans le graphique sur la barre correspondant à l'organisation que vous voulez éditer dans la section Utilisation de la mémoire de l'organisation ou sélectionnez le nom de l'organisation dans la section Liste des organisations. Dans la page Informations sur l'organisation, vous pouvez renommer l'organisation et ajouter ou supprimer des responsables.

   Remarque : vous recevez un message si vous sélectionnez un plan d'établissement des quotas qui n'est pas suffisant pour l'utilisation en cours pour l'organisation ;

2. Cliquez sur Cloud Foundry ou sur Conteneurs. Par défaut, la page du quota Cloud Foundry s'ouvre.
   • À partir de la page Cloud Foundry, vous pouvez sélectionner un plan et afficher les détails du quota des ressources suivantes :

   • Services,

   • Routes,

   • Quota de mémoire,

   • Allocation des applications.

   • Dans la page Conteneurs, vous pouvez affecter des valeurs entières aux zones suivantes.

     Limite d'image

     • Nombre maximal d'images de conteneur pouvant être contenues dans votre registre privé. Une image de conteneur est la base de chaque conteneur que vous créez. Une image est créée depuis un Dockerfile, lequel est un fichier en lecture seule contenant le système d'exploitation, l'application et toutes ses dépendances, et décrivant comment un conteneur est configuré. Les images sont partagées entre tous les membres d'une organisation.

     Allocation de mémoire par défaut

     • Quantité de mémoire de conteneur automatiquement allouée à la création d'un nouvel espace. Lors de la création d'un conteneur, vous devez choisir une taille de conteneur. Cette taille détermine la quantité de mémoire que le conteneur peut utiliser sur l'hôte de calcul et est comptabilisée dans votre limite de mémoire de conteneur.

     Allocation de mémoire maximale

     • Quantité maximale de mémoire de conteneur pouvant être allouée entre tous les espaces d'une organisation.

     Adresses IP flottantes par défaut

     • Nombre d'adresses IP publiques automatiquement allouées à la création d'un nouvel espace. Vous pouvez lier des adresses IP publiques à des conteneurs isolés et des groupes de conteneurs afin de les rendre accessibles depuis Internet.

     Adresses IP flottantes maximales

     • Nombre maximal d'adresses IP publiques pouvant être allouées entre tous les espaces d'une organisation.

     Remarque : si vous ne disposez pas encore de conteneurs dans votre environnement, ou si les conteneurs de votre environnement ne sont pas encore configurés, vous obtenez un message d'erreur.

     Pour plus d'informations sur les conteneurs, voir À propos d'IBM containers. Pour plus d'informations sur les quotas de conteneur, voir Quota et comptes Bluemix.

     Remarque : les conteneurs ne sont pas disponibles dans la région Bluemix Sydney.

     1. Pour sauvegarder les modifications que vous avez apportées dans la page Gérer l'organisation, cliquez sur SAUVEGARDER.

Dans la section Liste des organisations, vous pouvez afficher toutes les organisations de l'environnement Bluemix, et vous pouvez effectuer des actions pour des organisations individuelles en cliquant sur le nom de l'organisation.

• Pour supprimer l'organisation, cliquez sur l'icône Supprimer dans la colonne Actions.

• Afin d'afficher le plan d'établissement des quotas et l'utilisation pour une organisation, cliquez sur le nom de l'organisation dans la liste. La page Gérer les organisations de l'organisation sélectionnée affiche les informations suivantes sur l'utilisation :

• le nombre de services utilisés ;

• le nombre de routes utilisées ;

• un graphique du quota de mémoire qui représente le quota utilisé et le quota non utilisé ;

• un graphique de l'allocation des applications qui indique quelles sont les applications incluses dans le quota de mémoire utilisé ;

• un graphique de l'utilisation des applications mesurée qui représente un rapport sur trois mois du nombre de Go/heure consommé par application déployée. Vous pouvez sélectionner la vue Liste pour examiner les données de toutes les applications, notamment l'allocation mémoire par application et l'utilisation mesurée en Go par heure au cours des trois derniers mois.

• Pour éditer le nom de l'organisation et ajouter ou retirer des responsables, cliquez sur le nom de l'organisation dans la liste et suivez les invites à l'écran ;

• Pour afficher des informations sur un utilisateur particulier de l'organisation que vous visualisez, cliquez sur le nom d'utilisateur pour voir les Informations utilisateur. Vous pouvez ensuite cliquer sur le nom de l'organisation pour revenir aux Informations sur l'organisation.

En fonction de l'accès Lecture ou Ecriture pour les droits des utilisateurs, vous pouvez rechercher des utilisateurs existants, retirer des utilisateurs et ajouter des utilisateurs individuellement ou via un groupe. Si vous possédez le droit Superutilisateur, vous disposez d'un accès complet vous permettant d'exécuter n'importe quelle tâche pour la gestion des utilisateurs dans l'environnement. Passez en revue les tâches de gestion des utilisateurs suivantes et le niveau d'accès requis pour accomplir chacune de ces tâches :

• localisez les utilisateurs. Si vous disposez des accès Lecture ou Ecriture et que vous connaissez une partie ou la totalité du nom d'utilisateur, vous pouvez localiser des utilisateurs dans la table à l'aide de la zone Rechercher. Vous pouvez également filtrer la liste des utilisateurs en fonction de leur organisation et de leurs droits. Pour filtrer une liste d'utilisateurs, procédez comme suit :

  1. Cliquez sur Filtrer,

  2. Cliquez sur Organisations ou Droits, selon le filtrage que vous voulez appliquer.

     Organisation

     • Pour filtrer des utilisateurs par organisation, commencez à saisir le nom de l'organisation dans la zone Organisation et sélectionnez l'organisation dans la liste. Ensuite, sélectionnez le ou les rôles affectés aux utilisateurs dans l'organisation.

     Droits

     • Pour filtrer les utilisateurs en fonction de leurs droits, sélectionnez d'abord le type d'utilisateur. Par exemple, vous pouvez choisir d'afficher tous les superutilisateurs. Pour les droits autres que Superutilisateur ou Accès de base, vous pouvez aussi sélectionner le type d'accès, par exemple Lecture ou Ecriture,

  3. Cliquez sur Appliquer.

  La fenêtre Administration des utilisateurs affiche les filtres que vous définissez et les utilisateurs qui sont trouvés avec les filtres spécifiés. Ensuite, vous pouvez rechercher un utilisateur dans la table filtrée. Vous pouvez aussi modifier la liste des filtres spécifiés en retirant une option de filtre de la liste ;

• ajoutez un seul utilisateur. Si vous disposez des droits Superutilisateur ou Utilisateurs avec un accès Ecriture, vous pouvez ajouter des utilisateurs.

  1. Pour ajouter un seul utilisateur depuis votre annuaire LDAP, cliquez sur Ajouter un utilisateur,

  2. Dans la zone Rechercher, entrez l'adresse électronique de l'utilisateur, puis sélectionnez l'utilisateur dans la liste,

  3. Ensuite, dans la zone Organisation, choisissez l'organisation à laquelle ajouter l'utilisateur en entrant le nom de l'organisation et en le sélectionnant dans la liste,

  4. Pour ajouter l'utilisateur à l'organisation sélectionnée, cliquez sur Ajouter un utilisateur.

  Remarque : lorsque l'opération d'ajout aboutit, l'utilisateur est ajouté au tableau pour que vous puissiez l'afficher et le rechercher. Lorsque des utilisateurs sont ajoutés, aucun droit ne leur est affecté ;

• ajoutez un groupe d'utilisateurs depuis votre annuaire LDAP. Si vous disposez des droits Superutilisateur ou Utilisateurs avec un accès Ecriture, vous pouvez ajouter des utilisateurs :

  1. Cliquez sur Ajouter un groupe d'utilisateurs,

  2. Dans la zone Rechercher, entrez un nom de groupe à rechercher, puis sélectionnez le nom de groupe dans la liste,

  3. Ensuite, dans la zone Organisation, choisissez l'organisation à laquelle ajouter le groupe d'utilisateurs en entrant le nom de l'organisation et en le sélectionnant dans la liste,

  4. Pour ajouter le groupe d'utilisateurs à l'organisation sélectionnée, cliquez sur Ajouter des utilisateurs.

  Remarque : les groupes de plus de 50 utilisateurs sont ajoutés via un travail par lots en arrière-plan. Lorsque l'opération d'ajout aboutit, l'utilisateur ou le groupe est ajouté au tableau pour que vous puissiez l'afficher et le rechercher. Lorsque des utilisateurs sont ajoutés, aucun droit ne leur est affecté ;

• ajoutez un groupe d'utilisateurs en important une feuille de calcul qui répertorie des ID utilisateur, des adresses électroniques d'utilisateur et l'organisation à laquelle vous voulez ajouter l'utilisateur. Si vous disposez des droits Superutilisateur ou Utilisateurs avec un accès Ecriture, vous pouvez ajouter des utilisateurs.

Remarque : entrez les ID utilisateur qui correspondent aux valeurs utilisées dans votre registre d'utilisateurs.

1. Cliquez sur Importer des utilisateurs.

2. Cliquez sur Télécharger un modèle (.CSV) pour télécharger une feuille de calcul avec les colonnes requises que vous pourrez remplir ou créez votre propre modèle en utilisant une feuille de calcul qui comporte les en-têtes de colonne requis : ID utilisateur, Courrier électronique et Organisation. Deux colonnes facultatives sont également incluses dans le modèle : Prénom et Nom.

3. Indiquez les valeurs d'utilisateur dans les colonnes requises. Si vous n'utilisez pas d'annuaire LDAP, utilisez les en-têtes de colonne requis et les en-têtes de colonne facultatifs pour les utilisateurs que vous importez,

4. Sauvegardez votre fichier et cliquez sur Envoyer le fichier par téléchargement.

   Remarque : les colonnes de votre feuille de calcul peuvent apparaître dans n'importe quel ordre tant que toutes les colonnes requises sont présentes. Si l'importation aboutit, vous recevez un message de confirmation indiquant que tous les utilisateurs ont été ajoutés. Si l'importation n'a abouti que pour certains utilisateurs, consultez le message d'erreur afin de prendre des mesures pour les utilisateurs qui n'ont pas pu être ajoutés ;

• retirez des utilisateurs. Si vous disposez du droit Superutilisateur ou du droit Utilisateurs avec l'accès Ecriture, vous pouvez retirer définitivement des utilisateurs de l'environnement.

  1. Localisez l'utilisateur et cliquez sur l'icône .

  2. Cliquez sur Retirer ;

• pour éditer les droits et les organisations des utilisateurs, vous devez disposer du droit Superutilisateur. Pour éditer les droits des utilisateurs, localisez ces derniers et cliquez sur leur nom. Dans la page Edition d'utilisateur, vous pouvez activer ou désactiver les droits :

  1. Sélectionnez Activé dans la liste pour activer le droit Superutilisateur ou Accès de base,

  2. Sélectionnez Lecture dans la liste pour que l'utilisateur dispose de l'accès Lecture (en lecture seule) pour ce droit ou sélectionnez Ecriture pour que l'utilisateur dispose de l'accès Ecriture (édition ou ajout et retrait) pour ce droit.

  3. Sélectionnez Désactivé pour désactiver n'importe lequel des droits.

     Remarque : lorsque le droit Superutilisateur a pour valeur Activé, tous les autres droits sont définis avec l'accès Ecriture ;

• Pour ajouter ou retirer un utilisateur dans une organisation spécifique, vous devez disposer du droit Superutilisateur ou du droit Utilisateurs avec l'accès Ecriture.

  1. Pour ajouter un utilisateur à une organisation, sélectionnez le nom de celui-ci dans le tableau pour accéder à la page Edition d'utilisateur. Ensuite, utilisez la zone de recherche pour localiser une organisation, sélectionnez celle-ci dans la liste, puis cliquez sur Sauvegarder.

  2. Pour retirer un utilisateur d'une organisation, sélectionnez le nom de l'utilisateur concerné dans le tableau afin d'accéder à la page Edition d'utilisateur. Ensuite, cliquez sur pour l'organisation dont vous souhaitez retirer l'utilisateur, puis cliquez sur Sauvegarder ;

• pour afficher les informations sur l'organisation à laquelle l'utilisateur est affecté, cliquez sur le nom de l'organisation pour afficher les Informations sur l'organisation. Vous pouvez ensuite cliquer sur le nom d'utilisateur pour revenir aux Informations utilisateur.

Les droits suivants peuvent être accordés aux utilisateurs avec des niveaux d'accès particuliers (lecture ou écriture) qui permettent à ces derniers d'exécuter des tâches spécifiques dans la console d'administration.

Pour pouvoir exécuter des requêtes d'API Admin, vous devez vous connecter à la console d'administration.

Pour vous connecter à la console d'administration, vous pouvez utiliser l'authentification d'accès de base sur le nœud final https://console.<region>.bluemix.net/login. Le serveur renvoie un cookie avec votre session. Vous utilisez ce cookie pour toutes les opérations avec la console d'administration.

Remarque : la session n'est plus valide si elle n'est pas utilisée pendant quelques heures.

Pour vous connecter à la console d'administration, exécutez la commande suivante :

curl --user <user_id>:<password> -c ./cookies.txt --header "Accept: application/json" https://console.<region>.bluemix.net/login | python -m json.tool

--user id_utilisateur:mot_de_passe

• Accepte l'ID utilisateur et le mot de passe et envoie un en-tête d'autorisation de base.

-c nom_fichier

• Stocke l'ID utilisateur et le mot de passe spécifiés sous forme de cookie dans le fichier spécifié.

-b nom_fichier

• Extrait l'ID utilisateur et le mot de passe spécifiés sous forme de cookie dans le fichier spécifié.

--header

• Envoie un en-tête Accept.

Voici un exemple de sortie pour cette commande :

{
    "message": "Logged in",
    "name": {
        "familyName": "*last_name*",
        "givenName": "*first_name*"
    }
}

Vous pouvez également stocker votre ID utilisateur et votre mot de passe de manière à ne pas avoir à les saisir manuellement chaque fois que vous vous connectez. Pour stocker votre ID utilisateur et votre mot de passe afin de les réutiliser ultérieurement, utilisez l'exemple cURL suivant :

curl -X GET -H "Authorization: Basic <redacted>" -H "Accept: application/json" "http://localhost:3000/login"

Pour configurer vos informations de connexion dans un fichier distinct, puis appeler ce fichier de manière à ne pas avoir à le saisir à nouveau pour chaque demande d'authentification, utilisez l'option --netrc fournie par la commande cURL.

Pour utiliser l'option --netrc avec cURL, commencez par créer un fichier dans le répertoire de base de l'utilisateur en procédant de l'une des manières suivantes :

• sur un système Unix, créez un fichier nommé .netrc ;

• sur un système Windows, créez un fichier nommé _netrc.

Dans le fichier, entrez les informations suivantes :

machine console.<region>.bluemix.net login <id> password <password>

Lors de l'appel d'une commande cURL, ajoutez l'argument suivant : --netrc.

Lorsque vous vous connectez à la console d'administration, le serveur renvoie un cookie avec votre session. Ce cookie est requis dans le cadre du processus de connexion pour les futurs appels API relatifs à toutes les opérations liées à la console d'administration. Vous pouvez stocker des cookies afin de les utiliser ultérieurement.

Pour stocker des cookies après vous être connecté, utilisez l'option -c, comme illustré dans l'exemple CURL suivant :

curl --user <user_id>:<password> -c ./cookies.txt --header "Accept: application/json" https://console.<region>.bluemix.net/login | python -m json.tool

Pour réutiliser des cookies, utilisez l'option -b avec le nom de fichier de cookies que vous avez affecté à l'aide de l'option -c, comme illustré dans l'exemple CURL suivant :

curl --user <user_id>:<password> -b ./cookies.txt

Lorsque vous ajoutez un utilisateur, vous devez spécifier une organisation. Vous pouvez utiliser l'API REST Admin pour répertorier toutes les organisations. Vous devez disposer du droit Utilisateurs avec l'accès Lecture pour pouvoir répertorier les organisations. Pour répertorier toutes les organisations, exécutez la commande suivante :

curl -b ./cookies.txt https://<your_host>.ibm.com/codi/v1/organizations | python -m json.tool

-b nom_fichier

• Transmet l'ID utilisateur et le mot de passe stockés précédemment avec l'option -c dans le fichier sur le serveur HTTP sous forme de cookie.

Pour chaque organisation, les résultats incluent les informations suivantes :

• "guid", identificateur global unique de l'organisation ;

• "name", nom de l'organisation.

Voici un exemple de sortie pour cette commande :

{
     "resources": [
         {
             "guid": "05af098d-d476-4fb0-8b87-a84350e72af3",
             "name": "org-1"
         },
         {
             "guid": "5129a5a8-37c2-4ee4-a9b2-bebae3531db5",
             "name": "org-2"
         },
            
                  ....
            
         ],
         "total_results": 284
}

Vous pouvez déterminer si un utilisateur a déjà été ajouté à votre environnement Bluemix en utilisant l'API REST Admin afin de répertorier les utilisateurs enregistrés. Vous devez disposer du droit Utilisateurs avec l'accès Lecture pour pouvoir répertorier les utilisateurs enregistrés. Pour répertorier tous les utilisateurs, exécutez la commande suivante :

curl -b ./cookies.txt https://<your_host>.ibm.com/codi/v1/users | python -m json.tool

-b nom_fichier

• Transmet l'ID utilisateur et le mot de passe stockés précédemment avec l'option -c dans le fichier sur le serveur HTTP sous forme de cookie.

Pour chaque utilisateur enregistré, les résultats incluent les informations suivantes :

• "first_name" (prénom) et "last_name" (nom) ;

• "user_id", ID utilisateur et adresse électronique ;

• "guid", identificateur global unique de l'organisation ;

• "permissions", droits qui sont affectés à l'utilisateur pour la console d'administration.

Voici un exemple de sortie pour cette commande :

{
    "next_url": "/codi/v1/users?results_per_page=100&page=2",
    "prev_url": "",
    "resources": [
        {
            "active": true,
            "created_at": "2015-04-08T17:38:51.788Z",
            "created_by": "",
            "first_name": "un prénom",
            "guid": "5d5268cf-39c0-48d3-96ae-7afe928e5dd7",
            "last_name": "un nom",
            "permissions": [
                {
                    "display": "ops.admin"
                },
                {
                    "display": "ops.catalog.write"
                },
                {
                    "display": "ops.reports.write"
                },
                {
                    "display": "ops.catalog.read"
                },
                {
                    "display": "ops.users.write"
                },
                {
                    "display": "ops.reports.read"
                },
                {
                    "display": "ops.login"
                },
                {
                    "display": "ops.users.read"
                }
            ],
            "user_id": "un_id@us.ibm.com"
        },
                  ...
            
            
     }
    ],
    "total_pages": 395,
    "total_results": 39421
}

Vous pouvez utiliser l'API REST Admin pour ajouter des utilisateurs à l'instance Bluemix. Vous devez disposer du droit Utilisateurs avec l'accès Ecriture pour pouvoir ajouter des utilisateurs ou du droit Superutilisateur (ops.admin) pour la console d'administration. De plus, en tant qu'administrateur, vous pouvez autoriser les membres d'organisation qui ne disposent pas des droits Utilisateur ou Superutilisateur à ajouter de nouveaux utilisateurs uniquement à leur organisation. Utilisez la commande d'API suivante pour cette fonction spécifique pour les responsables d'organisation :

PUT console.<sous-domaine>.bluemix.net/codi/env_config/allow_managers?flag=<TRUE ou FALSE>

Vous pouvez ajouter un utilisateur ou une liste d'utilisateurs. Vous pouvez ajouter des utilisateurs à une seule organisation ou à plusieurs organisations. Pour ajouter un utilisateur, vous devez fournir les informations suivantes :

• prénom et nom de l'utilisateur. Indiquez les valeurs "first_name" et "last_name" figurant dans Liste des utilisateurs ;

• adresse électronique et ID utilisateur. Indiquez la valeur "user_id" figurant dans Liste des utilisateurs pour l'adresse électronique et l'ID utilisateur ;

• "guid". Indiquez l'identificateur global unique de l'organisation figurant dans Liste des organisations.

Vous fournissez les informations dans un fichier JSON.

curl -b ./cookies.txt https://<your_host>.ibm.com/codi/v1/users | python -m json.tool

-b nom_fichier

• Transmet l'ID utilisateur et le mot de passe stockés précédemment avec l'option -c dans le fichier sur le serveur HTTP sous forme de cookie.

1. Créez un fichier JSON qui contient les informations dans un format JSON correct.

   Par exemple, créez un fichier appelé user.json dont le contenu est le suivant :

    

   Sélectionnez

   {
       "members": [
           {
               "emails": [
                   "un_id_utilisateur@domaine.com"
               ],
               "first_name": "un_prénom",
               "last_name": "un_nom",
               "user_id": "un_id_utilisateur@domaine.com"
           }
       ],
       "organization_roles": [
           {
               "id": "7a891f9c-e4e7-46c7-8b4e-dffaa7eb3bcd"
           }
       ]
   }

2. Publiez le contenu du fichier JSON sur le nœud final de l'utilisateur en exécutant la commande suivante :

    

   Sélectionnez

   curl -v -b ./cookies.txt -X POST -H "Content-Type: application/json" -d @./user.json https://.ibm.com/codi/v1/users

-v

• Spécifie la sortie prolixe.

-X POST

• Spécifie une demande POST, qui remplace la demande GET par défaut.

-H « Content-Type: application/json »

• Spécifie l'en-tête content-type, qui dans ce cas est JSON.

-d données

• Spécifie les données, dans ce cas le fichier user.json, à envoyer dans la demande POST au serveur HTTP.

Voici un exemple de sortie pour cette commande :

* Connected to localhost (127.0.0.1) port 3000 (#0)
 > POST /codi/v1/users HTTP/1.1
 > User-Agent: curl/7.37.1
 > Host: localhost:3000
 > Accept: */*
 > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI
 > Content-Type: application/json
 > Content-Length: 333
 >
 * upload completely sent off: 333 out of 333 bytes
 < HTTP/1.1 201 Created
 < x-powered-by: Express
 < vary: X-HTTP-Method-Override
 < content-type: application/json
 < date: Wed, 22 Apr 2015 19:32:54 GMT
 < connection: close
 < transfer-encoding: chunked
 < X-Time_Check: Proxy Time: 5612 msec

Vous pouvez utiliser l'API REST Admin pour retirer des utilisateurs de l'instance Bluemix. Vous devez disposer du droit Utilisateurs avec l'accès Ecriture pour pouvoir retirer des utilisateurs.

Pour retirer un utilisateur, vous devez fournir l'ID de l'utilisateur. Exécutez la commande suivante :

curl -v -b ./cookies.txt -X DELETE https://<your_host>.ibm.com/codi/v1/users?user_id=<some_user_id@domain.com>

-X DELETE

• Spécifie une demande DELETE.

Voici un exemple de sortie pour cette commande :

* connect to ::1 port 3000 failed: Connection refused
 *   Trying 127.0.0.1...
 * Connected to localhost (127.0.0.1) port 3000 (#0)
 > DELETE /codi/v1/users?user_id=exampleuser@domain.com HTTP/1.1
 > User-Agent: curl/7.37.1
 > Host: localhost:3000
 > Accept: */*
 > Cookie: opsConsole.sid=s%3AHLcwKGumyEb3IxREmikDOG3ATKD5xYMe.jfjWAa1tJC0rGghpeV8RPHqE2JaFVL4ZFIJbQpSC%2FAI
 >
 < HTTP/1.1 201 Created
 < x-powered-by: Express
 < content-type: application/json
 < date: Wed, 22 Apr 2015 21:01:09 GMT
 < connection: close
 < transfer-encoding: chunked
 < X-Time_Check: Proxy Time: 1922 msec
 <

Vous pouvez utiliser le nœud final suivant pour appeler cette commande d'API : /api/v1/env

Remarque : l'un des droits suivants est nécessaire pour accéder à ces nœuds finals : Accès de base, Accès en lecture de l'utilisateur, Accès en écriture de l'utilisateur ou Superutilisateur

Les paramètres de requête suivants permettent de regrouper les mesures relatives à l'unité centrale, le disque, la mémoire, le réseau, le quota et les applications :

metric

• Une ou plusieurs des valeurs suivantes séparées par une virgule : memory, disk, cpu, network, quota et apps.

startTime

• Point le plus ancien dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre startTime n'est indiqué, le point de données disponible le plus récent est inclus. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 14 h pour startTime.

endTime

• Point le plus récent dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre endTime n'est indiqué, le point de données le plus récent est utilisé. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 17 h pour endTime.

sort

• Ordre dans lequel les données sont renvoyées. Les valeurs valides sont asc (croissant) et desc (décroissant). La valeur par défaut est l'ordre décroissant qui renvoie d'abord les données les plus récentes.

L'exemple suivant utilise les paramètres de requête pour regrouper des mesures sur votre environnement :

curl -b ./cookies.txt --header "Accept: application/json" https://console.<région>.bluemix.net/admin/metrics/api/v1/env?metric=cpu,network,disk,apps,memory

Les sections suivantes indiquent le format des données.

• Pour regrouper les enregistrements de données concernant l'utilisation de la mémoire, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "memory": {
    "total": {
      "physical": {
        "total_gb": 1728,
        "used": {
          "value_gb": 673.68,
          "percent": 38.99
        }
      },
    "allocated": {
        "reserved_gb": 3456,
        "total_allocated": {
          "value_gb": 2575.18,
          "percent": 74.51
        }
      },
    },
      "cell": {
      "physical": {
        "total_gb": 864,
      "used": {
          "value_gb": 336.84,
        "percent": 38.99
      }
      },
    "allocated": {
        "reserved_gb": 1728,
      "total_allocated": {
          "value_gb": 1287.59,
        "percent": 74.51
      }
      },
    },
    "dea": {
      "physical": {
          "total_gb": 864,
      "used": {
          "value_gb": 336.84,
        "percent": 38.99
      }
      },
    "allocated": {
        "reserved_gb": 1728,
      "total_allocated": {
          "value_gb": 1287.59,
        "percent": 74.51
      }
      },
    },
    "memory_by_container": [
      {
        "name": "dea_next/0",
        "type": "dea",
        "ip": "169.53.225.93",
        "percent": "47"
      },
      {
        "name": "dea_next/1",
        "type": "dea",
        "ip": "169.53.225.89",
        "percent": "51"
      },
      {
        "name": "dea_next/2",
        "type": "dea",
        "ip": "169.53.230.49",
        "percent": "45"
      },
      {
        "name": "dea_next/3",
        "type": "dea",
        "ip": "169.44.109.231",
        "percent": "43"
      }
    ]
  }
}

• Pour regrouper les enregistrements de données concernant l'utilisation du disque, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "disk": {
    "total": {
      "physical": {
        "total_gb": 16200,
        "used": {
          "value_gb": 1614,
          "percent": 9.96
        }
      },
    "allocated": {
        "reserved_gb": 32400,
        "total_allocated": {
          "value_gb": 3979,
          "percent": 12.28
        }
      },
    },
    "cell": {
      "physical": {
        "total_gb": 8100,
      "used": {
          "value_gb": 807,
        "percent": 9.96
      }
      },
    "allocated": {
        "reserved_gb": 16200,
      "total_allocated": {
          "value_gb": 1989.5,
        "percent": 12.28
      }
      },
    },
    "dea": {
      "physical": {
        "total_gb": 8100,
      "used": {
          "value_gb": 807,
        "percent": 9.96
      }
      },
    "allocated": {
        "reserved_gb": 16200,
      "total_allocated": {
          "value_gb": 1989.5,
        "percent": 12.28
      }
      },
    },
    "disk_by_container": [
      {
        "name": "dea_next/0",
        "type": "dea",
        "ip": "169.53.225.93",
        "percent": "13"
      },
      {
        "name": "dea_next/1",
        "type": "dea",
        "ip": "169.53.225.89",
        "percent": "14"
      },
      {
        "name": "dea_next/2",
        "type": "dea",
        "ip": "169.53.230.49",
        "percent": "13"
      },
      {
        "name": "dea_next/3",
        "type": "dea",
        "ip": "169.44.109.231",
        "percent": "12"
      }
    ]
  }
}

• Pour regrouper les enregistrements de données concernant l'utilisation de l'unité centrale, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "cpu": {
    "total": {
      "average_percent_cpu_used": 14.725
    },
    "cell": {
      "average_percent_cpu_used": 19
    },
    "dea": {
      "average_percent_cpu_used": 10.45
    },
    "cpu_by_container": [
      {
        "name": "dea_next/0",
        "type": "dea",
        "ip": "169.53.225.93",
        "sys_percent": "8.4",
        "user_percent": "2.7",
        "wait_percent": "0.0"
      },
      {
        "name": "dea_next/1",
        "type": "dea",
        "ip": "169.53.225.89",
        "sys_percent": "7.4",
        "user_percent": "2.4",
        "wait_percent": "0.0"
      },
      {
        "name": "cell/1",
        "type": "cell",
        "ip": "169.53.230.49",
        "sys_percent": "5.3",
        "user_percent": "1.9",
        "wait_percent": "0.0"
      },
      {
        "name": "cell/2",
        "type": "cell",
        "ip": "169.44.109.231",
        "sys_percent": "8.2",
        "user_percent": "22.6",
        "wait_percent": "0.0"
      }
    ]
  }
}

• Pour regrouper les enregistrements de données concernant votre réseau, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "network": {
    "datapower": {
    "response_times": [
      {
        "proxy": "custom_certificates",
        "ten_seconds_ms": "0",
        "one_minute_ms": "0",
        "ten_minutes_ms": "0",
        "one_hour_ms": "0",
        "one_day_ms": "0"
      },
      {
        "proxy": "bluemix",
        "ten_seconds_ms": "90",
        "one_minute_ms": "89",
        "ten_minutes_ms": "83",
        "one_hour_ms": "85",
        "one_day_ms": "95"
      }
      ],
        "transactions": [
      {
        "proxy": "custom_domains",
        "ten_seconds_ms": "0",
        "one_minute_ms": "0",
        "ten_minutes_ms": "0",
        "one_hour_ms": "0",
        "one_day_ms": "0"
      },
      {
        "proxy": "bluemix",
        "ten_seconds_ms": "697",
        "one_minute_ms": "747",
        "ten_minutes_ms": "802",
        "one_hour_ms": "794",
        "one_day_ms": "730"
      }
      ],
        "bandwidth": {
        "in_kbps": 10855,
        "out_kbps": 38090
      }
  }
}

• Pour regrouper les enregistrements de données concernant l'utilisation de quota, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "quota": {
    "reserved_memory": {
      "total_bytes": 33176474877952
    },
    "services": {
      "total": 111650
    },
    "routes": {
      "total": 1675000
    }
  }
}

• Pour regrouper les enregistrements de données concernant vos applications, employez le format de données suivant :

{
  "sample_time": 1477494000000,
  "apps": {
    "count": 1406,
    "allocation": {
      "memory_gb": 571.8,
      "disk_gb": 1204
    }
  }
}

Vous pouvez consulter des statistiques calculées sur les données de métriques de consommation de la mémoire et du disque dans votre environnement. Les statistiques renvoyées sont les valeurs moyennes, maximales et minimales des échantillons de données dans chaque regroupement de données. Les données peuvent être regroupées par jour (avec des statistiques calculées pour chaque jour) ou par mois (avec des statistiques calculées pour chaque mois).

Vous pouvez utiliser les nœuds finals suivants pour appeler cette commande d'API :

• /api/v1/env/stats/system/disk

• /api/v1/env/stats/system/memory

Remarque : l'un des droits suivants sont nécessaires pour accéder à ces nœuds finals : Accès de base, Accès en lecture de l'utilisateur, Accès en écriture de l'utilisateur ou Superutilisateur

En utilisant les paramètres de requête suivants, vous pouvez collecter des statistiques sur votre disque et la mémoire :

startTime

• Point le plus ancien dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre startTime n'est indiqué, le point de données disponible le plus récent est inclus.

endTime

• Point le plus récent dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre endTime n'est indiqué, le point de données le plus récent est utilisé.

averageType

• Regroupement sur lequel calculer les statistiques. Valeurs valides : day (jour) et month (mois). La valeur par défaut est 'day' et renvoie les valeurs d'utilisation moyenne pour chaque jour sur la plage de temps spécifiée. Si vous spécifiez comme valeur 'month', les valeurs d'utilisation moyenne pour chaque mois sont renvoyées.

L'exemple suivant utilise les paramètres de requête pour collecter des statistiques d'utilisation de la mémoire dans votre environnement, en établissant leur moyenne journalière :

curl -b ./cookies.txt --header "Accept: application/json" https://console.<region>.bluemix.net/admin/metrics/api/v1/env/stats/system/memory

Les sections suivantes indiquent le format des données.

• Pour regrouper les enregistrements de données concernant l'utilisation de la mémoire, employez le format de données suivant :

{
  "metadata": {
    "range_start": 1498003200000,
    "range_end": 1498089599999,
    "sample_count": 25
  },
  "memory": {
    "dea": {
      "physical": {
        "total": {
          "average_gb": 864,
          "max_gb": 864,
          "min_gb": 864
        },
        "used": {
          "average_gb": 63.41959999999999,
          "max_gb": 63.61,
          "min_gb": 63.12
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 1728,
          "max_gb": 1728,
          "min_gb": 1728
        },
        "total_allocated": {
          "average_gb": 54.78000000000001,
          "max_gb": 55.97,
          "min_gb": 52.72
        }
      }
    },
    "cell": {
      "physical": {
        "total": {
          "average_gb": 640,
          "max_gb": 640,
          "min_gb": 640
        },
        "used": {
          "average_gb": 286.1068,
          "max_gb": 295.8,
          "min_gb": 284.3
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 1600,
          "max_gb": 1600,
          "min_gb": 1600
        },
        "total_allocated": {
          "average_gb": 1200.3043999999998,
          "max_gb": 1259.45,
          "min_gb": 1191.33
        }
      }
    },
    "total": {
      "physical": {
        "total": {
          "average_gb": 1504,
          "max_gb": 1504,
          "min_gb": 1504
        },
        "used": {
          "average_gb": 349.52639999999997,
          "max_gb": 359.02,
          "min_gb": 347.64
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 3328,
          "max_gb": 3328,
          "min_gb": 3328
        },
        "total_allocated": {
          "average_gb": 1255.0844,
          "max_gb": 1313.67,
          "min_gb": 1245.8
        }
      }
    }
  }
}

• Pour regrouper les enregistrements de données concernant l'utilisation du disque, employez le format de données suivant :

{
  "metadata": {
    "range_start": 1498003200000,
    "range_end": 1498089599999,
    "sample_count": 25
  },
  "disk": {
    "dea": {
      "physical": {
        "total": {
          "average_gb": 8100,
          "max_gb": 8100,
          "min_gb": 8100
        },
        "used": {
          "average_gb": 325.32,
          "max_gb": 330,
          "min_gb": 324
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 16200,
          "max_gb": 16200,
          "min_gb": 16200
        },
        "total_allocated": {
          "average_gb": 98.39,
          "max_gb": 100.75,
          "min_gb": 95.75
        }
      }
    },
    "cell": {
      "physical": {
        "total": {
          "average_gb": 6000,
          "max_gb": 6000,
          "min_gb": 6000
        },
        "used": {
          "average_gb": 1539.48,
          "max_gb": 1557,
          "min_gb": 1533
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 12000,
          "max_gb": 12000,
          "min_gb": 12000
        },
        "total_allocated": {
          "average_gb": 1985.13,
          "max_gb": 2184.25,
          "min_gb": 1958.25
        }
      }
    },
    "total": {
      "physical": {
        "total": {
          "average_gb": 14100,
          "max_gb": 14100,
          "min_gb": 14100
        },
        "used": {
          "average_gb": 1864.8,
          "max_gb": 1881,
          "min_gb": 1857
        }
      },
    "allocated": {
        "reserved": {
          "average_gb": 28200,
          "max_gb": 28200,
          "min_gb": 28200
        },
        "total_allocated": {
          "average_gb": 2083.52,
          "max_gb": 2281,
          "min_gb": 2056
        }
      }
    }
  }
}

Vous pouvez utiliser les nœuds finals suivants pour appeler cette commande d'API :

• /api/v1/org/memory/physical

• /api/v1/org/memory/reserved

• /api/v1/org/disk/physical

• /api/v1/org/disk/reserved

Remarque : l'un des droits suivants sont nécessaires pour accéder à ces nœuds finals : Accès en lecture de l'utilisateur, Accès en écriture de l'utilisateur ou Superutilisateur

Utilisez les paramètres de requête suivants pour regrouper des mesures concernant vos organisations :

startTime

• Point le plus ancien dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre startTime n'est indiqué, le point de données disponible le plus récent est inclus. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 14 h pour startTime.

endTime

• Point le plus récent dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre endTime n'est indiqué, le point de données le plus récent est utilisé. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 17 h pour endTime.

count

• Nombre d'enregistrements à renvoyer pour chaque échantillon de données.

minValue

• Valeur la plus petite à renvoyer pour la mesure indiquée. Si aucune valeur n'est indiquée, toutes les valeurs sont renvoyées. Par exemple, pour regrouper les organisations qui utilisent au moins 20 000 octets de mémoire physique, spécifiez une valeur de minValue égale à 20 000.

L'exemple suivant regroupe les mesures concernant vos organisations :

curl -b ./cookies.txt --header "Accept: application/json" https://console.<region>.bluemix.net/admin/metrics/api/v1/org/memory/physical?count=5&startTime=2016-12-02T16:54:09.467Z

{
   docs: [],
   next_url:
}

Chaque document renvoyé représente les mesures demandées pour une organisation de chaque échantillon de données, au moment de la demande.

Vous pouvez utiliser les nœuds finals suivants pour appeler cette commande d'API :

• /api/v1/app/cpu/physical

• /api/v1/app/memory/physical

• /api/v1/app/memory/reserved

• /api/v1/app/disk/physical

• /api/v1/app/disk/reserved

Remarque : l'un des droits suivants sont nécessaires pour accéder à ces nœuds finals : Accès en lecture de l'utilisateur, Accès en écriture de l'utilisateur ou Superutilisateur

Utilisez les paramètres de requête suivants pour regrouper des mesures concernant vos applications :

startTime

• Point le plus ancien dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre startTime n'est indiqué, le point de données disponible le plus récent est inclus. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 14 h pour startTime.

endTime

• Point le plus récent dans le temps à partir duquel les données sont renvoyées. Si aucun paramètre endTime n'est indiqué, le point de données le plus récent est utilisé. Par exemple, pour regrouper les données situées entre 14 h et 17 h, indiquez la valeur correspondant à 17 h pour endTime.

count

• Nombre d'enregistrements à renvoyer pour chaque échantillon de données.

minValue

• Valeur la plus petite à renvoyer pour la mesure indiquée. Si aucune valeur n'est indiquée, toutes les valeurs sont renvoyées. Par exemple, pour regrouper les applications qui utilisent au moins 20 000 octets de mémoire physique, spécifiez une valeur de minValue égale à 20 000.

L'exemple suivant regroupe les mesures concernant vos applications :

curl -b ./cookies.txt --header "Accept: application/json" https://console.<region>.bluemix.net/admin/metrics/api/v1/app/cpu/physical?count=5&startTime=2016-12-02T16:54:09.467Z

{
   docs: [],
   next_url:
}

Chaque document renvoyé représente les mesures demandées pour une application de chaque échantillon de données, au moment de la demande.

I-P-2-a. Corps▲

{
  "name" : "Nom du courtier de services",
  "auth_username" : "nom d'utilisateur",
  "auth_password" : "mot de passe",
  "broker_url" : "https://broker.comp.com",
  "owningOrganization" : "ORG"
}

I-P-2-b. En-têtes▲

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1
Host: console.comp.bluemix.net
Content-Type: application/json

I-P-3-a. Statut▲

201 Created

I-P-3-b. Corps▲

{
    "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68",
    "name": "Nom du courtier de services",
    "broker_url": "https://provision-broker.comp.bluemix.net/bmx/provisioning/brokers/2063580064-8f23230c-7f36-4ce5-a298-2ab4108f1120",
    "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68",
    "auth_username": "nom d'utilisateur",
    "created_on": "2016-09-30T16:45:56.304Z"
}

I-Q-2-a. Corps▲

{
  "name" : "Nom du courtier de services",
  "auth_username" : "nom d'utilisateur",
  "auth_password" : "nouveau mot de passe",
  "broker_url" : "https://broker.comp.com",
  "owningOrganization" : "ORG"
}

I-Q-2-b. En-têtes▲

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1
Host: console.comp.bluemix.net
Content-Type: application/json

I-Q-3-a. Statut▲

201 Created

I-Q-3-b. Corps▲

{
    "_id": "2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68",
    "name": "Nom du courtier de services",
    "broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-d11bdd84-7556-469f-858d-2098b531f7f2",
    "proxy_broker_url": "https://provision-broker.dys0.bluemix.net/bmx/provisioning/brokers/2063580064-0ca80769-8e9e-4e1c-9b99-68bdcf1a2c68",
    "auth_username": "nom d'utilisateur",
    "created_on": "2016-09-30T16:45:56.304Z"
}

I-R-2-a. En-têtes▲

Authorization: bearer eyJ0eXAiOiJKV1QiLCJhbG ... ciOiJIUzI1
Host: console.comp.bluemix.net
Content-Type: application/json

I-R-3-a. Statut▲

204 No Content

Vous pouvez gérer les utilisateurs pour votre environnement Bluemix via l'interface de ligne de commande Cloud Foundry, avec le plug-in d'interface de ligne de commande d'administration Bluemix. Vous devez télécharger ce plug-in pour votre interface de ligne de commande Cloud Foundry.

Avant de commencer, installez l'interface de ligne de commande cf. Le plug-in d'interface de ligne de commande d'administration Bluemix requiert cf version 6.11.2 ou ultérieure. Télécharger l'interface de ligne de commande Cloud Foundry.

Restriction : l'interface de ligne de commande Cloud Foundry n'est pas prise en charge par Cygwin. Utilisez-la dans une fenêtre de ligne de commande autre que Cygwin.

I-R-4-a. Ajout du plug-in d'interface de ligne de commande d'administration Bluemix▲

cf plugins

cf ba