Skip to main content
ZStack
Resource Center/Network Service/Network Service Operations/Load Balancing Operations

ProvisionSlbInstance

ProvisionSlbInstance

PUT/zstack/v1/load-balancers/slb/instances/{uuid}/provision

Operation ID

ProvisionSlbInstance

Since

5.1.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

application/json

Path Parameters

  • uuid
    StringRequired

    Resource UUID.

Query Parameters

  • systemTags
    List

    Optional. The system tags.

  • userTags
    List

    Optional. The user tags.

Body Fields

  • slbInstanceUuid
    StringRequired

    The slb instance UUID.

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • success
    booleanRequired

    Whether the operation succeeded.

  • inventory
    CertificateInventoryRequired

    See inventory.

    • uuid
      StringRequired

      The UUID of the resource.

    • name
      StringRequired

      The name of the resource.

    • backendType
      StringRequired

      The backend type.

    • deployType
      StringRequired

      The deploy type.

    • slbOfferingUuid
      StringRequired

      The slb offering UUID.

    • description
      String

      Optional. The detailed description of the resource.

    • configVersion
      LongRequired

      The config version.

    • createDate
      TimestampRequired

      The creation date.

    • lastOpDate
      TimestampRequired

      The last operation date.

    • slbVms
      ListRequired

      See slbVms.

      • slbGroupUuid
        StringRequired

        The slb group UUID.

      • configVersion
        StringRequired

        The config version.

      • publicNetworkUuid
        StringRequired

        The public network UUID.

      • virtualRouterVips
        ListRequired

        The virtual router vips.

      • applianceVmType
        StringRequired

        The appliance VM instance type.

      • managementNetworkUuid
        StringRequired

        The management network UUID.

      • defaultRouteL3NetworkUuid
        StringRequired

        The default route L3 network UUID.

      • status
        StringRequired

        The resource status.

        • Pending
          SlbVmInstanceConfigTaskStatusRequired

          The Pending value.

        • Starting
          SlbVmInstanceConfigTaskStatusRequired

          The Starting value.

        • Success
          SlbVmInstanceConfigTaskStatusRequired

          The Success value.

        • Failed
          SlbVmInstanceConfigTaskStatusRequired

          The Failed value.

      • agentPort
        IntegerRequired

        The agent port.

      • haStatus
        StringRequired

        The HA status.

      • uuid
        StringRequired

        The resource UUID.

      • name
        StringRequired

        The resource name.

      • description
        StringRequired

        The detailed description of the resource.

      • zoneUuid
        StringRequired

        The zone UUID.

      • clusterUuid
        StringRequired

        The cluster UUID.

      • imageUuid
        StringRequired

        The image UUID.

      • hostUuid
        StringRequired

        The host UUID.

      • lastHostUuid
        StringRequired

        The last host UUID.

      • instanceOfferingUuid
        StringRequired

        The instance offering UUID.

      • rootVolumeUuid
        StringRequired

        The root volume UUID.

      • platform
        StringRequired

        The platform.

      • architecture
        StringRequired

        The architecture.

      • defaultL3NetworkUuid
        StringRequired

        The default L3 network UUID.

      • type
        StringRequired

        The resource type.

      • hypervisorType
        StringRequired

        The hypervisor type.

      • memorySize
        LongRequired

        The memory size.

      • reservedMemorySize
        LongRequired

        The reserved memory size.

      • cpuNum
        IntegerRequired

        The number of CPUs.

      • cpuSpeed
        LongRequired

        The CPU speed.

      • allocatorStrategy
        StringRequired

        The allocator strategy.

      • createDate
        TimestampRequired

        The creation date.

      • lastOpDate
        TimestampRequired

        The last operation date.

      • state
        StringRequired

        The resource state.

      • guestOsType
        StringRequired

        The guest OS type.

      • configTasks
        ListRequired

        See configTasks

        • vmInstanceUuid
          StringRequired

          The VM instance UUID.

        • configVersion
          longRequired

          The config version.

        • taskName
          StringRequired

          The task name.

        • taskData
          StringRequired

          The task data.

        • retryNumber
          longRequired

          The number of retry.

        • lastFailedReason
          StringRequired

          The last failed reason.

        • createDate
          TimestampRequired

          The creation date.

        • lastOpDate
          TimestampRequired

          The last operation date.

        • status
          SlbVmInstanceConfigTaskStatusRequired

          See status

          • Pending
            SlbVmInstanceConfigTaskStatusRequired

            The Pending value.

          • Starting
            SlbVmInstanceConfigTaskStatusRequired

            The Starting value.

          • Success
            SlbVmInstanceConfigTaskStatusRequired

            The Success value.

          • Failed
            SlbVmInstanceConfigTaskStatusRequired

            The Failed value.

      • vmNics
        ListRequired

        See vmNics

        • uuid
          StringRequired

          The resource UUID.

        • vmInstanceUuid
          StringRequired

          The VM instance UUID.

        • l3NetworkUuid
          StringRequired

          The L3 network UUID

        • ip
          StringRequired

          The IP address.

        • mac
          StringRequired

          The MAC address.

        • hypervisorType
          StringRequired

          The hypervisor type.

        • netmask
          StringRequired

          The netmask.

        • gateway
          StringRequired

          The gateway IP address.

        • metaData
          StringRequired

          The metadata.

        • ipVersion
          StringRequired

          The IP version.

        • driverType
          StringRequired

          The driver type.

        • internalName
          StringRequired

          The internal name.

        • deviceId
          StringRequired

          The device ID.

        • type
          StringRequired

          The resource type.

        • state
          StringRequired

          The vmNic state.

        • createDate
          TimestampRequired

          The creation date.

        • lastOpDate
          TimestampRequired

          The last operation date.

        • usedIps
          ListRequired

          See usedIps.

          • uuid
            StringRequired

            The resource UUID.

          • ipRangeUuid
            StringRequired

            The ip range UUID

          • l3NetworkUuid
            StringRequired

            The L3 network UUID.

          • ipVersion
            IntegerRequired

            The IP version.

          • ip
            StringRequired

            The IP address.

          • netmask
            StringRequired

            The netmask.

          • gateway
            StringRequired

            The gateway IP address.

          • usedFor
            StringRequired

            The intended use.

          • ipInLong
            longRequired

            The IP address represented as a long integer.

          • vmNicUuid
            StringRequired

            The vmNic UUID.

          • createDate
            TimestampRequired

            The creation date.

          • lastOpDate
            TimestampRequired

            The last operation date.

      • allVolumes
        ListRequired

        See allVolumes

        • uuid
          StringRequired

          The resource UUID.

        • name
          StringRequired

          The resource name.

        • description
          StringRequired

          The detailed description of the resource.

        • primaryStorageUuid
          StringRequired

          The primary storage UUID.

        • vmInstanceUuid
          StringRequired

          The VM instance UUID.

        • diskOfferingUuid
          StringRequired

          The disk offering UUID.

        • rootImageUuid
          StringRequired

          The root image UUID.

        • installPath
          StringRequired

          The installation path.

        • type
          StringRequired

          The resource type.

        • format
          StringRequired

          The format.

        • size
          LongRequired

          The size.

        • actualSize
          LongRequired

          The actual size.

        • deviceId
          IntegerRequired

          The device ID.

        • state
          StringRequired

          The resource state.

        • status
          StringRequired

          The resource status.

          • Pending
            SlbVmInstanceConfigTaskStatusRequired

            The Pending value.

          • Starting
            SlbVmInstanceConfigTaskStatusRequired

            The Starting value.

          • Success
            SlbVmInstanceConfigTaskStatusRequired

            The Success value.

          • Failed
            SlbVmInstanceConfigTaskStatusRequired

            The Failed value.

        • createDate
          TimestampRequired

          The creation date.

        • lastOpDate
          TimestampRequired

          The last operation date.

        • isShareable
          BooleanRequired

          Whether the resource is shareable.

        • volumeQos
          StringRequired

          The volume QoS.

        • lastDetachDate
          TimestampRequired

          The last detach date.

        • lastVmInstanceUuid
          StringRequired

          The last VM instance UUID.

      • vmCdRoms
        ListRequired

        See vmCdRoms

        • uuid
          StringRequired

          The resource UUID.

        • vmInstanceUuid
          StringRequired

          The VM instance UUID.

        • deviceId
          IntegerRequired

          The device ID.

        • isoUuid
          StringRequired

          The ISO UUID.

        • isoInstallPath
          StringRequired

          The ISO install path.

        • name
          StringRequired

          The resource name.

        • description
          StringRequired

          The detailed description of the resource.

        • createDate
          TimestampRequired

          The creation date.

        • lastOpDate
          TimestampRequired

          The last operation date.

    • lbs
      ListRequired

      See lbs.

      • slbGroupUuid
        StringRequired

        The slb group UUID.

      • name
        StringRequired

        The resource name.

      • uuid
        StringRequired

        The resource UUID.

      • description
        StringRequired

        The detailed description of the resource.

      • serverGroupUuid
        StringRequired

        The server group UUID.

      • state
        StringRequired

        The resource state.

      • type
        StringRequired

        The resource type.

      • vipUuid
        StringRequired

        VIP UUID.

      • ipv6VipUuid
        StringRequired

        The ipv 6 VIP UUID.

      • createDate
        TimestampRequired

        The creation date.

      • lastOpDate
        TimestampRequired

        The last operation date.

      • listeners
        ListRequired

        See listeners

        • uuid
          StringRequired

          The resource UUID.

        • name
          StringRequired

          The resource name.

        • description
          StringRequired

          The detailed description of the resource.

        • loadBalancerUuid
          StringRequired

          The load balancer UUID.

        • instancePort
          IntegerRequired

          The instance port.

        • loadBalancerPort
          IntegerRequired

          The load balancer port.

        • protocol
          StringRequired

          The protocol.

        • serverGroupUuid
          StringRequired

          The server group UUID.

        • createDate
          TimestampRequired

          The creation date.

        • lastOpDate
          TimestampRequired

          The last operation date.

        • vmNicRefs
          ListRequired

          See vmNicRefs

          • id
            LongRequired

            The resource ID.

          • listenerUuid
            StringRequired

            The listener UUID.

          • vmNicUuid
            StringRequired

            The vmNic UUID.

          • status
            StringRequired

            The resource status.

            • Pending
              SlbVmInstanceConfigTaskStatusRequired

              The Pending value.

            • Starting
              SlbVmInstanceConfigTaskStatusRequired

              The Starting value.

            • Success
              SlbVmInstanceConfigTaskStatusRequired

              The Success value.

            • Failed
              SlbVmInstanceConfigTaskStatusRequired

              The Failed value.

          • createDate
            TimestampRequired

            The creation date.

          • lastOpDate
            TimestampRequired

            The last operation date.

        • aclRefs
          ListRequired

          See aclRefs

          • id
            LongRequired

            The resource UUID.

          • listenerUuid
            StringRequired

            The listener UUID.

          • aclUuid
            StringRequired

            The acl UUID.

          • type
            StringRequired

            The type.

          • createDate
            TimestampRequired

            The creation date.

          • lastOpDate
            TimestampRequired

            The last operation date.

        • certificateRefs
          ListRequired

          See certificateRefs

          • id
            LongRequired

            The resource ID.

          • listenerUuid
            StringRequired

            The listener UUID.

          • certificateUuid
            StringRequired

            The certificate UUID.

          • createDate
            TimestampRequired

            The creation date.

          • lastOpDate
            TimestampRequired

            The last operation date.

        • serverGroupRefs
          ListRequired

          See serverGroupRefs

          • id
            LongRequired

            The resource ID.

          • listenerUuid
            StringRequired

            The listener UUID.

          • serverGroupUuid
            StringRequired

            The server group UUID.

          • createDate
            TimestampRequired

            The creation date.

          • lastOpDate
            TimestampRequired

            The last operation date.

    • networks
      ListRequired

      See networks.

      • slbGroupUuid
        StringRequired

        The slb group UUID.

      • l3NetworkUuid
        StringRequired

        The L3 network UUID.

      • l3NetworkCategory
        StringRequired

        The L3 network category.

      • l3NetworkType
        StringRequired

        The L3 network type.

      • type
        StringRequired

        The resource type.

      • createDate
        TimestampRequired

        The creation date.

      • lastOpDate
        TimestampRequired

        The last operation date.

    • monitorIps
      ListRequired

      See monitorIps.

      • id
        LongRequired

        The resource ID.

      • slbGroupUuid
        StringRequired

        The slb group UUID.

      • monitorIp
        StringRequired

        The monitor IP.

      • createDate
        TimestampRequired

        The creation date.

      • lastOpDate
        TimestampRequired

        The last operation date.

  • error
    ErrorCodeRequired

    The error code. If not null, the operation fails, or vice versa. For more information, see error.

    • code
      StringRequired

      The error code, which is a numbered or alphanumeric code that specifies an error. For example, SYS.1000, HOST.1001.

    • description
      StringRequired

      The brief description of the error.

    • details
      StringRequired

      The details about the error.

    • elaboration
      StringRequired

      The reserved field. Default value: null.

    • opaque
      LinkedHashMapRequired

      The reserved field. Default value: null.

    • cause
      ErrorCodeRequired

      The root error, which is the associated root cause of the current error. If no root error exists, this parameter is null.