Class SR


public class SR extends XenAPIObject
A storage repository First published in XenServer 4.0.
Author:
Cloud Software Group, Inc.
  • Field Details

    • ref

      protected final String ref
      The XenAPI reference (OpaqueRef) to this object.
  • Method Details

    • toWireString

      public String toWireString()
      Specified by:
      toWireString in class XenAPIObject
      Returns:
      The XenAPI reference (OpaqueRef) to this object.
    • equals

      public boolean equals(Object obj)
      If obj is a SR, compares XenAPI references for equality.
      Overrides:
      equals in class Object
    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object
    • getRecord

      Get a record containing the current state of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      all fields from the object
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getByUuid

      public static SR getByUuid(Connection c, String uuid) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Get a reference to the SR instance with the specified UUID. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      uuid - UUID of object to return
      Returns:
      reference to the object
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getByNameLabel

      public static Set<SR> getByNameLabel(Connection c, String label) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Get all the SR instances with the given label. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      label - label of object to return
      Returns:
      references to objects with matching names
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getUuid

      Get the uuid field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getNameLabel

      Get the name/label field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getNameDescription

      Get the name/description field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getAllowedOperations

      Get the allowed_operations field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getCurrentOperations

      Get the current_operations field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getVDIs

      Get the VDIs field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getPBDs

      Get the PBDs field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getVirtualAllocation

      public Long getVirtualAllocation(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Get the virtual_allocation field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getPhysicalUtilisation

      public Long getPhysicalUtilisation(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Get the physical_utilisation field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getPhysicalSize

      Get the physical_size field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getType

      Get the type field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getContentType

      Get the content_type field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getShared

      Get the shared field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getOtherConfig

      Get the other_config field of the given SR. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getTags

      Get the tags field of the given SR. Minimum allowed role: read-only First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getSmConfig

      Get the sm_config field of the given SR. Minimum allowed role: read-only First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getBlobs

      Get the blobs field of the given SR. Minimum allowed role: read-only First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getLocalCacheEnabled

      Get the local_cache_enabled field of the given SR. Minimum allowed role: read-only First published in XenServer 5.6 FP1.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getIntroducedBy

      Get the introduced_by field of the given SR. Minimum allowed role: read-only First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getClustered

      Get the clustered field of the given SR. Minimum allowed role: read-only First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getIsToolsSr

      Get the is_tools_sr field of the given SR. Minimum allowed role: read-only First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      value of the field
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setOtherConfig

      public void setOtherConfig(Connection c, Map<String,String> otherConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the other_config field of the given SR. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      otherConfig - New value to set
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • addToOtherConfig

      public void addToOtherConfig(Connection c, String key, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Add the given key-value pair to the other_config field of the given SR. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      key - Key to add
      value - Value to add
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • removeFromOtherConfig

      public void removeFromOtherConfig(Connection c, String key) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Remove the given key and its corresponding value from the other_config field of the given SR. If the key is not in that Map, then do nothing. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      key - Key to remove
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setTags

      Set the tags field of the given SR. Minimum allowed role: vm-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      tags - New value to set
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • addTags

      Add the given value to the tags field of the given SR. If the value is already in that Set, then do nothing. Minimum allowed role: vm-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      value - New value to add
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • removeTags

      public void removeTags(Connection c, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Remove the given value from the tags field of the given SR. If the value is not in that Set, then do nothing. Minimum allowed role: vm-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      value - Value to remove
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setSmConfig

      public void setSmConfig(Connection c, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the sm_config field of the given SR. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      smConfig - New value to set
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • addToSmConfig

      public void addToSmConfig(Connection c, String key, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Add the given key-value pair to the sm_config field of the given SR. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      key - Key to add
      value - Value to add
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • removeFromSmConfig

      public void removeFromSmConfig(Connection c, String key) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Remove the given key and its corresponding value from the sm_config field of the given SR. If the key is not in that Map, then do nothing. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      key - Key to remove
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • create

      public static SR create(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Boolean shared) throws Types.BadServerResponse, Types.XenAPIException, IOException, Types.SrUnknownDriver
      Create a new Storage Repository and introduce it into the managed system, creating both SR record and PBD record to attach it to current host (with specified device_config parameters) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      Returns:
      The reference of the newly created Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrUnknownDriver - The SR could not be connected because the driver was not recognised.
    • create

      public static SR create(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Boolean shared, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException, Types.SrUnknownDriver
      Create a new Storage Repository and introduce it into the managed system, creating both SR record and PBD record to attach it to current host (with specified device_config parameters) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      The reference of the newly created Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrUnknownDriver - The SR could not be connected because the driver was not recognised.
    • createAsync

      public static Task createAsync(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Boolean shared) throws Types.BadServerResponse, Types.XenAPIException, IOException, Types.SrUnknownDriver
      Create a new Storage Repository and introduce it into the managed system, creating both SR record and PBD record to attach it to current host (with specified device_config parameters) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrUnknownDriver - The SR could not be connected because the driver was not recognised.
    • createAsync

      public static Task createAsync(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Boolean shared, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException, Types.SrUnknownDriver
      Create a new Storage Repository and introduce it into the managed system, creating both SR record and PBD record to attach it to current host (with specified device_config parameters) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrUnknownDriver - The SR could not be connected because the driver was not recognised.
    • introduce

      public static SR introduce(Connection c, String uuid, String nameLabel, String nameDescription, String type, String contentType, Boolean shared) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Introduce a new Storage Repository into the managed system Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      uuid - The uuid assigned to the introduced SR
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      Returns:
      The reference of the newly introduced Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • introduce

      public static SR introduce(Connection c, String uuid, String nameLabel, String nameDescription, String type, String contentType, Boolean shared, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Introduce a new Storage Repository into the managed system Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      uuid - The uuid assigned to the introduced SR
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      The reference of the newly introduced Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • introduceAsync

      public static Task introduceAsync(Connection c, String uuid, String nameLabel, String nameDescription, String type, String contentType, Boolean shared) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Introduce a new Storage Repository into the managed system Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      uuid - The uuid assigned to the introduced SR
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • introduceAsync

      public static Task introduceAsync(Connection c, String uuid, String nameLabel, String nameDescription, String type, String contentType, Boolean shared, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Introduce a new Storage Repository into the managed system Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      uuid - The uuid assigned to the introduced SR
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      shared - True if the SR (is capable of) being shared by multiple hosts
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • make

      @Deprecated(since="XenServer 4.1") public static String make(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Deprecated.
      since XenServer 4.1
      Create a new Storage Repository on disk. This call is deprecated: use SR.create instead. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      Returns:
      The uuid of the newly created Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • make

      @Deprecated(since="XenServer 4.1") public static String make(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Deprecated.
      since XenServer 4.1
      Create a new Storage Repository on disk. This call is deprecated: use SR.create instead. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      The uuid of the newly created Storage Repository.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • makeAsync

      @Deprecated(since="XenServer 4.1") public static Task makeAsync(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Deprecated.
      since XenServer 4.1
      Create a new Storage Repository on disk. This call is deprecated: use SR.create instead. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • makeAsync

      @Deprecated(since="XenServer 4.1") public static Task makeAsync(Connection c, Host host, Map<String,String> deviceConfig, Long physicalSize, String nameLabel, String nameDescription, String type, String contentType, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Deprecated.
      since XenServer 4.1
      Create a new Storage Repository on disk. This call is deprecated: use SR.create instead. Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      physicalSize - The physical size of the new storage repository
      nameLabel - The name of the new storage repository
      nameDescription - The description of the new storage repository
      type - The type of the SR; used to specify the SR backend driver to use
      contentType - The type of the new SRs content, if required (e.g. ISOs)
      smConfig - Storage backend specific configuration options First published in XenServer 4.1.
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • destroy

      Destroy specified SR, removing SR-record from database and remove SR from disk. (In order to affect this operation the appropriate device_config is read from the specified SR's PBD on current host) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrHasPbd - The SR is still connected to a host via a PBD. It cannot be destroyed or forgotten.
    • destroyAsync

      Destroy specified SR, removing SR-record from database and remove SR from disk. (In order to affect this operation the appropriate device_config is read from the specified SR's PBD on current host) Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrHasPbd - The SR is still connected to a host via a PBD. It cannot be destroyed or forgotten.
    • forget

      Removing specified SR-record from database, without attempting to remove SR from disk Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrHasPbd - The SR is still connected to a host via a PBD. It cannot be destroyed or forgotten.
    • forgetAsync

      Removing specified SR-record from database, without attempting to remove SR from disk Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
      Types.SrHasPbd - The SR is still connected to a host via a PBD. It cannot be destroyed or forgotten.
    • update

      Refresh the fields on the SR object Minimum allowed role: pool-operator First published in XenServer 4.1.1.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • updateAsync

      Refresh the fields on the SR object Minimum allowed role: pool-operator First published in XenServer 4.1.1.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getSupportedTypes

      public static Set<String> getSupportedTypes(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Return a set of all the SR types supported by the system Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      the supported SR types
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • scan

      Refreshes the list of VDIs associated with an SR Minimum allowed role: vm-power-admin First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • scanAsync

      Refreshes the list of VDIs associated with an SR Minimum allowed role: vm-power-admin First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probe

      public static String probe(Connection c, Host host, Map<String,String> deviceConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      Returns:
      An XML fragment containing the scan results. These are specific to the scan being performed, and the backend.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probe

      public static String probe(Connection c, Host host, Map<String,String> deviceConfig, String type, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      type - The type of the SR; used to specify the SR backend driver to use
      smConfig - Storage backend specific configuration options
      Returns:
      An XML fragment containing the scan results. These are specific to the scan being performed, and the backend.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probeAsync

      public static Task probeAsync(Connection c, Host host, Map<String,String> deviceConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probeAsync

      public static Task probeAsync(Connection c, Host host, Map<String,String> deviceConfig, String type, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      type - The type of the SR; used to specify the SR backend driver to use
      smConfig - Storage backend specific configuration options
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probeExt

      public static Set<ProbeResult.Record> probeExt(Connection c, Host host, Map<String,String> deviceConfig, String type, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 7.6.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      type - The type of the SR; used to specify the SR backend driver to use
      smConfig - Storage backend specific configuration options
      Returns:
      A set of records containing the scan results.
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • probeExtAsync

      public static Task probeExtAsync(Connection c, Host host, Map<String,String> deviceConfig, String type, Map<String,String> smConfig) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Perform a backend-specific scan, using the given device_config. If the device_config is complete, then this will return a list of the SRs present of this type on the device, if any. If the device_config is partial, then a backend-specific scan will be performed, returning results that will guide the user in improving the device_config. Minimum allowed role: pool-operator First published in XenServer 7.6.
      Parameters:
      c - The connection the call is made on
      host - The host to create/make the SR on
      deviceConfig - The device config string that will be passed to backend SR driver
      type - The type of the SR; used to specify the SR backend driver to use
      smConfig - Storage backend specific configuration options
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setShared

      public void setShared(Connection c, Boolean value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Sets the shared flag on the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - True if the SR is shared
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setSharedAsync

      Sets the shared flag on the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - True if the SR is shared
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setNameLabel

      public void setNameLabel(Connection c, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the name label of the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - The name label for the SR
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setNameLabelAsync

      public Task setNameLabelAsync(Connection c, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the name label of the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - The name label for the SR
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setNameDescription

      public void setNameDescription(Connection c, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the name description of the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - The name description for the SR
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setNameDescriptionAsync

      public Task setNameDescriptionAsync(Connection c, String value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Set the name description of the SR Minimum allowed role: pool-operator First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      value - The name description for the SR
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • createNewBlob

      public Blob createNewBlob(Connection c, String name, String mimeType) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Create a placeholder for a named binary blob of data that is associated with this SR Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      name - The name associated with the blob
      mimeType - The mime type for the data. Empty string translates to application/octet-stream
      Returns:
      The reference of the blob, needed for populating its data
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • createNewBlob

      public Blob createNewBlob(Connection c, String name, String mimeType, Boolean _public) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Create a placeholder for a named binary blob of data that is associated with this SR Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      name - The name associated with the blob
      mimeType - The mime type for the data. Empty string translates to application/octet-stream
      _public - True if the blob should be publicly available First published in XenServer 6.1.
      Returns:
      The reference of the blob, needed for populating its data
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • createNewBlobAsync

      public Task createNewBlobAsync(Connection c, String name, String mimeType) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Create a placeholder for a named binary blob of data that is associated with this SR Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      name - The name associated with the blob
      mimeType - The mime type for the data. Empty string translates to application/octet-stream
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • createNewBlobAsync

      public Task createNewBlobAsync(Connection c, String name, String mimeType, Boolean _public) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Create a placeholder for a named binary blob of data that is associated with this SR Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      name - The name associated with the blob
      mimeType - The mime type for the data. Empty string translates to application/octet-stream
      _public - True if the blob should be publicly available First published in XenServer 6.1.
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • setPhysicalSize

      public void setPhysicalSize(Connection c, Long value) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Sets the SR's physical_size field Minimum allowed role: pool-operator First published in XenServer 4.1.
      Parameters:
      c - The connection the call is made on
      value - The new value of the SR's physical_size
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • assertCanHostHaStatefile

      public void assertCanHostHaStatefile(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Returns successfully if the given SR can host an HA statefile. Otherwise returns an error to explain why not Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • assertCanHostHaStatefileAsync

      public Task assertCanHostHaStatefileAsync(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Returns successfully if the given SR can host an HA statefile. Otherwise returns an error to explain why not Minimum allowed role: pool-operator First published in XenServer 5.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • assertSupportsDatabaseReplication

      public void assertSupportsDatabaseReplication(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Returns successfully if the given SR supports database replication. Otherwise returns an error to explain why not. Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • assertSupportsDatabaseReplicationAsync

      public Task assertSupportsDatabaseReplicationAsync(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Returns successfully if the given SR supports database replication. Otherwise returns an error to explain why not. Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • enableDatabaseReplication

      public void enableDatabaseReplication(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • enableDatabaseReplicationAsync

      public Task enableDatabaseReplicationAsync(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • disableDatabaseReplication

      public void disableDatabaseReplication(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • disableDatabaseReplicationAsync

      public Task disableDatabaseReplicationAsync(Connection c) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Minimum allowed role: pool-operator First published in XenServer 6.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      Task
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getDataSources

      Minimum allowed role: read-only First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      A set of data sources
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • recordDataSource

      public void recordDataSource(Connection c, String dataSource) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Start recording the specified data source Minimum allowed role: pool-operator First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      dataSource - The data source to record
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • queryDataSource

      public Double queryDataSource(Connection c, String dataSource) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Query the latest value of the specified data source Minimum allowed role: read-only First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      dataSource - The data source to query
      Returns:
      The latest value, averaged over the last 5 seconds
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • forgetDataSourceArchives

      public void forgetDataSourceArchives(Connection c, String dataSource) throws Types.BadServerResponse, Types.XenAPIException, IOException
      Forget the recorded statistics related to the specified data source Minimum allowed role: pool-operator First published in XenServer 7.0.
      Parameters:
      c - The connection the call is made on
      dataSource - The data source whose archives are to be forgotten
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getAll

      Return a list of all the SRs known to the system. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      references to all objects
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.
    • getAllRecords

      Return a map of SR references to SR records for all SRs known to the system. Minimum allowed role: read-only First published in XenServer 4.0.
      Parameters:
      c - The connection the call is made on
      Returns:
      records of all objects
      Throws:
      Types.BadServerResponse - Thrown if the response from the server contains an invalid status.
      Types.XenAPIException - if the call failed.
      IOException - if an error occurs during a send or receive. This includes cases where a payload is invalid JSON.