Network Security API . organizations . locations . firewallEndpoints . wildfireVerdictChangeRequests

Instance Methods

close()

Close httplib2 connections.

create(parent, body=None, x__xgafv=None)

Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.

get(name, x__xgafv=None)

Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.

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

Lists the Advanced malware sandbox (WildFire) verdict change requests in a given firewall endpoint in an organization and location.

list_next(previous_request, previous_response)

Retrieves the next page of results.

Method Details

close() 
Close httplib2 connections.
create(parent, body=None, x__xgafv=None) 
Creates an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.

Args:
  parent: string, Required. Parent value for `CreateWildfireVerdictChangeRequestRequest`. The parent is a firewall endpoint resource. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}`. (required)
  body: object, The request body.
    The object takes the form of:

{ # Message for an Advanced malware sandbox verdict change request (`WildfireVerdictChangeRequest`).
  "comment": "A String", # Required. The justification for the verdict change request. The maximum length is 2048 characters.
  "createTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was created.
  "fileName": "A String", # Output only. The file name of the malware sample.
  "fileType": "A String", # Output only. The file type of the malware sample.
  "finalVerdict": "A String", # Output only. The final verdict of the malware sample.
  "name": "A String", # Output only. Identifier. The relative name of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}`. Where `{wildfire_verdict_change_request_id}` is an ID in the format `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
  "newVerdict": "A String", # Required. The suggested verdict to apply to the malware sample.
  "oldVerdict": "A String", # Output only. The original verdict of the malware sample.
  "resolutionTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was resolved.
  "sha256": "A String", # Required. The SHA256 hash ([FIPS 180-4](https://csrc.nist.gov/publications/detail/fips/180/4/final)) of the malware sample that requires a verdict change.
  "sourceRegion": "A String", # Output only. The region of the file associated with the malware sample.
  "state": "A String", # Output only. The review state of the `WildfireVerdictChangeRequest`.
  "updateTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was last updated.
  "wildfireVerdictChangeRequestId": "A String", # Output only. The ID of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Message for an Advanced malware sandbox verdict change request (`WildfireVerdictChangeRequest`).
  "comment": "A String", # Required. The justification for the verdict change request. The maximum length is 2048 characters.
  "createTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was created.
  "fileName": "A String", # Output only. The file name of the malware sample.
  "fileType": "A String", # Output only. The file type of the malware sample.
  "finalVerdict": "A String", # Output only. The final verdict of the malware sample.
  "name": "A String", # Output only. Identifier. The relative name of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}`. Where `{wildfire_verdict_change_request_id}` is an ID in the format `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
  "newVerdict": "A String", # Required. The suggested verdict to apply to the malware sample.
  "oldVerdict": "A String", # Output only. The original verdict of the malware sample.
  "resolutionTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was resolved.
  "sha256": "A String", # Required. The SHA256 hash ([FIPS 180-4](https://csrc.nist.gov/publications/detail/fips/180/4/final)) of the malware sample that requires a verdict change.
  "sourceRegion": "A String", # Output only. The region of the file associated with the malware sample.
  "state": "A String", # Output only. The review state of the `WildfireVerdictChangeRequest`.
  "updateTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was last updated.
  "wildfireVerdictChangeRequestId": "A String", # Output only. The ID of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
}
get(name, x__xgafv=None) 
Gets an Advanced malware sandbox verdict change request in a given firewall endpoint in an organization and location.

Args:
  name: string, Required. The name of the `WildfireVerdictChangeRequest` to retrieve. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}`. Where `{wildfire_verdict_change_request_id}` is an ID in the format `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Message for an Advanced malware sandbox verdict change request (`WildfireVerdictChangeRequest`).
  "comment": "A String", # Required. The justification for the verdict change request. The maximum length is 2048 characters.
  "createTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was created.
  "fileName": "A String", # Output only. The file name of the malware sample.
  "fileType": "A String", # Output only. The file type of the malware sample.
  "finalVerdict": "A String", # Output only. The final verdict of the malware sample.
  "name": "A String", # Output only. Identifier. The relative name of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}`. Where `{wildfire_verdict_change_request_id}` is an ID in the format `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
  "newVerdict": "A String", # Required. The suggested verdict to apply to the malware sample.
  "oldVerdict": "A String", # Output only. The original verdict of the malware sample.
  "resolutionTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was resolved.
  "sha256": "A String", # Required. The SHA256 hash ([FIPS 180-4](https://csrc.nist.gov/publications/detail/fips/180/4/final)) of the malware sample that requires a verdict change.
  "sourceRegion": "A String", # Output only. The region of the file associated with the malware sample.
  "state": "A String", # Output only. The review state of the `WildfireVerdictChangeRequest`.
  "updateTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was last updated.
  "wildfireVerdictChangeRequestId": "A String", # Output only. The ID of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
}
list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None) 
Lists the Advanced malware sandbox (WildFire) verdict change requests in a given firewall endpoint in an organization and location.

Args:
  parent: string, Required. Parent value for `ListWildfireVerdictChangeRequestsRequest`. The parent is a firewall endpoint resource. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}`. (required)
  filter: string, Optional. Filter expression to filter the results. Supported fields are: - `sha256` (string, equality only, for example, `sha256 = "..."`) - `state` (enum, equality only, valid values are `OPEN`, `CLOSED`, or `PENDING`, for example, `state = "PENDING"`) - `create_time` (timestamp, comparisons, for example, `create_time >= "2026-01-01T00:00:00Z" AND create_time <= "2026-01-31T23:59:59Z"`). If filtering by `create_time`, you must specify both a start time and an end time. If `create_time` is not specified, the query defaults to the past 30 days.
  pageSize: integer, Optional. Requested page size. The server might return fewer items than requested. If unspecified, the server picks an appropriate default.
  pageToken: string, Optional. A page token, received from a previous `ListWildfireVerdictChangeRequests` call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to `ListWildfireVerdictChangeRequests` 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 `WildfireVerdictChangeRequest` resources.
  "nextPageToken": "A String", # A token that can be sent as `page_token` to retrieve the next page. If this field is omitted, there are no subsequent pages.
  "unreachable": [ # Unordered list. Locations that could not be reached.
    "A String",
  ],
  "wildfireVerdictChangeRequests": [ # The list of `WildfireVerdictChangeRequest` resources.
    { # Message for an Advanced malware sandbox verdict change request (`WildfireVerdictChangeRequest`).
      "comment": "A String", # Required. The justification for the verdict change request. The maximum length is 2048 characters.
      "createTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was created.
      "fileName": "A String", # Output only. The file name of the malware sample.
      "fileType": "A String", # Output only. The file type of the malware sample.
      "finalVerdict": "A String", # Output only. The final verdict of the malware sample.
      "name": "A String", # Output only. Identifier. The relative name of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `organizations/{organization}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}` or `projects/{project}/locations/{location}/firewallEndpoints/{firewall_endpoint}/wildfireVerdictChangeRequests/{wildfire_verdict_change_request_id}`. Where `{wildfire_verdict_change_request_id}` is an ID in the format `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
      "newVerdict": "A String", # Required. The suggested verdict to apply to the malware sample.
      "oldVerdict": "A String", # Output only. The original verdict of the malware sample.
      "resolutionTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was resolved.
      "sha256": "A String", # Required. The SHA256 hash ([FIPS 180-4](https://csrc.nist.gov/publications/detail/fips/180/4/final)) of the malware sample that requires a verdict change.
      "sourceRegion": "A String", # Output only. The region of the file associated with the malware sample.
      "state": "A String", # Output only. The review state of the `WildfireVerdictChangeRequest`.
      "updateTime": "A String", # Output only. The timestamp when the `WildfireVerdictChangeRequest` was last updated.
      "wildfireVerdictChangeRequestId": "A String", # Output only. The ID of the `WildfireVerdictChangeRequest`. This is a unique identifier generated by the third-party API. Format: `^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$`.
    },
  ],
}
list_next(previous_request, previous_response) 
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.