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.

Dataset Resize Member operation

The Dataset Resize Member operation is used to resize, change maximum capacity and change snap reserve for a data set member of the data set.

The following table describes the elements for this request.


Adapter request elements for Dataset Resize Member operation

Element

Definition

Required

<operation-name>

Specifies the name of the operation: dataset-resize-member

Yes

<arguments>

Specifies a list of arguments required for the operation

Yes

<targets>

Contains the parent XML element for the <target> element, which specifies the dynamic targets

Conditional; required if the adapter configuration is empty in Grid Manager

<target>

Contains the child XML <targets> element, which specifies the dynamic targets

Using dynamic targets, you can define connection information for a remote host in an adapter request. This capability enables you to configure an adapter in Grid Manager by specifying configuration information in an adapter request.

This XML element can have <host>, <user-name>, <password>, <protocol>, and <port> as its child elements.

Notes


  • An adapter configuration specified by using request-level dynamic targets takes precedence over Grid Manager level configuration information.
  • If you specify the request-level dynamic target by using <targets>, the request ignores the <targets> element that is a child of the <arguments> element.

Conditional; required if <targets> is present in the adapter request

<host>

Specifies the host name or IP address of the server on which NetApp DataFabric Manager is running

Conditional; required if <targets> is present in the adapter request

<user-name>

Specifies the user name required to log on to the NetApp DataFabric Manager

Conditional; required if <targets> is present in the adapter request

<password>

Specifies the password that corresponds to the <user-name>

The <password> element can contain an encryption-type attribute. The encryption-type attribute indicates whether the password specified is encrypted.

Valid values for encryption-type attribute: Base64, Plain (default)

Conditional; required if <targets> is present in the adapter request

<protocol>

Specifies the communication protocol used by the adapter

Valid values: http (default), https

No

<port>

Specifies the port on which NetApp DataFabric Manager is enabled

Default values: 8088 (http), 8488 (https)

No

<target>

Specifies the child XML element of the <arguments> element

You can use this element to specify the connection information for a DFM server. You can use a comma-separated list of configuration names, which executes the request simultaneously on all DFM servers identified by the configuration names.

Valid values:

  • The values specified for the <target> XML element must be the same as the values that have been specified for the name attribute of the <config> element in the Grid Manager adapter configuration.
  • You can provide "ALL" as the value. In this case, the request is executed on all the DFM servers defined in the Grid Manager adapter configuration.
  • You can specify multiple comma-separated names to allow for simultaneous execution of requests across multiple DFM servers.
  • You can skip this element. In this case, the request is executed on the first defined Grid Manager adapter configuration.
  • You can leave this element empty. In this case, the request is executed on the first defined Grid Manager adapter configuration.

    Note

    If you specify a request-level dynamic target by using <targets>, the request ignores this element.

No

<dataset-name-or-id>

Specifies the name or identifier of the data set to edit

Yes

<force>

Specifies whether a new dataset edit session should be started irrespective whether an edit is in progress

If TRUE, and an edit is already in progress on the specified data set or an object the data set is dependent on (such as a data protection policy), the previous edit session is rolled back and a new edit session is begun.

Valid values: TRUE, FALSE (default)

No

<maximum-capacity>

Specifies the new maximum capacity value for a flexible volume, in bytes

The <maximum-capacity> is valid only if the filer to which the volume belongs is of ONTAP version 7.1 or later and the member-id or member-name refers to a flexible volume.

Range: [1--2^44-1]

No

<member-id>

Specifies the data set member ID on which the resize operation is carried out

The member can be either a flexible volume or a qtree, which is a member of the effective primary node of the data set either through direct or indirect membership.

Note

You must specify either the <member-id element or the <member-name>. If the <member-id> is specified then the request ignores the <member-name>.

Conditional

<member-name>

Specifies the name of the data set member on which the resize operation is carried out

This member can be either a flexible volume or a qtree, which is a member of the effective primary node of the data set either through direct or indirect membership.

Note

You must specify either the <member-id element or the <member-name>. If the <member-id> is specified then the request ignores the <member-name>.

Conditional

<new-size>

Specifies the new size of the data set member, in bytes

If the member is a volume, this corresponds to the size of the volume. If the member is a qtree, this corresponds to the hard disk quota limit for the qtree.

Range: [1--2^44-1]

Yes

<snap-reserve>

Specifies the percentage of space set aside for snapshots in a volume

The value is specified in percentage of the total size of the volume. This input is valid only if the <member-id> or <member-name> refers to a flexible volume.

Range: [0--100]

No

A sample adapter request for this operation is given in the following figure.

Sample adapter request for Dataset Resize Member operation

<netapp-storage-request>
    <operation-name>dataset-resize-member</operation-name>
    <arguments>
      <targets>
        <target>
          <host>server137</host>
          <user-name>username</user-name>
          <password encryption-type = "Base64">cGFzc3dvcmQ=</password>
          <protocol>http</protocol>
          <port>8088</port>
        </target>
      </targets>
      <target />
      <member-name>devsim1:/nas_dataset</member-name>
      <dataset-name-or-id>nas dataset</dataset-name-or-id>
      <new-size>25000000</new-size>
      <snap-reserve>10</snap-reserve>
         <maximum-capacity>10000000</maximum-capacity>
      <force>true</force>
    </arguments>
  </netapp-storage-request>


A sample adapter response for this operation is given in the following figure.

Sample adapter response for Dataset Resize Member operation

<netapp-storage-response>
  <metadata>
    <status>success</status>
    <response-count>1</response-count>
  </metadata>
  <responses>
    <response>
      <metadata>
        <target>server137</target>
        <status>success</status>
        <count>1</count>
      </metadata>
      <output>
        <job-ids>
          <job-info>
            <job-id>3990</job-id>
          </job-info>
        </job-ids>
      </output>
    </response>
  </responses>
</netapp-storage-response>
Was this page helpful? Yes No Submitting... Thank you

Comments