ListFindingsResponse

Mensaje de respuesta para enumerar los resultados.

Representación JSON
{
  "listFindingsResults": [
    {
      object (ListFindingsResult)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
Campos
listFindingsResults[]

object (ListFindingsResult)

Resultados que coinciden con la solicitud de lista.

nextPageToken

string

Es un token para recuperar la página siguiente de resultados o dejarlo vacío si no hay más resultados.

totalSize

integer

Es la cantidad total de resultados que coinciden con la búsqueda.

ListFindingsResult

Es el resultado que contiene el hallazgo.

Representación JSON
{
  "finding": {
    object (Finding)
  },
  "resource": {
    object (Resource)
  }
}
Campos
finding

object (Finding)

Encontrar coincidencias con la solicitud de búsqueda

resource

object (Resource)

Solo salida. Es el recurso asociado a este hallazgo.

Recurso

Información relacionada con el recurso de Google Cloud asociado a este resultado.

Representación JSON
{
  "name": string,
  "displayName": string,
  "type": string,
  "cloudProvider": enum (CloudProvider),
  "service": string,
  "location": string,
  "resourcePath": {
    object (ResourcePath)
  },
  "resourcePathString": string,

  // Union field cloud_provider_metadata can be only one of the following:
  "gcpMetadata": {
    object (GcpMetadata)
  },
  "awsMetadata": {
    object (AwsMetadata)
  }
  // End of list of possible types for union field cloud_provider_metadata.
}
Campos
name

string

Es el nombre completo del recurso. Consulta: https://cloud.google.com/apis/design/resource_names#full_resource_name

displayName

string

Es el nombre legible por humanos del recurso.

type

string

Es el tipo de recurso completo.

cloudProvider

enum (CloudProvider)

Indica de qué proveedor de servicios en la nube proviene el hallazgo.

service

string

Es el servicio o el proveedor de recursos asociado con el recurso.

location

string

La región o ubicación del servicio (si corresponde).

resourcePath

object (ResourcePath)

Proporciona la ruta de acceso al recurso dentro de la jerarquía de recursos.

resourcePathString

string

Es una representación de cadena de la ruta de acceso al recurso. En Google Cloud, tiene el formato de org/{organization_id}/folder/{folder_id}/folder/{folder_id}/project/{projectId}, en el que puede haber cualquier cantidad de carpetas. En el caso de AWS, tiene el formato org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{accountId}, en el que puede haber cualquier cantidad de unidades organizativas.

Campo de unión cloud_provider_metadata.

cloud_provider_metadata puede ser una de las siguientes opciones:

gcpMetadata

object (GcpMetadata)

Los metadatos de GCP asociados con el hallazgo

awsMetadata

object (AwsMetadata)

Los metadatos de AWS asociados con el hallazgo

GcpMetadata

Metadatos de GCP asociados con el recurso, que solo se aplican si el proveedor de nube del hallazgo es Google Cloud Platform.

Representación JSON
{
  "project": string,
  "projectDisplayName": string,
  "parent": string,
  "parentDisplayName": string,
  "folders": [
    {
      object (Folder)
    }
  ],
  "organization": string
}
Campos
project

string

Es el nombre completo del recurso del proyecto al que pertenece el recurso.

projectDisplayName

string

Es el ID del proyecto al que pertenece el recurso.

parent

string

Es el nombre completo del recurso superior.

parentDisplayName

string

Es el nombre legible por humanos del elemento superior del recurso.

folders[]

object (Folder)

Solo salida. Contiene un mensaje de carpeta para cada carpeta en el linaje de activos. La primera carpeta es la carpeta anidada más profunda y la última es la carpeta que se encuentra directamente debajo de la organización.

organization

string

Es el nombre de la organización a la que pertenece el recurso.

Carpeta

Es un mensaje que contiene el nombre y el nombre visible de un recurso de carpeta.

Representación JSON
{
  "resourceFolder": string,
  "resourceFolderDisplayName": string
}
Campos
resourceFolder

string

Es el nombre completo del recurso de esta carpeta. Consulta: https://cloud.google.com/apis/design/resource_names#full_resource_name

resourceFolderDisplayName

string

Es el nombre visible definido por el usuario para esta carpeta.

AwsMetadata

Metadatos de AWS asociados con el recurso, que solo se aplican si el proveedor de servicios en la nube del hallazgo es Amazon Web Services.

Representación JSON
{
  "organization": {
    object (AwsOrganization)
  },
  "organizationalUnits": [
    {
      object (AwsOrganizationalUnit)
    }
  ],
  "account": {
    object (AwsAccount)
  }
}
Campos
organization

object (AwsOrganization)

La organización de AWS asociada con el recurso.

organizationalUnits[]

object (AwsOrganizationalUnit)

Es una lista de las unidades organizativas de AWS asociadas con el recurso, ordenadas del nivel más bajo (más cercano a la cuenta) al más alto.

account

object (AwsAccount)

La cuenta de AWS asociada con el recurso

AwsOrganization

Una organización es un conjunto de cuentas que se administran de forma centralizada con facturación consolidada, se organizan de forma jerárquica con unidades organizativas (UO) y se controlan con políticas.

Representación JSON
{
  "id": string
}
Campos
id

string

Es el identificador (ID) único de la organización. El patrón de regex para una cadena de ID de organización requiere "o-" seguido de entre 10 y 32 letras o dígitos en minúsculas.

AwsOrganizationalUnit

Una unidad organizativa (UO) es un contenedor de cuentas de AWS dentro de la raíz de una organización. Las políticas adjuntas a una UO se aplican a todas las cuentas que contiene y a las UO secundarias.

Representación JSON
{
  "id": string,
  "name": string
}
Campos
id

string

Es el identificador (ID) único asociado con esta UO. El patrón de regex para una cadena de ID de unidad organizativa requiere "ou-" seguido de entre 4 y 32 letras o dígitos en minúsculas (el ID de la raíz que contiene la UO). A esta cadena le sigue un segundo guion "-" y de 8 a 32 letras minúsculas o dígitos adicionales. Por ejemplo, "ou-ab12-cd34ef56".

name

string

Es el nombre descriptivo de la UO.

AwsAccount

Una cuenta de AWS que es miembro de una organización.

Representación JSON
{
  "id": string,
  "name": string
}
Campos
id

string

Es el identificador (ID) único de la cuenta, que contiene exactamente 12 dígitos.

name

string

Es el nombre descriptivo de esta cuenta.

ResourcePath

Representa la ruta de recursos que conduce al recurso sobre el que se informa este hallazgo.

Representación JSON
{
  "nodes": [
    {
      object (ResourcePathNode)
    }
  ]
}
Campos
nodes[]

object (ResourcePathNode)

Es la lista de nodos que forman la ruta de acceso de recursos ascendente, ordenada del nivel más bajo al más alto.

ResourcePathNode

Un nodo dentro de la ruta de recursos. Cada nodo representa un recurso dentro de la jerarquía de recursos.

Representación JSON
{
  "nodeType": enum (ResourcePathNodeType),
  "id": string,
  "displayName": string
}
Campos
nodeType

enum (ResourcePathNodeType)

Es el tipo de recurso que representa este nodo.

id

string

Es el ID del recurso que representa este nodo.

displayName

string

Es el nombre visible del recurso que representa este nodo.

ResourcePathNodeType

Es el tipo de recurso que representa el nodo.

Enums
RESOURCE_PATH_NODE_TYPE_UNSPECIFIED No se especificó el tipo de nodo.
GCP_ORGANIZATION El nodo representa una organización de Google Cloud.
GCP_FOLDER El nodo representa una carpeta de Google Cloud.
GCP_PROJECT El nodo representa un proyecto de Google Cloud.
AWS_ORGANIZATION El nodo representa una organización de AWS.
AWS_ORGANIZATIONAL_UNIT El nodo representa una unidad organizativa de AWS.
AWS_ACCOUNT El nodo representa una cuenta de AWS.