App Configuration Commandes CLI (valables uniquement pour les versions 0.0.1- 1.0.14 )

Les commandes CLI répertoriées ici ne seront valables que pour les versions 0.0.1- 1.0.14 qui seront bientôt obsolètes.

L'interface de ligne de commande (CLI) d' IBM Cloud offre des fonctionnalités supplémentaires pour les offres de services. La CLI d' IBM Cloud prend en charge un framework de plug-ins afin d'étendre ses capacités. Vous pouvez installer le plug-in de l'interface de ligne de commande App Configuration à partir du référentiel de plug-ins IBM Cloud. Grâce au plug-in CLI du service « App Configuration », vous pouvez facilement gérer les instances du service « App Configuration » à l'aide des commandes CLI.

Pour exécuter des commandes IBM Cloud App Configuration, utilisez ibmcloud app-configuration ou ibmcloud ac.

Prérequis

Un compte IBM Cloud. Si vous ne disposez pas de compte, cliquez ici pour en créer un.
Une instance du service IBM Cloud App Configuration.
L'interface de ligne de commande IBM Cloud.
En option, si vous souhaitez utiliser la prise en charge des terminaux privés fournie par la plateforme IBM Cloud, assurez-vous d'activer les terminauxVRF et les terminaux de service.

Installation du plug-in d'interface de ligne de commande de App Configuration

Installez le plug-in de l'interface de ligne de commande App Configuration en exécutant la commande suivante à partir du référentiel de plug-ins IBM IBM Cloud :

ibmcloud plugin install app-configuration

Vous êtes averti via la ligne de commande lorsque des mises à jour de l'interface CLI d' IBM Cloud et de ses plug-ins sont disponibles. Veillez à maintenir votre CLI à jour afin de pouvoir utiliser les nouvelles commandes. Vous pouvez afficher la version actuelle de tous les plug-ins installés en exécutant la commande ibmcloud plugin list.

Sortie

La commande génère la sortie suivante :

Looking up 'app-configuration' from repository 'IBM Cloud'...
Plug-in 'app-configuration' found in repository 'IBM Cloud'
Attempting to download the binary file...
[==============================================================================================================================================] 100.00%
Installing binary...
OK
Plug-in 'app-configuration' was successfully installed into /Users/<username>/.bluemix/plugins/app-configuration. Use 'ibmcloud plugin show app-configuration' to show its details.

Pour améliorer le contrôle et la sécurité de vos données lors de l'utilisation de CLI, vous avez la possibilité d'utiliser des routes privées vers les points d'extrémité IBM Cloud. Commencez par activer le routage et le transfert virtuels dans votre compte; vous pourrez ensuite activer l'utilisation des points de terminaison du service privé « IBM Cloud ». Pour plus d'informations sur la configuration de votre compte pour prendre en charge l'option de connectivité privée, voir Activation de VRF et de noeuds finaux de service.

Utilisez la commande suivante pour vous connecter à un noeud final privé via l'interface de ligne de commande :

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac init

Avant d'initialiser le plug-in CLI, assurez-vous de sélectionner le point de terminaison API, la région et le compte appropriés dans votre CLI IBM Cloud.

Initialisez le plug-in de l'interface de ligne de commande à l'aide de la commande suivante :

ibmcloud ac init --instance_id INSTANCE_ID

Options de commande

--instance_id INSTANCE_ID (facultatif): Identificateur global unique de l'instance App Configuration à utiliser.

Exemple

Connectez-vous à l'interface de ligne de commande IBM Cloud et initialisez-la sur l'instance de service App Configuration App Configuration Instance 1.

ibmcloud ac init

Sortie

La commande renvoie le résultat suivant (nom de l'instance suivi d'un espace et du GUID):

Initializing IBM Cloud App Configuration Service plug-in...

Select a App Configuration instance:
1. App_Configuration_Instance_1 123
2. App_Configuration_Instance_2 456
Enter a number> 1
App Configuration instance selected is - App_Configuration_Instance_1 (GUID - 123)

ibmcloud ac show

Pour afficher le nom et le GUID de l'instance en cours d'utilisation, utilisez cette commande.

ibmcloud ac show

Exemple

Prérequis : utilisez la commande ibmcloud ac init pour sélectionner une instance au préalable.

ibmcloud ac show

Sortie

La commande génère la sortie suivante :

App Configuration instance being used is - App_Configuration_Instance_1 (GUID - 123)

ibmcloud ac environment list

Vous pouvez afficher la liste de tous les environnements à l'aide de la commande suivante :

ibmcloud ac environment list [--expand EXPAND] [--sort SORT] [--tags TAGS] [--include INCLUDE] [--limit LIMIT] [--offset OFFSET]

Options de commande

--limit LIMIT (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à extraire.
--offset OFFSET (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à ignorer.
--tags TAGS (facultatif): Filtre basé sur les étiquettes.
--sort SORT (facultatif): Trier les détails en fonction de l'attribut spécifié.
--expand EXPAND (facultatif): Vue développée de l'élément.
--include INCLUDE (facultatif): Inclure les détails de la fonctionnalité et de la propriété dans la réponse.

Exemple

Pour répertorier tous les environnements, exécutez la commande suivante :

ibmcloud ac environment list

Sortie

La commande génère la sortie suivante :

name               environment_id
Prod Environment   prodEnvironment
Dev environment    devEnvironment

ibmcloud ac environment create

Vous pouvez créer un environnement à l'aide de la commande suivante :

ibmcloud ac environment create {--file FILE-PATH | --name NAME [--environment_id ENVIRONMENT_ID] [--description DESCRIPTION] [--tags TAGS] [--color_code COLOR_CODE]}

Options de commande

--name NAME: Nom de l'environnement. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--environment_id ENVIRONMENT_ID (facultatif): ID environnement. Si cette valeur n'est pas indiquée, le nom deviendra automatiquement l'identifiant. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION (facultatif): Description de l'environnement. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS (facultatif): Etiquettes associées à l'environnement. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--color_code COLOR_CODE (facultatif): Code couleur pour distinguer l'environnement. Code hexadécimal de la couleur. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par le fichier. Format de fichier pris en charge : JSON

Exemple

Pour créer un environnement nommé « Production_Environment » à l'aide d'options ( cliquez ici pour savoir comment utiliser les commandes avec l'option « --file »), exécutez la commande suivante :

ibmcloud ac environment create --name Production_Environment --environment_id prodEnvironment --description sampleDesc --tags sampleTag --color_code "#FF0000"

Sortie

La commande génère la sortie suivante :

updated_time     2021-05-21T05:28:07.000Z
name             Production_Environment
environment_id   prodEnvironment
description      sampleDesc
tags             sampleTag
color_code       #FF0000
created_time     2021-05-21T05:28:07.000Z

ibmcloud ac environment get

Vous pouvez obtenir des informations détaillées sur l'environnement à l'aide de la commande suivante :

ibmcloud ac environment get --environment_id ENVIRONMENT_ID [--expand EXPAND] [--include INCLUDE]

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--expand EXPAND (facultatif): Vue développée de l'élément.
--include INCLUDE (facultatif): Inclure les détails de la fonctionnalité et de la propriété dans la réponse.

Exemple

Pour obtenir un environnement portant l'identifiant prodEnvironment, exécutez la commande suivante :

ibmcloud ac environment get --environment_id prodEnvironment

Sortie

La commande génère la sortie suivante :

name             Production_Environment
environment_id   prodEnvironment

ibmcloud ac environment update

Vous pouvez mettre à jour un environnement à l'aide de la commande suivante :

ibmcloud ac environment update (--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --description DESCRIPTION --tags TAGS --color_code COLOR_CODE)

Options de commande

--name NAME: Nom de l'environnement. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--environment_id ENVIRONMENT_ID (facultatif): ID environnement. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION (facultatif): Description de l'environnement. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS (facultatif): Etiquettes associées à l'environnement. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--color_code COLOR_CODE (facultatif): Code couleur pour distinguer l'environnement. Code hexadécimal de la couleur. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par le fichier. Format de fichier pris en charge : JSON

Exemple

Pour mettre à jour un environnement portant l'ID prodEnvironment à l'aide d'options ( cliquez ici pour savoir comment utiliser les commandes avec l'option « '--file' »), exécutez la commande suivante :

ibmcloud ac environment update --name Production_Environment --environment_id prodEnvironment --description sampleUpdatedDesc --tags sampleUpdatedTag --color_code "#FF0000"

Sortie

La commande génère la sortie suivante :

name             Production_Environment
environment_id   prodEnvironment
description      sampleUpdatedDesc
tags             sampleUpdatedTag
color_code       #FF0000
created_time     2021-05-21T05:28:07.000Z
updated_time     2021-05-21T05:33:00.000Z

ibmcloud ac environment delete

Vous pouvez supprimer un environnement à l'aide de la commande suivante :

ibmcloud ac environment delete --environment_id ENVIRONMENT_ID

Options de commande

--environment_id ENVIRONMENT_ID: ID environnement.

Exemple

Pour supprimer un environnement portant l'ID prodEnvironment, exécutez la commande suivante :

ibmcloud ac environment delete --environment_id prodEnvironment

Sortie

La commande génère la sortie suivante :

OK

ibmcloud ac collection list

Vous pouvez répertorier toutes les collections à l'aide de la commande suivante :

ibmcloud ac collection list [--sort SORT] [--limit LIMIT] [--offset OFFSET] [--features FEATURES] [--properties PROPERTIES] [--tags TAGS] [--expand EXPAND] [--include INCLUDE]

Options de commande

--limit LIMIT (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à extraire.
--offset OFFSET (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à ignorer.
--features FEATURES (facultatif): Filtrer les collections à l'aide d'une liste de critères séparés par des virgules.
--properties PROPERTIES (facultatif): Filtrer les collections à l'aide d'une liste de propriétés séparées par des virgules.
--tags TAGS (facultatif): Filtre basé sur les étiquettes.
--sort SORT (facultatif): Trier les détails en fonction de l'attribut spécifié.
--expand EXPAND (facultatif): Vue développée de l'élément.
--include INCLUDE (facultatif): Inclure les détails de la fonctionnalité et de la propriété dans la réponse.

Exemple

Pour répertorier toutes les collections, exécutez la commande suivante :

ibmcloud ac collection list

Sortie

La commande génère la sortie suivante :

name                 collection_id
sample               sampleId
GHz Inc              ghzinc1

ibmcloud ac collection create

Vous pouvez créer une collection à l'aide de la commande suivante :

ibmcloud ac collection create {--file FILE-PATH | --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]}

Options de commande

--name NAME: Nom de la collection. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--collection_id COLLECTION_ID (facultatif): ID collection. Si cette valeur n'est pas indiquée, le nom deviendra automatiquement l'identifiant. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION (facultatif): Description de la collection. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS (facultatif): Etiquettes associées à la collection. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par le fichier. Format de fichier pris en charge : JSON

Exemple

Pour créer une collection nommée « sample » à l'aide d'options ( cliquez ici pour savoir comment utiliser les commandes avec l'option « --file »), exécutez la commande suivante :

ibmcloud ac collection create --name sample --collection_id sampleId --description sampleDesc --tags sampleTag

Sortie

La commande génère la sortie suivante :

collection_id   sampleId
description     sampleDesc
created_time    2021-01-18T08:15:45Z
updated_time    2021-01-18T08:15:45Z
name            sample

ibmcloud ac collection get

Vous pouvez récupérer une collection à l'aide de la commande suivante :

ibmcloud ac collection get --collection_id COLLECTION_ID [--expand EXPAND] [--include INCLUDE]

Options de commande

--collection_id COLLECTION_ID: Identifiant de la collection.
--expand EXPAND (facultatif): Vue développée des détails de la collection.
--include INCLUDE (facultatif): Inclure les détails de la fonctionnalité et de la propriété dans la réponse.

Exemple

Pour extraire une collection dont l'ID est sampleId, exécutez la commande suivante :

ibmcloud ac collection get --collection_id sampleId

Sortie

La commande génère la sortie suivante :

name            sample
collection_id   sampleId

ibmcloud ac collection update

Vous pouvez mettre à jour une collection à l'aide de la commande suivante :

ibmcloud ac collection update {--file FILE-PATH | --name NAME --collection_id COLLECTION_ID --description DESCRIPTION --tags TAGS}

Options de commande

--collection_id COLLECTION_ID: ID collection. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--name NAME: Nom de la collection. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la collection. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS (en option) Format de fichier pris en charge: Etiquettes associées à la collection. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée du fichier. Format de fichier pris en charge : JSON

Exemple

Pour mettre à jour une collection dont l'ID est sampleId à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac collection update --collection_id sampleId --name sample --description sampleDesc --tags sampleTag

Sortie

La commande génère la sortie suivante :

name            sample
collection_id   sampleId
description     sampleDescUpdated
created_time    2021-01-18T08:15:45Z
updated_time    2021-01-19T05:57:27Z

ibmcloud ac collection delete

Vous pouvez supprimer une collection à l'aide de la commande suivante :

ibmcloud ac collection delete --collection_id COLLECTION_ID

Options de commande

--collection_id COLLECTION_ID: ID collection

Exemple

Pour supprimer une collection dont l'ID est sampleId, exécutez la commande suivante :

ibmcloud ac collection delete --collection_id sampleId

Sortie

La commande génère la sortie suivante :

OK

ibmcloud ac feature list

Vous pouvez répertorier toutes les fonctionnalités à l'aide de la commande suivante :

ibmcloud ac feature list --environment_id ENVIRONMENT_ID [--sort SORT] [--limit LIMIT] [--offset OFFSET] [--tags TAGS] [--collections COLLECTIONS] [--segments SEGMENTS] [--expand EXPAND] [--include INCLUDE]

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--limit LIMIT (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à extraire.
--include INCLUDE (facultatif): Détails de la fonction pour inclure les collections associées ou les détails des règles dans la réponse.
--offset OFFSET (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à ignorer.
--collections COLLECTIONS (facultatif): Filtrer les fonctionnalités à l'aide d'une liste de collections séparées par des virgules.
--segments SEGMENTS (facultatif): Filtrer les caractéristiques à l'aide d'une liste de segments séparés par des virgules.
--expand EXPAND (facultatif): Vue développée de l'élément.
--tags TAGS (facultatif): Filtrez les fonctionnalités à l'aide d'une liste de balises séparées par des virgules.
--sort SORT (facultatif): Trier les détails en fonction de l'attribut spécifié.

Exemple

Pour répertorier toutes les fonctionnalités, exécutez la commande suivante :

ibmcloud ac feature list --environment_id "production"

Sortie

La commande génère la sortie suivante :

name            feature_id      segment_exists
Indian IBMers   ibm-discount    true
sampleFeature   sampleFeature   true
Cycle Rentals   cycle-rentals   true

ibmcloud ac feature create

Vous pouvez créer un élément à l'aide de la commande suivante :

ibmcloud ac feature create {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME [--feature_id FEATURE_ID] --description DESCRIPTION --type TYPE --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --tags TAGS --enabled ENABLED --segment_rules SEGMENT_RULES --collections COLLECTIONS}

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--feature_id FEATURE_ID (facultatif): ID de fonction. Si cette valeur n'est pas indiquée, le nom deviendra automatiquement l'identifiant. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--type TYPE: Type de la fonctionnalité (Booléen, Chaîne, Nombre). Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--enabled_value ENABLED_VALUE: Valeur de la fonctionnalité lorsqu'elle est activée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--disabled_value DISABLED_VALUE: Valeur de la fonctionnalité lorsqu'elle est désactivée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments.
--enabled ENABLED: Etat de l'indicateur de fonctionnalité.
--collections COLLECTIONS: Tableau de collections.
--file FILE: Entrée par fichier. Format de fichier pris en charge : JSON

Exemple

Pour créer une collection dont le nom est sample à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac feature create --environment_id "production" --name "IBMers" --feature_id "ibm-discount" --description "Discount given to IBM employees" --type "BOOLEAN" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]' --collections '[{"collection_id":"corporatediscount","enabled": true}]'  --tags "discount,sale" --enabled true

Sortie

La commande génère la sortie suivante :

type             BOOLEAN
enabled_value    true
segment_rules    <Array>
collections      <Array>
name             IBMers
feature_id       ibm-discount
description      Discount given to IBM employees
disabled_value   false
enabled          true
created_time     2021-02-02T17:52:46Z
updated_time     2021-02-02T17:52:46Z

ibmcloud ac feature get

Vous pouvez accéder à une fonctionnalité à l'aide de la commande suivante :

ibmcloud ac feature get --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID [--include INCLUDE]

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--feature_id FEATURE_ID: ID fonctionnalité pour l'indicateur de fonctionnalité.
--include INCLUDE (facultatif): Inclure les collections associées dans la réponse.

Exemple

Pour extraire une fonctionnalité dont l'ID est ibm-discount, exécutez la commande suivante :

ibmcloud ac feature get --environment_id "production" --feature_id ibm-discount

Sortie

La commande génère la sortie suivante :

name    type     disabled_value  updated_time          feature_id    description                      enabled_value  created_time          order  rules    value
IBMers  BOOLEAN  false           2021-02-02T17:52:46Z  ibm-discount  Discount given to IBM employees  true           2021-02-02T17:52:46Z  1      <Array>  true

ibmcloud ac feature update

Vous pouvez mettre à jour un élément à l'aide de la commande suivante :

ibmcloud ac feature update {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --feature_id FEATURE_ID --description DESCRIPTION --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --enabled ENABLED --tags TAGS --segment_rules SEGMENT_RULES --collections COLLECTIONS}

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--feature_id FEATURE_ID: ID de fonction. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--enabled_value ENABLED_VALUE: Valeur de la fonctionnalité lorsqu'elle est activée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--disabled_value DISABLED_VALUE: Valeur de la fonctionnalité lorsqu'elle est désactivée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--enabled ENABLED: Etat de l'indicateur de fonctionnalité.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments.
--collections COLLECTIONS: Tableau de collections.
--file FILE: Entrée par le fichier. Format de fichier pris en charge - JSON.

Exemple

Pour mettre à jour la description d'une fonctionnalité dont l'ID est ibm-discount à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac feature update --environment_id "production" --name "Indian IBMers" --feature_id "ibm-discount" --description "Discount given to IBM Indian employees" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]' --collections '[{"collection_id":"corporatediscount","enabled": true}]'  --tags "discount,sale" --enabled true

Sortie

La commande génère la sortie suivante :

updated_time     2021-02-02T18:06:03Z
description      Discount given to IBM Indian employees
enabled_value    true
disabled_value   false
segment_rules    <Array>
created_time     2021-02-02T17:52:46Z
name             Indian IBMers
type             BOOLEAN
enabled          true
collections      <Array>

ibmcloud ac feature update-values

Vous pouvez mettre à jour les valeurs d'une fonctionnalité (cette méthode permet de mettre à jour le nom de la fonctionnalité, ses valeurs « enabled_value » et « disabled_value », ses balises, sa description et les règles de segmentation associées; toutefois, elle ne permet pas d'activer ou de désactiver le drapeau de la fonctionnalité ni de l'affecter à une collection) à l'aide de la commande suivante :

ibmcloud ac feature update-values {--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME --feature_id FEATURE_ID --description DESCRIPTION --enabled_value ENABLED_VALUE --disabled_value DISABLED_VALUE --tags TAGS --segment_rules SEGMENT_RULES}

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--feature_id FEATURE_ID: ID de fonction. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--enabled_value ENABLED_VALUE: Valeur de la fonctionnalité lorsqu'elle est activée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--disabled_value DISABLED_VALUE: Valeur de la fonctionnalité lorsqu’elle n’est pas disponible. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la fonctionnalité. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments.
--file FILE: Entrée par le fichier. Format de fichier pris en charge : JSON

Exemple

ibmcloud ac feature update-values --environment_id "production" --name "Indian IBMers" --feature_id "ibm-discount" --description "Discount given to IBM Indian employees" --enabled_value true --disabled_value false --segment_rules '[{"rules":[{"segments":["ibm_employees"]}],"value": true,"order": 1}]'  --tags "discount,sale"

Sortie

La commande génère la sortie suivante :

updated_time     2021-02-02T18:06:03Z
description      Discount given to IBM Indian employees
enabled_value    true
disabled_value   false
segment_rules    <Array>
created_time     2021-02-02T17:52:46Z
name             Indian IBMers
type             BOOLEAN
collections      <Array>

ibmcloud ac feature delete

Vous pouvez supprimer un élément à l'aide de la commande suivante :

ibmcloud ac feature delete --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--feature_id FEATURE_ID: ID de fonction

Exemple

Pour supprimer une fonctionnalité dont l'ID est ibm-discount, exécutez la commande suivante :

ibmcloud ac feature delete --environment_id "production" --feature_id ibm-discount

Sortie

La commande génère la sortie suivante :

OK

ibmcloud ac feature toggle

Vous pouvez activer ou désactiver une valeur de fonctionnalité à l'aide de la commande suivante :

ibmcloud ac feature toggle --environment_id ENVIRONMENT_ID --feature_id FEATURE_ID --enabled ENABLED

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--feature_id FEATURE_ID: ID de fonction
--enabled ENABLED: Etat de l'indicateur de fonctionnalité.

Exemple

Pour basculer une valeur de fonctionnalité dont l'ID est ibm-discount, exécutez la commande suivante :

ibmcloud ac feature toggle --environment_id "production" --feature_id ibm-discount --enabled false

Sortie

La commande génère la sortie suivante :

name    type     disabled_value  updated_time          feature_id    description                      enabled_value  created_time          order  rules    value
IBMers  BOOLEAN  false           2021-02-02T17:52:46Z  ibm-discount  Discount given to IBM employees  true           2021-02-02T17:52:46Z  1      <Array>  true

ibmcloud ac segment list

Vous pouvez répertorier tous les segments à l'aide de la commande suivante :

ibmcloud ac segment list [--limit LIMIT] [--offset OFFSET] [--sort SORT] [--tags TAGS] [--expand EXPAND] [--include INCLUDE]

Options de commande

--limit LIMIT (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à extraire.
--include INCLUDE (facultatif): Détails du segment pour inclure les règles associées dans la réponse.
--offset OFFSET (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à ignorer.
--expand EXPAND (facultatif): Vue développé des détails du segment.
--tags TAGS (facultatif): Filtrer les segments à l'aide d'une liste de balises séparées par des virgules.
--sort SORT (facultatif): Trier les détails en fonction de l'attribut spécifié.

Exemple

Pour répertorier tous les segments, exécutez la commande suivante :

ibmcloud ac segment list

Sortie

La commande génère la sortie suivante :

name            segment_id
India IBMers    ibm_employees_01
IBM Employees   ibm_employees

ibmcloud ac segment create

Vous pouvez créer un segment à l'aide de la commande suivante :

ibmcloud ac segment create {--file FILE-PATH | --name NAME [--segment_id SEGMENT_ID] --description DESCRIPTION --tags TAGS --rules RULES}

Options de commande

--name NAME: Nom du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_id SEGMENT_ID (facultatif): ID segment. Si cette valeur n'est pas indiquée, le nom deviendra automatiquement l'identifiant. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--rules RULES: Liste des règles permettant de déterminer si l'entité fait partie du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées au segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par l'intermédiaire d'un fichier. Format de fichier pris en charge : JSON

Exemple

Pour créer une collection dont le nom est sample à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac segment create --name "IBM Employees" --segment_id "ibm_employees" --description "IBM Employees Segment" --tags "ibm" --rules '[{"attribute_name": "email", "operator": "endsWith", "values": ["@ibm.com"]}]'

Sortie

La commande génère la sortie suivante :

name           IBM Employees
segment_id     ibm_employees
description    IBM Employees Segment
created_time   2021-02-02T19:04:22Z
updated_time   2021-02-02T19:04:22Z

ibmcloud ac segment get

Vous pouvez obtenir un segment à l'aide de la commande suivante :

ibmcloud ac segment get --segment_id SEGMENT_ID [--include INCLUDE]

Options de commande

--segment_id SEGMENT_ID: ID segment.
--include INCLUDE (facultatif): Indique d'inclure les détails de la fonctionnalité et de la propriété en fonction de l'association des segments.

Exemple

Pour extraire un segment dont l'ID est ibm_employees, exécutez la commande suivante :

ibmcloud ac segment get --segment_id ibm_employees

Sortie

La commande génère la sortie suivante :

segment_id     description    features  created_time          updated_time          name           attribute_name  operator  values
ibm_employees  IBM Employees  -         2021-02-02T19:04:22Z  2021-02-02T19:04:22Z  IBM Employees  email           endsWith  <Array>

ibmcloud ac segment update

Vous pouvez mettre à jour un segment à l'aide de la commande suivante :

ibmcloud ac segment update {--file FILE-PATH | --name NAME --segment_id SEGMENT_ID --description DESCRIPTION --tags TAGS --rules RULES}

Options de commande

--name NAME: Nom du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_id SEGMENT_ID: ID segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--rules RULES: Liste des règles permettant de déterminer si l'entité fait partie du segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées au segment. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par l'intermédiaire d'un fichier. Format de fichier pris en charge : JSON

Exemple

Pour mettre à jour la description d'un segment dont l'ID est ibm_employees à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac segment update --name "IBM India Employees" --segment_id "ibm_employees" --description "IBM India Employees" --tags "ibm" --rules '[{"attribute_name": "email", "operator": "endsWith", "values": ["@in.ibm.com"]}]'

Sortie

La commande génère la sortie suivante :

description    IBM India Employees
created_time   2021-02-02T19:04:22Z
updated_time   2021-02-02T19:10:01Z
name           IBM India Employees
segment_id     ibm_employees

ibmcloud ac segment delete

Vous pouvez supprimer un segment à l'aide de la commande suivante :

ibmcloud ac segment delete --segment_id SEGMENT_ID

Options de commande

--segment_id SEGMENT_ID: ID de segment

Exemple

Pour supprimer un segment dont l'ID est ibm_employees, exécutez la commande suivante :

ibmcloud ac segment delete --segment_id ibm_employees

Sortie

La commande génère la sortie suivante :

OK

ibmcloud ac property list

Vous pouvez répertorier toutes les propriétés à l'aide de la commande suivante :

ibmcloud ac property list --environment_id ENVIRONMENT_ID [--expand EXPAND] [--sort SORT] [--tags TAGS] [--include INCLUDE] [--collections COLLECTIONS] [--segments SEGMENTS] [--limit LIMIT] [--offset OFFSET]

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--limit LIMIT (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à extraire.
--include INCLUDE (facultatif): Détails du segment pour inclure les règles associées dans la réponse.
--offset OFFSET (facultatif): Utilisée pour la pagination. Nombre d'enregistrements à ignorer.
--collections COLLECTIONS (facultatif): Filtrer les fonctionnalités à l'aide d'une liste de collections séparées par des virgules.
--segments SEGMENTS (facultatif): Filtrer les caractéristiques à l'aide d'une liste de segments séparés par des virgules.
--expand EXPAND (facultatif): Vue développé des détails du segment.
--tags TAGS (facultatif): Filtrer les segments à l'aide d'une liste de balises séparées par des virgules.
--sort SORT (facultatif): Trier les détails en fonction de l'attribut spécifié.

Exemple

Pour répertorier toutes les propriétés, exécutez la commande suivante :

ibmcloud ac property list --environment_id "production"

Sortie

La commande génère la sortie suivante :

collections   name             property_id      description                 type      value   tags                        segment_rules
-             Email property   email-property   Property for email Update   BOOLEAN   false   version: 1.1, pre-release   -
-             name             name             desc                        NUMERIC   1       tags                        -

ibmcloud ac property create

Vous pouvez créer une propriété à l'aide de la commande suivante :

ibmcloud ac property create (--file FILE-PATH | --environment_id ENVIRONMENT_ID --name NAME [--property_id PROPERTY_ID] --description DESCRIPTION --type TYPE --value VALUE --tags TAGS --segment_rules SEGMENT-RULES --collections COLLECTIONS)

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--property_id PROPERTY_ID (facultatif): ID de propriété. Si cette valeur n'est pas indiquée, le nom deviendra automatiquement l'identifiant. Zone facultative : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--value VALUE: Valeur de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--type TYPE: Type de propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--collections COLLECTIONS: Liste des ID collection représentant les collections associées à la propriété spécifiée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par l'intermédiaire d'un fichier. Format de fichier pris en charge : JSON

Exemple

Pour créer une propriété dont le nom est email-property à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac property create --environment_id "production" --name Email_Property --property_id email-property --description Email_Property --type STRING --value VALUE --tags tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]' --collections '[]'

Sortie

La commande génère la sortie suivante :

name             Email_Property
description      Email_Property
type             STRING
value            VALUE
segment_rules    <Array>
property_id      email-property
segment_exists   true
tags             tags
collections      -

ibmcloud ac property get

Vous pouvez récupérer une propriété à l'aide de la commande suivante :

ibmcloud ac property get --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--include INCLUDE]

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--property_id PROPERTY_ID: ID de propriété pour l'indicateur de propriété.
--include INCLUDE (facultatif): Détails de la propriétés pour inclure les collections associées ou les détails des règles dans la réponse.

Exemple

Pour obtenir une propriété dont l'ID est email-property, exécutez la commande suivante :

ibmcloud ac property get --environment_id "production" --property_id email-property

Sortie

La commande génère la sortie suivante :

tags                        collections   name             property_id      description                 type      value   rules     value   order
version: 1.1, pre-release   -             Email_Property   email-property   Property for email Update   BOOLEAN   false   <Array>   true    1

ibmcloud ac property update

Vous pouvez mettre à jour une propriété à l'aide de la commande suivante :

ibmcloud ac property update (--file FILE-PATH | --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--name NAME] [--description DESCRIPTION] [--value VALUE] [--tags TAGS] [--segment_rules SEGMENT-RULES] [--collections COLLECTIONS])

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--property_id PROPERTY_ID: ID de propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--value VALUE: Valeur de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--collections COLLECTIONS: Liste des ID collection représentant les collections associées à la propriété spécifiée. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par l'intermédiaire d'un fichier. Format de fichier pris en charge : JSON

Exemple

Pour mettre à jour la description d'une propriété dont l'ID est email-property à l'aide d'indicateurs (cliquez ici pour utiliser des commandes avec l'indicateur '--file'), exécutez la commande suivante :

ibmcloud ac property update --environment_id "production" --name Email_Property --property_id email-property --description Email_Property_Updated --value VALUE --tags Updated_Tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]' --collections '[]'

Sortie

La commande génère la sortie suivante :

name             Email_Property
value            VALUE
segment_rules    <Array>
collections      -
tags             Updated_Tags
property_id      email-property
segment_exists   true
description      Email_Property_Updated
type             STRING

ibmcloud ac property update-values

Vous pouvez mettre à jour les valeurs des propriétés (il est possible de modifier la valeur d'une propriété et les règles de ciblage, mais cette méthode ne permet pas d'attribuer une propriété à une collection) à l'aide de la commande suivante :

ibmcloud ac property update-values (--file FILE-PATH | --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID [--name NAME] [--description DESCRIPTION][--value VALUE] [--tags TAGS] [--segment_rules SEGMENT-RULES])

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--name NAME: Nom de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--property_id PROPERTY_ID: ID de propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--description DESCRIPTION: Description de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--segment_rules SEGMENT_RULES: Précisez les règles de ciblage utilisées pour définir des valeurs différentes selon les segments. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--tags TAGS: Etiquettes associées à la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--value VALUE: Valeur de la propriété. Zone obligatoire : entrée sous forme d'indicateur ou depuis un fichier.
--file FILE: Entrée par fichier. Format de fichier pris en charge : JSON

Exemple

ibmcloud ac property update-values --environment_id "production" --name Email_Property --property_id email-property --description Email_Property_Updated --value VALUE --tags Updated_Tags --segment_rules '[{"rules":[{"segments":["kmu9n7px"]}],"value":"$default","order":1}]'

Sortie

La commande génère la sortie suivante :

name             Email_Property
value            VALUE
segment_rules    <Array>
tags             Updated_Tags
property_id      email-property
segment_exists   true
description      Email_Property_Updated
type             STRING

ibmcloud ac property delete

Vous pouvez supprimer une propriété à l'aide de la commande suivante :

ibmcloud ac property delete --environment_id ENVIRONMENT_ID --property_id PROPERTY_ID

Options de commande

--environment_id ENVIRONMENT_ID: ID d'environnement
--property_id PROPERTY_ID: ID de la propriété

Exemple

Pour supprimer une propriété dont l'ID est ibm_employees, exécutez la commande suivante :

ibmcloud ac property delete --environment_id "production" --property_id ibm_employees

Sortie

La commande génère la sortie suivante :

OK

ibmcloud ac export

Vous pouvez exporter les données de configuration de l'instance sélectionnée à l'aide de la commande suivante :

ibmcloud ac export [--file FILE] [--output OUTPUT]

Options de commande

--file FILE (facultatif): Chemin d'accès au fichier vers lequel la configuration sera exportée.
--output OUTPUT (facultatif): Choisissez un format de sortie - il peut être 'JSON' ou 'yaml'. (par défaut "JSON")

Exemple

Pour exporter les données de configuration de l'instance sélectionnée, exécutez la commande suivante :

ibmcloud ac export --file exportedConfig.json

Sortie

La commande génère la sortie suivante :

OK
Configuration exported to file exportedConfig.json

ibmcloud ac import

Vous pouvez importer des données de configuration à partir d'un fichier vers l'instance sélectionnée à l'aide de la commande suivante :

ibmcloud ac import --file FILE [--clean CLEAN]

Options de commande

--file FILE: Chemin d'accès au fichier à partir duquel la configuration sera importée.
--clean CLEAN (facultatif): Si cette option est définie sur « true », les données existantes de l'instance du service sont effacées avant l'importation des données de configuration.

Exemple

Pour importer des données de configuration à partir d'un fichier vers l'instance sélectionnée, exécutez la commande suivante :

ibmcloud ac import --file exportedConfig.json

Sortie

La commande génère la sortie suivante :

OK
Configuration imported from file exportedConfig.json

Créer ou mettre à jour un élément à partir d'un fichier

Ce plug-in vous permet de créer ou de mettre à jour des éléments au format JSON stockés dans un fichier.

Voici comment créer une collection à partir d'un fichier.

ibmcloud ac collection create {--file FILE-PATH | --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]}

Notez le symbole '|'. Il indique qu'il existe deux manières d'utiliser la commande.

ibmcloud ac collection create --file FILE-PATH
OR
ibmcloud ac collection create --name NAME [--collection_id COLLECTION_ID] [--description DESCRIPTION] [--tags TAGS]

Pour connaître le format JSON pris en charge, consultez la documentation de l'API.

Utilisez l'indicateur de fichier (ne peut pas être combiné à un autre indicateur) pour indiquer le chemin d'accès du fichier.

Exemple

Pour créer une collection dont l'ID est corporateDiscount stockée dans un fichier create_collection_body.json, exécutez la commande suivante :

ibmcloud ac collection create --file create_collection_body.json

Voici le contenu de la page create_collection_body.json:

{
    "name": "Corporate Discount",
    "collection_id": "corporateDiscount",
    "description": "Discount for partner Organizations",
    "tags": "discount,sale"
}

Sortie

La commande génère la sortie suivante :

name            Corporate Discount
collection_id   corporateDiscount
description     Discount for partner Organizations
created_time    2021-02-02T19:17:07Z
updated_time    2021-02-02T19:17:07Z

La procédure à suivre pour créer ou mettre à jour une collection, une entité ou un segment est similaire à celle décrite précédemment. Pour connaître la structure du format JSON acceptée, consultez la documentation de l'API

ibmcloud plug-in uninstall

Utilisez cette commande pour désinstaller le plug-in d'interface de ligne de commande App Configuration.

ibmcloud plugin uninstall app-configuration

La désinstallation renvoie un message de réussite, en l'absence d'erreur.

App Configuration Commandes CLI (valables uniquement pour les versions 0.0.1- 1.0.14 )

App Configuration Commandes CLI (valables uniquement pour les versions 0.0.1- 1.0.14 )

Prérequis

Installation du plug-in d'interface de ligne de commande de App Configuration

Sortie

Connexion à l'interface de ligne de commande avec un noeud final privé

ibmcloud ac init

Options de commande

Exemple

Sortie

ibmcloud ac show

Exemple

Sortie

ibmcloud ac environment list

Options de commande

Exemple

Sortie

ibmcloud ac environment create

Options de commande

Exemple

Sortie

ibmcloud ac environment get

Options de commande

Exemple

Sortie

ibmcloud ac environment update

Options de commande

Exemple

Sortie

ibmcloud ac environment delete

Options de commande

Exemple

Sortie

ibmcloud ac collection list

Options de commande

Exemple

Sortie

ibmcloud ac collection create

Options de commande

Exemple

Sortie

ibmcloud ac collection get

Options de commande

Exemple

Sortie

ibmcloud ac collection update

Options de commande

Exemple

Sortie

ibmcloud ac collection delete

Options de commande

Exemple

Sortie

ibmcloud ac feature list

Options de commande

Exemple

Sortie

ibmcloud ac feature create

Options de commande

Exemple

Sortie

ibmcloud ac feature get

Options de commande

Exemple

Sortie

ibmcloud ac feature update

Options de commande

Exemple

Sortie

ibmcloud ac feature update-values

Options de commande

Exemple

Sortie

ibmcloud ac feature delete

Options de commande

Exemple

Sortie

ibmcloud ac feature toggle

Options de commande

Exemple