계정의 사용자에 대해 IBM Cloud 카탈로그 및 개인용 카탈로그 사용자 정의

개인 카탈로그는 IBM Cloud® 카탈로그 및 자신의 카탈로그에 있는 제품에 대한 액세스를 중앙에서 관리할 수 있는 방법을 제공합니다. 계정의 사용자가 특정 솔루션을 사용할 수 있도록 공용 카탈로그 및 개인용 카탈로그를 사용자 정의할 수 있습니다. 이렇게 하면 카탈로그가 비즈니스와 관련이 있는지 확인할 수 있습니다.

시작하기 전에

시작하기 전에

시작하기 전에

  • 종량과금제 또는 구독 계정을 사용하고 있는지 확인하십시오. 자세한 내용은 계정 유형 보기를 참조하십시오.

  • 이 태스크를 완료하려면 카탈로그 관리 서비스에 대한 관리자 역할이 있어야 합니다.

  • 카탈로그 관리 플러그인을 설치하려면 다음 명령을 실행하십시오.

    ibmcloud plugin install catalogs-management

시작하기 전에

  • 종량과금제 또는 구독 계정을 사용하고 있는지 확인하십시오. 자세한 내용은 계정 유형 보기를 참조하십시오.

  • 이 태스크를 완료하려면 카탈로그 관리 서비스에 대한 관리자 역할이 있어야 합니다.

  • Terraform을 사용하여 카탈로그를 사용자 정의하려면 다음을 완료했는지 확인하십시오.

    • Terraform CLI를 설치하고 Terraform에 대한 IBM Cloud 제공자 플러그인을 구성하십시오. 자세한 정보는 IBM Cloud® 에 대한 튜토리얼을 참조하십시오. 플러그인은 이 태스크를 완료하는 데 사용되는 IBM Cloud API를 요약합니다.
    • HashiCorp 구성 언어를 사용하여 리소스를 정의하기 위한 Terraform 구성 파일을 작성하십시오. 자세한 내용은 테라폼 문서를 참조하세요.

콘솔을 사용하여 모든 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그에 있는 모든 제품을 포함하는 카탈로그를 작성하려면 다음 단계를 완료하십시오.

  1. IBM Cloud 콘솔에서 관리 > 카탈로그로 이동하고 카탈로그 작성을 클릭하십시오.
  2. 제품(기본값) 카탈로그 유형을 선택하십시오.
  3. 이름 및 설명을 입력하십시오.
  4. 모든 제품 옵션이 선택되었는지 확인하고 작성을 클릭하십시오. 사용 가능 여부는 설정 페이지의 계정 수준에서 설정한 필터를 기반으로 합니다.
  5. 카탈로그 이름 > 필터 관리를 클릭하여 카탈로그에 모든 제품이 포함되어 있는지 확인하십시오. 그런 다음 1단계: IBM Cloud 카탈로그에서 모든 제품 포함 또는 제외 선택에서 IBM Cloud 카탈로그에서 모든 제품 포함이 선택되어 있는지 확인하십시오.

콘솔을 사용하여 선택한 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그에 있는 특정 제품 세트를 포함하는 카탈로그를 작성하려면 다음 단계를 완료하십시오.

  1. IBM Cloud 콘솔에서 관리 > 카탈로그로 이동하고 카탈로그 작성을 클릭하십시오.
  2. 제품(기본값) 카탈로그 유형을 선택하십시오.
  3. 이름 및 설명을 입력하십시오.
  4. 작성을 클릭하십시오.
  5. 카탈로그 이름 > 필터 관리를 클릭하십시오.
  6. 1단계: IBM Cloud 카탈로그에서 모든 제품 포함 또는 제외 선택에서 IBM Cloud 카탈로그에서 모든 제품 제외를 선택하십시오.
  7. 2단계를 건너뛰고 3단계: 규칙에 대한 예외 추가에서 추가를 클릭하십시오.
  8. 조건으로 포함이 선택되어 있는지 확인한 다음 사용자가 액세스할 제품을 개별적으로 선택하십시오. 이 예제 프로젝트에서는 watsonx Assistant, Speech to Text 및 Text to Speech를 선택합니다.

콘솔을 사용하여 IBM Cloud 카탈로그의 가시성 설정

개인 카탈로그를 작성했으므로 다음 단계를 완료하여 계정의 모든 사용자에 대한 공용 카탈로그의 가시성을 끄십시오.

  1. 이동 경로에서 카탈로그를 클릭하십시오.

  2. 설정 을 클릭하십시오.

  3. IBM Cloud 카탈로그를 꺼짐으로 설정하십시오.

    IBM Cloud 카탈로그의 표시를 해제하면 하이라이트 페이지도 숨겨집니다. 이 페이지는 다양한 제품 카테고리에서 최고의 결과를 찾는 데 도움이 됩니다.

  4. 공개 카탈로그로 이동하고 카탈로그 전환기를 확장하여 필터 및 설정이 올바르게 적용되는지 확인하십시오. 계정의 개인 카탈로그만 목록에 표시되어야 합니다.

개인용 카탈로그의 설정을 업데이트하여 언제든지 포함하거나 제외할 제품을 업데이트할 수 있습니다.

사용자 정의 배너를 사용하여 개인용 카탈로그 브랜딩

개인용 카탈로그의 배너에 사용자 정의 이미지를 추가하여 브랜드와 일치하도록 개인용 카탈로그의 룩앤필을 개선할 수 있습니다. 개인용 카탈로그에 대한 액세스 권한이 부여된 모든 사용자는 기본 IBM Cloud 배너 대신 개인용 카탈로그로 이동하여 제품을 검색할 때 사용자 정의 배너를 볼 수 있습니다. 사용자 지정 배너 이미지를 추가하려면 다음 단계를 완료합니다:

  1. 관리 > 카탈로그로 이동한 다음 비공개 카탈로그를 클릭합니다.

  2. 배너를 추가하려는 개인용 카탈로그의 행에서 오버플로우 메뉴 아이콘 조치 아이콘 를 클릭한 후 편집을 클릭하십시오.

  3. 카탈로그 배너 필드 에 사용자 지정 배너에 URL 추가하거나, 업로드를 클릭하여 이미지를 직접 추가할 수 있습니다.

    권장되는 최대 이미지 크기는 944 x 260픽셀입니다.

  4. 업데이트 를 클릭하십시오.

  5. 그런 다음 카탈로그 로 이동하고 목록에서 개인용 카탈로그를 선택하여 개인용 카탈로그의 업데이트된 룩앤필을 보십시오.

카탈로그에 추가하는 개인용 카탈로그 제품의 제공자 이름을 사용자 정의할 수도 있습니다. 기본적으로 카탈로그의 필터인 Community 를 제공자로 사용하여 표시되지만, 이를 회사 또는 조직의 이름으로 사용자 정의할 수 있습니다. 자세한 정보는 카탈로그 항목 정보 제공 을 참조하십시오.

콘솔을 사용하여 개인용 카탈로그에 대한 액세스 권한 부여

사용자에게 개인 카탈로그의 제품에 대해 작업할 수 있는 권한을 부여하려면 사용자에게 카탈로그 관리 서비스에 대한 뷰어 역할을 지정하십시오.

콘솔을 사용하여 비공개 카탈로그 삭제하기

개인용 카탈로그를 삭제하면 카탈로그 내의 모든 제품도 삭제됩니다. 비공개 카탈로그를 삭제하려면 다음 단계를 완료하세요:

  1. IBM Cloud 콘솔에서 관리 > 카탈로그로 이동하여 비공개 카탈로그를 클릭합니다.
  2. 삭제하려는 카탈로그에 대한 작업 아이콘 작업 아이콘 클릭하고 삭제를 선택합니다.

개인용 카탈로그를 삭제한 후 7일이내에 복원 할 수 있습니다.

CLI를 사용하여 모든 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그에 있는 모든 제품을 포함하는 카탈로그를 작성하려면 다음 단계를 완료하십시오.

  1. 리소스 그룹을 대상으로 지정하여 카탈로그를 작성하십시오. ibmcloud resource groups 명령을 실행한 후 ibmcloud target -g "resource group" 명령을 실행할 수 있습니다.

  2. 다음 명령을 사용하여 계정에 새 개인용 카탈로그를 작성하십시오.

    ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]

새 비공개 카탈로그를 만들면 기본적으로 모든 IBM Cloud 카탈로그 제품이 표시됩니다. 자세한 정보는 카탈로그 관리 CLI를 참조하십시오.

CLI를 사용하여 선택한 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그에 있는 특정 제품 세트를 포함하는 카탈로그를 작성하려면 다음 단계를 완료하십시오.

  1. 리소스 그룹을 대상으로 지정하여 카탈로그를 작성하십시오. ibmcloud resource groups 명령을 실행한 후 ibmcloud target -g "resource group" 명령을 실행할 수 있습니다.
  2. 다음 명령을 사용하여 계정에 새 개인 카탈로그를 작성하십시오.
    ibmcloud catalog create --name CATALOG [--catalog-description "DESCRIPTION"]
  3. 특정 제품 및 해당 가격 플랜을 포함하거나 제외하도록 필터를 업데이트하십시오. 카탈로그를 지정하는지 확인하십시오. 그렇지 않으면 필터가 기본 계정 레벨로 설정됩니다. 자세한 명령 옵션은 카탈로그 관리 CLI를 참조하십시오.
    ibmcloud catalog filter offering --offering PRODUCT-NAME

CLI를 사용하여 IBM Cloud 카탈로그의 가시성 설정

기본적으로 IBM Cloud 공용 카탈로그는 계정의 모든 사용자에게 표시됩니다. IBM Cloud 카탈로그에 대한 가시성을 끄고 개인용 카탈로그에 제품을 추가하여 선택한 사용자만 제품을 사용할 수 있도록 설정할 수 있습니다. 계정의 모든 사용자에 대해 공용 카탈로그의 가시성을 끄려면 다음 명령을 사용하십시오.

ibmcloud catalog filter hide-ibm-public-catalog

CLI를 사용하여 개인용 카탈로그에 대한 액세스 권한 부여

사용자에게 개인 카탈로그의 제품에 대해 작업할 수 있는 권한을 부여하려면 사용자에게 카탈로그 관리 서비스에 대한 뷰어 역할을 지정하십시오.

CLI를 사용하여 비공개 카탈로그 삭제하기

개인용 카탈로그를 삭제하면 카탈로그 내의 모든 제품도 삭제됩니다. 비공개 카탈로그를 삭제하려면 다음 명령을 실행합니다:

ibmcloud catalog delete --catalog CATALOG

개인용 카탈로그를 삭제한 후 7일이내에 복원 할 수 있습니다.

API를 사용하여 모든 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그의 모든 제품이 포함된 카탈로그를 작성하려면 다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하십시오. 변수를 사용자 계정의 값으로 대체하십시오.

curl -X 'POST' \
'https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H "Authorization: ${IC_IAM_TOKEN}" \
-d '{"label": "testcurlcatalog", "short_description": "testing creating a catalog through curl"}'

ServiceCall<Catalog> createCatalog(CreateCatalogOptions createCatalogOptions)

Example request

String label = "{label}";
String shortDesc = "{shortDesc}";
CreateCatalogOptions createOptions = new CreateCatalogOptions.Builder().label(label).shortDescription(shortDesc).build();
Response<Catalog> response = service.createCatalog(createOptions).execute();
System.out.println(response.getResult());

createCatalog(params, [callback()])

Example request

label = "{label}";
shortDesc = "{shortDesc}";
response = await service.createCatalog({ 'label': label, 'shortDescription': shortDesc });
console.log(response);

create_catalog(self, id=None, rev=None, label=None, short_description=None, catalog_icon_url=None, tags=None, url=None, crn=None, offerings_url=None, features=None, disabled=None, created=None, updated=None, resource_group_id=None, owning_account=None, catalog_filters=None, syndication_settings=None, **kwargs)

Exapmle request

label = "{label}"
shortDesc = "{shortDesc}"
response = self.service.create_catalog(label=label, short_description=shortDesc)
print(response)

(catalogManagement *CatalogManagementV1) CreateCatalog(createCatalogOptions *CreateCatalogOptions) (result *Catalog, response *core.DetailedResponse, err error)

Example request

label := "{label}"
shortDesc := "{shortDesc}"
createOptions := service.NewCreateCatalogOptions()
createOptions.SetLabel(label)
createOptions.SetShortDescription(shortDesc)
_, response, _ := service.CreateCatalog(createOptions)
fmt.Println(response)

새 비공개 카탈로그를 만들면 기본적으로 모든 IBM Cloud 공개 카탈로그 제품이 표시됩니다. 자세한 정보는 카탈로그 관리 API를 참조하십시오.

API를 사용하여 선택한 제품이 포함된 개인용 카탈로그 작성

IBM Cloud 카탈로그의 특정 제품 세트가 포함된 카탈로그를 작성하려면 다음 샘플 요청에 표시된 대로 카탈로그 관리 API를 호출하십시오. 변수를 사용자 계정의 값으로 대체하십시오.

curl -X 'POST' \
'https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogs' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-H "Authorization: ${IC_IAM_TOKEN}" \
-d '{"label": "testcurlcatalog4", "short_description": "testing creating a catalog through curl", "catalog_filters": { "include_all": false, "id_filters": { "include": { "filter_terms": [ "AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea" ] } } }}'

각 catalog_filters 개체에 대해 include_all 필드에 부울 값 false 을 설정하여 모든 공개 카탈로그 제품을 제외해야 합니다. 포함할 제품을 지정하려면 category_filters 또는 id_filters 으로 필터링하면 됩니다. filter_terms 에 포함할 제품 속성 또는 제품 ID를 입력합니다. 이 예에서 AdvancedMobileAccess-d6aece47-d840-45b0-8ab9-ad15354deeea 은 제품 ID입니다.

자세한 명령 옵션은 카탈로그 관리 API를 참조하십시오.

API를 사용하여 IBM Cloud 카탈로그의 가시성 설정

계정에서 공용 카탈로그를 숨기려면 hide_IBM_cloud_catalog 필드의 부울 값이 true인지 확인하십시오. 또는 각 include_all 오브젝트에 대해 false 필드에 부울 값 account_filters를 지정할 수 있습니다. 그러면 사용자가 작성하는 개인용 카탈로그만 계정에 표시됩니다.

curl -X "PUT" "https://cm.globalcatalog.cloud.ibm.com/api/v1-beta/catalogaccount"
-H "accept: */*"
-H "Authorization: {iam-bearer-token}"
-d '{"id":"string","hide_IBM_cloud_catalog":true,"account_filters":{"include_all":true,"category_filters":{"additionalProp1":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp2":{"include":true,"filter":{"filter_terms":["string"]}},"additionalProp3":{"include":true,"filter":{"filter_terms":["string"]}}},"id_filters":{"include":{"filter_terms":["string"]},"exclude":{"filter_terms":["string"]}}}}'

자세한 정보는 카탈로그 관리 API를 참조하십시오.

API를 사용하여 개인용 카탈로그에 대한 액세스 권한 부여

사용자에게 개인 카탈로그의 제품에 대해 작업할 수 있는 권한을 부여하려면 사용자에게 카탈로그 관리 서비스에 대한 뷰어 역할을 지정하십시오.

API를 사용하여 비공개 카탈로그 삭제하기

개인용 카탈로그를 삭제하면 카탈로그 내의 모든 제품도 삭제됩니다. 비공개 카탈로그를 삭제하려면 다음 명령을 사용합니다:

DELETE /catalogs/{catalog_identifier}

자세한 정보는 카탈로그 관리 API를 참조하십시오.

개인용 카탈로그를 삭제한 후 7일이내에 복원 할 수 있습니다.

Terraform을 사용하여 개인용 카탈로그 작성

Terraform을 사용하여 계정의 사용자가 특정 솔루션을 사용할 수 있도록 공용 카탈로그 및 개인용 카탈로그를 사용자 지정할 수 없습니다. 공용 카탈로그 및 개인용 카탈로그를 사용자 정의하려면 UI, CLI 또는 API 단계로 전환하십시오.

비공개 카탈로그를 만들려면 다음 단계를 따르세요:

  1. main.tf 파일에서 인수를 작성하십시오. 다음 예제에서는 ibm_cm_catalog 리소스를 사용하여 카탈로그를 작성합니다. 여기서 label은 카탈로그를 식별하기 위한 표시 이름입니다.

    resource "ibm_cm_catalog" "cm_catalog" {
label = "label"
short_description = "short_description"
}

    자세한 내용은 테라폼 카탈로그 관리 페이지의 인수 참조 세부 정보를 참조하세요.

  2. 구성 파일 빌드를 완료한 후 Terraform CLI를 초기화하십시오. 자세한 정보는 작업 디렉토리 초기화를 참조하십시오.

    terraform init

  3. main.tf 파일에서 자원을 프로비저닝하십시오. 자세한 정보는 Terraform을 사용하여 인프라 프로비저닝을 참조하십시오.

    1. terraform plan 를 실행하여 제안된 조치를 미리보기 위한 Terraform 실행 플랜을 생성하십시오.

      terraform plan

    2. terraform apply 를 실행하여 계획에 정의된 자원을 작성하십시오.

      terraform apply

Terraform을 사용하여 개인용 카탈로그에 대한 액세스 권한 부여하기

사용자에게 개인 카탈로그의 제품에 대해 작업할 수 있는 권한을 부여하려면 사용자에게 카탈로그 관리 서비스에 대한 뷰어 역할을 지정하십시오.