Ve referencias a las instancias de VM

En esta página, se describe cómo usar la API de lista de referencias para ver las relaciones entre los recursos; en particular, puedes ver las relaciones entre las instancias de VM y otros recursos de Compute Engine.

Cuando usas esta API, Compute Engine muestra una lista de referencias en las que se describe lo siguiente:

  • El recurso de origen: el recurso que apunta al recurso de destino.
  • El recurso de destino: el recurso en cuestión.
  • El tipo de referencia: la relación entre los dos recursos.

Por ejemplo, puedes usar esta API para ver de forma conveniente una lista de grupos de instancias administrados a los que pertenece una instancia de VM.

Antes de comenzar

Limitaciones

  • Solo puedes enumerar las relaciones entre las instancias de VM y los grupos de instancias (administrados y no administrados).
  • No es posible enumerar referencias con la herramienta de línea de comandos gcloud o Google Cloud Console.

Enumera una única referencia

Una referencia es un recurso que se refiere a otro recurso. Para instancias de VM, una referencia común es un grupo de instancias.

Por ejemplo, supongamos que tienes una instancia de VM llamada example-ig-a1 en la zona us-central1-a. La instancia de VM es miembro de un grupo de instancias llamado example-ig en la misma zona, como se muestra en el siguiente diagrama:

Para ver esta relación, llama al método listReferrers en example-ig-a1 con la siguiente solicitud HTTP:

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

El servidor muestra una lista de respuesta estándar que contiene los siguientes elementos:

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

En este caso, el target es example-ig-a1, que es un MEMBER_OF del referrer, el grupo de instancias example-ig.

Genera una lista de varias referencias

Si un recurso tiene más de una referencia, la respuesta muestra una lista de todas las referencias del recurso de destino. Si una instancia pertenece a dos grupos de instancias, la respuesta contiene ambos grupos de instancias.

Por ejemplo, la siguiente respuesta indica que la instancia llamada example-instance-a2 pertenece a dos grupos de instancias: example-ig y example-ig-2:

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

Genera una lista de referencias de alcance cruzado

El método listReferrers también muestra información sobre las referencias que existen dentro de otros alcances, como otras regiones o zonas. Por ejemplo, supongamos que tienes una instancia de VM que pertenece a un grupo de instancias regionales administrado:

Llama al método listReferrers orientado a esta instancia con la siguiente solicitud HTTP:

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

El servidor muestra una respuesta de lista estándar que contiene los siguientes elementos:

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

La respuesta muestra el grupo de instancias regionales administrado en la lista de referencias.

Genera una lista de referencias para todos los recursos dentro de una colección

Si usas el carácter comodín (-), puedes solicitar una lista de las referencias a todas las instancias de VM dentro de una zona específica. La solicitud se puede realizar con una solicitud HTTP similar a la que se muestra a continuación:

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

El servidor muestra una respuesta que contiene una lista de instancias de VM en la zona y referencias a la instancia. Por ejemplo:

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

Próximos pasos