Share via

3.2.5.3 GetServerStatus

  • Article

The GetServerStatus method returns the connection state to a given partition of the data source associated with the management agent. The client MUST pass the GUID of the partition for which to return status. The server will return one of the following status messages:

  • If the client is not permitted to perform this operation, the server MUST return access-denied<5>.

  • If the server is unable to communicate to any implementation specific components, the server SHOULD return connection-failure <6>.

  • If the data source server is running with a secure communication link, the server MUST return success.

  • If the data source server is running but the security between the server and the data source server uses encryption where the encryption key length is 40 bits or fewer, the server MUST return success-low-security.

  • If the data source server is running but the password synchronization setting for the management agent is not enabled, the server MUST return success-password-sync-disabled.

  • If the PartitionGuid parameter is not in a GUID format, the server MUST return incorrect-partition-id-format.

  • If the management agent was unable to log on to the data source server with the stored credentials, the server MUST return ma-credentials-failure.

  • If the management agent type does not support password changes, the server MUST return ma-feature-not-supported.

  • If the partition corresponding to the partition GUID has not been configured, the server MUST return partition-not-configured.

  • If the server could not connect to the data source server, the server MUST return server-down.

  • If the partition GUID parameter cannot be matched to a partition in the data source server that belongs to the management agent, the server MUST return unknown-partition-id.

Otherwise, the server MUST return call-failure.