How do I call the tenants endpoints over HTTP?

Table of Contents

This file documents the tenants resource over HTTP, one section per endpoint. Every section exports its own Hurl file into projects/ores.http/scripts/library/. Running a file sends that one request, so a failure names the endpoint it came from.

1. Endpoints

1.1. GET /api/v1/tenancy/tenants

List tenants. It needs a session.

It forwards to iam.v1.tenants.list.

The request is:

GET /api/v1/tenancy/tenants
GET {{base_url}}/api/v1/tenancy/tenants
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.2. GET /api/v1/tenancy/tenants/__none__

Get one tenant. It needs a session.

It forwards to iam.v1.tenants.get.

The request is:

GET /api/v1/tenancy/tenants/__none__
GET {{base_url}}/api/v1/tenancy/tenants/__none__
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.3. POST /api/v1/tenancy/tenants/get-many

Get many tenants. It needs a session.

It forwards to iam.v1.tenants.get_many.

The request is:

POST /api/v1/tenancy/tenants/get-many
POST {{base_url}}/api/v1/tenancy/tenants/get-many
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.4. POST /api/v1/tenancy/tenants

Create one tenant. It needs a session.

It forwards to iam.v1.tenants.put.

The request is:

POST /api/v1/tenancy/tenants
POST {{base_url}}/api/v1/tenancy/tenants
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.5. PUT /api/v1/tenancy/tenants

Replace one tenant. It needs a session.

It forwards to iam.v1.tenants.put.

The request is:

PUT /api/v1/tenancy/tenants
PUT {{base_url}}/api/v1/tenancy/tenants
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.6. POST /api/v1/tenancy/tenants/put-many

Write many tenants. It needs a session.

It forwards to iam.v1.tenants.put_many.

The request is:

POST /api/v1/tenancy/tenants/put-many
POST {{base_url}}/api/v1/tenancy/tenants/put-many
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.7. DELETE /api/v1/tenancy/tenants/__none__

Delete one tenant. It needs a session.

It forwards to iam.v1.tenants.delete.

The request is:

DELETE /api/v1/tenancy/tenants/__none__
DELETE {{base_url}}/api/v1/tenancy/tenants/__none__
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.8. POST /api/v1/tenancy/tenants/delete-many

Delete many tenants. It needs a session.

It forwards to iam.v1.tenants.delete_many.

The request is:

POST /api/v1/tenancy/tenants/delete-many
POST {{base_url}}/api/v1/tenancy/tenants/delete-many
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.9. GET /api/v1/tenancy/tenants/__none__/versions

List the recorded versions of one tenant. It needs a session.

It forwards to iam.v1.tenants_versions.list.

The request is:

GET /api/v1/tenancy/tenants/__none__/versions
GET {{base_url}}/api/v1/tenancy/tenants/__none__/versions
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

1.10. GET /api/v1/tenancy/tenants/__none__/versions/0

Get one recorded version of one tenant. It needs a session.

It forwards to iam.v1.tenants_versions.get.

The request is:

GET /api/v1/tenancy/tenants/__none__/versions/0
GET {{base_url}}/api/v1/tenancy/tenants/__none__/versions/0
Accept: application/json
Authorization: Bearer {{token}}
HTTP 200

Emacs 29.3 (Org mode 9.6.15)