The request timeout, in seconds (default:300.0). If the request takes longer than the timeout, aTimeoutErroris raised. The maximum allowed timeout is1800seconds.
body
If present, the request body (it is rare but allowed to send body in a DELETE request).
headers
The HTTP request headers. If present, must be a map of strings.
query
Optional query parameters. If present, must be a map that will get URL-encoded and appended to the URL. The map values must be strings, ints, floats, booleans, or lists of those.
auth
Optional authentication properties. If present, must be a map withtypeattribute in["OIDC", "OAuth2"]. Ascopeskey is also supported. For details, seeMake authenticated requests to Google Cloud APIs.
private_service_name
string
If present,private_service_namemust be a string that specifies a registered Service Directory service name with formatprojects/my-project/locations/us-east1/namespaces/my-namespace/services/my-service.
ca_certificate
bytes
If present,ca_certificatemust be a bytes value describing a custom CA certificate in DER format that will be used in place of the standard certificate pool. The certificate must be signed by a subject alternative name as defined byRFC 3280.
Returns
The HTTP response as a map withbody,code(status code), andheadersattributes.
Raised exceptions
Exceptions
ConnectionError
In case of a network problem (DNS failure, truncated response, etc.).
ConnectionFailedError
When the connection is halted during transfer (failed connection, refused connection, etc.).
TimeoutError
When the specified timeout is reached before the response is received.
HttpError
If the response status is >= 400.
ValueError
If timeout is > 1800. If the URL is invalid or if authType is present and URL is invalid for the given authType. If the private_service_name is invalid. If private_service_name is present and URL contains a port. If ca_certificate is present but not of type bytes.
Examples
# Make a `DELETE` request to an external HTTP endpoint-delete_resource:call:http.deleteargs:url:https://www.example.com/endpointresult:message-return_value:return:${message.body}
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2026-04-17 UTC."],[],[]]
