ListFindingsResponse

Mensagem de resposta para listar descobertas.

Representação JSON
{
  "listFindingsResults": [
    {
      object (ListFindingsResult)
    }
  ],
  "readTime": string,
  "nextPageToken": string,
  "totalSize": integer
}
Campos
listFindingsResults[]

object (ListFindingsResult)

Resultados que correspondem à solicitação de lista.

readTime

string (Timestamp format)

Tempo usado para executar a solicitação de lista.

Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".

nextPageToken

string

Token para recuperar a próxima página de resultados ou vazia se não houver mais resultados.

totalSize

integer

O número total de resultados que correspondem à consulta.

ListFindingsResult

Resultado que contém a descoberta e a StateChange.

Representação JSON
{
  "finding": {
    object (Finding)
  },
  "stateChange": enum (StateChange),
  "resource": {
    object (Resource)
  }
}
Campos
finding

object (Finding)

Encontrar a correspondência da solicitação de pesquisa.

stateChange

enum (StateChange)

Mudança de estado da descoberta entre os pontos no tempo.

resource

object (Resource)

Apenas saída. Recurso associado a essa descoberta.

StateChange

A mudança no estado da descoberta.

Quando você consulta dois pontos no tempo, isso descreve a mudança na descoberta entre os dois pontos: ALTERADA, SEM ALTERAÇÃO, ADICIONADA ou REMOVIDA. As descobertas não podem ser excluídas. Portanto, REMOVED implica que a descoberta no carimbo de data/hora não corresponde ao filtro especificado, mas corresponde ao carimbo de data/hora - compareDuration. Se não houver um compareDuration fornecido na solicitação, a mudança de estado será: UNUSED

Enums
UNUSED A mudança de estado não é usada. Esse é o padrão canônico para esse tipo enumerado.
CHANGED A descoberta mudou de estado de alguma forma entre os pontos no tempo e existiu nos dois pontos.
UNCHANGED A descoberta não mudou de estado entre os pontos no tempo e existiu nos dois pontos.
ADDED A descoberta foi criada entre os pontos no tempo.
REMOVED A descoberta no carimbo de data/hora não corresponde ao filtro especificado, mas corresponde ao carimbo de data/hora - compareDuration.

Recurso

Informações relacionadas ao recurso do Google Cloud associado a essa descoberta.

Representação 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

O nome completo do recurso. Consulte: https://cloud.google.com/apis/design/resource_names#full_resource_name

displayName

string

O nome legível do recurso.

type

string

O tipo completo do recurso.

projectName

string

O nome completo do projeto ao qual o recurso pertence.

projectDisplayName

string

O ID do projeto ao qual o recurso pertence.

parentName

string

O nome completo do recurso pai.

parentDisplayName

string

O nome legível por humanos do pai do recurso.

folders[]

object (Folder)

Contém uma mensagem de pasta para cada pasta na ancestralidade dos recursos. A primeira é a pasta aninhada mais profunda, e a última é a pasta diretamente abaixo da organização.

cloudProvider

enum (CloudProvider)

Indica de qual provedor de nuvem a descoberta é.

organization

string

Indica a organização / locatário a que a descoberta se refere.

service

string

O provedor de serviço ou recurso associado ao recurso.

location

string

A região ou o local do serviço (se aplicável).

resourcePath

object (ResourcePath)

Fornece o caminho para o recurso na hierarquia de recursos.

resourcePathString

string

Uma representação de string do caminho do recurso. No Google Cloud, ele tem o formato org/{organization_id}/folder/{folder_id}/folder/{folder_id}/project/{projectId}, em que pode haver qualquer número de pastas. Na AWS, ele tem o formato org/{organization_id}/ou/{organizational_unit_id}/ou/{organizational_unit_id}/account/{accountId}, em que pode haver qualquer número de unidades organizacionais.

Campo de união cloud_provider_metadata.

cloud_provider_metadata pode ser apenas de um dos tipos a seguir:

awsMetadata

object (AwsMetadata)

Os metadados da AWS associados à descoberta.

AwsMetadata

Metadados da AWS associados ao recurso, aplicável apenas se o provedor de nuvem da descoberta for a Amazon Web Services.

Representação JSON
{
  "organization": {
    object (AwsOrganization)
  },
  "organizationalUnits": [
    {
      object (AwsOrganizationalUnit)
    }
  ],
  "account": {
    object (AwsAccount)
  }
}
Campos
organization

object (AwsOrganization)

A organização da AWS associada ao recurso.

organizationalUnits[]

object (AwsOrganizationalUnit)

Uma lista de unidades organizacionais da AWS associadas ao recurso, ordenada do nível mais baixo (mais próximo da conta) ao mais alto.

account

object (AwsAccount)

A conta da AWS associada ao recurso.

AwsOrganization

Uma organização é um conjunto de contas gerenciadas de forma centralizada usando o faturamento consolidado, organizado hierarquicamente com unidades organizacionais (UOs) e controlado com políticas.

Representação JSON
{
  "id": string
}
Campos
id

string

O identificador exclusivo (ID) da organização. O padrão de regex de uma string de ID da organização exige "o-" seguido de 10 a 32 letras ou dígitos em letras minúsculas.

AwsOrganizationalUnit

Uma unidade organizacional (UO) é um contêiner de contas da AWS na raiz de uma organização. As políticas anexadas a uma UO são aplicadas a todas as contas contidas nela e em todas as UOs filhas.

Representação JSON
{
  "id": string,
  "name": string
}
Campos
id

string

O identificador exclusivo (ID) associado a esta unidade organizacional. O padrão de regex para uma string de ID de unidade organizacional exige "ou-" seguido de 4 a 32 letras ou dígitos em letras minúsculas (o ID da raiz que contém a OU). Essa string é seguida por um segundo hífen e de 8 a 32 letras minúsculas ou dígitos. Por exemplo, "ou-ab12-cd34ef56".

name

string

O nome amigável da UO.

AwsAccount

Uma conta da AWS que é membro de uma organização.

Representação JSON
{
  "id": string,
  "name": string
}
Campos
id

string

O identificador exclusivo (ID) da conta, que contém exatamente 12 dígitos.

name

string

O nome amigável dessa conta.

ResourcePath

Representa o caminho dos recursos que levam ao recurso relacionado a essa descoberta.

Representação JSON
{
  "nodes": [
    {
      object (ResourcePathNode)
    }
  ]
}
Campos
nodes[]

object (ResourcePathNode)

A lista de nós que compõem o caminho do recurso, ordenada do nível mais baixo ao mais alto.

ResourcePathNode

Um nó no caminho do recurso. Cada nó representa um recurso na hierarquia.

Representação JSON
{
  "nodeType": enum (ResourcePathNodeType),
  "id": string,
  "displayName": string
}
Campos
nodeType

enum (ResourcePathNodeType)

O tipo de recurso que este nó representa.

id

string

O ID do recurso representado por este nó.

displayName

string

O nome de exibição do recurso representado por este nó.

ResourcePathNodeType

O tipo de recurso que o nó representa.

Enums
RESOURCE_PATH_NODE_TYPE_UNSPECIFIED O tipo de nó não foi especificado.
GCP_ORGANIZATION O nó representa uma organização do Google Cloud.
GCP_FOLDER O nó representa uma pasta do Google Cloud.
GCP_PROJECT O nó representa um projeto do Google Cloud.
AWS_ORGANIZATION O nó representa uma organização da AWS.
AWS_ORGANIZATIONAL_UNIT O nó representa uma unidade organizacional da AWS.
AWS_ACCOUNT O nó representa uma conta da AWS.