Si quieres ver las relaciones entre las instancias de VM y otros recursos de Compute Engine, usa el método de la API de REST listReferrers.
Cuando usas REST, Compute Engine muestra una lista de referencias que describen 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 REST para ver de forma conveniente una lista de grupos de instancias a los que pertenece una instancia de VM.
Antes de empezar
-
Configura la autenticación si aún no lo hiciste.
La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud.
Para ejecutar un código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.
Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a la CLI de gcloud.
Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:
gcloud init
Limitaciones
- Solo puedes enumerar las relaciones entre las instancias de VM y los grupos de instancias (administrados y no administrados).
- Solo puedes enumerar referencias con REST.
Genera una lista de 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 de referrer, el grupo example-ig instance.
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 administrado regional (MIG regional):
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-rmig
}
]
La respuesta muestra el grupo de instancias regional 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-rmig
}
]
¿Qué sigue?
- Obtén más información sobre los grupos de instancias.
- Consulta una lista de zonas y regiones aplicables.