CliQr is now part of Cisco Learn More About Cisco

Update Image

Details

API Details
NameUpdate Image
DescriptionUpdates the specified image for the identified cloud region. See Manage Images for additional context.
MethodPUT
URIv1/tenants/tenantId/images/imageId
CloudCenter ReleaseIntroduced in CloudCenter 4.0.
NotesFor additional context on <PORT> usage in the following example(s), see Base URI Format.
ESB Headeraction: put.tenants.tenantId.images.imageId

Example

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

Request Body

Response

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

imageId
  • DescriptionUnique, system-generated identifier for a logically mapped image (see Manage Images for additional context).
  • Type: String

Required

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

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

  • Type: String

description
  • DescriptionA brief description for this CloudCenter Resource.

  • Type: String
visibility
  • Description: Indicates the type of user to which this image is visible
  • Type: Enumeration

    EnumerationDescription
    PRIVATEThis image is visible only to the tenant owner admin
    PUBLICThis image is visible to all tenants and users.
    PUBLISHEDThis image is visible only to tenant users.
numOfNics
  • Description: The number of Network Interface Cards (NICs) attached to this instance type or cloud image 

  • Type: Integer
osName
  • Description: Type of operating system associated with this resource
  • Type: Enumeration

    EnumerationDescription
    LINUXThe associated resource is specific to the Linux operating system.
    WINDOWSThe associated resource is specific to the Windows operating system.
enabled
  • Description: Indicates that this resource has been enabled.

    • true = resource has been enabled
    • false = resource has not been enabled (default)
  • Type: Boolean
imageType
  • Description: Identifies whether this image is for the CCO or the application VM
  • Type: Enumeration

    EnumerationDescription
    CLOUD_GATEWAYThe CCO image
    CLOUD_WORKERThe application VM image

Response Attributes

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

  • Type: String
resource
  • Description: Unique URL to access this resource
  • Type: String
perms (click for additional details)
name
  • DescriptionThe name assigned for this CloudCenter ResourceValid characters are letters, numbers, underscores, and spaces.

  • Type: String

internalImageName
  • Description: The internal name for this image 
  • Type: String
description
  • DescriptionA brief description for this CloudCenter Resource.

  • Type: String
visibility
  • Description: Indicates the type of user to which this image is visible
  • Type: Enumeration

    EnumerationDescription
    PRIVATEThis image is visible only to the tenant owner admin
    PUBLICThis image is visible to all tenants and users.
    PUBLISHEDThis image is visible only to tenant users.
imageType
  • Description: Identifies whether this image is for the CCO or the application VM
  • Type: Enumeration

    EnumerationDescription
    CLOUD_GATEWAYThe CCO image
    CLOUD_WORKERThe application VM image
osName
  • Description: Type of operating system associated with this resource
  • Type: Enumeration

    EnumerationDescription
    LINUXThe associated resource is specific to the Linux operating system.
    WINDOWSThe associated resource is specific to the Windows operating system.
tags
  • DescriptionTags associated with this resource. Each string represents a System Tag.

    Icon

    If you filter reports based on tags that you applied to VMs or jobs, then the report displays all the VMs or jobs that have this exact combination of tags.

  • Type: Array of JSONs

enabled
  • Description: Indicates that this resource has been enabled.

    • true = resource has been enabled
    • false = resource has not been enabled (default)
  • Type: Boolean
systemImage
  • Description: Indicates whether this image is a predefined system image (see Manage Images for additional context):
    • true =  A predefined system image
    • false = Not a predefined system image
  • Type: Boolean 

detail (click for more details)

If the request URL does not have a detail query parameter with the value=true, then this field displays null.

count
  • Description: The number of times that this phase bundle was added/attached.

    Icon

    On successful image creation, this value will always remain 0.

  • TypeInteger