Visualizza i referrer alle istanze di Compute Engine

Per visualizzare le relazioni tra le istanze Compute Engine e altre risorse Compute Engine, utilizza gcloud CLI o REST.

Quando elenchi i referrer alle istanze di computing, Compute Engine restituisce un elenco di riferimenti che descrivono:

  • La risorsa di origine: la risorsa che punta alla risorsa di destinazione
  • La risorsa di destinazione: la risorsa in questione
  • Il tipo di riferimento: la relazione tra le due risorse

Ad esempio, puoi elencare i referrer per visualizzare un elenco di gruppi di istanze a cui appartiene un'istanza di computing.

Prima di iniziare

  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa al modo in cui prevedi di utilizzare gli esempi in questa pagina:

    gcloud

    1. Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata. Dopo aver eseguito l'accesso, inizializza Google Cloud CLI eseguendo il comando seguente: 

      gcloud init
  • Imposta una regione e una zona predefinite.

    • REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Limitazioni

  • Puoi elencare le relazioni solo tra istanze di computing e gruppi di istanze. Sono supportati sia i gruppi di istanze gestite che non gestite.

Elenca un singolo referrer

Un referrer è una risorsa che fa riferimento a un'altra risorsa. Per le istanze di computing, un referrer comune è un gruppo di istanze.

Ad esempio, supponiamo che tu abbia un'istanza di computing denominata example-ig-a1 nella zona us-central1-a. L'istanza di computing è un membro di un gruppo di istanze denominato example-ig nella stessa zona, come mostrato nel seguente diagramma:

Un'istanza di computing è un membro di un gruppo di istanze nella stessa zona.

Per visualizzare questa relazione, utilizza gcloud CLI o REST:

gcloud

Utilizza il comando gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.
  • ZONE: la zona in cui si trova l'istanza di computing.

Ad esempio, per elencare i referrer per l'istanza example-ig-a1 nella zona us-central1-a, esegui il seguente comando:

gcloud compute instances list-referrers example-ig-a1 \
    --zone=us-central1-a

L'output è simile al seguente:

REFERRER                                                                                          REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1

REST

Invia una richiesta GET al metodo instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova l'istanza di computing.
  • ZONE: la zona in cui si trova l'istanza di computing.
  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.

Ad esempio, per elencare i referrer per l'istanza example-ig-a1 nella zona us-central1-a, effettua la seguente richiesta HTTP:

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

Il server restituisce una risposta di elenco standard contenente i seguenti elementi:

{
  "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"
    }
  ]
}

In questo caso, la risorsa di destinazione è example-ig-a1, che è un MEMBER_OF della risorsa referrer, il gruppo di istanze example-ig.

Elenca più referrer

Se una risorsa ha più referrer, la risposta restituisce un elenco di tutti i referrer per la risorsa di destinazione. Se un'istanza appartiene a due gruppi di istanze, la risposta contiene entrambi i gruppi di istanze.

Se un'istanza di computing è un membro di due gruppi di istanze, la risposta contiene entrambi i gruppi di istanze.

Ad esempio, supponiamo che l'istanza denominata example-instance-a2 nella zona us-central1-a appartenga a due gruppi di istanze, example-ig e example-ig-2:

gcloud

Utilizza il comando gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.
  • ZONE: la zona in cui si trova l'istanza di computing.

Ad esempio, per elencare i referrer per l'istanza example-instance-a2 nella zona us-central1-a, esegui il seguente comando:

gcloud compute instances list-referrers example-instance-a2 \
    --zone=us-central1-a

L'output è simile al seguente:

REFERRER                                                                                            REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-instance-a2

REST

Invia una richiesta GET al metodo instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova l'istanza di computing.
  • ZONE: la zona in cui si trova l'istanza di computing.
  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.

Ad esempio, per elencare i referrer per l'istanza example-instance-a2 nella zona us-central1-a, effettua la seguente richiesta HTTP:

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

Il server restituisce una risposta di elenco standard contenente i seguenti elementi:

{
  "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"
    }
  ]
}

Elenca i referrer tra ambiti

Puoi anche visualizzare informazioni sui referrer presenti in altri ambiti, ad esempio altre regioni o zone. Ad esempio, supponiamo di avere un'istanza di computing che appartiene a un gruppo di istanze gestite a livello di regione (MIG a livello di regione):

Nella regione us-central1, l'istanza new-instance-a3 nella zona us-central1-a è un membro del gruppo di istanze regionali example-rmig.

Per visualizzare i referrer che hanno come target questa istanza, utilizza gcloud CLI o REST:

gcloud

Utilizza il comando gcloud compute instances list-referrers:

gcloud compute instances list-referrers INSTANCE_NAME \
    --zone=ZONE

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.
  • ZONE: la zona in cui si trova l'istanza di computing.

Ad esempio, per elencare i referrer per l'istanza new-instance-a3 nella zona us-central1-a, esegui il seguente comando:

gcloud compute instances list-referrers new-instance-a3 \
    --zone=us-central1-a

L'output è simile al seguente:

REFERRER                                                                                          REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3

REST

Invia una richiesta GET al metodo instances.listReferrers:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME/referrers

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui si trova l'istanza di computing.
  • ZONE: la zona in cui si trova l'istanza di computing.
  • INSTANCE_NAME: il nome dell'istanza di computing per la quale vuoi elencare i referrer.

Ad esempio, per elencare i referrer per l'istanza new-instance-a3 nella zona us-central1-a, effettua la seguente richiesta HTTP:

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

Il server restituisce una risposta di elenco standard contenente i seguenti elementi:

{
  "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 risposta mostra il gruppo di istanze regionali nell'elenco dei referrer.

Elenca i referrer di tutte le risorse di una raccolta

Utilizzando il carattere jolly (-), puoi richiedere un elenco di tutti i referrer di tutte le istanze di computing all'interno di una zona specifica:

gcloud

Utilizza il comando gcloud compute instances list-referrers con il carattere jolly -:

gcloud compute instances list-referrers - \
    --zone=ZONE

Sostituisci ZONE con la zona in cui vuoi elencare i referrer per tutte le istanze di computing.

Ad esempio, per elencare i referrer di tutte le istanze di computing nella zona us-central1-a, esegui il seguente comando:

gcloud compute instances list-referrers - \
    --zone=us-central1-a

L'output è simile al seguente:

REFERRER                                                                                            REFERENCE_TYPE  TARGET
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a1
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig    MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instanceGroups/example-ig-2  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/example-ig-a2
https://www.googleapis.com/compute/v1/projects/myproject/regions/us-central1/instanceGroups/example-rmig  MEMBER_OF       https://www.googleapis.com/compute/v1/projects/myproject/zones/us-central1-a/instances/new-instance-a3

REST

Invia una richiesta GET al metodo instances.listReferrers con il carattere jolly -:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/-/referrers

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto in cui vuoi elencare i referrer.
  • ZONE: la zona in cui vuoi elencare i referrer per tutte le istanze di computing.

Ad esempio, per elencare i referrer di tutte le istanze di computing nella zona us-central1-a, invia la seguente richiesta HTTP:

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

Il server restituisce una risposta contenente un elenco di istanze di computing nella zona e i riferimenti a ciascuna istanza. Ad esempio:

{
  "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"
    }
  ]
}

Passaggi successivi