VM 인스턴스에 대한 리퍼러 보기

이 페이지에서는 List Referrers API를 사용하여 리소스 간의 관계를 확인하는 방법을 설명합니다. 특히, VM 인스턴스와 다른 Compute Engine 리소스 간의 관계를 확인할 수 있습니다.

이 API를 사용하는 경우 Compute Engine은 다음과 같은 참조의 목록을 반환합니다.

  • 소스 리소스 - 타겟 리소스를 참조하는 리소스입니다.
  • 타겟 리소스 - 해당하는 리소스입니다.
  • 참조 유형 - 두 리소스 간의 관계입니다.

예를 들어 이 API를 사용하여 VM 인스턴스가 속해 있는 관리형 인스턴스 그룹의 목록을 간편하게 확인할 수 있습니다.

시작하기 전에

제한사항

  • VM 인스턴스와 인스턴스 그룹(관리형 및 비관리형) 간의 관계만 나열할 수 있습니다.
  • gcloud 도구 또는 Google Cloud Platform Console을 사용하여 리퍼러를 나열할 수는 없습니다.

단일 리퍼러 나열

리퍼러는 다른 리소스를 참조하는 리소스입니다. VM 인스턴스의 경우 공통 리퍼러는 인스턴스 그룹입니다.

예를 들어 us-central1-a 영역에 example-ig-a1이라는 VM 인스턴스가 있다고 가정해 보겠습니다. VM 인스턴스는 아래 다이어그램에 표시된 것처럼 동일한 영역에 있는 example-ig라는 인스턴스 그룹의 구성원입니다.

이 관계를 보려면 다음 HTTP 요청으로 example-ig-a1에서 listReferrers 메소드를 호출합니다.

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1/referrers

서버에서는 다음 항목이 포함된 표준 목록 응답을 반환합니다.

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  }
]

이 경우에 target은 example-ig-a1로서 referrer인 example-ig 인스턴스 그룹의 MEMBER_OF입니다.

여러 리퍼러 나열

리소스에 리퍼러가 두 개 이상 있는 경우 응답에는 타겟 리소스의 모든 리퍼러 목록이 반환됩니다. 한 인스턴스가 두 인스턴스 그룹에 속하는 경우 응답에는 두 인스턴스 그룹이 모두 포함됩니다.

예를 들어 다음 응답은 example-instance-a2라는 이름의 인스턴스가 example-ig 및 example-ig-2라는 두 인스턴스 그룹에 속해 있음을 나타냅니다.

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  }
]

교차 범위 리퍼러 나열

listReferrers 메소드는 다른 지역 또는 영역과 같은 다른 범위 내에 있는 리퍼러에 대한 정보도 반환합니다. 예를 들어, 지역 관리형 인스턴스 그룹에 속한 VM 인스턴스가 있다고 가정해 보겠습니다.

다음 HTTP 요청으로 이 인스턴스를 타겟으로 하는 listReferrers 메소드를 호출합니다.

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3/referrers

서버에서는 다음 항목이 포함된 표준 목록 응답을 반환합니다.

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rig
  }
]

응답의 리퍼러 목록에는 지역의 관리형 인스턴스 그룹이 표시됩니다.

모음 내 모든 리소스에 대한 리퍼러 나열

와일드 카드 문자(-)를 사용하여 특정 영역 내의 모든 VM 인스턴스에 대한 모든 리퍼러의 목록을 요청할 수 있습니다. 다음과 유사한 HTTP 요청으로 이러한 요청을 실행할 수 있습니다.

GET https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/-/referrers

서버에서는 영역에 있는 VM 인스턴스 목록과 인스턴스에 대한 참조를 포함하는 응답을 반환합니다. 예를 들면 다음과 같습니다.

"items": [
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2
  },
  {
    "target": https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3,
    "referenceType": MEMBER_OF,
    "referrer": https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rig
  }
]

다음 단계

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Compute Engine 문서