Information
Unsupported content 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.

provider


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

create

Use provider-create from the command line to create a new provider based on the specified definition.

Command-line syntax
clm provider-create [-h] [--waitfor TIME_OUT_SECONDS] --providerdefinition NAME|id:<GUID> --providername NAME
[--description DESCRIPTION] --attr ATTRIBUTE_NAME=VALUE [ATTRIBUTE_NAME=VALUE ...]

Use provider_create in the API to create a new provider based on the specified definition. This command returns a Provider Python object with the same attributes and relationships.

API syntax
obj = provider_create(gcac, provider_name=None, description=None, provider_definition_name=None, access_attributes=None)

obj.guid # returns the GUID
obj.name # returns the name
...

Command-line argument

API parameter

Description

Required?

--providerdefinition
provider_definition_name

Name or GUID of a provider deinition to use for the new provider.

Yes

--providername
provider_name

Name of the new provider.

Yes

--attr
access_attributes

Value for each access attribute defined for the provider definition

Yes

--description
description

Description of the new provider.

 

--waitfor

 

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

 

 

gcac

GenericCloudAPIClient instance/user authentication.

 

delete

Use provider-delete from the command line to delete a provider.

Command-line syntax
clm provider-delete [-h] --providername NAME|id:<GUID>

Use provider_delete in the API to delete a provider. This command returns a Provider Python object with the same attributes and relationships.

API syntax
obj = provider_delete(gcac, provider_name=None)

obj.guid # returns the GUID
obj.name # returns the name
...

Command-line argument

API parameter

Description

Required?

--providername
provider_name

Name of the provider to delete.

Yes

 

gcac

GenericCloudAPIClient instance/user authentication.

 

list

Use provider-list from the command line to list registered providers.

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

Use provider_list in the API to list registered providers. This command returns a list of Provider Python objects with the same attributes and relationships.

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

obj[n].guid returns the GUID
obj[n].name returns the name
...

Command-line argument

API parameter

Description

Required?

-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.

 

--filter
filters

List the output that matches the specified filters.

 

 

gcac

GenericCloudAPIClient instance/user authentication.

 

update

Use provider-update from the command line to update a provider description or the values of its access attributes.

Command-line syntax
clm provider-update [-h] [--waitfor TIME_OUT_SECONDS] --provider NAME|id:<GUID> [--description DESCRIPTION]
[--attr ATTRIBUTE_NAME=VALUE [ATTRIBUTE_NAME=VALUE ...]]

Use provider_update in the API to update a provider description or the values of its access attributes. This command returns a Provider Python object with the same attributes and relationships.

API syntax
obj = provider_update(gcac, provider_name=None, description=None, access_attributes=None)

obj.guid # returns the GUID
obj.name # returns the name
...

Command-line argument

API parameter

Description

Required?

--provider
provider_name

Name of the provider to update.

Yes

--description
description

New description of the provider.

 

--attr
access_attributes

Value of each access attribute to be updated.

 

--waitfor

 

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

 

 

gcac

GenericCloudAPIClient instance/user authentication.

 

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Cloud Lifecycle Management 4.6