Retrieve Zone Configuration operation

The Retrieve Zone Configuration operation enables you to retrieve the configuration parameters for the specified Zone.

The following table describes the elements for the adapter request:

Unknown macro: {multi-excerpt}

Adapter request elements for the Retrieve Zone Configuration operation

Element	Definition	Required
`<operation-type>`	Defines the type of operation: `Configure_Zone`	Yes
`<operation-name>`	Defines the name of operation: `Retrieve_Zone_Configuration`	Yes
`<zone-name>`	Specifies the name of the Zone for which you want to retrieve the configuration parameters	Yes
`<operation-timeout-secs>`	Specifies the time, in seconds, to wait for the operation to complete on the target server If the operation is not successful within this interval, the adapter returns an error message. Default value: 300 seconds	No
`<host>`	Specifies the host name of the Solaris computer hosting Solaris Zones	No
`<port>`	Specifies the port on which the SSH service is running on the host computer Default value: 22	No
`<user-name>`	Specifies the user name for the Solaris computer If no user name is specified, the request is executed with the user name specified in the adapter configuration.	No
`<password>`	Specifies the password corresponding to the user name	Conditional Required if you specify the `<user-name>` element

The following figure shows the sample adapter request for the Retrieve Zone Configuration operation:

Unknown macro: {multi-excerpt}

Sample adapter request for the Retrieve Zone Configuration operation

<solaris-zones-request>
    <target>
      <host>vm-sol-abc<host>
      <user-name>admin<user-name>
      <password>adminpass</password>
      <port>8888</port>
    </target>
    <operation-type>Configure_Zone</operation-type>
    <operation-name>Retrieve_Zone_Configuration</operation-name>
    <zone-name>zone1</zone-name>
</solaris-zones-request>

Note

You need to specify the elements in the <target> block of the adapter request only if you want to override the elements specified in the adapter configuration.

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

Unknown macro: {multi-excerpt}

Sample adapter response for the Retrieve Zone Configuration operation

<solaris-zones-response>
  <metadata>
    <status>success</status>
  </metadata>
  <target-output host="vm-sol-abc">
    <metadata>
      <os-id>SunOS</os-id>
      <os-version>5.10</os-version>
      <status>success</status>
    </metadata>
    <operation-output>
      <metadata>
        <command>zonecfg -z "zone1" info</command>
        <line-count>20</line-count>
        <execution-milliseconds>731</execution-milliseconds>
        <exit-code>0</exit-code>
        <status>success</status>
      </metadata>
      <output>
        <line index="1">zonename: zone1</line>
        <line index="2">zonepath: /zones/testzone1</line>
        <line index="3">brand: native</line>
        <line index="4">autoboot: true</line>
        <line index="5">bootargs: </line>
        <line index="6">pool: </line>
        <line index="7">limitpriv: </line>
        <line index="8">scheduling-class: </line>
        <line index="9">ip-type: shared</line>
        <line index="10">inherit-pkg-dir:</line>
        <line index="11">	dir: /lib</line>
        <line index="12">inherit-pkg-dir:</line>
        <line index="13">	dir: /platform</line>
        <line index="14">inherit-pkg-dir:</line>
        <line index="15">	dir: /sbin</line>
        <line index="16">inherit-pkg-dir:</line>
        <line index="17">	dir: /usr</line>
        <line index="18">net:</line>
        <line index="19">	address: 10.128.248.3</line>
        <line index="20">	physical: vnet0</line>
      </output>
    </operation-output>
  </target-output>
</solaris-zones-response>

Retrieve Zone Configuration operation

Comments