# API hub API . projects . locations . discoveredApiObservations

## Instance Methods

Returns the discoveredApiOperations Resource.

Close httplib2 connections.

Gets a DiscoveredAPIObservation in a given project, location and ApiObservation.

Lists all the DiscoveredAPIObservations in a given project and location.

Retrieves the next page of results.

### Method Details

`close()`

    Close httplib2 connections.

`get(name, x__xgafv=None)`

    Gets a DiscoveredAPIObservation in a given project, location and ApiObservation.

    Args:
      name: string, Required. The name of the DiscoveredApiObservation to retrieve. Format: projects/{project}/locations/{location}/discoveredApiObservations/{discovered_api_observation} (required)
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Respresents an API Observation observed in one of the sources.
      "apiOperationCount": "A String", # Optional. The number of observed API Operations.
      "createTime": "A String", # Output only. Create time stamp of the observation in API Hub.
      "hostname": "A String", # Optional. The hostname of requests processed for this Observation.
      "knownOperationsCount": "A String", # Output only. The number of known API Operations.
      "lastEventDetectedTime": "A String", # Optional. Last event detected time stamp
      "name": "A String", # Identifier. The name of the discovered API Observation. Format: `projects/{project}/locations/{location}/discoveredApiObservations/{discovered_api_observation}`
      "origin": "A String", # Optional. For an observation pushed from a gcp resource, this would be the gcp project id.
      "serverIps": [ # Optional. The IP address (IPv4 or IPv6) of the origin server that the request was sent to. This field can include port information. Examples: `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
        "A String",
      ],
      "sourceLocations": [ # Optional. The location of the observation source.
        "A String",
      ],
      "sourceMetadata": { # SourceMetadata represents the metadata for a resource at the source. # Output only. The metadata of the source from which the observation was collected.
        "originalResourceCreateTime": "A String", # Output only. The time at which the resource was created at the source.
        "originalResourceId": "A String", # Output only. The unique identifier of the resource at the source.
        "originalResourceUpdateTime": "A String", # Output only. The time at which the resource was last updated at the source.
        "pluginInstanceActionSource": { # PluginInstanceActionSource represents the plugin instance action source. # Output only. The source of the resource is a plugin instance action.
          "actionId": "A String", # Output only. The id of the plugin instance action.
          "pluginInstance": "A String", # Output only. The resource name of the source plugin instance. Format is `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
        },
        "sourceType": "A String", # Output only. The type of the source.
      },
      "sourceTypes": [ # Optional. The type of the source from which the observation was collected.
        "A String",
      ],
      "style": "A String", # Optional. Style of ApiObservation
      "unknownOperationsCount": "A String", # Output only. The number of unknown API Operations.
      "updateTime": "A String", # Output only. Update time stamp of the observation in API Hub.
    }

`list(parent, pageSize=None, pageToken=None, x__xgafv=None)`

    Lists all the DiscoveredAPIObservations in a given project and location.

    Args:
      parent: string, Required. The parent, which owns this collection of ApiObservations. Format: projects/{project}/locations/{location} (required)
      pageSize: integer, Optional. The maximum number of ApiObservations to return. The service may return fewer than this value. If unspecified, at most 10 ApiObservations will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
      pageToken: string, Optional. A page token, received from a previous `ListApiObservations` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListApiObservations` must match the call that provided the page token.
      x__xgafv: string, V1 error format.
        Allowed values
          1 - v1 error format
          2 - v2 error format

    Returns:
      An object of the form:

        { # Message for response to listing DiscoveredApiObservations
      "discoveredApiObservations": [ # The DiscoveredApiObservation from the specified project and location.
        { # Respresents an API Observation observed in one of the sources.
          "apiOperationCount": "A String", # Optional. The number of observed API Operations.
          "createTime": "A String", # Output only. Create time stamp of the observation in API Hub.
          "hostname": "A String", # Optional. The hostname of requests processed for this Observation.
          "knownOperationsCount": "A String", # Output only. The number of known API Operations.
          "lastEventDetectedTime": "A String", # Optional. Last event detected time stamp
          "name": "A String", # Identifier. The name of the discovered API Observation. Format: `projects/{project}/locations/{location}/discoveredApiObservations/{discovered_api_observation}`
          "origin": "A String", # Optional. For an observation pushed from a gcp resource, this would be the gcp project id.
          "serverIps": [ # Optional. The IP address (IPv4 or IPv6) of the origin server that the request was sent to. This field can include port information. Examples: `"192.168.1.1"`, `"10.0.0.1:80"`, `"FE80::0202:B3FF:FE1E:8329"`.
            "A String",
          ],
          "sourceLocations": [ # Optional. The location of the observation source.
            "A String",
          ],
          "sourceMetadata": { # SourceMetadata represents the metadata for a resource at the source. # Output only. The metadata of the source from which the observation was collected.
            "originalResourceCreateTime": "A String", # Output only. The time at which the resource was created at the source.
            "originalResourceId": "A String", # Output only. The unique identifier of the resource at the source.
            "originalResourceUpdateTime": "A String", # Output only. The time at which the resource was last updated at the source.
            "pluginInstanceActionSource": { # PluginInstanceActionSource represents the plugin instance action source. # Output only. The source of the resource is a plugin instance action.
              "actionId": "A String", # Output only. The id of the plugin instance action.
              "pluginInstance": "A String", # Output only. The resource name of the source plugin instance. Format is `projects/{project}/locations/{location}/plugins/{plugin}/instances/{instance}`
            },
            "sourceType": "A String", # Output only. The type of the source.
          },
          "sourceTypes": [ # Optional. The type of the source from which the observation was collected.
            "A String",
          ],
          "style": "A String", # Optional. Style of ApiObservation
          "unknownOperationsCount": "A String", # Output only. The number of unknown API Operations.
          "updateTime": "A String", # Output only. Update time stamp of the observation in API Hub.
        },
      ],
      "nextPageToken": "A String", # A token, which can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
    }

`list_next()`

    Retrieves the next page of results.

            Args:
              previous_request: The request for the previous page. (required)
              previous_response: The response from the request for the previous page. (required)

            Returns:
              A request object that you can call 'execute()' on to request the next
              page. Returns None if there are no more items in the collection.