App Configuration Comandi CLI (validi solo per le versioni 0.0.1- 1.0.14 )

I comandi CLI elencati qui saranno validi solo per le versioni 0.0.1- 1.0.14 che saranno deprecate.

L'interfaccia della riga di comando (CLI) di IBM Cloud offre funzionalità aggiuntive per l'offerta di servizi. La CLI di IBM Cloud supporta un framework plug-in per estenderne le funzionalità. È possibile installare il plug-in CLI di App Configuration dal repository dei plug-in di IBM Cloud. Con il plug-in CLI del servizio App Configuration, è possibile gestire facilmente le istanze del servizio App Configuration utilizzando i comandi CLI.

Per eseguire i comandi IBM Cloud App Configuration, utilizzare ibmcloud app-configuration o ibmcloud ac.

Prerequisiti

Un resoconto su IBM Cloud. Se non si dispone di un account, fare clic qui per crearne uno.
Un'istanza di IBM Cloud App Configuration servizio.
IBM Cloud CLI.
Facoltativamente, se si desidera utilizzare il supporto per endpoint privati fornito dalla piattaforma IBM Cloud, assicurarsi di abilitare VRF e gli endpoint di servizio.

Installazione del plugin della CLI App Configuration

Installate il plug-in App Configuration CLI eseguendo il seguente comando dal repo del plug-in IBM IBM Cloud:

ibmcloud plugin install app-configuration

Quando sono disponibili aggiornamenti per la CLI di IBM Cloud e per i plug-in, riceverai una notifica sulla riga di comando. Assicurati di mantenere aggiornata la tua CLI in modo da poter utilizzare i nuovi comandi. Puoi visualizzare la versione corrente di tutti i plugin installati eseguendo ibmcloud plugin list.

Output

Il comando restituisce il seguente output:

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.

Per migliorare il controllo e la sicurezza dei dati quando si utilizza l'interfaccia CLI, è possibile utilizzare percorsi privati per gli endpoint di IBM Cloud. Per prima cosa, attiva il routing e il forwarding virtuali nel tuo account; a quel punto potrai abilitare l'uso degli endpoint del servizio privato " IBM Cloud ". Per ulteriori informazioni sull'impostazione dell'account per supportare l'opzione di connettività privata, vedere Abilitazione di VRF ed endpoint di servizio.

Utilizzare il seguente comando per accedere a un endpoint privato utilizzando la CLI:

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac init

Prima di inizializzare il plug-in CLI, assicurati di selezionare l'endpoint API, la regione e l'account corretti nella tua CLI IBM Cloud.

Inizializzare il plug-in CLI utilizzando il seguente comando:

ibmcloud ac init --instance_id INSTANCE_ID

Opzioni comando

--instance_id INSTANCE_ID (facoltativo): GUID dell'istanza App Configuration da utilizzare.

Esempio

Accedere a IBM Cloud CLI e inizializzare la CLI all'istanza di servizio App Configuration App Configuration Instance 1.

ibmcloud ac init

Output

Il comando restituisce il seguente output (nome dell'istanza seguito da uno spazio e dal 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)

mostra ibmcloud ac

Per vedere il nome e il GUID dell'istanza in uso, usare questo comando.

ibmcloud ac show

Esempio

Prerequisito - Usare il comando ibmcloud ac init per selezionare prima un'istanza.

ibmcloud ac show

Output

Il comando restituisce il seguente output:

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

elenco degli ambienti ibmcloud ac

È possibile elencare tutti gli ambienti utilizzando il comando:

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

Opzioni comando

--limit LIMIT (facoltativo): Utilizzato per la paginazione. Il numero di record da richiamare.
--offset OFFSET (facoltativo): Utilizzato per la paginazione. Il numero di record da ignorare.
--tags TAGS (facoltativo): Filtra in base ai tag.
--sort SORT (facoltativo): Ordina i dettagli in base all'attributo specificato.
--expand EXPAND (facoltativo): Vista espansa dell'elemento.
--include INCLUDE (facoltativo): Includi i dettagli della funzione e della proprietà nella risposta.

Esempio

Per visualizzare l'elenco di tutti gli ambienti, eseguire il seguente comando:

ibmcloud ac environment list

Output

Il comando restituisce il seguente output:

name               environment_id
Prod Environment   prodEnvironment
Dev environment    devEnvironment

creare l'ambiente ibmcloud ac

È possibile creare un ambiente utilizzando il comando:

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

Opzioni comando

--name NAME: Nome dell'ambiente. Campo obbligatorio - da inserire come flag o da file.
--environment_id ENVIRONMENT_ID (facoltativo): ID ambiente. Se questo valore non viene specificato, il nome diventerà automaticamente l'ID. Campo facoltativo - da inserire come flag o da file.
--description DESCRIPTION (facoltativo): Descrizione dell'ambiente. Campo facoltativo - da inserire come flag o da file.
--tags TAGS (facoltativo): Tag associati all'ambiente. Campo facoltativo - da inserire come flag o da file.
--color_code COLOR_CODE (facoltativo): Codice colore per distinguere l'ambiente. Il codice esadecimale del colore. Campo facoltativo - da inserire come flag o da file.
--file FILE: Ingresso attraverso il file. Formato file supportato: JSON

Esempio

Per creare un ambiente con il nome Production_Environment usando i flag (fare clic qui per usare i comandi con il flag --file ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

ambiente ibmcloud ac ottenere

È possibile ottenere un dettaglio dell'ambiente utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--expand EXPAND (facoltativo): Vista espansa dell'elemento.
--include INCLUDE (facoltativo): Includi i dettagli della funzione e della proprietà nella risposta.

Esempio

Per ottenere un ambiente con ID prodEnvironment, eseguire il seguente comando:

ibmcloud ac environment get --environment_id prodEnvironment

Output

Il comando restituisce il seguente output:

name             Production_Environment
environment_id   prodEnvironment

aggiornamento dell'ambiente ibmcloud ac

È possibile aggiornare un ambiente utilizzando il comando:

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

Opzioni comando

--name NAME: Nome dell'ambiente. Campo obbligatorio - da inserire come flag o da file.
--environment_id ENVIRONMENT_ID (facoltativo): ID ambiente. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION (facoltativo): Descrizione dell'ambiente. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS (facoltativo): Tag associati all'ambiente. Campo obbligatorio - da inserire come flag o da file.
--color_code COLOR_CODE (facoltativo): Codice colore per distinguere l'ambiente. Il codice esadecimale del colore. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso attraverso il file. Formato file supportato: JSON

Esempio

Per aggiornare un ambiente con ID prodEnvironment usando i flag (fare clic qui per usare i comandi con il flag '--file' ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

eliminazione dell'ambiente ibmcloud ac

È possibile eliminare un ambiente utilizzando il comando:

ibmcloud ac environment delete --environment_id ENVIRONMENT_ID

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente.

Esempio

Per eliminare un ambiente con ID prodEnvironment, eseguire il seguente comando:

ibmcloud ac environment delete --environment_id prodEnvironment

Output

Il comando restituisce il seguente output:

OK

elenco di raccolta ibmcloud ac

È possibile elencare tutte le raccolte utilizzando il comando:

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

Opzioni comando

--limit LIMIT (facoltativo): Utilizzato per la paginazione. Il numero di record da richiamare.
--offset OFFSET (facoltativo): Utilizzato per la paginazione. Il numero di record da ignorare.
--features FEATURES (facoltativo): Filtra le collezioni in base a un elenco di caratteristiche separate da virgole.
--properties PROPERTIES (facoltativo): Filtra le collezioni in base a un elenco di proprietà separate da virgole.
--tags TAGS (facoltativo): Filtra in base ai tag.
--sort SORT (facoltativo): Ordina i dettagli in base all'attributo specificato.
--expand EXPAND (facoltativo): Vista espansa dell'elemento.
--include INCLUDE (facoltativo): Includi i dettagli della funzione e della proprietà nella risposta.

Esempio

Per visualizzare l'elenco di tutte le raccolte, eseguire il seguente comando:

ibmcloud ac collection list

Output

Il comando restituisce il seguente output:

name                 collection_id
sample               sampleId
GHz Inc              ghzinc1

ibmcloud ac collection create

È possibile creare una raccolta utilizzando il comando:

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

Opzioni comando

--name NAME: Nome della raccolta. Campo obbligatorio - da inserire come flag o da file.
--collection_id COLLECTION_ID (facoltativo): ID raccolta. Se questo valore non viene specificato, il nome diventerà automaticamente l'ID. Campo facoltativo - da inserire come flag o da file.
--description DESCRIPTION (facoltativo): Descrizione della raccolta. Campo facoltativo - da inserire come flag o da file.
--tags TAGS (facoltativo): Tag associati alla raccolta. Campo facoltativo - da inserire come flag o da file.
--file FILE: Ingresso attraverso il file. Formato file supportato: JSON

Esempio

Per creare una raccolta con il nome sample usando i flag (fare clic qui per usare i comandi con il flag --file ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

È possibile ottenere una collezione utilizzando il comando:

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

Opzioni comando

--collection_id COLLECTION_ID: ID della collezione per la collezione.
--expand EXPAND (facoltativo): Vista espansa dei dettagli della raccolta.
--include INCLUDE (facoltativo): Includi i dettagli della funzione e della proprietà nella risposta.

Esempio

Per ottenere una raccolta con ID sampleId, eseguire il seguente comando:

ibmcloud ac collection get --collection_id sampleId

Output

Il comando restituisce il seguente output:

name            sample
collection_id   sampleId

aggiornamento della raccolta ibmcloud ac

È possibile aggiornare una collezione utilizzando il comando:

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

Opzioni comando

--collection_id COLLECTION_ID: ID raccolta. Campo obbligatorio - da inserire come flag o da file.
--name NAME: Nome della raccolta. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione della raccolta. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS (opzionale) Formato file supportato: Tag associati alla raccolta. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso dal file. Formato file supportato: JSON

Esempio

Per aggiornare una raccolta con l'ID sampleId usando i flag (fare clic qui per usare i comandi con il flag '--file' ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

eliminazione della raccolta ibmcloud ac

È possibile eliminare una raccolta utilizzando il comando:

ibmcloud ac collection delete --collection_id COLLECTION_ID

Opzioni comando

--collection_id COLLECTION_ID: ID raccolta

Esempio

Per eliminare una raccolta con ID sampleId, eseguire il seguente comando:

ibmcloud ac collection delete --collection_id sampleId

Output

Il comando restituisce il seguente output:

OK

elenco delle funzionalità di ibmcloud ac

È possibile elencare tutte le caratteristiche utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--limit LIMIT (facoltativo): Utilizzato per la paginazione. Il numero di record da richiamare.
--include INCLUDE (facoltativo): Dettagli della funzione per includere i dettagli delle regole o delle raccolte associate nella risposta.
--offset OFFSET (facoltativo): Utilizzato per la paginazione. Il numero di record da ignorare.
--collections COLLECTIONS (facoltativo): Filtra le caratteristiche in base a un elenco di raccolte separate da virgole.
--segments SEGMENTS (facoltativo): Filtra le caratteristiche in base a un elenco di segmenti separati da virgole.
--expand EXPAND (facoltativo): Vista espansa dell'elemento.
--tags TAGS (facoltativo): Filtra le caratteristiche in base a un elenco di tag separati da virgole.
--sort SORT (facoltativo): Ordina i dettagli in base all'attributo specificato.

Esempio

Per visualizzare l'elenco completo delle funzionalità, eseguire il seguente comando:

ibmcloud ac feature list --environment_id "production"

Output

Il comando restituisce il seguente output:

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

ibmcloud ac funzione create

È possibile creare una funzione utilizzando il comando:

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}

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome funzione. Campo obbligatorio - da inserire come flag o da file.
--feature_id FEATURE_ID (facoltativo): ID funzione. Se questo valore non viene specificato, il nome diventerà automaticamente l'ID. Campo facoltativo - da inserire come flag o da file.
--description DESCRIPTION: Descrizione dell'elemento. Campo obbligatorio - da inserire come flag o da file.
--type TYPE: Tipo della proprietà (booleano, stringa, numero). Campo obbligatorio - da inserire come flag o da file.
--enabled_value ENABLED_VALUE: Valore della funzione quando è abilitata. Campo obbligatorio - da inserire come flag o da file.
--disabled_value DISABLED_VALUE: Valore della funzione quando è disabilitata. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla funzione. Campo obbligatorio - da inserire come flag o da file.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti.
--enabled ENABLED: Stato dell'indicatore di funzione.
--collections COLLECTIONS: Array di raccolte.
--file FILE: Ingresso tramite file. Formato file supportato: JSON

Esempio

Per creare una raccolta con il nome sample usando i flag (fare clic qui per usare i comandi con il flag '--file' ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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 funzione get

È possibile ottenere una funzione utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--feature_id FEATURE_ID: ID della caratteristica per il segnalatore di caratteristica.
--include INCLUDE (facoltativo): Includi le raccolte associate nella risposta.

Esempio

Per ottenere una funzione con ID ibm-discount, eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

aggiornamento delle funzionalità di ibmcloud ac

È possibile aggiornare una funzione utilizzando il comando:

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}

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome funzione. Campo obbligatorio - da inserire come flag o da file.
--feature_id FEATURE_ID: ID funzione. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione dell'elemento. Campo obbligatorio - da inserire come flag o da file.
--enabled_value ENABLED_VALUE: Valore della funzione quando è abilitata. Campo obbligatorio - da inserire come flag o da file.
--disabled_value DISABLED_VALUE: Valore della funzione quando è disabilitata. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla funzione. Campo obbligatorio - da inserire come flag o da file.
--enabled ENABLED: Stato dell'indicatore di funzione.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti.
--collections COLLECTIONS: Array di raccolte.
--file FILE: Ingresso attraverso il file. Formato file supportato - JSON.

Esempio

Per aggiornare la descrizione di una caratteristica con ID ibm-discount utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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>

aggiornamento dei valori delle funzioni di ibmcloud ac

È possibile aggiornare i valori di una caratteristica (questo metodo consente di aggiornare il nome della caratteristica, il valore della caratteristica abilitata, il valore della caratteristica disabilitata, i tag, la descrizione e le regole del segmento della caratteristica; tuttavia, questo metodo non consente di attivare il flag della caratteristica e di assegnare la caratteristica a una raccolta), utilizzando il comando:

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}

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome funzione. Campo obbligatorio - da inserire come flag o da file.
--feature_id FEATURE_ID: ID funzione. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione dell'elemento. Campo obbligatorio - da inserire come flag o da file.
--enabled_value ENABLED_VALUE: Valore della funzione quando è abilitata. Campo obbligatorio - da inserire come flag o da file.
--disabled_value DISABLED_VALUE: Valore della caratteristica quando questa non è disponibile. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla funzione. Campo obbligatorio - da inserire come flag o da file.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti.
--file FILE: Ingresso attraverso il file. Formato file supportato: JSON

Esempio

Per aggiornare la descrizione di una caratteristica con ID ibm-discount utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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"

Output

Il comando restituisce il seguente output:

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>

eliminazione della funzione ibmcloud ac

È possibile eliminare una funzione utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--feature_id FEATURE_ID: ID funzione

Esempio

Per eliminare un elemento con ID ibm-discount, eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

OK

funzione ibmcloud ac da attivare

È possibile attivare il valore di una funzione utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--feature_id FEATURE_ID: ID funzione
--enabled ENABLED: Stato dell'indicatore di funzione.

Esempio

Per attivare il valore di una caratteristica con ID ibm-discount, eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

elenco dei segmenti ibmcloud ac

È possibile elencare tutti i segmenti utilizzando il comando:

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

Opzioni comando

--limit LIMIT (facoltativo): Utilizzato per la paginazione. Il numero di record da richiamare.
--include INCLUDE (facoltativo): Dettagli del segmento per includere le regole associate nella risposta.
--offset OFFSET (facoltativo): Utilizzato per la paginazione. Il numero di record da ignorare.
--expand EXPAND (facoltativo): Vista espansa dei dettagli del segmento.
--tags TAGS (facoltativo): Filtra i segmenti in base a un elenco di tag separati da virgole.
--sort SORT (facoltativo): Ordina i dettagli in base all'attributo specificato.

Esempio

Per visualizzare l'elenco di tutti i segmenti, eseguire il seguente comando:

ibmcloud ac segment list

Output

Il comando restituisce il seguente output:

name            segment_id
India IBMers    ibm_employees_01
IBM Employees   ibm_employees

creare il segmento ibmcloud ac

È possibile creare un segmento utilizzando il comando:

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

Opzioni comando

--name NAME: Nome del segmento. Campo obbligatorio - da inserire come flag o da file.
--segment_id SEGMENT_ID (facoltativo): ID segmento. Se questo valore non viene specificato, il nome diventerà automaticamente l'ID. Campo facoltativo - da inserire come flag o da file.
--description DESCRIPTION: Descrizione del segmento. Campo obbligatorio - da inserire come flag o da file.
--rules RULES: Elenco delle regole che determinano se l'entità fa parte del segmento. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati al segmento. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso attraverso un file. Formato file supportato: JSON

Esempio

Per creare una raccolta con il nome sample usando i flag (fare clic qui per usare i comandi con il flag '--file' ), eseguire il seguente comando:

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"]}]'

Output

Il comando restituisce il seguente output:

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

segmento ibmcloud ac ottenere

È possibile ottenere un segmento utilizzando il comando:

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

Opzioni comando

--segment_id SEGMENT_ID: ID segmento.
--include INCLUDE (facoltativo): Indica di includere i dettagli della caratteristica e della proprietà in base all'associazione dei segmenti.

Esempio

Per ottenere un segmento con ID ibm_employees, eseguire il seguente comando:

ibmcloud ac segment get --segment_id ibm_employees

Output

Il comando restituisce il seguente output:

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>

aggiornamento del segmento ibmcloud ac

È possibile aggiornare un segmento utilizzando il comando:

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

Opzioni comando

--name NAME: Nome del segmento. Campo obbligatorio - da inserire come flag o da file.
--segment_id SEGMENT_ID: ID segmento. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione del segmento. Campo obbligatorio - da inserire come flag o da file.
--rules RULES: Elenco delle regole che determinano se l'entità fa parte del segmento. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati al segmento. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso attraverso un file. Formato file supportato: JSON

Esempio

Per aggiornare la descrizione di un segmento con ID ibm_employees utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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"]}]'

Output

Il comando restituisce il seguente output:

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

eliminazione del segmento ibmcloud ac

È possibile eliminare un segmento utilizzando il comando:

ibmcloud ac segment delete --segment_id SEGMENT_ID

Opzioni comando

--segment_id SEGMENT_ID: ID segmento

Esempio

Per eliminare un segmento con ID ibm_employees, eseguire il seguente comando:

ibmcloud ac segment delete --segment_id ibm_employees

Output

Il comando restituisce il seguente output:

OK

elenco delle proprietà di ibmcloud ac

È possibile elencare tutte le proprietà utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--limit LIMIT (facoltativo): Utilizzato per la paginazione. Il numero di record da richiamare.
--include INCLUDE (facoltativo): Dettagli del segmento per includere le regole associate nella risposta.
--offset OFFSET (facoltativo): Utilizzato per la paginazione. Il numero di record da ignorare.
--collections COLLECTIONS (facoltativo): Filtra le caratteristiche in base a un elenco di raccolte separate da virgole.
--segments SEGMENTS (facoltativo): Filtra le caratteristiche in base a un elenco di segmenti separati da virgole.
--expand EXPAND (facoltativo): Vista espansa dei dettagli del segmento.
--tags TAGS (facoltativo): Filtra i segmenti in base a un elenco di tag separati da virgole.
--sort SORT (facoltativo): Ordina i dettagli in base all'attributo specificato.

Esempio

Per visualizzare l'elenco completo delle proprietà, eseguire il seguente comando:

ibmcloud ac property list --environment_id "production"

Output

Il comando restituisce il seguente output:

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                        -

creazione della proprietà ibmcloud ac

È possibile creare una proprietà utilizzando il comando:

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)

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome proprietà. Campo obbligatorio - da inserire come flag o da file.
--property_id PROPERTY_ID (facoltativo): Id proprietà. Se questo valore non viene specificato, il nome diventerà automaticamente l'ID. Campo facoltativo - da inserire come flag o da file.
--description DESCRIPTION: Descrizione della proprietà. Campo obbligatorio - da inserire come flag o da file.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla proprietà. Campo obbligatorio - da inserire come flag o da file.
--value VALUE: Valore proprietà. Campo obbligatorio - da inserire come flag o da file.
--type TYPE: Tipo proprietà. Campo obbligatorio - da inserire come flag o da file.
--collections COLLECTIONS: Elenco di ID di raccolta che rappresentano le raccolte associate alla proprietà specificata. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso attraverso un file. Formato file supportato: JSON

Esempio

Per creare una proprietà con il nome email-property utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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 '[]'

Output

Il comando restituisce il seguente output:

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

proprietà ibmcloud ac get

È possibile ottenere una proprietà utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--property_id PROPERTY_ID: ID della proprietà per il flag di proprietà.
--include INCLUDE (facoltativo): I dettagli della proprietà devono includere nella risposta le informazioni relative alle raccolte o alle regole associate.

Esempio

Per ottenere una proprietà con ID email-property, eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

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

aggiornamento della proprietà di ibmcloud ac

È possibile aggiornare una proprietà utilizzando il comando:

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])

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome proprietà. Campo obbligatorio - da inserire come flag o da file.
--property_id PROPERTY_ID: Id proprietà. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione della proprietà. Campo obbligatorio - da inserire come flag o da file.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla proprietà. Campo obbligatorio - da inserire come flag o da file.
--value VALUE: Valore proprietà. Campo obbligatorio - da inserire come flag o da file.
--collections COLLECTIONS: Elenco di ID di raccolta che rappresentano le raccolte associate alla proprietà specificata. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso attraverso un file. Formato file supportato: JSON

Esempio

Per aggiornare la descrizione di una proprietà con ID email-property utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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 '[]'

Output

Il comando restituisce il seguente output:

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

aggiornamento dei valori delle proprietà di ibmcloud ac

È possibile aggiornare i valori delle proprietà (il valore delle proprietà e le regole di puntamento possono essere aggiornate, tuttavia questo metodo non consente di assegnare le proprietà a una collezione), utilizzando il comando:

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])

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--name NAME: Nome proprietà. Campo obbligatorio - da inserire come flag o da file.
--property_id PROPERTY_ID: Id proprietà. Campo obbligatorio - da inserire come flag o da file.
--description DESCRIPTION: Descrizione della proprietà. Campo obbligatorio - da inserire come flag o da file.
--segment_rules SEGMENT_RULES: Specificare le regole di targeting utilizzate per impostare valori diversi per i vari segmenti. Campo obbligatorio - da inserire come flag o da file.
--tags TAGS: Tag associati alla proprietà. Campo obbligatorio - da inserire come flag o da file.
--value VALUE: Valore proprietà. Campo obbligatorio - da inserire come flag o da file.
--file FILE: Ingresso tramite file. Formato file supportato: JSON

Esempio

Per aggiornare la descrizione di un immobile con ID email-property utilizzando i flag (fare clic qui per utilizzare i comandi con il flag '--file' ), eseguire il seguente comando:

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}]'

Output

Il comando restituisce il seguente output:

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

eliminazione della proprietà ibmcloud ac

È possibile eliminare una proprietà utilizzando il comando:

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

Opzioni comando

--environment_id ENVIRONMENT_ID: ID ambiente
--property_id PROPERTY_ID: ID proprietà

Esempio

Per eliminare una proprietà con ID ibm_employees, eseguire il seguente comando:

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

Output

Il comando restituisce il seguente output:

OK

esportazione ibmcloud ac

È possibile esportare i dati di configurazione dell'istanza selezionata, utilizzando il comando:

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

Opzioni comando

--file FILE (facoltativo): Percorso del file in cui verrà esportata la configurazione.
--output OUTPUT (facoltativo): Scegliere un formato di output, che può essere "JSON" o "yaml". (predefinito "JSON")

Esempio

Per esportare i dati di configurazione dell'istanza selezionata, eseguire il seguente comando:

ibmcloud ac export --file exportedConfig.json

Output

Il comando restituisce il seguente output:

OK
Configuration exported to file exportedConfig.json

importazione ibmcloud ac

È possibile importare i dati di configurazione da un file all'istanza selezionata, utilizzando il comando:

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

Opzioni comando

--file FILE: Percorso del file da cui verrà importata la configurazione.
--clean CLEAN (facoltativo): Se impostato su "true", cancella i dati esistenti nell'istanza del servizio prima dell'importazione dei dati di configurazione.

Esempio

Per importare i dati di configurazione da un file all'istanza selezionata, eseguire il seguente comando:

ibmcloud ac import --file exportedConfig.json

Output

Il comando restituisce il seguente output:

OK
Configuration imported from file exportedConfig.json

Creare o aggiornare un elemento da un file

Il plug-in offre le funzioni di creazione o aggiornamento di elementi in formato JSON, memorizzati in un file.

In questo modo è possibile creare una raccolta da un file.

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

Si noti il simbolo "|". Ciò indica che esistono due modi per utilizzare il comando.

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

Per visualizzare il formato JSON supportato, consultare i documenti API.

Utilizzare il flag file (non può essere combinato con nessun altro flag) per indicare il percorso del file.

Esempio

Per creare una raccolta con ID corporateDiscount memorizzata in un file create_collection_body.json eseguire il seguente comando:

ibmcloud ac collection create --file create_collection_body.json

Ecco il contenuto di create_collection_body.json:

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

Output

Il comando restituisce il seguente output:

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

Il comportamento per la creazione e l'aggiornamento di una collezione, di una caratteristica o di un segmento è simile a quello descritto in precedenza. Per la struttura del formato JSON accettato, consultare i documenti API

disinstallazione del plug-in ibmcloud

Utilizzare questo comando per disinstallare il plug-in App Configuration CLI.

ibmcloud plugin uninstall app-configuration

Se non ci sono errori, la disinstallazione restituisce un messaggio di successo.

App Configuration Comandi CLI (validi solo per le versioni 0.0.1- 1.0.14 )

App Configuration Comandi CLI (validi solo per le versioni 0.0.1- 1.0.14 )

Prerequisiti

Installazione del plugin della CLI App Configuration

Output

Accesso alla CLI con un endpoint privato

ibmcloud ac init

Opzioni comando

Esempio

Output

mostra ibmcloud ac

Esempio

Output

elenco degli ambienti ibmcloud ac

Opzioni comando

Esempio

Output

creare l'ambiente ibmcloud ac

Opzioni comando

Esempio

Output

ambiente ibmcloud ac ottenere

Opzioni comando

Esempio

Output

aggiornamento dell'ambiente ibmcloud ac

Opzioni comando

Esempio

Output

eliminazione dell'ambiente ibmcloud ac

Opzioni comando

Esempio

Output

elenco di raccolta ibmcloud ac

Opzioni comando

Esempio

Output

ibmcloud ac collection create

Opzioni comando

Esempio

Output

ibmcloud ac collection get

Opzioni comando

Esempio

Output

aggiornamento della raccolta ibmcloud ac

Opzioni comando

Esempio

Output

eliminazione della raccolta ibmcloud ac

Opzioni comando

Esempio

Output

elenco delle funzionalità di ibmcloud ac

Opzioni comando

Esempio

Output

ibmcloud ac funzione create

Opzioni comando

Esempio

Output

ibmcloud ac funzione get

Opzioni comando

Esempio

Output

aggiornamento delle funzionalità di ibmcloud ac

Opzioni comando

Esempio

Output

aggiornamento dei valori delle funzioni di ibmcloud ac

Opzioni comando

Esempio

Output

eliminazione della funzione ibmcloud ac

Opzioni comando

Esempio

Output

funzione ibmcloud ac da attivare

Opzioni comando

Esempio