Veja e exporte as definições do Gestor de acessos privilegiados

Enquanto visualizador das definições do Gestor de acessos privilegiados, pode ver as definições do Gestor de acessos privilegiados para uma organização, uma pasta ou um projeto. Também pode exportar definições programaticamente através da Google Cloud CLI.

Antes de começar

Para receber as autorizações de que precisa para ver as definições do Privileged Access Manager, peça ao seu administrador para lhe conceder as seguintes funções de IAM na organização, na pasta ou no projeto:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Estas funções predefinidas contêm as autorizações necessárias para ver as definições do Gestor de acessos privilegiados. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para ver as definições do Privileged Access Manager:

  • Para ver as definições:
    • privilegedaccessmanager.settings.get
    • privilegedaccessmanager.settings.fetchEffective

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Ver definições

Consola

  1. Aceda à página Gestor de acessos privilegiados.

    Aceda ao Gestor de acessos privilegiados

  2. Selecione a organização, a pasta ou o projeto para os quais quer ver as definições do Privileged Access Manager.

  3. Clique no separador Definições.

A página Definições apresenta os detalhes das definições do Gestor de acessos privilegiados para o recurso selecionado.

gcloud

Pode ver as seguintes definições de um recurso:

  • Definições individuais que são definidas diretamente no recurso.

  • Definições eficazes definidas no recurso ou herdadas do respetivo recurso principal.

    Veja as definições individuais de um recurso

    O comando gcloud alpha pam settings describe permite ver as definições do Gestor de acessos privilegiados.

    Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

    • RESOURCE_TYPE: opcional. O tipo de recurso para o qual quer obter as definições. Use o valor organization, folder ou project.
    • RESOURCE_ID: usado com RESOURCE_TYPE. O ID do projeto, da pasta ou da organização para os quais quer gerir autorizações. Google CloudOs IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Execute o seguinte comando:

    Linux, macOS ou Cloud Shell

    gcloud alpha pam settings describe \
    --location=global \
    -- RESOURCE_TYPE=RESOURCE_ID \

    Windows (PowerShell)

    gcloud alpha pam settings describe `
    --location=global `
    -- RESOURCE_TYPE=RESOURCE_ID `

    Windows (cmd.exe)

    gcloud alpha pam settings describe ^
    --location=global ^
    -- RESOURCE_TYPE=RESOURCE_ID ^

    Deve receber uma resposta semelhante à seguinte:

    createTime: '2025-05-18T10:10:10.101010101Z'
emailNotificationSettings:
  customNotificationBehavior:
    adminNotifications:
      grantActivated: ENABLED
      grantActivationFailed: DISABLED
      grantEnded: ENABLED
      grantExternallyModified: ENABLED
    approverNotifications:
      pendingApproval: ENABLED
    requesterNotifications:
      entitlementAssigned: ENABLED
      grantActivated: ENABLED
      grantExpired: ENABLED
      grantRevoked: ENABLED
etag: "ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md"
name: RESOURCE_TYPE/RESOURCE_ID/locations/global/settings
serviceAccountApproverSettings:
  enabled: true
updateTime: '2025-05-18T10:10:10.101010101Z'

    Veja as definições eficazes num recurso

    O comando gcloud alpha pam settings describe-effective permite ver as definições do Gestor de acessos privilegiados.

    Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

    • RESOURCE_TYPE: opcional. O tipo de recurso para o qual quer obter as definições. Use o valor organization, folder ou project.
    • RESOURCE_ID: usado com RESOURCE_TYPE. O ID do projeto, da pasta ou da organização para os quais quer gerir autorizações. Google CloudOs IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Execute o seguinte comando:

    Linux, macOS ou Cloud Shell

    gcloud alpha pam settings describe-effective \
    --location=global \
    --RESOURCE_TYPE=RESOURCE_ID \

    Windows (PowerShell)

    gcloud alpha pam settings describe-effective `
    --location=global `
    --RESOURCE_TYPE=RESOURCE_ID `

    Windows (cmd.exe)

    gcloud alpha pam settings describe-effective ^
    --location=global ^
    --RESOURCE_TYPE=RESOURCE_ID ^

    Deve receber uma resposta semelhante à seguinte:

    emailNotificationSettings:
  customNotificationBehavior:
    adminNotifications:
      notifyGrantActivated: true
      notifyGrantActivationFailed: true
      notifyGrantEnded: true
      notifyGrantExternallyModified: true
    approverNotifications:
      notifyPendingApproval: true
    requesterNotifications:
      notifyEntitlementAssigned: true
      notifyEntitlementUpdated: true
      notifyGrantActivated: true
      notifyGrantActivationFailed: true
      notifyGrantEnded: true
      notifyGrantExpired: true
      notifyGrantExternallyModified: true
      notifyGrantRevoked: true
parent: RESOURCE_TYPE/RESOURCE_ID/locations/global
serviceAccountApproverSettings: {}

REST

Pode ver as seguintes definições de um recurso:

  • Definições individuais que são definidas diretamente no recurso.

  • Definições eficazes definidas no recurso ou herdadas do respetivo recurso principal.

    Veja as definições individuais de um recurso

    O método getSettings da API Privileged Access Manager visualiza as definições do Gestor de acessos privilegiados.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • SCOPE: a organização, a pasta ou o projeto para o qual quer obter as definições, no formato de organizations/ORGANIZATION_ID, folders/FOLDER_ID ou projects/PROJECT_ID. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Método HTTP e URL: 

    GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global/settings

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    
{
  "createTime": "2025-05-18T10:10:10.101010101Z",
  "emailNotificationSettings": {
    "customNotificationBehavior": {
      "adminNotifications": {
        "grantActivated": "ENABLED",
        "grantActivationFailed": "DISABLED",
        "grantEnded": "ENABLED",
        "grantExternallyModified": "ENABLED"
      },
      "approverNotifications": {
        "pendingApproval": "ENABLED"
      },
      "requesterNotifications": {
        "entitlementAssigned": "ENABLED",
        "grantActivated": "ENABLED",
        "grantExpired": "ENABLED",
        "grantRevoked": "ENABLED"
      }
    }
  },
  "etag": "\"ZjlkNWZlMWUtNDlhYS00YjJjAYlzNWYtZWFkNGVjOWU3NWMkBwYRsottW5Md\"",
  "name": "SCOPE/locations/global/settings",
  "serviceAccountApproverSettings": {
    "enabled": true
  },
  "updateTime": "2025-05-18T10:10:10.101010101Z"
}

    Veja as definições eficazes num recurso

    O método fetchEffectiveSettings da API Privileged Access Manager visualiza as definições do Gestor de acessos privilegiados.

    Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

    • SCOPE: a organização, a pasta ou o projeto para o qual quer obter as definições, no formato de organizations/ORGANIZATION_ID, folders/FOLDER_ID ou projects/PROJECT_ID. Os IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

    Método HTTP e URL: 

    GET https://privilegedaccessmanager.googleapis.com/v1beta/SCOPE/locations/global:effectiveSettings

    Para enviar o seu pedido, expanda uma destas opções:

    Deve receber uma resposta JSON semelhante à seguinte:

    {
  "emailNotificationSettings": {
    "customNotificationBehavior": {
      "adminNotifications": {
        "notifyGrantActivated": "true",
        "notifyGrantActivationFailed": "true",
        "notifyGrantEnded": "true",
        "notifyGrantExternallyModified": "true"
      },
      "approverNotifications": {
        "notifyPendingApproval": "true"
      },
      "requesterNotifications": {
        "notifyEntitlementAssigned": "true",
        "notifyEntitlementUpdated": "true",
        "notifyGrantActivated": "true",
        "notifyGrantActivationFailed": "true",
        "notifyGrantEnded": "true",
        "notifyGrantExpired": "true",
        "notifyGrantExternallyModified": "true",
        "notifyGrantRevoked": "true"
      }
    }
  },
  "parent": "SCOPE/locations/global",
  "serviceAccountApproverSettings": {}
}

Exporte definições de forma programática através da CLI gcloud

O comando gcloud alpha pam settings export obtém e exporta as definições de um recurso específico.

Antes de usar qualquer um dos dados de comandos abaixo, faça as seguintes substituições:

  • FILENAME: O nome do ficheiro para exportar o conteúdo das definições.
  • RESOURCE_TYPE: opcional. O tipo de recurso ao qual o recurso correspondente pertence. Use o valor organization, folder ou project.
  • RESOURCE_ID: usado com RESOURCE_TYPE. O ID do projeto, da pasta ou da organização para os quais quer gerir autorizações. Google CloudOs IDs dos projetos são strings alfanuméricas, como my-project. Os IDs das pastas e das organizações são numéricos, como 123456789012.

Execute o seguinte comando:

Linux, macOS ou Cloud Shell

gcloud alpha pam settings export \
    --destination=FILENAME.yaml \
    --location=global \
    -- RESOURCE_TYPE=RESOURCE_ID

Windows (PowerShell)

gcloud alpha pam settings export `
    --destination=FILENAME.yaml `
    --location=global `
    -- RESOURCE_TYPE=RESOURCE_ID

Windows (cmd.exe)

gcloud alpha pam settings export ^
    --destination=FILENAME.yaml ^
    --location=global ^
    -- RESOURCE_TYPE=RESOURCE_ID

Deve receber uma resposta semelhante à seguinte:

Exported [RESOURCE_TYPE/RESOURCE_ID/locations/global/settings] to FILENAME.yaml.

O que se segue?