Returns a list of the gateway's local disks. To specify which gateway to describe, you use the Amazon Resource Name (ARN) of the gateway in the body of the request.
The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all. The response includes a DiskStatus field. This field can have a value of present (the disk is available to use), missing (the disk is no longer connected to the gateway), or mismatch (the disk node is occupied by a disk that has incorrect metadata or the disk content is corrupted).
Raises:
-
InternalServerError
–
An internal server error has occurred during the request. For more information, see the error and message fields.
-
InvalidGatewayRequestException
–
An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields.
-
UnknownServiceError
–
The service returned an error code this client does not model.
Examples:
To list the gateway's local disks
The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all.
>>> client.list_local_disks(gateway_arn='arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B')
Source code in docs_src/capo_storage_gateway/_services/storage_gateway.py
| def list_local_disks(
self,
gateway_arn: "capo_storage_gateway.types.gateway_arn.GatewayARN",
*,
config_overrides: Optional[StorageGatewayClientConfig] = None,
) -> "capo_storage_gateway.types.list_local_disks_output.ListLocalDisksOutput":
"""<p>Returns a list of the gateway's local disks. To specify which gateway to describe, you use the Amazon Resource Name (ARN) of the gateway in the body of the request.</p> <p>The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all. The response includes a <code>DiskStatus</code> field. This field can have a value of present (the disk is available to use), missing (the disk is no longer connected to the gateway), or mismatch (the disk node is occupied by a disk that has incorrect metadata or the disk content is corrupted).</p>
Raises:
capo_storage_gateway.errors.internal_server_error.InternalServerError: <p>An internal server error has occurred during the request. For more information, see the error and message fields.</p>
capo_storage_gateway.errors.invalid_gateway_request_exception.InvalidGatewayRequestException: <p>An exception occurred because an invalid gateway request was issued to the service. For more information, see the error and message fields.</p>
capo_storage_gateway.errors.UnknownServiceError: The service returned an error code this client does not model.
Examples:
To list the gateway's local disks
The request returns a list of all disks, specifying which are configured as working storage, cache storage, or stored volume or not configured at all.
>>> client.list_local_disks(gateway_arn='arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B')
"""
def _handler(
req: "OperationRequest[capo_storage_gateway.types.list_local_disks_input.ListLocalDisksInput]",
) -> OperationResponse[
"capo_storage_gateway.types.list_local_disks_output.ListLocalDisksOutput"
]:
import capo_storage_gateway._operations.storage_gateway_20130630.list_local_disks
output, http_response = (
capo_storage_gateway._operations.storage_gateway_20130630.list_local_disks.list_local_disks(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("ListLocalDisks")
)
input_: capo_storage_gateway.types.list_local_disks_input.ListLocalDisksInput = {
"gateway_arn": gateway_arn
}
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|