Skip to main content

invocations

Creates, updates, deletes, gets or lists an invocations resource.

Overview​

Nameinvocations
TypeResource
Idnvidia.nvcf_invocation.invocations

Fields​

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
invokeexecfunction_id, bodyNVCF-INPUT-ASSET-REFERENCES, NVCF-POLL-SECONDSDeprecated and will be removed soon. Please use the new NVCF Invocation API endpoint to invoke a function. Invokes the specified function that was successfully deployed. If the version is not specified, any active function versions will handle the request. If the version is specified in the URI, then the request is exclusively processed by the designated version of the function. By default, this endpoint will block for 5 seconds. If the request is not fulfilled before the timeout, it's status is considered in-progress or pending and the response includes HTTP status code 202 with an invocation request ID, indicating that the client should commence polling for the result using the invocation request ID. Access to this endpoint mandates inclusion of a bearer token with 'invoke_function' scope in the HTTP Authorization header. Additionally, this endpoint has the capability to provide updates on the progress of the request, contingent upon the workload's provision of such information. In-progress responses are returned in order. If no in-progress response is received during polling you will receive the most recent in-progress response. Only the first 256 unread in-progress messages are kept.
invoke_versionexecfunction_id, version_id, bodyNVCF-INPUT-ASSET-REFERENCES, NVCF-POLL-SECONDSDeprecated and will be removed soon. Please use the new NVCF Invocation API endpoint to invoke a function. Invokes the specified function that was successfully deployed. If the version is not specified, any active function versions will handle the request. If the version is specified in the URI, then the request is exclusively processed by the designated version of the function. By default, this endpoint will block for 5 seconds. If the request is not fulfilled before the timeout, it's status is considered in-progress or pending and the response includes HTTP status code 202 with an invocation request ID, indicating that the client should commence polling for the result using the invocation request ID. Access to this endpoint mandates inclusion of a bearer token with 'invoke_function' scope in the HTTP Authorization header. Additionally, this endpoint has the capability to provide updates on the progress of the request, contingent upon the workload's provision of such information. In-progress responses are returned in order. If no in-progress response is received during polling you will receive the most recent in-progress response. Only the first 256 unread in-progress messages are kept.

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
function_idstring (uuid)
version_idstring (uuid)Function version id
NVCF-INPUT-ASSET-REFERENCESarray
NVCF-POLL-SECONDSinteger (int32)

Lifecycle Methods​

EXEC variables use wire (API) names.

Deprecated and will be removed soon. Please use the new NVCF Invocation API endpoint to invoke a function. Invokes the specified function that was successfully deployed. If the version is not specified, any active function versions will handle the request. If the version is specified in the URI, then the request is exclusively processed by the designated version of the function. By default, this endpoint will block for 5 seconds. If the request is not fulfilled before the timeout, it's status is considered in-progress or pending and the response includes HTTP status code 202 with an invocation request ID, indicating that the client should commence polling for the result using the invocation request ID. Access to this endpoint mandates inclusion of a bearer token with 'invoke_function' scope in the HTTP Authorization header. Additionally, this endpoint has the capability to provide updates on the progress of the request, contingent upon the workload's provision of such information. In-progress responses are returned in order. If no in-progress response is received during polling you will receive the most recent in-progress response. Only the first 256 unread in-progress messages are kept.

EXEC nvidia.nvcf_invocation.invocations.invoke
@function_id='{{ function_id }}' --required,
@NVCF-INPUT-ASSET-REFERENCES='{{ NVCF-INPUT-ASSET-REFERENCES }}',
@NVCF-POLL-SECONDS='{{ NVCF-POLL-SECONDS }}'
@@json=
'{
"body": "{{ body }}"
}'
;