App Configuration Comandos CLI (válidos solo para las versiones 0.0.1- 1.0.14 )

Comandos CLI que se enumeran aquí solo serán válidos para las versiones 0.0.1- 1.0.14, que quedarán obsoletas.

La interfaz comando línea de comandos (CLI) de IBM Cloud proporciona capacidades adicionales para la oferta de servicios. La CLI de IBM Cloud admite un marco de complementos para ampliar su capacidad. Puede instalar el plugin de CLI de App Configuration desde el repositorio de plugins de IBM Cloud. Con el complemento de la CLI del servicio « App Configuration », puedes gestionar fácilmente las instancias del servicio « App Configuration » mediante los comandos de la CLI.

Para ejecutar mandatos de IBM Cloud App Configuration, utilice ibmcloud app-configuration o ibmcloud ac.

Requisitos previos

Una cuenta de IBM Cloud. Si no tiene una cuenta, pulse aquí para crear una.
Una instancia del servicio IBM Cloud App Configuration.
CLI de IBM Cloud.
Opcionalmente, si desea utilizar el soporte de endpoints privados que proporciona la plataforma IBM Cloud, asegúrese de habilitarVRF y los endpoints de servicio.

Instalación del plugin de CLI de App Configuration

Instale el plugin de CLI de App Configuration ejecutando el siguiente mandato desde el repositorio de plugins de IBM IBM Cloud:

ibmcloud plugin install app-configuration

Se te notificará en la comando cuando haya actualizaciones disponibles para la CLI de IBM Cloud y los complementos. Asegúrate de mantener tu CLI actualizada para poder utilizar los nuevos comandos. Puede ver la versión actual de todos los plugins instalados con el mandato ibmcloud plugin list.

Salida

El mandato devuelve el siguiente resultado:

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.

Para mejorar el control y la seguridad de sus datos cuando utilice CLI, tiene la opción de utilizar rutas privadas a los puntos finales de IBM Cloud. En primer lugar, activa el enrutamiento y reenvío virtuales en tu cuenta; a continuación, podrás habilitar el uso de los puntos finales del servicio privado « IBM Cloud ». Para obtener más información sobre la configuración de la cuenta para dar soporte a la opción de conectividad privada, consulte Habilitación de puntos finales de VRF y de servicio.

Utilice el mandato siguiente para iniciar sesión en un punto final privado mediante la CLI:

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac init

Antes de inicializar el complemento de la CLI, asegúrate de seleccionar el punto final de la API, la región y la cuenta correctos en tu CLI de IBM Cloud.

Inicialice el plugin de cli utilizando el siguiente mandato:

ibmcloud ac init --instance_id INSTANCE_ID

Opciones de comando

--instance_id INSTANCE_ID (opcional): GUID de la instancia de configuración de aplicaciones a utilizar.

Ejemplo

Inicie sesión en la CLI de IBM Cloud e inicialice la CLI para la instancia App Configuration Instance 1 del servicio App Configuration.

ibmcloud ac init

Salida

El comando devuelve la siguiente salida (nombre de la instancia seguido de un espacio junto con el 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

Para ver el nombre y el GUID de la instancia que se está utilizando, utiliza este comando.

ibmcloud ac show

Ejemplo

Requisito previo: utilice el mandato ibmcloud ac init para seleccionar primero una instancia.

ibmcloud ac show

Salida

El mandato devuelve el siguiente resultado:

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

ibmcloud ac environment list

Puedes ver una lista de todos los entornos utilizando el comando :

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

Opciones de comando

--limit LIMIT (opcional): Se utiliza para la paginación. El número de registros a recuperar.
--offset OFFSET (opcional): Se utiliza para la paginación. El número de registros a omitir.
--tags TAGS (opcional): Filtrar en función de las etiquetas.
--sort SORT (opcional): Ordenar los detalles según el atributo especificado.
--expand EXPAND (opcional): Vista expandida del elemento.
--include INCLUDE (opcional): Incluir detalles de característica y propiedad en la respuesta.

Ejemplo

Para listar todos los entornos, ejecute el mandato siguiente:

ibmcloud ac environment list

Salida

El mandato devuelve el siguiente resultado:

name               environment_id
Prod Environment   prodEnvironment
Dev environment    devEnvironment

ibmcloud ac environment create

Puedes crear un entorno utilizando el comando :

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

Opciones de comando

--name NAME: Nombre del entorno. Campo necesario; especificar como un distintivo o desde un archivo.
--environment_id ENVIRONMENT_ID (opcional): ID de entorno. Si no se indica este valor, el nombre se convertirá automáticamente en el ID. Campo opcional; especificar como un distintivo o desde un archivo.
--description DESCRIPTION (opcional): Descripción del entorno. Campo opcional; especificar como un distintivo o desde un archivo.
--tags TAGS (opcional): Etiquetas asociadas al entorno. Campo opcional; especificar como un distintivo o desde un archivo.
--color_code COLOR_CODE (opcional): Código de color para distinguir el entorno. El código hexadecimal para el color. Campo opcional; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través del fichero. Formato de archivo soportado: JSON

Ejemplo

Para crear un entorno con el nombre « Production_Environment » utilizando opciones ( haz clic aquí para ver cómo utilizar comandos con la opción « --file »), ejecuta el siguiente comando :

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes obtener información detallada sobre el entorno utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--expand EXPAND (opcional): Vista expandida del elemento.
--include INCLUDE (opcional): Incluir detalles de característica y propiedad en la respuesta.

Ejemplo

Para obtener un entorno con el ID « prodEnvironment », ejecuta el siguiente comando :

ibmcloud ac environment get --environment_id prodEnvironment

Salida

El mandato devuelve el siguiente resultado:

name             Production_Environment
environment_id   prodEnvironment

ibmcloud ac environment update

Puedes actualizar un entorno utilizando el siguiente comando :

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

Opciones de comando

--name NAME: Nombre del entorno. Campo necesario; especificar como un distintivo o desde un archivo.
--environment_id ENVIRONMENT_ID (opcional): ID de entorno. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION (opcional): Descripción del entorno. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS (opcional): Etiquetas asociadas al entorno. Campo necesario; especificar como un distintivo o desde un archivo.
--color_code COLOR_CODE (opcional): Código de color para distinguir el entorno. El código hexadecimal para el color. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través del fichero. Formato de archivo soportado: JSON

Ejemplo

Para actualizar un entorno con el ID « prodEnvironment » utilizando opciones ( haz clic aquí para ver cómo utilizar comandos con la opción « '--file' »), ejecuta el siguiente comando :

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes eliminar un entorno utilizando el comando :

ibmcloud ac environment delete --environment_id ENVIRONMENT_ID

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno.

Ejemplo

Para eliminar un entorno con el ID « prodEnvironment », ejecuta el siguiente comando :

ibmcloud ac environment delete --environment_id prodEnvironment

Salida

El mandato devuelve el siguiente resultado:

OK

ibmcloud ac collection list

Puede listar todas las recopilaciones utilizando el mandato:

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

Opciones de comando

--limit LIMIT (opcional): Se utiliza para la paginación. El número de registros a recuperar.
--offset OFFSET (opcional): Se utiliza para la paginación. El número de registros a omitir.
--features FEATURES (opcional): Filtra las colecciones según una lista de características separadas por comas.
--properties PROPERTIES (opcional): Filtrar colecciones según una lista de propiedades separadas por comas.
--tags TAGS (opcional): Filtrar en función de las etiquetas.
--sort SORT (opcional): Ordenar los detalles según el atributo especificado.
--expand EXPAND (opcional): Vista expandida del elemento.
--include INCLUDE (opcional): Incluir detalles de característica y propiedad en la respuesta.

Ejemplo

Para listar todas las recopilaciones ejecute el mandato siguiente:

ibmcloud ac collection list

Salida

El mandato devuelve el siguiente resultado:

name                 collection_id
sample               sampleId
GHz Inc              ghzinc1

ibmcloud ac collection create

Puedes crear una colección utilizando el comando :

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

Opciones de comando

--name NAME: Nombre de la recopilación. Campo necesario; especificar como un distintivo o desde un archivo.
--collection_id COLLECTION_ID (opcional): ID de colección. Si no se indica este valor, el nombre se convertirá automáticamente en el ID. Campo opcional; especificar como un distintivo o desde un archivo.
--description DESCRIPTION (opcional): Descripción de la recopilación. Campo opcional; especificar como un distintivo o desde un archivo.
--tags TAGS (opcional): Etiquetas asociadas a la recopilación. Campo opcional; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través del fichero. Formato de archivo soportado: JSON

Ejemplo

Para crear una colección con el nombre « sample » utilizando indicadores ( haz clic aquí para ver cómo utilizar comandos con el indicador « --file »), ejecuta el siguiente comando :

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes obtener una colección utilizando el comando :

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

Opciones de comando

--collection_id COLLECTION_ID: Identificador de la colección.
--expand EXPAND (opcional): Vista expandida de los detalles de la recopilación.
--include INCLUDE (opcional): Incluir detalles de característica y propiedad en la respuesta.

Ejemplo

Para obtener una recopilación con Id sampleId, ejecute el siguiente mandato:

ibmcloud ac collection get --collection_id sampleId

Salida

El mandato devuelve el siguiente resultado:

name            sample
collection_id   sampleId

ibmcloud ac collection update

Puedes actualizar una colección utilizando el comando :

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

Opciones de comando

--collection_id COLLECTION_ID: ID de colección. Campo necesario; especificar como un distintivo o desde un archivo.
--name NAME: Nombre de la recopilación. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la recopilación. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS (opcional) Formato de archivo admitido: Etiquetas asociadas a la recopilación. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada del archivo. Formato de archivo soportado: JSON

Ejemplo

Para actualizar una recopilación con el id sampleId utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el mandato siguiente:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes eliminar una colección utilizando el comando :

ibmcloud ac collection delete --collection_id COLLECTION_ID

Opciones de comando

--collection_id COLLECTION_ID: ID de colección

Ejemplo

Para eliminar una colección con el ID sampleId, ejecuta el siguiente comando :

ibmcloud ac collection delete --collection_id sampleId

Salida

El mandato devuelve el siguiente resultado:

OK

ibmcloud ac feature list

Puede listar todas las características utilizando el mandato:

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--limit LIMIT (opcional): Se utiliza para la paginación. El número de registros a recuperar.
--include INCLUDE (opcional): Detalles de características para incluir las recopilaciones asociadas o los detalles de las reglas en la respuesta.
--offset OFFSET (opcional): Se utiliza para la paginación. El número de registros a omitir.
--collections COLLECTIONS (opcional): Filtra las características mediante una lista de colecciones separadas por comas.
--segments SEGMENTS (opcional): Filtra las características mediante una lista de segmentos separados por comas.
--expand EXPAND (opcional): Vista expandida del elemento.
--tags TAGS (opcional): Filtra las características mediante una lista de etiquetas separadas por comas.
--sort SORT (opcional): Ordenar los detalles según el atributo especificado.

Ejemplo

Para listar todas las características, ejecute el mandato siguiente:

ibmcloud ac feature list --environment_id "production"

Salida

El mandato devuelve el siguiente resultado:

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

ibmcloud ac feature create

Puedes crear un elemento utilizando el 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}

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de característica. Campo necesario; especificar como un distintivo o desde un archivo.
--feature_id FEATURE_ID (opcional): ID de característica. Si no se indica este valor, el nombre se convertirá automáticamente en el ID. Campo opcional; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--type TYPE: Tipo de la característica (Boolean, String, Number). Campo necesario; especificar como un distintivo o desde un archivo.
--enabled_value ENABLED_VALUE: Valor de la característica cuando está habilitada. Campo necesario; especificar como un distintivo o desde un archivo.
--disabled_value DISABLED_VALUE: Valor de la característica cuando está inhabilitada. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento.
--enabled ENABLED: El estado del distintivo de característica.
--collections COLLECTIONS: Matriz de recopilaciones.
--file FILE: Entrada a través de fichero. Formato de archivo soportado: JSON

Ejemplo

Para crear una recopilación con el nombre sample utilizando distintivos (pulse aquí para utilizar mandato con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes obtener una función utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--feature_id FEATURE_ID: ID de característica para el distintivo de característica.
--include INCLUDE (opcional): Incluir las recopilaciones asociadas en la respuesta.

Ejemplo

Para obtener una característica con el ID ibm-discount, ejecute el mandato siguiente:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes actualizar una característica utilizando el 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}

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de característica. Campo necesario; especificar como un distintivo o desde un archivo.
--feature_id FEATURE_ID: ID de característica. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--enabled_value ENABLED_VALUE: Valor de la característica cuando está habilitada. Campo necesario; especificar como un distintivo o desde un archivo.
--disabled_value DISABLED_VALUE: Valor de la característica cuando está inhabilitada. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--enabled ENABLED: El estado del distintivo de característica.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento.
--collections COLLECTIONS: Matriz de recopilaciones.
--file FILE: Entrada a través del fichero. Formato de archivo soportado: JSON.

Ejemplo

Para actualizar la descripción de una característica con ID ibm-discount utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes actualizar los valores de una función (este método permite actualizar el nombre de la función, el valor «enabled_value», el valor «disabled_value», las etiquetas, la descripción y las reglas de segmentos de la función; sin embargo, no permite activar o desactivar la función ni asignarla a una colección) utilizando el 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}

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de característica. Campo necesario; especificar como un distintivo o desde un archivo.
--feature_id FEATURE_ID: ID de característica. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--enabled_value ENABLED_VALUE: Valor de la característica cuando está habilitada. Campo necesario; especificar como un distintivo o desde un archivo.
--disabled_value DISABLED_VALUE: Valor de la función cuando no está disponible. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la característica. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento.
--file FILE: Entrada a través del fichero. Formato de archivo soportado: JSON

Ejemplo

Para actualizar la descripción de una característica con ID ibm-discount utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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"

Salida

El mandato devuelve el siguiente resultado:

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

Puedes eliminar un elemento utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--feature_id FEATURE_ID: ID de característica

Ejemplo

Para suprimir una característica con el id ibm-discount, ejecute el mandato siguiente:

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

Salida

El mandato devuelve el siguiente resultado:

OK

ibmcloud ac feature toggle

Puedes activar o desactivar el valor de una característica utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--feature_id FEATURE_ID: ID de característica
--enabled ENABLED: El estado del distintivo de característica.

Ejemplo

Para conmutar un valor de característica con el ID ibm-discount, ejecute el mandato siguiente:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puede listar todos los segmentos utilizando el mandato:

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

Opciones de comando

--limit LIMIT (opcional): Se utiliza para la paginación. El número de registros a recuperar.
--include INCLUDE (opcional): Detalles del segmento para incluir las reglas asociadas en la respuesta.
--offset OFFSET (opcional): Se utiliza para la paginación. El número de registros a omitir.
--expand EXPAND (opcional): Vista expandida de detalles de segmento.
--tags TAGS (opcional): Filtra los segmentos según una lista de etiquetas separadas por comas.
--sort SORT (opcional): Ordenar los detalles según el atributo especificado.

Ejemplo

Para listar todos los segmentos, ejecute el mandato siguiente:

ibmcloud ac segment list

Salida

El mandato devuelve el siguiente resultado:

name            segment_id
India IBMers    ibm_employees_01
IBM Employees   ibm_employees

ibmcloud ac segment create

Puedes crear un segmento utilizando el comando :

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

Opciones de comando

--name NAME: Nombre de segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_id SEGMENT_ID (opcional): ID de segmento. Si no se indica este valor, el nombre se convertirá automáticamente en el ID. Campo opcional; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción del segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--rules RULES: Lista de normas que determinan si la entidad forma parte del segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas al segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través de un fichero. Formato de archivo soportado: JSON

Ejemplo

Para crear una recopilación con el nombre sample utilizando distintivos (pulse aquí para utilizar mandato con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes obtener un segmento utilizando el comando :

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

Opciones de comando

--segment_id SEGMENT_ID: ID de segmento.
--include INCLUDE (opcional): Indica que se incluyan los detalles de la característica y la propiedad en función de la asociación de segmentos.

Ejemplo

Para obtener un segmento con el ID ibm_employees, ejecute el mandato siguiente:

ibmcloud ac segment get --segment_id ibm_employees

Salida

El mandato devuelve el siguiente resultado:

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

Puedes actualizar un segmento utilizando el comando :

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

Opciones de comando

--name NAME: Nombre de segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_id SEGMENT_ID: ID de segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción del segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--rules RULES: Lista de normas que determinan si la entidad forma parte del segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas al segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través de un fichero. Formato de archivo soportado: JSON

Ejemplo

Para actualizar la descripción de un segmento con ID ibm_employees utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes eliminar un segmento utilizando el comando :

ibmcloud ac segment delete --segment_id SEGMENT_ID

Opciones de comando

--segment_id SEGMENT_ID: ID de segmento

Ejemplo

Para suprimir un segmento con el ID ibm_employees, ejecute el mandato siguiente:

ibmcloud ac segment delete --segment_id ibm_employees

Salida

El mandato devuelve el siguiente resultado:

OK

ibmcloud ac property list

Puede listar todas las propiedades utilizando el mandato:

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--limit LIMIT (opcional): Se utiliza para la paginación. El número de registros a recuperar.
--include INCLUDE (opcional): Detalles del segmento para incluir las reglas asociadas en la respuesta.
--offset OFFSET (opcional): Se utiliza para la paginación. El número de registros a omitir.
--collections COLLECTIONS (opcional): Filtra las características mediante una lista de colecciones separadas por comas.
--segments SEGMENTS (opcional): Filtra las características mediante una lista de segmentos separados por comas.
--expand EXPAND (opcional): Vista expandida de detalles de segmento.
--tags TAGS (opcional): Filtra los segmentos según una lista de etiquetas separadas por comas.
--sort SORT (opcional): Ordenar los detalles según el atributo especificado.

Ejemplo

Para listar todas las propiedades, ejecute el mandato siguiente:

ibmcloud ac property list --environment_id "production"

Salida

El mandato devuelve el siguiente resultado:

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

Puedes crear una propiedad utilizando el 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)

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--property_id PROPERTY_ID (opcional): ID de propiedad. Si no se indica este valor, el nombre se convertirá automáticamente en el ID. Campo opcional; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--value VALUE: Valor de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--type TYPE: Tipo de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--collections COLLECTIONS: Lista de los ID de colección que representan las colecciones asociadas a la propiedad especificada. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través de un fichero. Formato de archivo soportado: JSON

Ejemplo

Para crear una propiedad con el nombre email-property utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes obtener una propiedad utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--property_id PROPERTY_ID: ID de propiedad para el distintivo de propiedad.
--include INCLUDE (opcional): Detalles de propiedades para incluir las recopilaciones asociadas o los detalles de las reglas en la respuesta.

Ejemplo

Para obtener una propiedad ID email-property, ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes actualizar una propiedad utilizando el 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])

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--property_id PROPERTY_ID: ID de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--value VALUE: Valor de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--collections COLLECTIONS: Lista de los ID de colección que representan las colecciones asociadas a la propiedad especificada. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través de un fichero. Formato de archivo soportado: JSON

Ejemplo

Para actualizar la descripción de una propiedad con ID email-property utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes actualizar los valores de las propiedades (se pueden actualizar tanto el valor de la propiedad como las reglas de selección; sin embargo, este método no permite asignar una propiedad a una colección) utilizando el 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])

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--name NAME: Nombre de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--property_id PROPERTY_ID: ID de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--description DESCRIPTION: Descripción de la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--segment_rules SEGMENT_RULES: Especifica las reglas de segmentación que se utilizan para establecer valores distintos para cada segmento. Campo necesario; especificar como un distintivo o desde un archivo.
--tags TAGS: Etiquetas asociadas a la propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--value VALUE: Valor de propiedad. Campo necesario; especificar como un distintivo o desde un archivo.
--file FILE: Entrada a través de fichero. Formato de archivo soportado: JSON

Ejemplo

Para actualizar la descripción de una propiedad con el ID email-property utilizando distintivos (pulse aquí para utilizar mandatos con el distintivo '--file'), ejecute el siguiente mandato:

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

Salida

El mandato devuelve el siguiente resultado:

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

Puedes eliminar una propiedad utilizando el comando :

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

Opciones de comando

--environment_id ENVIRONMENT_ID: ID de entorno
--property_id PROPERTY_ID: ID de la propiedad

Ejemplo

Para suprimir una propiedad con el ID ibm_employees, ejecute el mandato siguiente:

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

Salida

El mandato devuelve el siguiente resultado:

OK

ibmcloud ac export

Puede exportar datos de configuración de la instancia seleccionada utilizando el mandato:

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

Opciones de comando

--file FILE (opcional): Ruta del archivo al que se exportará la configuración.
--output OUTPUT (opcional): Elija un formato de salida - puede ser "JSON" o "yaml". (por defecto "JSON")

Ejemplo

Para exportar datos de configuración de la instancia seleccionada, ejecute el siguiente mandato:

ibmcloud ac export --file exportedConfig.json

Salida

El mandato devuelve el siguiente resultado:

OK
Configuration exported to file exportedConfig.json

ibmcloud ac import

Puede importar datos de configuración de un archivo a la instancia seleccionada, utilizando el mandato:

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

Opciones de comando

--file FILE: Ruta del archivo desde el que se importará la configuración.
--clean CLEAN (opcional): Si se establece en «true», borra los datos existentes en la instancia del servicio antes de importar los datos de configuración.

Ejemplo

Para importar datos de configuración de un archivo a la instancia seleccionada, ejecute el siguiente mandato:

ibmcloud ac import --file exportedConfig.json

Salida

El mandato devuelve el siguiente resultado:

OK
Configuration imported from file exportedConfig.json

Crear o actualizar un elemento a partir de un archivo

El complemento te permite crear o actualizar elementos en formato JSON almacenados en un archivo.

Así es como puedes crear una colección a partir de un archivo.

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

Observe el símbolo '|'. Esto indica que hay dos formas de utilizar el mandato.

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

Para consultar el formato JSON compatible, consulta la documentación de la API.

Utilice el distintivo de archivo (no se puede combinar con ningún otro distintivo) para indicar la vía de acceso del archivo.

Ejemplo

Para crear una recopilación con el ID corporateDiscount almacenado en un archivo create_collection_body.json, ejecute el siguiente mandato:

ibmcloud ac collection create --file create_collection_body.json

Este es el contenido de create_collection_body.json:

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

Salida

El mandato devuelve el siguiente resultado:

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

El procedimiento para crear y actualizar una colección, un elemento o un segmento es similar al mencionado anteriormente. Para conocer la estructura del formato JSON admitida, consulta la documentación de la API

ibmcloud plug-in uninstall

Utilice este mandato para desinstalar el plugin de CLI de configuración de apps.

ibmcloud plugin uninstall app-configuration

La desinstalación devuelve un mensaje de realizado satisfactoriamente, si no hay errores.

App Configuration Comandos CLI (válidos solo para las versiones 0.0.1- 1.0.14 )

App Configuration Comandos CLI (válidos solo para las versiones 0.0.1- 1.0.14 )

Requisitos previos

Instalación del plugin de CLI de App Configuration

Salida

Inicio de sesión en la CLI con un punto final privado

ibmcloud ac init

Opciones de comando

Ejemplo

Salida

ibmcloud ac show

Ejemplo

Salida

ibmcloud ac environment list

Opciones de comando

Ejemplo

Salida

ibmcloud ac environment create

Opciones de comando

Ejemplo

Salida

ibmcloud ac environment get

Opciones de comando

Ejemplo

Salida

ibmcloud ac environment update

Opciones de comando

Ejemplo

Salida

ibmcloud ac environment delete

Opciones de comando

Ejemplo

Salida

ibmcloud ac collection list

Opciones de comando

Ejemplo

Salida

ibmcloud ac collection create

Opciones de comando

Ejemplo

Salida

ibmcloud ac collection get

Opciones de comando

Ejemplo

Salida

ibmcloud ac collection update

Opciones de comando

Ejemplo

Salida

ibmcloud ac collection delete

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature list

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature create

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature get

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature update

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature update-values

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature delete

Opciones de comando

Ejemplo

Salida

ibmcloud ac feature toggle

Opciones de comando

Ejemplo