Returns the description of the gateway volumes specified in the request. The list of gateway volumes in the request must be from one gateway. In the response, Storage Gateway returns volume information sorted by volume ARNs. This operation is only supported in stored volume gateway type.
Parameters:
-
volume_ar_ns
(VolumeARNs)
–
An array of strings where each string represents the Amazon Resource Name (ARN) of a stored volume. All of the specified stored volumes must be from the same gateway. Use ListVolumes to get volume ARNs for a gateway.
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 describe the volumes of a gateway
Returns the description of the gateway volumes specified in the request belonging to the same gateway.
>>> await client.describe_storedi_scsi_volumes(volume_ar_ns=['arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB'])
Source code in docs_src/capo_storage_gateway/_services/async_storage_gateway.py
| async def describe_storedi_scsi_volumes(
self,
volume_ar_ns: "capo_storage_gateway.types.volume_ar_ns.VolumeARNs",
*,
config_overrides: Optional[AsyncStorageGatewayClientConfig] = None,
) -> "capo_storage_gateway.types.describe_storedi_scsi_volumes_output.DescribeStorediSCSIVolumesOutput":
"""<p>Returns the description of the gateway volumes specified in the request. The list of gateway volumes in the request must be from one gateway. In the response, Storage Gateway returns volume information sorted by volume ARNs. This operation is only supported in stored volume gateway type.</p>
Args:
volume_ar_ns: <p>An array of strings where each string represents the Amazon Resource Name (ARN) of a stored volume. All of the specified stored volumes must be from the same gateway. Use <a>ListVolumes</a> to get volume ARNs for a gateway.</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 describe the volumes of a gateway
Returns the description of the gateway volumes specified in the request belonging to the same gateway.
>>> await client.describe_storedi_scsi_volumes(volume_ar_ns=['arn:aws:storagegateway:us-east-1:111122223333:gateway/sgw-12A3456B/volume/vol-1122AABB'])
"""
async def _handler(
req: "AsyncOperationRequest[capo_storage_gateway.types.describe_storedi_scsi_volumes_input.DescribeStorediSCSIVolumesInput]",
) -> AsyncOperationResponse[
"capo_storage_gateway.types.describe_storedi_scsi_volumes_output.DescribeStorediSCSIVolumesOutput"
]:
import capo_storage_gateway._operations.storage_gateway_20130630.describe_storedi_scsi_volumes
(
output,
http_response,
) = await capo_storage_gateway._operations.storage_gateway_20130630.describe_storedi_scsi_volumes.async_describe_storedi_scsi_volumes(
req.options, req.input
)
return AsyncOperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("DescribeStorediSCSIVolumes")
)
input_: capo_storage_gateway.types.describe_storedi_scsi_volumes_input.DescribeStorediSCSIVolumesInput = {
"volume_ar_ns": volume_ar_ns
}
response = await aexecute_pipeline(
AsyncOperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
await response.response.aclose()
return response.output
|