List storage components

Retrieves a list of all storage components created in the VSP One Object system, along with their associated component settings.

Endpoint

POST /storage_component/list

Request structure

Not applicable.

Response structure

  {
    "id": "string",
    "storageType": "string",
    "storageComponentConfig": {
      "label": "Cloud AWS Bucket",
      "storageFaultDomain": "string",
      "storageClass": "string",
      "host": "URL of an existing storage component backend",
      "uriScheme": "HTTPS",
      "port": 0,
      "bucket": "string",
      "region": "string",
      "authType": "V2",
      "siteAffiliation": {
        "id": "string"
      },
      "useProxy": true,
      "proxyHost": "string",
      "proxyPort": 0,
      "proxyUserName": "string",
      "proxyPassword": "string",
      "proxyDomain": "string",
      "usePathStyleAlways": true,
      "connectionTimeout": 0,
      "socketTimeout": 0,
      "connectionTTL": 0,
      "maxConnections": 0,
      "userAgentPrefix": "string",
      "socketSendBufferSizeHint": 0,
      "socketRecvBufferSizeHint": 0,
      "managementProtocol": "http or https",
      "managementHost": "hostname.acme.org",
      "namespace": "string",
      "dataPersistentVolumeName": "string",
      "dataClaimCapacity": "string",
      "node": "string",
      "state": "ACTIVE",
      "encryptedKeyVersions": "string"
    },
    "storageFaultDomainId": "string",
    "storageClassId": "string",
    "storageCustomMetadata": {
      "custom1": "data",
      "custom2": "data2"
    }
  }
]

Parameter	Type	Description
id	UUID	The ID of the storage component.
storageType	Enum	The type of storage component: `AMAZON_S3`: An Amazon Web Services S3-compatible node `HCP_S3`: A Hitachi Content Platform node `HCPS_S3`: An VSP One Object S Series node `GENERIC_S3`: An S3-compatible node
storageComponentConfig	List	The following storage component configuration values:
label	String	The name of the storage component.
host	String	The URL of the storage component back-end host domain.
https	Boolean	`true` for HTTPS connection to back-end system, `false` for HTTP.
port	32-bit integer	HTTP port to back-end system.
bucket	String	The name of the bucket.
region	String	The S3 region.
authType	String	AWS Signature Version, used for authenticating all interactions with Amazon S3: `V2` `V4`
siteAffiliation	UUID	The value of `id`, a UUID representing the storage component or the user.
useProxy	Boolean	If `true`, a proxy server is defined. If `false`, a proxy server is not defined.
proxyHost	String	The proxy host, if used; otherwise, `null`.
proxyPort	32-bit integer	The proxy port number, if used; otherwise, `null`.
proxyUserName	String	The proxy domain user name, if used; otherwise, `null`.
proxyPassword	String	The proxy domain password, if used; otherwise, `null`.
proxyDomain	String	The proxy domain, if used; otherwise, `null`.
usePathStyleAlways	Boolean	If `true`, use path-style syntax to send requests to the back-end system; if `false`, use virtual-hosted style.
connectionTimeout	32-bit integer	The amount of time, in milliseconds, that the HTTP connection waits to establish a connection before timing out.
socketTimeout	32-bit integer	The timeout value for reading from a connected socket.
connectionTTL	64-bit integer	The connection time to live (TTL) for a request.
maxConnections	32-bit integer	The maximum number of open HTTP connections to a storage component.
userAgentPrefix	String	The HTTP user agent prefix header, used in requests to a storage component.
socketSendBufferSizeHint	32-bit integer	The size hint, in bytes, for the low-level TCP send buffer.
socketRecvBufferSizeHint	32-bit integer	The size hint, in bytes, for the low-level TCP receive buffer.
managementProtocol	String	The communication protocol for VSP One Object S Series node MAPI requests: `http` `https`
managementHost	String	The host managing an VSP One Object S Series node storage component.
readOnly	Boolean	If `true`, the storage component is marked as read-only. If `false`, the storage component is available for reading and writing data.
state	Enum	The state of the storage component, indicating its availability to serve requests: `ACTIVE`: The storage component is ready for requests. `INACTIVE`: The storage component is on an administrative pause. `INACCESSIBLE`: The storage component is not accessible. This can be caused by network, authentication, or certificate errors. `UNVERIFIED`: The storage component has not been activated or has failed to activate.

Return codes

Status code	HTTP name	Description
200	OK	The request was executed successfully.
401	Unauthorized	Access was denied because credentials are not valid.
405	Method Not Allowed	The specified HTTP method is not allowed for a storage component. Resend using POST.