Skip to main content

api_applications

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

Overview​

Nameapi_applications
TypeResource
Idovh.me.api_applications

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
namestringName of this application
application_idintegerID of this Application (wire: applicationId)
application_keystringKey of this application (wire: applicationKey)
descriptionstringDescription of this application
statusstringStatus of this application (active, blocked, inactive, trusted)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectapplication_idRetrieve information about an application
listselectx_pagination_modeRetrieve all applications
deletedeleteapplication_idDelete an application. It will revoke all credential belonging to this application

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
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
application_idintegerApplication ID (wire: applicationId)
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Retrieve information about an application

SELECT
name,
application_id,
application_key,
description,
status
FROM ovh.me.api_applications
WHERE application_id = '{{ application_id }}' -- required
;

DELETE examples​

Delete an application. It will revoke all credential belonging to this application

DELETE FROM ovh.me.api_applications
WHERE application_id = '{{ application_id }}' --required
;