SendCustomRequest Method
Sends a custom request to the server.
Syntax
public func sendCustomRequest(httpMethod: String, keyName: String, versionId: String, action: String) throws -> Void
Remarks
This method can be used to send arbitrary requests to the server.
Valid values for HttpMethod are:
- GET (default if empty)
- HEAD
- POST
- PUT
- PATCH
- DELETE
KeyName and VersionId are optional. The former must be specified if the latter is specified; both are ignored if KeyRing is empty. Action is also optional.
When this method is called, the class does the following:
- Builds a request URL, including query parameters, like https://cloudkms.googleapis.com/v1/projects/{GoogleProjectId}/locations/{Location}[/keyRings/{KeyRing}[/cryptoKeys/{KeyName}[/cryptoKeyVersions/{VersionId}]]][{Action}] using:
- The GoogleProjectId, Location, and (if non-empty) KeyRing properties.
- The KeyName, VersionId, and Action parameters.
- All query parameters from QueryParam*.
- Adds an Authorization header with the value specified by Authorization.
- Adds any request headers from OtherHeaders.
- Adds any request body supplied via the specified InputFile or InputData.
- Sends the request to the server.
- Stores the response headers in the ParsedHeader* properties; and the response body in the specified OutputFile or OutputData.
If the response body is JSON data, the XPath, XText, and other X* configuration settings can then be used to navigate and extract information from it.