The Source namespace provides commands to manage the sources of authentication metadata information. The interface definition language infrastructure provides tools to generate various kinds of metadata in JSON format from the interface definition files and additional properties files. One of the generated files contains authentication information. The generated file can be registered as a source of metadata. The authentication file contains all the data present in the interface definition files. Each authentication file contains data about one component element. When a authentication file is added as a source, each source contributes only one component element's metadata. Authentication metadata can also be discovered from a remote server that supports the authentication metadata namespaces (see authentication). Since multiple components can be registered with a single metadata server, when a remote server is registered as a source, that source can contribute more than one component.
List of commands:
dcli com vmware vapi metadata authentication source create
Description
Creates a new metadata source. Once the server validates the registration information of the metadata source, the authentication metadata is retrieved from the source. This populates elements in all the namespaces defined in authentication namespace.
Options
| Option Name | Type | Required | Description |
|---|---|---|---|
source‑id |
string | Yes | metadata source identifier. The parameter must be an identifier for the resource type: com.vmware.vapi.metadata.authentication.source. |
spec‑description |
string | Yes | English language human readable description of the source. |
spec‑type |
string | Yes | Type of the metadata source. Valid values are: {FILE, REMOTE} |
spec‑filepath |
string | No | Absolute file path of the metamodel metadata file that has the metamodel information about one component element. This option is optional and it is only relevant when the value of type is FILE. |
spec‑address |
string | No | Connection information of the remote server. This should be of the format http(s)://IP:port/namespace. The remote server should contain the namespaces in metamodel namespace. It could expose metamodel information of one or more components. This option is optional and it is only relevant when the value of type is REMOTE. |
Example
dcli com vmware vapi metadata authentication source create --source-id testId --spec-description testString --spec-type test
dcli com vmware vapi metadata authentication source delete
Description
Deletes an existing authentication metadata source from the infrastructure.
Options
| Option Name | Type | Required | Description |
|---|---|---|---|
source‑id |
string | Yes | Identifier of the metadata source. The parameter must be an identifier for the resource type: com.vmware.vapi.metadata.authentication.source. |
Example
dcli com vmware vapi metadata authentication source delete --source-id testId
dcli com vmware vapi metadata authentication source get
Description
Retrieves information about the metadata source corresponding to source-id.
Options
| Option Name | Type | Required | Description |
|---|---|---|---|
source‑id |
string | Yes | Identifier of the metadata source. The parameter must be an identifier for the resource type: com.vmware.vapi.metadata.authentication.source. |
Example
dcli com vmware vapi metadata authentication source get --source-id testId
dcli com vmware vapi metadata authentication source list
Description
Returns the identifiers of the metadata sources currently registered with the infrastructure.
Example
dcli com vmware vapi metadata authentication source list
dcli com vmware vapi metadata authentication source reload
Description
Reloads the authentication metadata from all the metadata sources or of a particular metadata source if source-id is specified.
Options
| Option Name | Type | Required | Description |
|---|---|---|---|
source‑id |
string | No | Identifier of the metadata source. The parameter must be an identifier for the resource type: com.vmware.vapi.metadata.authentication.source. If unspecified, all the metadata sources are reloaded. |
Example
dcli com vmware vapi metadata authentication source reload
dcli com vmware vapi metadata authentication source fingerprint
Description
Returns the aggregate fingerprint of metadata from all the metadata sources or from a particular metadata source if source-id is specified.
Options
| Option Name | Type | Required | Description |
|---|---|---|---|
source‑id |
string | No | Identifier of the metadata source. The parameter must be an identifier for the resource type: com.vmware.vapi.metadata.authentication.source. If unspecified, the fingerprint of all the metadata sources is returned. |
Example
dcli com vmware vapi metadata authentication source fingerprint