Skip to main content

alldoms

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

Overview​

Namealldoms
TypeResource
Idovh.domain_v2.alldoms

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idstringUnique identifier of the resource. Here, the AllDom name itself is used as an identifier.
checksumstringComputed hash used to control concurrent modification requests
current_stateobjectThe representation of the AllDom's current state (wire: currentState)
current_tasksarrayOngoing asynchronous tasks related to the AllDom resource (wire: currentTasks)
iamobjectIAM resource metadata
resource_statusstringReflects the readiness of the AllDom resource (CREATING, CREATION_PLANNED, DELETING, ERROR, OUT_OF_SYNC, READY, SUSPENDED, UNKNOWN, UPDATING) (wire: resourceStatus)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectalldom_nameGet an AllDom resource (Beta version)
listselectx_pagination_cursor, x_pagination_size, iam_tagsList all the AllDom resources (Beta version)

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
alldom_namestringAlldom name (wire: alldomName)
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"}})
iam_tagsobjectFilter resources on IAM tags (wire: iamTags)
x_pagination_cursorstringPagination cursor (wire: X-Pagination-Cursor)
x_pagination_sizeintegerPagination size (wire: X-Pagination-Size)

SELECT examples​

Get an AllDom resource (Beta version)

SELECT
id,
checksum,
current_state,
current_tasks,
iam,
resource_status
FROM ovh.domain_v2.alldoms
WHERE alldom_name = '{{ alldom_name }}' -- required
;