Files
nexus/knowledgebase/csd-wiki/ICSD/ESM-SaaS-Tenant-Provision-Automation-API-Document_686070458.md

454 lines
25 KiB
Markdown

# ESM-SaaS-Tenant-Provision-Automation-API-Document_686070458
## Introduction
ESM SaaS products include SMAX, CMS, OO, HCMX, etc. All these products are automatically deployed on AWS through a set of AWS lambda functions.
These functions are triggered by calling the API interface of each function. They will execute the internal APIs of ESM SaaS one by one to complete the configuration work.
This is a detailed description of the steps to perform.
## SMAX tenant provisioning
### Customer creation
This function is for creating a Customer in the BO.
- **URI****:** https://{SMAX\_FQDN}/x4x/lambda/customerCreation
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Create a **Customer** | POST | {SMAX\_FQDN}/bo/rest/entities/customer |
### Tenant creation
This function is for deploying a tenant in the BO and creating associated admin users and SMAX licenses.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantCreation
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Greate an **Account** | POST | {SMAX\_FQDN}/bo/rest/entities/account |
| 3 | Create a tenant | POST | {SMAX\_FQDN}/bo/rest/entities/tenant |
| 4 | Create an admin user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 5 | Create a customer user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 6 | Attach the users to the tenant | PUT | {SMAX\_FQDN}/bo/rest/entities/user/attachOrRemove |
| 7 | Set the admin user as the tenant owner | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID} |
| 8 | Create a license | POST | {SMAX\_FQDN}/bo/rest/entities/license |
| 9 | Assign license to the tenant | POST | {SMAX\_FQDN}/bo/rest/license activities/assign |
| 10 | Deploy the tenant | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/deploy |
### Tenant status
This function is for checking or editing the status of a tenant.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantStatus
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get the tenant status | GET | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID} |
| 3 | Update the tenant status | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID} |
### Tenant Google Analytics switch
This function is for enable/disable the google analytics for the tenant.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/GATrackingId
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Set Google Analytics tracking ID | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/GA\_TRACKING\_ID |
| 3 | Enable or Disable Google Analytics | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_GA |
### Put authorization principal to the customer user
This function is for grant a SMAX role on a customer user.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/setPermission
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Get the current authorization principal | GET | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/rms/AuthorizationPrincipalResourceJSON?filter=UserId+=+'{customerEmail}' |
| 3 | Put the new authorization principal | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/rms/AuthorizationPrincipalResourceJSON/{resourceId} |
### Deploy SMAX demo data
This function is for deploying the SMAX demo data.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/smaxDemoData
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Validate SMAX Demo Data | GET | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/ess/deployment/validateDemoDataNotDeployed |
| 3 | Deploy SMAX Demo Data | GET | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/ess/deployment/deployBetaData |
### Enable self-password reset
This function is for enable self-password reset function.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/selfPasswordReset
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the IDM auth token | POST | {SMAX\_FQDN}/idm-service/v3.0/tokens |
| 2 | PUT self-password reset metadata | PUT | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/metadata |
### Disable notification service
This function is for disable the notification service of a tenant.
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/emailService
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Disable notification service | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/NOTIFICATION\_SERVICE\_ENABLED |
### Set CMS client download link
This function is for set CMS download link in the integration configuration page
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/cmsDownloadLink
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the integration user's auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Set CMS client's download link | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/TenantSettings/settings/CMS\_DOWNLOAD\_SERVICE |
### Set OO client download link
This function is for set OO download link in the integration configuration page
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/ooDownloadLink
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the integration user's auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Set OO client's download link | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/TenantSettings/settings/OO\_DOWNLOAD\_SERVICE |
### Update navigation trusted domain
This function is for update navigation trusted domain of the tenant
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantConfig/navigationTrustedDomain
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?tenantId={ESM\_TENANT\_ID} |
| 2 | Update the navigation trusted domain | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/NavigationTrustedDomains |
### Tenant deletion
This function is for delete tenant
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/tenantDeletion
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get the tenant | GET | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID} |
| 3 | Update tenant to inactive | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID} |
| 4 | Delete the tenant | DELETE | {SMAX\_FQDN}/bo/rest/entities/tenant |
### Account deletion
This function is for delete account
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/accountDeletion
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get the users of the account | GET | {SMAX\_FQDN}/bo/rest/entities/user?timeStamp={{NOW}}&filter=((account+eq+"{{accountId}}")+and+((name+nin+"bo-integration@ [dummy.com](http://dummy.com/),saw-integration-internal@ [dummy.com](http://dummy.com/),saw-integration-external@ [dummy.com](http://dummy.com/) ")+or+(idmOrganization+neq+"sysbo")))&offset=0&limit=100 |
| 3 | Delete the users | DELETE | {SMAX\_FQDN}/bo/rest/entities/user |
| 4 | Delete the tenant | DELETE | {SMAX\_FQDN}/bo/rest/entities/account |
## CMS Tenant provisioning
### CMS tenant creation
This function is for creating a CMS tenant
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cmsCustomerCreation
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the CMS auth token | POST | {CMS\_FQDN}/cms-gateway/urest/v1/1/authentication?target=cms |
| 2 | Create a CMS tenant | POST | {CMS\_FQDN}/cms-gateway/urest/v1/tenants |
### CMS tenant post-configuration
This function is for post-config after the CMS tenant creation
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cmsGroupCreation
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the ucmdb auth token | POST | {CMS\_FQDN}/ucmdb-server/rest-api/authenticate |
| 2 | Get CMS internal license | GET | {CMS\_FQDN}/ucmdb-server/rest-api/uiserver/license/capacity |
| 3 | Allocate license to the CMS tenant | PATCH | {CMS\_FQDN}/ucmdb-server/rest-api/uiserver/license/customers/{ESM\_TENANT\_ID}/capacity |
| 4 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 5 | Create the CMS admin user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 6 | Create the CMS integration user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 7 | Attach the CMS users to the tenant | PUT | {SMAX\_FQDN}/bo/rest/entities/user/attachOrRemove |
| 8 | Get the IDM auth token | POST | {SMAX\_FQDN}/idm-service/v3.0/tokens |
| 9 | Create an IDM Group for CMS | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups |
| 10 | Bind the CMS admin role to the IDM group | PUT | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/roles/SuperAdmin/groups/{groupName} |
| 11 | Bind the CMS admin user to the IDM group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/{groupName}/members |
| 12 | Bind the CMS integration user to the IDM group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/{groupName}/members |
| 13 | Bind the customer user to the IDM group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/{groupName}/members |
### CMS tenant status
This function is for checking or stopping a CMS tenant
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cmsCustomerStatus
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the CMS auth token | POST | {CMS\_FQDN}/cms-gateway/urest/v1/1/authentication?target=cms |
| 2 | Get the CMS tenant | GET | {CMS\_FQDN}/cms-gateway/urest/v1/tenants/{cmsCustomerId} |
| 3 | Get the ucmdb auth token to stop tenant | POST | {CMS\_FQDN}/ucmdb-server/rest-api/authenticate |
| 4 | Stop the CMS tenant | PUT | {CMS\_FQDN}/ucmdb-server/rest-api/customers/{cmsCustomerId} |
### CMS tenant deletion
This function is for delete a CMS tenant
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cmsCustomerDeletion
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the ucmdb auth token | POST | {CMS\_FQDN}/ucmdb-server/rest-api/authenticate |
| 2 | Delete the CMS tenant | DELETE | {CMS\_FQDN}/ucmdb-server/rest-api/customers/{cmsCustomerId} |
### Native SACM enablement
This function is for enable Native SACM
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/sacmEnablement
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Deploy the Native SACM | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/sam |
| 3 | Enable the Native SACM | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/forceEnable |
### SAM enablement
This function is for enable SAM
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/samEnablement
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Pre-check the SAM capability deployment | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities/readiness |
| 3 | Deploy the SAM capability | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Enable the SAM capability | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
## OO enablement
### OO capability creation
This function is for creating OO capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/ooEnablement/createOO
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Pre-check the OO capability deployment | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities/readiness |
| 3 | Deploy the OO capability | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Create the OO integration user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 5 | Attach the integration user to the tenant | PUT | {SMAX\_FQDN}/bo/rest/entities/user/attachOrRemove |
### OO capability enablement
This function is for enable OO capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/ooEnablement/enableOO
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get the OO deployment status | GET | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 3 | Enable the OO capability | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Get the IDM auth token | POST | {SMAX\_FQDN}/idm-service/v3.0/tokens |
| 5 | Bing the customer user to the OO admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/OO\_ADMINISTRATORS/members |
| 6 | Bing the integration user to the OO admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/OO\_ADMINISTRATORS/members |
| 7 | Get the OO internal license | POST | {OO\_FQDN}/autopass/wsservices/v11/license/view |
| 8 | Assign the OO license to the tenant | POST | {OO\_FQDN}/autopass/services/v12/tenant/license/assign |
| 9 | Change the min/max pool size | PATCH | {OO\_FQDN}/oocontroller/rest/v1/tenants/{ESM\_TENANT\_ID} |
## DND enablement
### DND capability creation
This function is for creating DND capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/dndEnablement/createDND
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Pre-check the DND capability deployment | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities/readiness |
| 3 | Create the DND admin user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 4 | Create the DND transport user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 5 | Attach the users to the tenant | PUT | {SMAX\_FQDN}/bo/rest/entities/user/attachOrRemove |
| 6 | Deploy the DND capability | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
### DND capability enablement
This function is for enable DND capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/dndEnablement/enableDND
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get the DND deployment status | GET | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 3 | Enable the DND capability | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Assign the DND license to the tenant | POST | {SMAX\_FQDN}/bo/rest/licenseActivities/assign |
| 5 | Get the IDM auth token | POST | {SMAX\_FQDN}/idm-service/v3.0/tokens |
| 6 | Bing the SMAX admin user to the CS admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/CS\_ADMINISTRATORS/members |
| 7 | Bing the customer user to the CS admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/CS\_ADMINISTRATORS/members |
| 8 | Bing the customer user to the DND admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/DND\_ADMINISTRATORS/members |
## CGRO enablement
### CGRO capability creation
This function is for creating CGRO capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cgroEnablement/createCGRO
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Pre-check the CGRO capability deployment | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities/readiness |
| 3 | Create the CGRO admin user | POST | {SMAX\_FQDN}/bo/rest/entities/user |
| 5 | Attach the user to the tenant | PUT | {SMAX\_FQDN}/bo/rest/entities/user/attachOrRemove |
| 6 | Deploy the CGRO capability | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
### CGRO capability enablement
This function is for enable CGRO capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/cgroEnablement/enableCGRO
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Get CGRO deployment status | GET | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 3 | Enable CGRO capability | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Get the IDM auth token | POST | {SMAX\_FQDN}/idm-service/v3.0/tokens |
| 5 | Bing the SMAX admin user to the CGRO admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/CGRO\_ADMINISTRATORS/members |
| 6 | Bing the customer user to the CGRO admin group | POST | {SMAX\_FQDN}/idm-service/api/scim/organizations/{ESM\_TENANT\_ID}/groups/CGRO\_ADMINISTRATORS/members |
## ITOM Aviator enablement
### ITOM Aviator enablement
This function is for enable ITOM Aviator capability
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/aviatorEnablement
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the BO auth token | POST | {SMAX\_FQDN}/bo/rest/auth/token |
| 2 | Pre-check the ITOM Aviator capability deployment | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities/readiness |
| 3 | Deploy the ITOM Aviator capability | POST | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
| 4 | Enable the ITOM Aviator capability | PUT | {SMAX\_FQDN}/bo/rest/entities/tenant/{ESM\_TENANT\_ID}/capabilities |
## HCMX FinOps
### Tenant key chain generation
This function is for the key chain for the HCMX FinOps
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/keychain
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Generate tenant key chain | POST | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/encryption/tenant\_key\_chain |
| 3 | Get tenant key chain for the validation | GET | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/encryption/tenant\_key\_chain/{ESM\_TENANT\_ID}/status |
### Application settings
This function is for updating the application settings of the HCMX FinOps
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/appsettings
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Update the customization restriction policy | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/CustomizationRestrictionPolicy |
| 3 | Update the experience mode | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_SMAXMENU\_MODE |
| 4 | Enable the CGRO integration | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_CGRO\_INTEGRATION |
| 5 | Enable the Service Design and Deployment | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_SERVICE\_DESIGNS |
| 6 | Enable the Operations Orchestration | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_MT\_OO\_INTEGRATION |
| 7 | Enable the Aggregation | PUT | {SMAX\_FQDN}/rest/{ESM\_TENANT\_ID}/common-settings/setting/ENABLE\_AGGREGATION\_NORTH\_STAR |
### Microsoft Azure capsules installation
This function is for installing the Microsoft Azure capsules
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/capsule\_azure
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Install Microsoft Azure 3.2.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 3 | Install Microsoft Azure 3.2.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/46501b17-6264-4698-97bb-cedca4d8a4e0/3.2.0 |
| 4 | Install Microsoft Azure 3.3.1 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 5 | Install Microsoft Azure 3.3.1 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/46501b17-6264-4698-97bb-cedca4d8a4e0/3.3.1 |
| 6 | Install Microsoft Azure 3.4.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 7 | Install Microsoft Azure 3.4.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/46501b17-6264-4698-97bb-cedca4d8a4e0/3.4.0 |
### Microsoft AWS capsules installation
This function is for installing the AWS capsules
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/capsule\_aws
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Install AWS 3.1.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 3 | Install AWS 3.1.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/cd27f32e-fddb-4d3f-baae-c2ac91b476ec/3.1.0 |
| 4 | Install AWS 3.2.1 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 5 | Install AWS 3.2.1 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/cd27f32e-fddb-4d3f-baae-c2ac91b476ec/3.2.1 |
### Microsoft GCP capsules installation
This function is for installing the GCP capsules
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/capsule\_gcp
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Install GCP 2.0.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 3 | Install GCP 2.0.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/4ffd2627-11e8-4194-ba35-92415fcc98b0/2.0.0 |
### Microsoft VMware capsules installation
This function is for installing the VMware capsules
- **URI:** https://{SMAX\_FQDN}/x4x/lambda/hcmxPostConfig/capsule\_vmware
- **Execution APIs:**
| No | Function | Method | URL Path |
| --- | --- | --- | --- |
| 1 | Get the SMAX auth token | POST | {SMAX\_FQDN}/auth/authentication-endpoint/authenticate/token?TENANTID={ESM\_TENANT\_ID} |
| 2 | Install VMware vCenter 19.0.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 3 | Install VMware vCenter 19.0.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{{ESM\_TENANT\_ID}}/content-packages/a88dd597-cea0-24a7-1921-e60066394a3e/19.0.0 |
| 4 | Install VMware vCenter 3.1.0 capsule | POST | {SMAX\_FQDN}/content-store-gateway/v1/{ESM\_TENANT\_ID}/content-packages/ |
| 5 | Install VMware vCenter 3.1.0 installation status | GET | {SMAX\_FQDN}/content-store-gateway/v1/{{ESM\_TENANT\_ID}}/content-packages/a9ea8c81-c3e8-4bd3-a3d4-146ea00c8be2/3.1.0 |