App Configuration CLI 명령어 ( 0.0.1- 1.0.14 버전에서만 유효)

여기에 나열된 CLI 명령어는 버전 0.0.1- 1.0.14 에서만 유효하며, 해당 버전은 더 이상 사용되지 않을 예정입니다.

IBM Cloud 의 명령줄 인터페이스(CLI)는 서비스 제공을 위한 추가 기능을 제공합니다. IBM Cloud CLI는 기능 확장을 위한 플러그인 프레임워크를 지원합니다. App Configuration 플러그인 저장소에서 IBM Cloud CLI 플러그인을 설치할 수 있습니다. App Configuration 서비스 CLI 플러그인을 사용하면 CLI 명령어를 통해 App Configuration 서비스 인스턴스를 손쉽게 관리할 수 있습니다.

IBM Cloud App Configuration 명령을 실행하려면, ibmcloud app-configuration 또는 ibmcloud ac를 사용하십시오.

전제조건

App Configuration CLI 플러그인 설치

IBM 플러그인 저장소 IBM Cloud에서 다음 명령을 실행하여 App Configuration CLI 플러그인을 설치하십시오.

ibmcloud plugin install app-configuration

IBM Cloud CLI 및 플러그인의 업데이트가 제공되면 명령줄을 통해 알림이 표시됩니다. 새로운 명령어를 사용할 수 있도록 CLI를 항상 최신 상태로 유지하시기 바랍니다. ibmcloud plugin list를 실행하여 설치된 모든 플러그인의 현재 버전을 볼 수 있습니다.

출력

명령은 다음 출력을 리턴합니다.

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.

사설 엔드포인트로 CLI에 로그인

CLI 사용 시 데이터에 대한 제어 및 보안을 강화하기 위해 IBM Cloud 엔드포인트에 대한 비공개 경로를 사용할 수 있습니다. 먼저 계정에서 가상 라우팅 및 전달 기능을 활성화한 다음, IBM Cloud 의 비공개 서비스 엔드포인트 사용을 활성화할 수 있습니다. 사설 연결 옵션을 지원하도록 계정을 설정하는 데 관한 자세한 정보는 VRF 및 서비스 엔드포인트 사용을 참조하십시오.

CLI를 사용하여 사설 엔드포인트에 로그인하려면 다음 명령을 사용하십시오.

ibmcloud login -a private.cloud.ibm.com

ibmcloud ac init

CLI 플러그인을 초기화하기 전에, IBM Cloud CLI에서 올바른 API 엔드포인트, 리전 및 계정을 선택했는지 확인하십시오.

다음 명령을 사용하여 CLI 플러그인을 초기화하십시오.

ibmcloud ac init --instance_id INSTANCE_ID

명령 옵션

--instance_id INSTANCE_ID(선택사항)
사용할 앱 구성 인스턴스의 GUID입니다.

예

IBM Cloud CLI로 로그인하고 App Configuration 서비스 인스턴스 App Configuration Instance 1로 CLI를 초기화하십시오.

ibmcloud ac init

출력

이 명령은 다음 출력을 반환합니다(인스턴스 이름 뒤에 공백과 함께 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

사용 중인 인스턴스의 이름과 GUID를 확인하려면 다음 명령을 사용하십시오.

ibmcloud ac show

예

선행 조건 - ibmcloud ac init 명령을 사용하여 먼저 인스턴스를 선택하십시오.

ibmcloud ac show

출력

명령은 다음 출력을 리턴합니다.

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

ibmcloud ac environment list

다음 명령어를 사용하면 모든 환경을 나열할 수 있습니다:

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

명령 옵션

--limit LIMIT(선택사항)
페이지 매김에 사용됩니다. 검색할 레코드 수입니다.
--offset OFFSET(선택사항)
페이지 매김에 사용됩니다. 건너뛸 레코드 수입니다.
--tags TAGS(선택사항)
태그를 기준으로 필터링합니다.
--sort SORT(선택사항)
지정된 속성을 기반으로 세부사항을 정렬합니다.
--expand EXPAND(선택사항)
항목의 보기를 펼칩니다.
--include INCLUDE(선택사항)
응답에서 기능 및 특성 세부사항을 포함합니다.

예

모든 환경을 나열하려면 다음 명령을 실행하십시오.

ibmcloud ac environment list

출력

명령은 다음 출력을 리턴합니다.

name               environment_id
Prod Environment   prodEnvironment
Dev environment    devEnvironment

ibmcloud ac environment create

다음 명령어를 사용하여 환경을 생성할 수 있습니다:

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

명령 옵션

--name NAME
환경 이름입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--environment_id ENVIRONMENT_ID(선택사항)
환경 ID입니다. 이 값을 지정하지 않으면 이름이 자동으로 ID로 설정됩니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION(선택사항)
환경에 대한 설명입니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS(선택사항)
환경과 연관되는 태그입니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--color_code COLOR_CODE(선택사항)
환경을 구분하는 색상 코드입니다. 색상의 16진 코드입니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 “ Production_Environment ”라는 이름의 환경을 생성하려면( --file 플래그와 함께 명령어를 사용하는 방법은 여기를 클릭하세요 ), 다음 명령어를 실행하십시오:

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하면 환경 정보를 확인할 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--expand EXPAND(선택사항)
항목의 보기를 펼칩니다.
--include INCLUDE(선택사항)
응답에서 기능 및 특성 세부사항을 포함합니다.

예

ID가 prodEnvironment 인 환경을 설정하려면 다음 명령을 실행하십시오:

ibmcloud ac environment get --environment_id prodEnvironment

출력

명령은 다음 출력을 리턴합니다.

name             Production_Environment
environment_id   prodEnvironment

ibmcloud ac environment update

다음 명령어를 사용하여 환경을 업데이트할 수 있습니다:

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

명령 옵션

--name NAME
환경 이름입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--environment_id ENVIRONMENT_ID(선택사항)
환경 ID입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION(선택사항)
환경에 대한 설명입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS(선택사항)
환경과 연관되는 태그입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--color_code COLOR_CODE(선택사항)
환경을 구분하는 색상 코드입니다. 색상의 16진 코드입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

ID가 prodEnvironment 인 환경을 플래그를 사용하여 업데이트하려면( '--file' 플래그와 함께 명령어를 사용하는 방법은 여기를 클릭하세요 ), 다음 명령어를 실행하십시오:

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 환경을 삭제할 수 있습니다:

ibmcloud ac environment delete --environment_id ENVIRONMENT_ID

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID입니다.

예

ID가 prodEnvironment 인 환경을 삭제하려면 다음 명령을 실행하십시오:

ibmcloud ac environment delete --environment_id prodEnvironment

출력

명령은 다음 출력을 리턴합니다.

OK

ibmcloud ac collection list

다음 명령을 사용하여 모든 콜렉션을 나열할 수 있습니다.

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

명령 옵션

--limit LIMIT(선택사항)
페이지 매김에 사용됩니다. 검색할 레코드 수입니다.
--offset OFFSET(선택사항)
페이지 매김에 사용됩니다. 건너뛸 레코드 수입니다.
--features FEATURES(선택사항)
쉼표로 구분된 특징 목록을 기준으로 컬렉션을 필터링합니다.
--properties PROPERTIES(선택사항)
쉼표로 구분된 속성 목록을 기준으로 컬렉션을 필터링합니다.
--tags TAGS(선택사항)
태그를 기준으로 필터링합니다.
--sort SORT(선택사항)
지정된 속성을 기반으로 세부사항을 정렬합니다.
--expand EXPAND(선택사항)
항목의 보기를 펼칩니다.
--include INCLUDE(선택사항)
응답에서 기능 및 특성 세부사항을 포함합니다.

예

모든 콜렉션을 나열하려면 다음 명령을 실행하십시오.

ibmcloud ac collection list

출력

명령은 다음 출력을 리턴합니다.

name                 collection_id
sample               sampleId
GHz Inc              ghzinc1

ibmcloud ac collection create

다음 명령어를 사용하여 컬렉션을 생성할 수 있습니다:

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

명령 옵션

--name NAME
콜렉션 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--collection_id COLLECTION_ID(선택사항)
콜렉션 ID입니다. 이 값을 지정하지 않으면 이름이 자동으로 ID로 설정됩니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION(선택사항)
콜렉션에 대한 설명. 선택적 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS(선택사항)
콜렉션과 연관된 태그. 선택적 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

flags를 사용하여 “ sample ”라는 이름의 컬렉션을 생성하려면( --file 플래그와 함께 명령어를 사용하는 방법은 여기를 클릭하세요 ), 다음 명령어를 실행하세요:

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 컬렉션을 가져올 수 있습니다:

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

명령 옵션

--collection_id COLLECTION_ID
해당 컬렉션의 컬렉션 ID입니다.
--expand EXPAND(선택사항)
콜렉션 세부사항의 보기를 펼칩니다.
--include INCLUDE(선택사항)
응답에서 기능 및 특성 세부사항을 포함합니다.

예

ID가 sampleId인 콜렉션을 가져오려면 다음 명령을 실행하십시오.

ibmcloud ac collection get --collection_id sampleId

출력

명령은 다음 출력을 리턴합니다.

name            sample
collection_id   sampleId

ibmcloud ac collection update

다음 명령어를 사용하여 컬렉션을 업데이트할 수 있습니다:

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

명령 옵션

--collection_id COLLECTION_ID
콜렉션 ID입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--name NAME
콜렉션 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
콜렉션에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS (선택 사항) 지원되는 파일 형식
콜렉션과 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일에서 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 ID가 sampleId인 콜렉션을 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 컬렉션을 삭제할 수 있습니다:

ibmcloud ac collection delete --collection_id COLLECTION_ID

명령 옵션

--collection_id COLLECTION_ID
콜렉션 ID

예

ID가 sampleId 인 컬렉션을 삭제하려면 다음 명령을 실행하십시오:

ibmcloud ac collection delete --collection_id sampleId

출력

명령은 다음 출력을 리턴합니다.

OK

ibmcloud ac feature list

다음 명령을 사용하여 모든 기능을 나열할 수 있습니다.

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--limit LIMIT(선택사항)
페이지 매김에 사용됩니다. 검색할 레코드 수입니다.
--include INCLUDE(선택사항)
기능 세부사항을 연관된 콜렉션에 포함하거나 규칙 세부사항을 응답에 포함합니다.
--offset OFFSET(선택사항)
페이지 매김에 사용됩니다. 건너뛸 레코드 수입니다.
--collections COLLECTIONS(선택사항)
쉼표로 구분된 컬렉션 목록을 기준으로 기능을 필터링합니다.
--segments SEGMENTS(선택사항)
쉼표로 구분된 세그먼트 목록을 기준으로 기능을 필터링합니다.
--expand EXPAND(선택사항)
항목의 보기를 펼칩니다.
--tags TAGS(선택사항)
쉼표로 구분된 태그 목록을 기준으로 기능을 필터링합니다.
--sort SORT(선택사항)
지정된 속성을 기반으로 세부사항을 정렬합니다.

예

모든 기능을 나열하려면 다음 명령을 실행하십시오.

ibmcloud ac feature list --environment_id "production"

출력

명령은 다음 출력을 리턴합니다.

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

ibmcloud ac feature create

다음 명령을 사용하여 피처를 생성할 수 있습니다:

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}

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
기능 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--feature_id FEATURE_ID(선택사항)
기능 Id입니다. 이 값을 지정하지 않으면 이름이 자동으로 ID로 설정됩니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
기능에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--type TYPE
기능 유형(부울, 문자열, 숫자). 필수 필드 - 플래그로 또는 파일에서 입력.
--enabled_value ENABLED_VALUE
사용으로 설정되는 경우 기능의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--disabled_value DISABLED_VALUE
사용 안함으로 설정되는 경우 기능의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
기능과 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오.
--enabled ENABLED
기능 플래그의 상태.
--collections COLLECTIONS
콜렉션 배열입니다.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 이름이 sample인 콜렉션을 작성하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하면 해당 기능을 사용할 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--feature_id FEATURE_ID
기능 플래그에 대한 기능 ID.
--include INCLUDE(선택사항)
응답에서 연관된 콜렉션을 포함합니다.

예

ID가 ibm-discount인 기능을 가져오려면 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 피처를 업데이트할 수 있습니다:

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}

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
기능 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--feature_id FEATURE_ID
기능 Id입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
기능에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--enabled_value ENABLED_VALUE
사용으로 설정되는 경우 기능의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--disabled_value DISABLED_VALUE
사용 안함으로 설정되는 경우 기능의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
기능과 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--enabled ENABLED
기능 플래그의 상태.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오.
--collections COLLECTIONS
콜렉션 배열입니다.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON.

예

플래그를 사용하여 ID가 ibm-discount인 기능의 설명을 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 기능의 값을 업데이트할 수 있습니다(이 방법을 통해 기능 이름, 기능 활성화 값(enabled_value), 기능 비활성화 값(disabled_value), 태그, 설명 및 기능 세그먼트 규칙을 업데이트할 수 있지만, 기능 플래그를 토글하거나 기능을 컬렉션에 할당하는 것은 불가능합니다.)

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}

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
기능 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--feature_id FEATURE_ID
기능 Id입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
기능에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--enabled_value ENABLED_VALUE
사용으로 설정되는 경우 기능의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--disabled_value DISABLED_VALUE
해당 기능이 사용할 수 없을 때의 값. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
기능과 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 ID가 ibm-discount인 기능의 설명을 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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"

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 피처를 삭제할 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--feature_id FEATURE_ID
기능 ID

예

ID가 ibm-discount인 기능을 삭제하려면 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

OK

ibmcloud ac feature toggle

다음 명령을 사용하여 기능 값을 켜거나 끌 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--feature_id FEATURE_ID
기능 ID
--enabled ENABLED
기능 플래그의 상태.

예

ID가 ibm-discount인 기능 값을 전환하려면 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령을 사용하여 모든 세그먼트를 나열할 수 있습니다.

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

명령 옵션

--limit LIMIT(선택사항)
페이지 매김에 사용됩니다. 검색할 레코드 수입니다.
--include INCLUDE(선택사항)
연관된 규칙을 응답에 포함하는 세그먼트 세부사항입니다.
--offset OFFSET(선택사항)
페이지 매김에 사용됩니다. 건너뛸 레코드 수입니다.
--expand EXPAND(선택사항)
세그먼트 세부사항의 보기를 펼칩니다.
--tags TAGS(선택사항)
쉼표로 구분된 태그 목록을 기준으로 세그먼트를 필터링합니다.
--sort SORT(선택사항)
지정된 속성을 기반으로 세부사항을 정렬합니다.

예

모든 세그먼트를 나열하려면 다음 명령을 실행하십시오.

ibmcloud ac segment list

출력

명령은 다음 출력을 리턴합니다.

name            segment_id
India IBMers    ibm_employees_01
IBM Employees   ibm_employees

ibmcloud ac segment create

다음 명령어를 사용하여 세그먼트를 생성할 수 있습니다:

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

명령 옵션

--name NAME
세그먼트 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_id SEGMENT_ID(선택사항)
세그먼트 Id입니다. 이 값을 지정하지 않으면 이름이 자동으로 ID로 설정됩니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
세그먼트에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--rules RULES
해당 기업이 해당 세그먼트에 속하는지 여부를 결정하는 규칙 목록. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
세그먼트와 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 이름이 sample인 콜렉션을 작성하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 세그먼트를 가져올 수 있습니다:

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

명령 옵션

--segment_id SEGMENT_ID
세그먼트 Id입니다.
--include INCLUDE(선택사항)
세그먼트 연관을 기반으로 기능 및 특성 세부사항을 포함하도록 지시합니다.

예

ID가 ibm_employees인 세그먼트를 가져오려면 다음 명령을 실행하십시오.

ibmcloud ac segment get --segment_id ibm_employees

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 세그먼트를 업데이트할 수 있습니다:

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

명령 옵션

--name NAME
세그먼트 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_id SEGMENT_ID
세그먼트 Id입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
세그먼트에 대한 설명. 필수 필드 - 플래그로 또는 파일에서 입력.
--rules RULES
해당 기업이 해당 세그먼트에 속하는지 여부를 결정하는 규칙 목록. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
세그먼트와 연관된 태그. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 ID가 ibm_employees인 기능의 세그먼트를 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 세그먼트를 삭제할 수 있습니다:

ibmcloud ac segment delete --segment_id SEGMENT_ID

명령 옵션

--segment_id SEGMENT_ID
세그먼트 ID

예

ID가 ibm_employees인 세그먼트를 삭제하려면 다음 명령을 실행하십시오.

ibmcloud ac segment delete --segment_id ibm_employees

출력

명령은 다음 출력을 리턴합니다.

OK

ibmcloud ac property list

다음 명령을 사용하여 모든 특성을 나열할 수 있습니다.

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--limit LIMIT(선택사항)
페이지 매김에 사용됩니다. 검색할 레코드 수입니다.
--include INCLUDE(선택사항)
연관된 규칙을 응답에 포함하는 세그먼트 세부사항입니다.
--offset OFFSET(선택사항)
페이지 매김에 사용됩니다. 건너뛸 레코드 수입니다.
--collections COLLECTIONS(선택사항)
쉼표로 구분된 컬렉션 목록을 기준으로 기능을 필터링합니다.
--segments SEGMENTS(선택사항)
쉼표로 구분된 세그먼트 목록을 기준으로 기능을 필터링합니다.
--expand EXPAND(선택사항)
세그먼트 세부사항의 보기를 펼칩니다.
--tags TAGS(선택사항)
쉼표로 구분된 태그 목록을 기준으로 세그먼트를 필터링합니다.
--sort SORT(선택사항)
지정된 속성을 기반으로 세부사항을 정렬합니다.

예

모든 특성을 나열하려면 다음 명령을 실행하십시오.

ibmcloud ac property list --environment_id "production"

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 속성을 생성할 수 있습니다:

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)

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
속성 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--property_id PROPERTY_ID(선택사항)
특성 ID입니다. 이 값을 지정하지 않으면 이름이 자동으로 ID로 설정됩니다. 선택적 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
특성에 대한 설명입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
특성과 연관되는 태그입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--value VALUE
특성 값입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--type TYPE
특성 유형입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--collections COLLECTIONS
지정된 특성과 연관된 콜렉션을 나타내는 콜렉션 ID 목록입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 이름이 email-property인 특성을 작성하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 속성을 가져올 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--property_id PROPERTY_ID
특성 플래그의 특성 ID입니다.
--include INCLUDE(선택사항)
응답에서 연관되는 콜렉션 또는 규칙 세부사항을 포함하는 특성 세부사항입니다.

예

ID가 email-property인 특성을 가져오려면 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 속성을 업데이트할 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
속성 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--property_id PROPERTY_ID
특성 ID입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
특성에 대한 설명입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
특성과 연관되는 태그입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--value VALUE
특성 값입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--collections COLLECTIONS
지정된 특성과 연관된 콜렉션을 나타내는 콜렉션 ID 목록입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 ID가 email-property인 특성의 설명을 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령을 사용하여 특성 값을 업데이트할 수 있습니다(특성 값과 대상 지정 규칙은 업데이트할 수 있지만 이 메소드에서는 콜렉션에 특성을 지정할 수 없음).

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--name NAME
속성 이름. 필수 필드 - 플래그로 또는 파일에서 입력.
--property_id PROPERTY_ID
특성 ID입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--description DESCRIPTION
특성에 대한 설명입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--segment_rules SEGMENT_RULES
각 세그먼트에 따라 서로 다른 값을 설정하는 데 사용되는 타겟팅 규칙을 지정하십시오. 필수 필드 - 플래그로 또는 파일에서 입력.
--tags TAGS
특성과 연관되는 태그입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--value VALUE
특성 값입니다. 필수 필드 - 플래그로 또는 파일에서 입력.
--file FILE
파일을 통해 입력합니다. 지원되는 파일 형식 - JSON

예

플래그를 사용하여 ID가 email-property인 특성의 설명을 업데이트하려면('--file' 플래그와 함께 명령을 사용하려면 여기를 클릭), 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

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

다음 명령어를 사용하여 속성을 삭제할 수 있습니다:

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

명령 옵션

--environment_id ENVIRONMENT_ID
환경 ID
--property_id PROPERTY_ID
특성 ID

예

ID가 ibm_employees인 특성을 삭제하려면 다음 명령을 실행하십시오.

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

출력

명령은 다음 출력을 리턴합니다.

OK

ibmcloud ac export

다음 명령을 사용하여 선택한 인스턴스의 구성 데이터를 내보낼 수 있습니다.

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

명령 옵션

--file FILE(선택사항)
구성이 내보내질 파일의 경로.
--output OUTPUT(선택사항)
출력 형식을 선택합니다. 'JSON' 또는 'yaml' 중 하나를 선택할 수 있습니다. (기본값은 "JSON")

예

선택한 인스턴스의 구성 데이터를 내보내려면 다음 명령을 실행하십시오.

ibmcloud ac export --file exportedConfig.json

출력

명령은 다음 출력을 리턴합니다.

OK
Configuration exported to file exportedConfig.json

ibmcloud ac import

다음 명령을 사용하여 파일에서 선택한 인스턴스로 구성 데이터를 가져올 수 있습니다.

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

명령 옵션

--file FILE
구성을 가져올 파일의 경로.
--clean CLEAN(선택사항)
'true'로 설정하면, 구성 데이터를 가져오기 전에 서비스 인스턴스의 기존 데이터를 지웁니다.

예

파일에서 선택한 인스턴스로 구성 데이터를 가져오려면 다음 명령을 실행하십시오.

ibmcloud ac import --file exportedConfig.json

출력

명령은 다음 출력을 리턴합니다.

OK
Configuration imported from file exportedConfig.json

파일에서 항목 생성 또는 업데이트

이 플러그인은 파일에 저장된 JSON 형식의 항목을 생성하거나 업데이트하는 기능을 제공합니다.

파일을 사용하여 컬렉션을 만드는 방법은 다음과 같습니다.

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

'|' 기호에 주의하십시오. 이 기호는 명령을 사용하는 두 가지 방법이 있음을 나타냅니다.

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

지원되는 JSON 형식을 확인하려면 API 문서를 참조하십시오.

파일 플래그(다른 플래그와 결합할 수 없음)를 사용하여 파일의 경로를 지정하십시오.

예

corporateDiscountcreate_collection_body.json* 파일에 저장되는 ID가 *인 콜렉션을 작성하려면 다음 명령을 실행하십시오.

ibmcloud ac collection create --file create_collection_body.json

create_collection_body.json 의 내용은 다음과 같습니다:

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

출력

명령은 다음 출력을 리턴합니다.

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

컬렉션, 피처 또는 세그먼트의 생성 및 업데이트 방식은 앞서 언급한 것과 유사합니다. 허용되는 JSON 형식 구조에 대해서는 API 문서를 참조하십시오

ibmcloud plug-in uninstall

이 명령을 사용하여 App Configuration CLI 플러그인을 설치 제거할 수 있습니다.

ibmcloud plugin uninstall app-configuration

오류가 없다면 설치 제거 작업은 성공 메시지를 리턴합니다.