Visualizza criteri di posizionamento

Questo documento spiega come visualizzare i criteri di posizionamento. Nello specifico, viene spiegato come visualizzare i criteri di posizionamento disponibili in un progetto specificato o come visualizzare i dettagli di configurazione di uno di questi criteri.

Prima di iniziare

  • Esamina le limitazioni relative ai criteri di posizionamento.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare o eliminare i criteri di posizionamento, chiedi all'amministratore di concederti il ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) per il progetto. Per saperne di più sulla concessione dei ruoli, vedi Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per visualizzare o eliminare i criteri di posizionamento. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per visualizzare o eliminare i criteri di posizionamento sono necessarie le seguenti autorizzazioni:

  • Per visualizzare un elenco dei criteri di posizionamento: compute.resourcePolicies.list nel progetto
  • Per visualizzare i dettagli di un criterio di posizionamento: compute.resourcePolicies.get nel progetto

Potresti anche essere in grado di ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

  • Configurare l'autenticazione.

    Seleziona la scheda relativa a come intendi utilizzare gli esempi di questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud, non è necessario configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente: 

      gcloud init
    2. Imposta una regione e una zona predefinite.

    REST

    Per utilizzare gli esempi di API REST su questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci allgcloud CLI.

      Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente: 

      gcloud init

    • Visualizza i criteri di posizionamento

    Per visualizzare i criteri di posizionamento disponibili in un progetto specificato, seleziona uno dei seguenti metodi:

    Visualizzare un elenco dei criteri di posizionamento

    Puoi visualizzare un elenco di tutti i criteri di posizionamento in un progetto specificato utilizzando l'interfaccia a riga di comando gcloud CLI'API Compute Engine.

    gcloud

    Per visualizzare un elenco dei criteri di posizionamento, utilizza il comando gcloud compute resource-policies list con il flag --filter impostato su groupPlacementPolicy:*.

    gcloud compute resource-policies list \
    --filter="groupPlacementPolicy:*" \
    --project=PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto in cui vuoi visualizzare un elenco di criteri di posizionamento. Se ometti questo flag, il suo valore viene impostato sull'ID del progetto attuale.

    L'output è simile al seguente:

    NAME: policy-1
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:10:51.958-08:00

NAME: policy-2
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2023-07-15T02:11:16.826-08:00

    Per ulteriori informazioni sull'utilizzo delle espressioni di filtro per restringere un elenco di risorse Compute Engine, consulta il comando gcloud topic filters.

    REST

    Per visualizzare un elenco di criteri di posizionamento che si trovano in una regione specifica, invia una richiesta GET al metodo resourcePolicies.list con il parametro di query filter impostato su groupPlacementPolicy%3A*.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies?filter=groupPlacementPolicy%3A*

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui vuoi visualizzare un elenco di criteri di posizionamento.

    • REGION: la regione in cui si trovano uno o più criteri di posizionamento.

    L'output è simile al seguente:

    {
  "kind": "compute#resourcePolicyList",
  "id": "projects/example-project/regions/us-central1/resourcePolicies",
  "items": [
    {
      "kind": "compute#resourcePolicy",
      "id": "637231102400797797",
      "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-1",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-1",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "1228789480840827204",
      "creationTimestamp": "2023-07-15T02:10:51.958-08:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/policy-2",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "policy-2",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 2
      },
      "status": "READY"
    }
  ],
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies",
  "etag": "-L7XCupTQ5V9__TOJ8G5RDcR2cY=/g_xt0udkOM_tU7jSL0z9I2Sivis="
}

    Per ulteriori informazioni sull'utilizzo delle espressioni di filtro per restringere un elenco di criteri delle risorse mediante la codifica degli URL, consulta il parametro di query filter.

    Visualizzare i dettagli di un criterio di posizionamento

    Puoi visualizzare i dettagli di un criterio di posizionamento in un progetto specificato utilizzando l'interfaccia a riga di comando gcloud CLI'API Compute Engine.

    gcloud

    Per visualizzare i dettagli di un criterio di posizionamento, utilizza il comando gcloud compute resource-policies describe.

    gcloud compute resource-policies describe POLICY_NAME \
    --project=PROJECT_ID \
    --region=REGION

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui si trova il criterio di posizionamento di cui vuoi visualizzare i dettagli.

    • POLICY_NAME: il nome di un criterio di posizionamento esistente.

    • REGION: la regione in cui si trova il criterio di posizionamento.

    L'output è simile al seguente:

    creationTimestamp: '2023-07-15T02:10:51.958-08:00'
groupPlacementPolicy:
  availabilityDomainCount: 2
id: '1228789480840827204'
kind: compute#resourcePolicy
name: pp2
region: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
selfLink: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy
status: READY

    REST

    Per visualizzare i dettagli di un criterio di posizionamento, effettua una richiesta GET al metodo resourcePolicies.get.

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/POLICY_NAME

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto in cui si trova il criterio di posizionamento di cui vuoi visualizzare i dettagli.

    • REGION: la regione in cui si trova il criterio di posizionamento.

    • POLICY_NAME: il nome di un criterio di posizionamento esistente.

    L'output è simile al seguente:

    {
  "kind": "compute#resourcePolicy",
  "id": "637231102400797797",
  "creationTimestamp": "2023-07-28T04:12:11.072-07:00",
  "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-policy",
  "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
  "name": "policy-1",
  "groupPlacementPolicy": {
      "availabilityDomainCount": 2
  },
  "status": "READY"
}

    Che cosa succede dopo?