Unsupported content

 

This version of the product has reached end of support. The documentation is available for your convenience. However, you must be logged in to access it. You will not be able to leave comments.

serviceblueprint

This topic describes the verbs, command-line arguments, and API parameters available for the serviceblueprint noun in the BMC Cloud Lifecycle Management SDK.

create

Use serviceblueprint-create from the command line to create a service blueprint from the specified json file. If a blueprint with the same name already exists, a new version of that blueprint is created.

Command-line syntax
clm serviceblueprint-create [-h] [--waitfor TIME_OUT_SECONDS] --jsonfile FILE_PATH [--blueprintname NAME]

Use serviceblueprint_create in the API to create a service blueprint from the specified json file. If a blueprint with the same name already exists, a new version of that blueprint is created. This command returns a BlueprintDocument API object with the same attributes and relationships.

API syntax
obj = serviceblueprint_create(gcac, blueprint_name=None, json_file=None)

obj.guid # returns the GUID
obj.name # returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
--jsonfilejson_filePath and name of the json file containing blueprint definition.Yes
--blueprintnameblueprint_nameName of the service blueprint. If you do not specify a name, the name specified in the json file is used. 
--waitfor 

Time in seconds to wait for a response from the server, otherwise return running task details.

 
 gcacGenericCloudAPIClient instance/user authentication. 

export

Use serviceblueprint-export from the command line to export the specified service blueprint version as a json file.

Command-line syntax
clm serviceblueprint-export [-h] [--waitfor TIME_OUT_SECONDS] --blueprint NAME|id:<GUID> --outfile FILE_PATH

Use serviceblueprint_export in the API to export the specified service blueprint version as a json file. This command returns a BlueprintDocument API object with the same attributes and relationships.

API syntax
obj = serviceblueprint_export(gcac, blueprint=None, file_name=None)

obj.guid # returns the GUID
obj.name # returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
--blueprintblueprint

Name of the service blueprint, or the GUID of a service blueprint version

Yes
--outfilefile_namePath and file name for the exported json file.Yes
--waitfor 

Time in seconds to wait for a response from the server, otherwise return running task details.

 
 gcacGenericCloudAPIClient instance/user authentication. 

list

Use serviceblueprint-list from the command line to list available service blueprints.

Command-line syntax
clm serviceblueprint-list [-h] [-l] [-u] [-n] [-s] [-k FIELD_NAME [FIELD_NAME ...]] 
[--filter FIELD_NAME=VALUE [FIELD_NAME=VALUE ...]]

Use serviceblueprint_list from the API to list available service blueprints. This command returns a list of BlueprintDocument API objects with the same attributes and relationships.

API syntax
obj = serviceblueprint_list(gcac, filters=None)

obj[n].guid returns the GUID
obj[n].name returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
-l List all fields. This parameter does not need a value. 
-u List only GUIDs. This parameter does not need a value. 
-n List only names. This parameter does not need a value. 
-s List GUIDs, names, and status (if applicable). This parameter does not need a value. 
-k List the field names specified in the value for this parameter. 
--filterfiltersList the output that matches the specified filters. 
 gcacGenericCloudAPIClient instance/user authentication.

make-latest

Use serviceblueprint-make-latest from the command line to mark the specified version of a service blueprint as the latest version.

Command-line syntax
clm serviceblueprint-make-latest [-h] [--waitfor TIME_OUT_SECONDS] --blueprint NAME|id:<GUID> 
[--versionnumber VERSIONNUMBER]

Use serviceblueprint_make_latest in the API to mark the specified version of a service blueprint as the latest version. This command returns a BlueprintDocument API object with the same attributes and relationships.

API syntax
obj = serviceblueprint_make_latest(gcac, blueprint=None, versionnumber=None)

obj.guid # returns the GUID
obj.name # returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
--blueprintblueprintName or GUID of the service blueprint.Yes
--versionnumberversionnumberVersion number of the service blueprint. 
--waitfor 

Time in seconds to wait for a response from the server, otherwise return running task details.

 
 gcacGenericCloudAPIClient instance/user authentication. 

map-to

Use serviceblueprint-map-to from the command line to map tags to artifacts defined in a service blueprint.

Command-line syntax
clm serviceblueprint-map-to [-h] [--waitfor TIME_OUT_SECONDS] --blueprint NAME|id:<GUID> 
--tag GROUP[TAG1,TAG2,...] --configuration NAME [--resourceset NAME] [--versionnumber VERSIONNUMBER]

Use serviceblueprint_map in the API to map tags to artifacts defined in a service blueprint. This command returns a BlueprintDocument API object with the same attributes and relationships.

API syntax
obj = serviceblueprint_map(gcac, blueprint=None, resourceset=None, configuration=None, 
versionnumber=None, tagList=None)

obj.guid # returns the GUID
obj.name # returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
--blueprintblueprintName or GUID of the service blueprint.Yes
--tagtagList

List of tags to map.

Yes
--configurationconfiguration

Name of the deployment model.

Yes
--resourcesetresourcesetName of the resource set. 
--versionnumberversionnumberVersion number of the service blueprint. 
--waitfor 

Time in seconds to wait for a response from the server, otherwise return running task details.

 
 gcacGenericCloudAPIClient instance/user authentication. 

unmap-to

Use serviceblueprint-unmap-to from the command line to unmap tags from artifacts defined in a service blueprint.

Command-line syntax
clm serviceblueprint-unmap-to [-h] [--waitfor TIME_OUT_SECONDS] --blueprint NAME|id:<GUID> 
--tag GROUP[TAG1,TAG2,...] --configuration NAME [--resourceset NAME] [--versionnumber VERSIONNUMBER]

Use serviceblueprint_unmap in the API to unmap tags from artifacts defined in a service blueprint. This command returns a BlueprintDocument API object with the same attributes and relationships.

API syntax
obj = serviceblueprint_unmap(gcac, blueprint=None, resourceset=None, configuration=None, 
versionnumber=None, tagList=None)

obj.guid # returns the GUID
obj.name # returns the name
...
Command-line argumentAPI parameterDescriptionRequired?
--blueprintblueprintName or GUID of the service blueprint.Yes
--tagtagList

List of tags to unmap.

Yes
--configurationconfiguration

Name of the deployment model.

Yes
--resourcesetresourcesetName of the resource set. 
--versionnumberversionnumberVersion number of the service blueprint. 
--waitfor 

Time in seconds to wait for a response from the server, otherwise return running task details.

 
 gcacGenericCloudAPIClient instance/user authentication. 

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.

Comments