인스턴스 ID 및 클라우드 리소스 이름(CRN) 검색

서비스에 대한 API 요청에 고유 ID 또는 인스턴스 ID를 포함하여 오퍼레이션에 대해 개별 IBM® Key Protect 인스턴스를 대상으로 지정할 수 있습니다. 마찬가지로 관련 클라우드 리소스 이름(CRN)을 아는 것도 도움이 될 수 있습니다.

IBM Cloud 콘솔에서 인스턴스 ID와 CRN 보기

Key Protect 리소스 목록으로 이동하여 IBM Cloud 인스턴스와 연관된 인스턴스 ID를 볼 수 있습니다.

  1. IBM Cloud 콘솔에 로그인하세요.

  2. 메뉴 > 리소스 목록으로 이동한 후 서비스를 클릭하여 클라우드 서비스 목록을 찾아보십시오.

  3. 표의 행을 클릭하십시오. 그러면 CRN과 인스턴스 GUID를 볼 수 있는 리소스 표 사이드 패널이 열립니다.

  4. 인스턴스 이름 링크를 클릭하십시오. 그러면 Key Protect 인스턴스가 열립니다.

  5. ‘개요’ 페이지에서 ‘인스턴스’ 섹션을 찾으세요. 여기에는 인스턴스 ID와 CRN이 코드 스니펫으로 나열되어 있습니다.

CLI를 사용하여 인스턴스 ID와 CRN 검색

또한 사용자는 Key Protect 인스턴스의 키 링에 IBM Cloud CLI.

  1. IBM Cloud에 IBM Cloud CLI.

    ibmcloud login

    로그인에 실패하면 ibmcloud login --sso 명령을 실행하여 다시 시도하십시오. 다음 --sso 연동 ID로 로그인할 때는 이 매개변수가 필수입니다. 이 옵션이 사용되면 CLI 출력에 나열되는 링크로 이동하여 일회성 패스코드를 생성하십시오.

  2. Key Protect의 프로비저닝된 인스턴스가 포함된 계정, 지역 및 리소스 그룹을 선택하십시오.

  3. 사용자의 Key Protect 인스턴스에 저장되는 루트 키를 사용하십시오.

    ibmcloud resource service-instance <instance_name> --id

    <instance_name>을(를) 사용자가 Key Protect 인스턴스에 저장되는 루트 키를 사용하십시오. 인스턴스의 이름을 모르는 경우 ibmcloud resource service-instances 명령을 실행하여 선택한 영역에서 프로비저닝한 인스턴스 이름 목록을 검색하십시오.

    다음 잘린 예제에서는 CLI 출력을 보여줍니다.

    crn:v1:bluemix:public:kms:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901

    42454b3b-5b06-407b-a4b3-34d9ef323901 값은 예제 인스턴스 ID입니다.

API를 사용하여 인스턴스 ID 검색

애플리케이션을 빌드하여 연결하는 데 도움이 되는 인스턴스 ID를 프로그래밍 방식으로 검색하려 할 수 있습니다. 다음 IBM Cloud 리소스 컨트롤러 API를 호출한 후, JSON 출력 결과를 jq 로 파이프하여 이 값을 추출합니다.

  1. IBM Cloud IAM 액세스 토큰을 검색하십시오.

  2. 인스턴스 ID를 가져오려면 리소스 컨트롤러 API 를 호출하세요. 

    $ curl -X GET \
    "https://resource-controller.cloud.ibm.com/v2/resource_instances" \
    -H "authorization: Bearer <IAM_token>" | jq -r '.resources[] | select(.name | contains("<instance_name>")) | .guid'

    <instance_name>을(를) 사용자가 Key Protect 인스턴스에 저장되는 루트 키를 사용하십시오. 인스턴스 이름을 모르는 경우, GET /v2/resource_instances 요청을보내 선택한 리전에서 프로비저닝한 인스턴스 이름 목록을 조회하세요.

    다음 출력은 인스턴스 ID 예제를 표시합니다.

    42454b3b-5b06-407b-a4b3-34d9ef323901