Tenant resources let you create, retrieve information about, modify, and delete tenants. The table below provides information about these resources.
Method |
Use |
Access |
Notes |
|
---|---|---|---|---|
tenant |
Retrieve information about a tenant |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
||
N/A |
Check for the existence of a tenant |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
|
|
tenant |
Modify a tenant |
•For an HCP tenant tenant-level user account with the administrator role •For the default tenant, system-level user account with the administrator role |
||
List |
Retrieve a list of the service plans that are available for the tenant to assign to its namespaces |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
Valid only if the tenant is configured to allow service plan selection. The listed service plans are identified by service plan name. In XML, each listed service plan is the value of an element named name. In JSON, the name in the name/value pair that lists the service plans is name. |
|
.../tenants/tenant-name/availableServicePlans/service-plan-name |
||||
available |
Retrieve information about a service plan that’s available for the tenant to assign to its namespaces |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
Valid only if the tenant is configured to allow service plan selection. |
|
chargeback |
Generate a chargeback report for a tenant |
|
Not valid for the default tenant. Supported output formats are XML, JSON, and CSV. For information about optional query parameters for generating chargeback reports, see Query parameters for generating chargeback reports. For information about chargeback reports, see About chargeback reports. |
|
consoleSecurity |
Retrieve the Tenant Management Console configuration for a tenant |
Tenant-level user account with the security role |
Not valid for the default tenant. |
|
Modify the Tenant Management Console configuration for a tenant |
Tenant-level user account with the security role |
|||
contactInfo |
Retrieve the contact information for a tenant |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
|
|
Modify the contact information for a tenant |
•For an HCP tenant, tenant-level user account with the administrator role •For the default tenant, system-level user account with the administrator role |
|
||
cors See cors data type |
PUT | Set the default CORS rules configuration for all namespaces owned by the tenant |
•System-level user account with the administrator role •Tenant-level user account with the administrator role |
If the default tenant-level CORS configuration is set, it is applicable for all namespaces that do not have a namespace-level CORS configuration. |
GET | Retrieve the default CORS configuration for all namespaces owned by the tenant |
•System-level user account with the monitor or administrator role •Tenant-level user account with the monitor or administrator role |
||
DELETE | Delete the default CORS configuration for all namespaces owned by the tenant |
•System-level user account with the administrator role •Tenant-level user account with the administrator role |
If the resource does not have a default CORS configuration, the HTTP status code 404 Not Found is returned. | |
email |
Retrieve the email notification configuration for a tenant |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the with the monitor or administrator role |
|
|
POST |
Modify the email notification configuration for a tenant |
•For an HCP tenant, tenant-level user account with the administrator role •For the default tenant, system-level user account with the administrator role |
|
|
namespace |
Retrieve the default settings for namespace creation for a tenant |
Tenant-level user account with the monitor or administrator role |
Not valid for the default tenant. |
|
Modify the default settings for namespace creation for a tenant |
Tenant-level user account with the administrator role |
|||
List |
Retrieve the list of permissions in the data access permission mask for a tenant |
•For an HCP tenant, tenant-level user account with the monitor, administrator, or compliance role •For the default tenant, system-level user account with the monitor, administrator, or compliance role |
For the format of the permission list, see Permission lists. |
|
List |
Modify the list of permissions in the data access permission mask for a tenant |
•For an HCP tenant, tenant-level user account with the administrator role •For the default tenant, system-level user account with the administrator role |
Valid values for permissions are: •DELETE •PRIVILEGED •PURGE •READ •SEARCH •WRITE These values are case sensitive. For the format of the permission list, see Permission lists. The set of permissions specified in the request body replaces the set of permissions currently included in the data access permission mask for the tenant. To remove all permissions, specify an empty list. If the set of permissions includes PURGE, delete permission is enabled automatically. If the set of permissions includes SEARCH, read permission is enabled automatically. |
|
searchSecurity |
Retrieve the Search Console configuration for a tenant |
Tenant-level user account with the security role |
Not valid for the default tenant. |
|
Modify the Search Console configuration for a tenant |
Tenant-level user account with the security role |
|||
statistics |
Retrieve statistics about the content of the namespaces owned by a tenant |
•For an HCP tenant, tenant-level user account with the monitor or administrator role •For the default tenant, system-level user account with the monitor or administrator role |
|
© 2015, 2020 Hitachi Vantara LLC. All rights reserved.