Visualizza criteri di posizionamento

---

Questo documento descrive come visualizzare i criteri di posizionamento.

La visualizzazione dei criteri di posizionamento è utile per vedere tutti i criteri di posizionamento esistenti in un progetto o per verificare i dettagli di configurazione di un criterio di posizionamento specifico.

Prima di iniziare

• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è la procedura mediante la quale la tua identità viene verificata per l'accesso alle API e ai servizi Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.
  

  Select the tab for how you plan to use the samples on this page:

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

     Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Per ulteriori informazioni, vedi Esegui l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i criteri di posizionamento, chiedi all'amministratore di concederti Ruolo IAM Amministratore istanze Compute (v1) (roles/compute.instanceAdmin.v1) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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

Autorizzazioni obbligatorie

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

• Per visualizzare un elenco dei tuoi criteri di posizionamento: compute.resourcePolicies.list on the project
• Per visualizzare i dettagli di un criterio di posizionamento: compute.resourcePolicies.get on the project

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Visualizza i criteri di posizionamento

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

• Per vedere tutti i criteri di posizionamento esistenti in un progetto, visualizza un elenco dei tuoi criteri di posizionamento.

• Per vedere i dettagli di configurazione di un criterio di posizionamento, visualizza i dettagli di un criterio di posizionamento.

Visualizzare un elenco dei criteri di posizionamento

Per visualizzare un elenco di tutti i criteri di posizionamento nel tuo progetto, seleziona una delle le seguenti opzioni:

gcloud

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

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

L'output è simile al seguente:

NAME: example-compact-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:09:24.588-07:00

NAME: example-spread-policy
DESCRIPTION:
REGION: https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1
CREATION_TIMESTAMP: 2024-05-09T02:08:13.404-07: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 in una regione specifica, invia una richiesta GET al metodo resourcePolicies.list. Nell'URL della richiesta, includi il parametro di query filter e impostalo 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": "5587673659722509355",
      "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-compact-policy",
      "groupPlacementPolicy": {
        "collocation": "COLLOCATED"
      },
      "status": "READY"
    },
    {
      "kind": "compute#resourcePolicy",
      "id": "5970772604948130963",
      "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
      "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
      "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
      "name": "example-spread-policy",
      "groupPlacementPolicy": {
        "availabilityDomainCount": 5
      },
      "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 di espressioni di filtro per restringere un elenco di criteri delle risorse mediante la codifica URL, consulta il parametro di query filter.

Visualizzare i dettagli di un criterio di posizionamento

Per visualizzare i dettagli di un criterio di posizionamento, seleziona una delle seguenti opzioni:

gcloud

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

Nota: se vuoi visualizzare il campo maxDistance in un posizionamento compatto utilizza il Comando gcloud beta compute resource-policies describe .

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

Sostituisci quanto segue:

• POLICY_NAME: il nome di un posizionamento esistente .

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

L'output è simile al seguente:

• Se visualizzi i dettagli di un criterio di posizionamento compatto:

  creationTimestamp: '2024-05-09T02:09:24.588-07:00'
  groupPlacementPolicy:
    collocation: COLLOCATED
  id: '5587673659722509355'
  kind: compute#resourcePolicy
  name: example-compact-policy
  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-compact-policy
  status: READY
  

• Se stai visualizzando i dettagli di un criterio di posizionamento distribuito:

  creationTimestamp: '2024-05-09T02:08:13.404-07:00'
  groupPlacementPolicy:
    availabilityDomainCount: 5
  id: '5970772604948130963'
  kind: compute#resourcePolicy
  name: example-spread-policy
  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-spread-policy
  status: READY
  

REST

Per visualizzare i dettagli di un criterio di posizionamento, invia una richiesta GET a Metodo resourcePolicies.get.

Nota: se vuoi visualizzare il campo maxDistance in un posizionamento compatto norme, invia una richiesta GET Metodo beta.resourcePolicies.get anziché Google Cloud.

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 è stato inserito il posizionamento criterio di cui vuoi visualizzare i dettagli.

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

• POLICY_NAME: il nome di un posizionamento esistente .

L'output è simile al seguente:

• Se visualizzi i dettagli di un criterio di posizionamento compatto:

  {
    "kind": "compute#resourcePolicy",
    "id": "5587673659722509355",
    "creationTimestamp": "2024-05-09T02:09:24.588-07:00",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-compact-policy",
    "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
    "name": "example-compact-policy",
    "groupPlacementPolicy": {
      "collocation": "COLLOCATED"
    },
    "status": "READY"
  }
  

• Se stai visualizzando i dettagli di un criterio di posizionamento distribuito:

  {
    "kind": "compute#resourcePolicy",
    "id": "5970772604948130963",
    "creationTimestamp": "2024-05-09T02:08:13.404-07:00",
    "selfLink": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/resourcePolicies/example-spread-policy",
    "region": "https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1",
    "name": "example-spread-policy",
    "groupPlacementPolicy": {
      "availabilityDomainCount": 5
    },
    "status": "READY"
  }
  

Passaggi successivi

• Scopri come sostituire, rimuovere o eliminare i criteri di posizionamento.

• Scopri come applicare un criterio di posizionamento:

  • Applica i criteri di posizionamento compatto alle VM.

  • Applica i criteri di posizionamento distribuito alle VM.

• Scopri come verificare la posizione delle VM che utilizzano i criteri di posizionamento compatti.