SoftwareContainer class (Provider API)

The class Software Container represents software which hosts other software. Hosting means that software is deployed to, or runs on the container. An Application Server cluster, a Relational Database System (RDBMS), and a Database are all examples of {{SoftwareContainer}}s.

SoftwareContainer class APIs

The following tables list the basic APIs, operation APIs, and relationship APIs for the SoftwareContainer class.

Basic APIs

Name

HTTP
method

URI

Description

create

POST

csm/SoftwareContainer

Creates a SoftwareContainer object.

delete

DELETE

csm/SoftwareContainer/guid

Deletes a SoftwareContainer object.

Operation APIs

Name

HTTP
method

URI

Description

compare

POST

csm/SoftwareContainer/compare

Compare the referenceSoftwareContainer to the otherSoftwareConatiner. If isCompatibe is true, then return true iff said containers are compatible. Otherwise, return true iff the containers are incompatible.

decommission

POST

csm/SoftwareContainer/guid/decommission

getQualifiedHostingContainers

POST

csm/SoftwareContainer/guid/getQualifiedHostingContainers

If this SoftwareContainer is supported, then return the subset of candidateHostingContainers that qualify as hosts. Otherwise, return an error that indicates this SoftwareContainer is not supported. The semantics of a "qualifying host" is provider-dependent and may consider any substantive attributes of the software containers (but not attributes such as guid, name, description, externalId, isOnboarded, etc.)

getSupportedEditions

POST

csm/SoftwareContainer/getSupportedEditions

Return all supported container editions, if any.
The result is a set of (name,value) pairs, where:
name = "<provider-uri>:<type>:<subtype>"
value = "<edition>"
Meaning that <edition> is supported for the (<provider-uri>, <type>, <subtype>) tuple.
The * quantifier can be used to denote that an edition is supported to any type or subtype.

getSupportedHardwarePlatforms

POST

csm/SoftwareContainer/getSupportedHardwarePlatforms

Return all supported container hardware platforms, if any.
The result is a set of (name,value) pairs, where:
name = "<provider-uri>:<type>:<subtype>:<edition>"
value = "<hardware-platform>"
Meaning that <edition> is supported for the (<provider-uri>, <type>, <subtype>, <edition>) tuple.
The * quantifier can be used to denote that a software platform is supported on any type, subtype, etc.

getSupportedSoftwarePlatforms

POST

csm/SoftwareContainer/getSupportedSoftwarePlatforms

Return all supported container software platforms, if any.
The result is a set of (name,value) pairs, where:
name = "<provider-uri>:<type>:<subtype>:<edition>:<hardware-platform>"
value = "<software-platform>"
Meaning that <edition> is supported for the (<provider-uri>, <type>, <subtype>, <edition>, <hardware-platform>) tuple.
The * quantifier can be used to denote that a software platform is supported on any type, subtype, etc.

getSupportedSubtypes

POST

csm/SoftwareContainer/getSupportedSubtypes

Return all supported container subtypes, if any.
The result is a set of (name,value) pairs, where:
name = "<provider URI>:<type>"
value = "<subtype>"
Meaning that <subtype> is supported for the provider <<provider URI> and the type <type>.
To denote that a specific <subtype> is supported for any type use the * quantifier.

getSupportedTypes

POST

csm/SoftwareContainer/getSupportedTypes

Return all container types supported by the implementing provider.
The result is a set of (name,value) pairs, where:
name = "<provider-uri>"
value = "<type>"
Meaning that the <type> is supported for the <provider-uri> provider.

getSupportedVersions

POST

csm/SoftwareContainer/getSupportedVersions

Return all supported container versions, if any.
The result is a set of (name,value) pairs, where:
name = "<provider-uri>:<type>:<subtype>:<edition>:<hardware-platform>:<software-platform>"
value = "<software-platform>"
Meaning that <edition> is supported for the (<provider-uri>, <type>, <subtype>, <edition>, <hardware-platform>, <software-platform>) tuple.
The * quantifier can be used to denote that a software platform is supported on any type, subtype, etc.

offboard

POST

csm/SoftwareContainer/offboard

onboard

POST

csm/SoftwareContainer/onboard

start

POST

csm/SoftwareContainer/guid/start

Start the object specified by the <guid> in the URI.

stop

POST

csm/SoftwareContainer/guid/stop

Stop the object specified by the <guid> in the URI.

Relationship APIs

The SoftwareContainer class has no relationship APIs.

SoftwareContainer class relationships and attributes

The following tables list the relationships and attributes of the SoftwareContainer class.

Relationships

Name

Type

Multi-
plicity

Description

componentRunningSoftware

RunningSoftware

0..*

componentSoftwareContainer

SoftwareContainer

0..*

compositeSoftwareContainer

SoftwareContainer

0..1

softwareResourceProperties

SoftwareResourceProperty

0..*

applicationSoftware

ApplicationSoftware

0..*

hostedRunningSoftware

RunningSoftware

0..*

Attributes

Name

Type

Multi-
plicity

Description

adminUserName

String

0..1

edition

String

0..1

hardwareArchitecture

HardwareArchitectureType

0..1

installableResource

String

0..1

installableResourceType

String

0..1

instanceCount

Integer

0..1

isClustered

Boolean

1

isOnboarded

Boolean

0..1

Is true iff the SoftwareContainer was onboarded and has yet to be offboarded.
Is false iff the SoftwareContainer was offboarded and yet to be onboarded.
Null, otherwise.

platformArchitecture

String

0..1

provisionedDate

Date

1

state

ProvisionedResourceState

1

subtype

String

0..1

type

String

1

manufacturer

String

1

Name of the software manufacturer

patchLevel

String

0..1

Patch level of the software

productCatalogId

String

0..1

Product catalog identifier for the software

productName

String

1

Name of the software product

version

String

0..1

Software version

externalID

String

0..1

Identifier used for the object by an external provider

owner

String

0..1

Name of the owner of the object

reconciliationID

String

0..1

Reconciliation identity value for the object from the BMC Atrium CMDB

tokenID

String

0..1

Token identifier

description

String

0..1

Text that describes the object

guid

String

1

Globally unique identifier for the object

labels

String

0..*

modifiedDate

Date

0..1

Date the Cloudobject was modified

name

String

1

Human-readable name of the object

Was this page helpful? Yes No Submitting... Thank you

Comments