OpsWorks / Client / describe_volumes

describe_volumes#

OpsWorks.Client.describe_volumes(**kwargs)#

Describes an instance’s Amazon EBS volumes.

Note

This call accepts only one resource-identifying parameter.

Required Permissions: To use this action, an IAM user must have a Show, Deploy, or Manage permissions level for the stack, or an attached policy that explicitly grants permissions. For more information about user permissions, see Managing User Permissions.

See also: AWS API Documentation

Request Syntax

response = client.describe_volumes(
    InstanceId='string',
    StackId='string',
    RaidArrayId='string',
    VolumeIds=[
        'string',
    ]
)
Parameters:
  • InstanceId (string) – The instance ID. If you use this parameter, DescribeVolumes returns descriptions of the volumes associated with the specified instance.

  • StackId (string) – A stack ID. The action describes the stack’s registered Amazon EBS volumes.

  • RaidArrayId (string) – The RAID array ID. If you use this parameter, DescribeVolumes returns descriptions of the volumes associated with the specified RAID array.

  • VolumeIds (list) –

    Am array of volume IDs. If you use this parameter, DescribeVolumes returns descriptions of the specified volumes. Otherwise, it returns a description of every volume.

    • (string) –

Return type:

dict

Returns:

Response Syntax

{
    'Volumes': [
        {
            'VolumeId': 'string',
            'Ec2VolumeId': 'string',
            'Name': 'string',
            'RaidArrayId': 'string',
            'InstanceId': 'string',
            'Status': 'string',
            'Size': 123,
            'Device': 'string',
            'MountPoint': 'string',
            'Region': 'string',
            'AvailabilityZone': 'string',
            'VolumeType': 'string',
            'Iops': 123,
            'Encrypted': True|False
        },
    ]
}

Response Structure

  • (dict) –

    Contains the response to a DescribeVolumes request.

    • Volumes (list) –

      An array of volume IDs.

      • (dict) –

        Describes an instance’s Amazon EBS volume.

        • VolumeId (string) –

          The volume ID.

        • Ec2VolumeId (string) –

          The Amazon EC2 volume ID.

        • Name (string) –

          The volume name. Volume names are a maximum of 128 characters.

        • RaidArrayId (string) –

          The RAID array ID.

        • InstanceId (string) –

          The instance ID.

        • Status (string) –

          The value returned by DescribeVolumes.

        • Size (integer) –

          The volume size.

        • Device (string) –

          The device name.

        • MountPoint (string) –

          The volume mount point. For example, “/mnt/disk1”.

        • Region (string) –

          The Amazon Web Services Region. For more information about Amazon Web Services Regions, see Regions and Endpoints.

        • AvailabilityZone (string) –

          The volume Availability Zone. For more information, see Regions and Endpoints.

        • VolumeType (string) –

          The volume type. For more information, see Amazon EBS Volume Types.

          • standard - Magnetic. Magnetic volumes must have a minimum size of 1 GiB and a maximum size of 1024 GiB.

          • io1 - Provisioned IOPS (SSD). PIOPS volumes must have a minimum size of 4 GiB and a maximum size of 16384 GiB.

          • gp2 - General Purpose (SSD). General purpose volumes must have a minimum size of 1 GiB and a maximum size of 16384 GiB.

          • st1 - Throughput Optimized hard disk drive (HDD). Throughput optimized HDD volumes must have a minimum size of 125 GiB and a maximum size of 16384 GiB.

          • sc1 - Cold HDD. Cold HDD volumes must have a minimum size of 125 GiB and a maximum size of 16384 GiB.

        • Iops (integer) –

          For PIOPS volumes, the IOPS per disk.

        • Encrypted (boolean) –

          Specifies whether an Amazon EBS volume is encrypted. For more information, see Amazon EBS Encryption.

Exceptions

  • OpsWorks.Client.exceptions.ValidationException

  • OpsWorks.Client.exceptions.ResourceNotFoundException