Update Tenant

Details

API Details
Name

Update Tenant

Description

Updates the configured details for this tenant based on the specified Tenant ID.

MethodPUT
URI/v1/tenants/tenantId
CloudCenter Release
  • Introduced in CloudCenter 4.0.
  • The minAppFeeRate, ccTransactionFeeRate, revShareRate, and enableConsolidatedBilling attributes are deprecated.
Notes
  • For additional context on <PORT> usage in the following example(s), see Base URI Format.
    Upload the logo image before creating a service (see Upload Logo). If you do not upload a logo and provide the existing logo path (loginLogo or homepageLogo) prior to creating a tenant, then the logo image from the currently-provided path is deleted and this logo image is moved to another location after the tenant is created.
ESB Headeraction: update.tenants.tenantId

Example

curl -k -X PUT -H "Accept: application/json" -H "Content-Type: application/json" -u cloudcenteradmin:40E45DBE57E35ECB "https://<HOST>:<PORT>/v1/tenants/7"

Request Body

Enable monthly billing for this tenant:

{
    "id": 7,
    "userId": "22",
    "parentTenantId": 1,
    "name": "Company07, Inc",
    "shortName": "Company07",
    "domainName": "vt01-06.Company07.com",
    "phone": "18005536387",
    "externalId": "",
    "url": "http://www.company07.com",
    "contactEmail": "admin@company07.com",
    "about": "",
    "termsOfService": "",
    "privacyPolicy": "",
    "loginLogo": "/assets/vendors/6/img/logo.png",
    "homePageLogo": "/assets/vendors/6/img/logo-loggedin.png",
    "enablePurchaseOrder": true,
    "enableEmailNotificationsToUsers": true,
    "enableMonthlyBilling": false,
    "defaultChargeType": "Hourly",
    "preferences": [
        {
            "name": "PASSWORD_MIN_LENGTH",
            "value": "5"
        },
        {
            "name": "PASSWORD_EXPIRATION_DAYS",
            "value": "8"
        },
        {
            "name": "PASSWORD_DISABLE_SELF_RESET",
            "value": "true"
        },
        {
            "name": "PASSWORD_REQUIRE_LOWERCASE",
            "value": "true"
        }
    ],
    "defaultActivationProfileId": "7",
    "activationCodes": [
        {
            "tenantId": "7",
            "name": "Self SignUp Users",
            "activationProfileId": "7"
        }
    ],
    "firewallProfiles": [
        {
            "tenantId": 7,
            "name": "Application VM",
            "description": "Firewall rules for job instances",
            "firewallRules": [
                {
                    "protocol": "tcp",
                    "fromPort": "80",
                    "toPort": "80",
                    "sourceIPRanges": [
                        "0.0.0.0/0"
                    ],
                    "cloudId": "1"
                }
            ]
        }
    ]
}

 

Response

{
    "id": "7",
    "resource": "https://<HOST>:<PORT>/v1/tenants/7",
    "perms": [],
    "name": "Company07, Inc",
    "url": "http://www.company07.com",
    "about": "",
    "contactEmail": "admin@company07.com",
    "phone": "18005536387",
    "userId": "22",
    "termsOfService": "",
    "privacyPolicy": "",
    "revShareRate": 0,
    "ccTransactionFeeRate": 0,
    "minAppFeeRate": 0,
    "shortName": "Company07",
    "enablePurchaseOrder": true,
    "enableEmailNotificationsToUsers": true,
    "parentTenantId": 1,
    "externalId": "",
    "defaultActivationProfileId": "7",
    "enableMonthlyBilling": false,
    "defaultChargeType": "Hourly",
    "loginLogo": "/assets/vendors/7/img/logo.png",
    "homePageLogo": "/assets/vendors/7/img/logo-loggedin.png",
    "domainName": "vt01-06.Company07.com",
    "activationCodes": [
        {
            "tenantId": "7",
            "name": "Self SignUp Users",
            "activationProfileId": "7"
        }
    ],
    "firewallProfiles": [
        {
            "tenantId": "7",
            "name": "Application VM",
            "description": "Firewall rules for job instances",
            "firewallRules": [
                {
                    "protocol": "tcp",
                    "fromPort": "80",
                    "toPort": "80",
                    "sourceIPRanges": [
                        "0.0.0.0/0"
                    ],
                    "cloudId": "1"
                }
            ]
        }
    ],
    "preferences": [
        {
            "name": "PASSWORD_MIN_LENGTH",
            "value": "5"
        },
        {
            "name": "PASSWORD_DISABLE_SELF_RESET",
            "value": "true"
        },
        {
            "name": "PASSWORD_REQUIRE_LOWERCASE",
            "value": "true"
        },
        {
            "name": "PASSWORD_EXPIRATION_DAYS",
            "value": "8"
        }
    ],
    "user": {
        "id": "22",
        "resource": "https://<HOST>:<PORT>/v1/tenants/7/users/22,
        "perms": [],
        "username": "admin_m",
        "password": "===redacted===",
        "enabled": true,
        "type": "TENANT",
        "firstName": "Admin",
        "lastName": "Company07",
        "companyName": "Company07, Inc",
        "tenantId": "7",
        "emailAddr": "admin@company07.com",
        "emailVerified": true,
        "phoneNumber": "18005536387",
        "externalId": "",
        "accessKeys": "https://<HOST>:<PORT>/v1/users/22/keys",
        "disableReason": null,
        "accountSource": "AdminCreated",
        "status": "ENABLED",
        "detail": null,
        "activationData": null,
        "created": 1439699960000,
        "lastUpdated": 1439699960000,
        "coAdmin": false
    }
}

 

Request Attributes

tenantId
  • DescriptionUnique, system-generated identifier for the tenant organization. A tenant admin must belong to this tenant to invoke any APIs for this tenant. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.

  • Type: String

Required

id
  • DescriptionUnique, system-generated identifier for this CloudCenter Resource.

  • Type: String
userId
  • Description: Unique, system-generated identifier for a user
  • Type: String
parentTenantId
  • Description: Unique, system-generated identifier for the parent tenant organization
  • Type: Integer
name
  • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

  • Type: String

shortName
  • Description: Unique short version of this tenant's name to be used in the Login page. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.
  • Type: String
domainName
  • Description: DNS domain name for this tenant organization. Valid characters are letters, numbers, hyphens, and underscores. See Add Sub-TenantsTenant ID and Tenant Name Dependency for additional details. The behavior for this attribute differs based on it being a request or a response:
    • API Request: If the suffix company07.com is present in the CCM property file, and requiredname.company07.com is required dnsName, the domainName attribute should only contain the value requiredname.
    • API Response: The domainName attribute  displays requiredname.company07.com.
  • Type: String
phone
  • DescriptionThe phone number for this tenant organization 
  • Type: String
externalId
  • DescriptionIdentity provider ID for external access (for example, SSO). This value must match the corresponding user's SAML subject Name ID value. Defaults to empty string if not set.
  • Type: String
url
  • Description: The URL that is associated with the tenant's marketing website. See  Add Sub-TenantsTenant ID and Tenant Name Dependency for additional details.

    This is not the URL to access the CloudCenter platform

  • Type: String
contactEmail
  • Description: The contact email address for this tenant organization
  • Type: String
about
  • Description: Additional information about the tenant organization
  • Type: String
termsOfService
  • Description: The text of this contract
  • Type: String
privacyPolicy
  • Description: Privacy policy of the tenant organization
  • Type: String
  • Description: URL of a saved image to be displayed as the logo on the Login page of the CCM uploading logos. See Upload Logo for additional context.
  • Type: String
  • Description: URL of a saved image to be displayed as the logo on the CCM home page after the user has logged into the CloudCenter platform. See Upload Logo for additional context.
  • Type: String
  • Type: Boolean
enableEmailNotificationsToUsers
  • Description: Indicates if the invoice email at the end of each month must be sent to tenant users.
    • true = Email messages should be sent to users
    • false = email messages should not be sent to users
  • Type: Boolean
enableMonthlyBilling
  • Description: Indicates whether monthly billing should be enabled for this tenant. See Tenant Billing for additional context.
    • true = Enable monthly billing for this tenant
    • false = Do not enable monthly billing for this tenant
  • Type: Boolean
defaultChargeType
  • DescriptionThe default charge type for this account.  
  • Type: Enumeration

    EnumerationDescription
    HOURLYDefault, if not included in the request. See Tenant Billing for additional context.
    MONTHLYSee Tenant Billing for additional context.
preferences
  • Description: Identifies the preferences set for all uses within a tenant
  • Type: Array of name-value pairs

    name
    • Description: Tenant administrators can specify password rules. If specified, these rules are enforced for all users within the specified tenant. Effective Cloud Center 4.6.1, the CloudCenter platform enforces a minimum password length of 5 characters for all settings. See Add Sub-Tenants > User Password Rules for additional context
    • Type: Enumeration

      EnumerationDescription
       PASSWORD_MIN_LENGTH

      Specify the minimum length for password
      Default = 5

       PASSWORD_REQUIRE_UPPERCASERequire at least one uppercase character in every password
      Default = false
      PASSWORD_REQUIRE_LOWERCASERequire at least one lowercase character in every password
      Default = false
      PASSWORD_REQUIRE_DIGIT Require at least one digit in every password
      Default = false
      PASSWORD_REQUIRE_SPECIAL_CHARACTER Require at least one special character in every password
      Default = false
       PASSWORD_DISABLE_SELF_RESET Disable the users ability to reset their own passwords
      Default = false
      PASSWORD_EXPIRATION_DAYSSpecify that the password expires in X number of days

      Default = null

     

    value
    • Description: Indicates the set value for this property
    • Type: Float
defaultActivationProfileId
  • Description: Activation profile ID to use when activating a user if another activation profile ID is not specified. See Map an Activation Profile for additional context.
  • Type: String
activationCodes
  • Description: Information about the activated user
  • Type: Sequence of name-value pairs

    tenantId
    • DescriptionUnique, system-generated identifier for the tenant organization. A tenant admin must belong to this tenant to invoke any APIs for this tenant. See Add Sub-Tenants > Tenant ID and Tenant Name Dependency.

    • Type: String
    name
    • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

    • Type: String

    activationProfileId
    • Description: Unique, system-generated identifier for the activationProfile
    • Type: String
firewallProfiles (click for additional details)

Response Attributes

All configured attributes for the tenant.