Cómo ver tus recursos

En este documento, se muestra cómo ver tus recursos con Cloud Asset Inventory y Google Cloud CLI en Cloud Shell.

Antes de comenzar

Para completar las instrucciones de este documento, debes habilitar la API de Cloud Asset Inventory y configurar los permisos para acceder a Cloud Asset Inventory y Compute Engine.

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Si usas un proyecto existente para esta guía, verifica que tengas los permisos necesarios a fin de completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

  4. Enable the Cloud Asset Inventory API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Si usas un proyecto existente para esta guía, verifica que tengas los permisos necesarios a fin de completarla. Si creaste un proyecto nuevo, ya tienes los permisos necesarios.

  7. Enable the Cloud Asset Inventory API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

  8. Roles obligatorios

    Para obtener los permisos que necesitas y completar estas instrucciones, pídele a tu administrador que te otorgue los siguientes roles de IAM en la organización, carpeta o proyecto:

    Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

    Estos roles predefinidos contienen los permisos necesarios para completar estas instrucciones. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

    Permisos necesarios

    Se requieren los siguientes permisos para completar estas instrucciones:

    • Para enumerar los metadatos de activos, haz lo siguiente: cloudasset.assets.listResource
    • Para crear una instancia de VM de Compute Engine, haz lo siguiente:
      • compute.disks.create
      • compute.instances.create
      • compute.instances.delete
      • compute.instances.setServiceAccount
      • compute.projects.get
      • compute.subnetworks.use
      • compute.subnetworks.useExternalIp
      • compute.zoneOperations.get

    También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

    Cómo ver tus recursos

    En el proyecto que elijas, crea una instancia de VM de Compute Engine para que puedas verla en Cloud Asset Inventory:

    1. En la consola de Google Cloud , ve a la página Instancias de VM.

      Ir a Instancias de VM

    2. Haz clic en Crear instancia.

    3. Ingresa un nombre para la instancia.

    4. Haz clic en Crear.

    5. Espera a que se cree la instancia.

    Enumera todas las instancias de VM de tu proyecto:

    1. En la Google Cloud consola, haz clic en Activar Cloud Shell.

    2. En Cloud Shell, ejecute el siguiente comando:

      gcloud asset list \
          --project=PROJECT_ID \
          --asset-types=compute.googleapis.com/Instance \
          --content-type=resource
      

      Reemplaza PROJECT_ID por el ID del proyecto cuyos recursos deseas enumerar.

      En el muestra de código anterior, se usa un tipo de recurso compute.googleapis.com/Instance para enumerar solo las instancias de VM de Compute Engine. Para ver todos los tipos de recursos, consulta Tipos de recursos.

      También se estableció un tipo de contenido de resource. Esto especifica que también se deben devolver los metadatos de resource en la respuesta. Si no se establece ningún tipo de contenido, solo se devuelve información básica sobre cada recurso, como el nombre, la última vez que se actualizó y el proyecto en el que se encuentra.

    Realiza una limpieza

    Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

    1. En la consola de Google Cloud , ve a la página Instancias de VM.

      Ir a Instancias de VM

    2. En la misma fila que el nombre de la instancia de VM que creaste, haz clic en Más acciones.

    3. Haz clic en Borrar y, luego, confirma la eliminación.

    ¿Qué sigue?

    • Para explorar más opciones relacionadas con la visualización de tus recursos, consulta Cómo enumerar recursos.