ListFindingsResponse

Mensaje de respuesta para enumerar los resultados.

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

object (ListFindingsResult)

Resultados que coinciden con la solicitud de lista.
readTime

string (Timestamp format)

Es el tiempo que se usó para ejecutar la solicitud de lista.

Usa RFC 3339, en el que el resultado generado siempre se normalizará en Z y usará 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan compensaciones distintas de "Z". Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
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 y su StateChange.

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

object (Finding)

Encontrar coincidencias con la solicitud de búsqueda
stateChange

enum (StateChange)

Es el cambio de estado del hallazgo entre los puntos en el tiempo.
resource

object (Resource)

Solo salida. Es el recurso asociado a este hallazgo.

StateChange

Es el cambio de estado del hallazgo.

Cuando se realizan consultas en dos puntos en el tiempo, se describe el cambio en el hallazgo entre los dos puntos: CHANGED, UNCHANGED, ADDED o REMOVED. Los resultados no se pueden borrar, por lo que REMOVED implica que el resultado en la marca de tiempo no coincide con el filtro especificado, pero sí en la marca de tiempo - compareDuration. Si no se proporcionó compareDuration en la solicitud, el cambio de estado será UNUSED.

Enums
UNUSED No se usa el cambio de estado, este es el valor predeterminado canónico para esta enumeración.
CHANGED El hallazgo cambió de estado de alguna manera entre los puntos en el tiempo y existió en ambos.
UNCHANGED El hallazgo no cambió de estado entre los puntos en el tiempo y existió en ambos.
ADDED El hallazgo se creó entre los puntos en el tiempo.
REMOVED El hallazgo en la marca de tiempo no coincide con el filtro especificado, pero sí en la marca de tiempo - compareDuration.

Recurso

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

Representación JSON 
{
  "name": string,
  "displayName": string,
  "type": string,
  "projectName": string,
  "projectDisplayName": string,
  "parentName": string,
  "parentDisplayName": string,
  "folders": [
    {
      object (Folder)
    }
  ],
  "cloudProvider": enum (CloudProvider),
  "organization": string,
  "service": string,
  "location": string,
  "resourcePath": {
    object (ResourcePath)
  },
  "resourcePathString": string,

  // Union field cloud_provider_metadata can be only one of the following:
  "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.
projectName

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.
parentName

string

Es el nombre completo del recurso superior.
parentDisplayName

string

Es el nombre legible por humanos del elemento superior del recurso.
folders[]

object (Folder)

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.
cloudProvider

enum (CloudProvider)

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

string

Indica para qué organización o inquilino es 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:
awsMetadata

object (AwsMetadata)

Los metadatos de AWS asociados con el hallazgo

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.