Add NAS Datastore operation


The Add NAS Datastore operation enables you to create a new storage datastore attached to the network.

The following table describes the elements for the adapter request.

Adapter request elements for the Add NAS Datastore operation

Element

Definition

Required

<operation-type>

Defines the type of operation: Host

Yes

<operation-name>

Defines the name of operation: Add_NAS_Datastore

Yes

<soap-url>

Specifies the URL for the remote SOAP service running on the VMware VirtualCenter

If the <soap-url> element is not specified, the request uses the VirtualCenter Server details specified in the adapter configuration.

Default format for HTTPS: https://<hostName>:<port>/sdk/vim

Default format for HTTP: http://<hostName>:<port>/sdk/vim

Warning

Note

If you want to use an HTTP value, you might need to change the configuration of the VMware Infrastructure application.

No

<transport>

Specifies the transport protocol for the message

If the <transport> element is not provided, the request uses the VirtualCenter Server details specified in the adapter configuration.

Valid values: https-rpc (default), http-rpc

Warning

Note

If the value of the <transport> element is https-rpc, you must install the security certificate for the VMware Virtual Center to the keystore of the peer on which the adapter is enabled.

No

<user-name>

Specifies the user name that is used for HTTP basic authentication on the VMware Virtual Center

If no user name is specified, the request is executed with the user name that is specified in the configuration.

No

<password>

Specifies the password corresponding to <user-name>

Conditional; required if <user-name> is specified

<parameters>

Contains the elements required to execute the operation

Yes

<host-system>

Specifies the DNS name of the host on which you want to add the datastore

This element can contain only String values

Yes

<remote-host>

Specifies the host running the Network File System (NFS) server

Yes

<remote-path>

Specifies the remote path for the NFS mount point

Yes

<local-path>

Specifies the name for the new datastore

Yes

<access-node>

Specifies the access node for the mount point

Valid values are readOnly and readWrite.

If this element is set to readOnly, the virtual machine has read-only access to the datastore. If this element is set to readWrite, the virtual machine has read and write access to the datastore.

Yes

The following figure shows a sample adapter request for the Add NAS Datastoree operation.

Sample adapter request for the Add NAS Datastore operation

<vmware-infrastructure-request>
<operation-type>Host</operation-type>
<operation-name>Add_NAS_Datastore</operation-name>
<soap-url></soap-url>
<transport></transport>
<user-name></user-name>
<password></password>
<parameters>
    <host-system>xyz.bmc.com</host-system>
    <spec>
    <remote-host>10.251.1.69</remote-host>
    <remote-path>/vol/test1/bmc1</remote-path>
    <local-path>NetAppNASStorage1</local-path>
    <access-mode>readWrite</access-mode>
    </spec>
</parameters>
</vmware-infrastructure-request>

The following figure shows the response for the sample adapter request.

Sample adapter response for the Add NAS Datastore operation

<vmware-infrastructure-response>
 <metadata>
   <status>success</status>
 </metadata>
  <AddNASDatastoreResponse>
       <Datastore>datastore-6114</Datastore>
  </AddNASDatastoreResponse>
 </vmware-infrastructure-response>

The following table describes the response element for the Add NAS Datastore operation.

Adapter response element for the Add NAS Datastore operation

Element

Definition

<Datastore>

Specifies the newly created datastore

 

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

TrueSight Orchestration Content 21.3