Create Tenant Account

POST

https://nico-rest-api.nico.svc.cluster.local/v2/org/:org/nico/tenant/account

POST

/v2/org/:org/nico/tenant/account

$ curl -X POST https://nico-rest-api.nico.svc.cluster.local/v2/org/org/nico/tenant/account \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "tenantOrg": "rf43bbtnb9c5",
>   "infrastructureProviderId": "e94bcfda-f6cb-42e4-80ec-516811e5abbf"
> }'

1 {
2   "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
3   "infrastructureProviderId": "e94bcfda-f6cb-42e4-80ec-516811e5abbf",
4   "infrastructureProviderOrg": "xskkpgqpeakn",
5   "tenantId": null,
6   "tenantOrg": "rf43bbtnb9c5",
7   "tenantContact": {
8     "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
9     "email": "janed@nvidia.com",
10     "firstName": "Jane",
11     "lastName": "Doe",
12     "created": "2019-08-24T14:15:22Z",
13     "updated": "2019-08-24T14:15:22Z"
14   },
15   "allocationCount": 0,
16   "status": "Pending",
17   "statusHistory": [
18     {
19       "status": "Pending",
20       "message": "Request received, pending processing",
21       "created": "2019-08-24T14:15:22Z",
22       "updated": "2019-08-24T14:15:22Z"
23     }
24   ],
25   "created": "2019-08-24T14:15:22Z",
26   "updated": "2019-08-24T14:15:22Z"
27 }

Create a Tenant Account.

Org must have an Infrastructure Provider entity. User must have authorization role with PROVIDER_ADMIN suffix. The Infrastructure Provider is inferred from the caller’s org; the deprecated infrastructureProviderId request body field is optional and, when provided, must match the org’s Infrastructure Provider.

Infrastructure Provider can create a Tenant Account by specifying the Tenant’s UUID or Tenant’s org name. This sets the Tenant Account status to “Invited”. The Tenant can then view the account information and accept the account by updating the Tenant Account.

Create a Tenant Account. Org must have an Infrastructure Provider entity. User must have authorization role with `PROVIDER_ADMIN` suffix. The Infrastructure Provider is inferred from the caller's org; the deprecated `infrastructureProviderId` request body field is optional and, when provided, must match the org's Infrastructure Provider. Infrastructure Provider can create a Tenant Account by specifying the Tenant's UUID or Tenant's org name. This sets the Tenant Account status to "Invited". The Tenant can then view the account information and accept the account by updating the Tenant Account.

Authentication

AuthorizationBearer

export JWT_BEARER_TOKEN="<jwt-bearer-token>"
# Example org name: "acme-inc
export ORG_NAME=<org-name>
# Use the JWT bearer token in your API request auth header:
curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current

``` export JWT_BEARER_TOKEN="<jwt-bearer-token>" # Example org name: "acme-inc export ORG_NAME=<org-name> # Use the JWT bearer token in your API request auth header: curl -v -X GET -H "Content-Type: application/json" -H "Authorization: Bearer $JWT_BEARER_TOKEN" https://nico-rest-api.nico.svc.cluster.local/v2/org/$ORG_NAME/nico/user/current ```

Path parameters

orgstringRequired

Name of the Org

Request

This endpoint expects an object.

tenantOrgstringRequiredformat: "^[A-Za-z0-9_-]+$">=1 character

Must be a valid Org name

infrastructureProviderIdstringOptionalformat: "uuid"Deprecated

Deprecated; inferred from the caller’s org Infrastructure Provider when omitted. When provided, the value must match the org’s Infrastructure Provider — mismatched values are rejected with 400.

Response

Created

idstringRead-onlyformat: "uuid"

Unique UUID v4 identifier for the Tenant Account

infrastructureProviderIdstringformat: "uuid"

ID of the Infrastructure Provider

infrastructureProviderOrgstring

Organization name of the Infrastructure Provider

tenantIdstring or nullformat: "uuid"

ID of the Tenant

tenantOrgstring or null

Org of the Tenant

tenantContactobject

Contact user for the Tenant

allocationCountinteger

Number of Allocations for the Tenant Account

statusenum

Status of the Tenant Account

statusHistorylist of objects

Chronological status history for the Tenant Account

createddatetimeRead-only

Date/time when the Tenant Account was created

updateddatetimeRead-only

Date/time when the Tenant Account was last updated

Errors

400

Bad Request Error

403

Forbidden Error