DataSync / Paginator / DescribeStorageSystemResourceMetrics

DescribeStorageSystemResourceMetrics#

class DataSync.Paginator.DescribeStorageSystemResourceMetrics#
paginator = client.get_paginator('describe_storage_system_resource_metrics')
paginate(**kwargs)#

Creates an iterator that will paginate through responses from DataSync.Client.describe_storage_system_resource_metrics().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    DiscoveryJobArn='string',
    ResourceType='SVM'|'VOLUME'|'CLUSTER',
    ResourceId='string',
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters:
  • DiscoveryJobArn (string) –

    [REQUIRED]

    Specifies the Amazon Resource Name (ARN) of the discovery job that collects information about your on-premises storage system.

  • ResourceType (string) –

    [REQUIRED]

    Specifies the kind of storage system resource that you want information about.

  • ResourceId (string) –

    [REQUIRED]

    Specifies the universally unique identifier (UUID) of the storage system resource that you want information about.

  • StartTime (datetime) – Specifies a time within the total duration that the discovery job ran. To see information gathered during a certain time frame, use this parameter with EndTime.

  • EndTime (datetime) – Specifies a time within the total duration that the discovery job ran. To see information gathered during a certain time frame, use this parameter with StartTime.

  • PaginationConfig (dict) –

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) –

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) –

      The size of each page.

    • StartingToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type:

dict

Returns:

Response Syntax

{
    'Metrics': [
        {
            'Timestamp': datetime(2015, 1, 1),
            'P95Metrics': {
                'IOPS': {
                    'Read': 123.0,
                    'Write': 123.0,
                    'Other': 123.0,
                    'Total': 123.0
                },
                'Throughput': {
                    'Read': 123.0,
                    'Write': 123.0,
                    'Other': 123.0,
                    'Total': 123.0
                },
                'Latency': {
                    'Read': 123.0,
                    'Write': 123.0,
                    'Other': 123.0
                }
            },
            'Capacity': {
                'Used': 123,
                'Provisioned': 123,
                'LogicalUsed': 123
            },
            'ResourceId': 'string',
            'ResourceType': 'SVM'|'VOLUME'|'CLUSTER'
        },
    ],

}

Response Structure

  • (dict) –

    • Metrics (list) –

      The details that your discovery job collected about your storage system resource.

      • (dict) –

        Information, including performance data and capacity usage, provided by DataSync Discovery about a resource in your on-premises storage system.

        • Timestamp (datetime) –

          The time when DataSync Discovery collected this information from the resource.

        • P95Metrics (dict) –

          The types of performance data that DataSync Discovery collects about the on-premises storage system resource.

          • IOPS (dict) –

            The IOPS peaks for an on-premises storage system resource. Each data point represents the 95th percentile peak value during a 1-hour interval.

            • Read (float) –

              Peak IOPS related to read operations.

            • Write (float) –

              Peak IOPS related to write operations.

            • Other (float) –

              Peak IOPS unrelated to read and write operations.

            • Total (float) –

              Peak total IOPS on your on-premises storage system resource.

          • Throughput (dict) –

            The throughput peaks for an on-premises storage system resource. Each data point represents the 95th percentile peak value during a 1-hour interval.

            • Read (float) –

              Peak throughput related to read operations.

            • Write (float) –

              Peak throughput related to write operations.

            • Other (float) –

              Peak throughput unrelated to read and write operations.

            • Total (float) –

              Peak total throughput on your on-premises storage system resource.

          • Latency (dict) –

            The latency peaks for an on-premises storage system resource. Each data point represents the 95th percentile peak value during a 1-hour interval.

            • Read (float) –

              Peak latency for read operations.

            • Write (float) –

              Peak latency for write operations.

            • Other (float) –

              Peak latency for operations unrelated to read and write operations.

        • Capacity (dict) –

          The storage capacity of the on-premises storage system resource.

          • Used (integer) –

            The amount of space that’s being used in a storage system resource.

          • Provisioned (integer) –

            The total amount of space available in a storage system resource.

          • LogicalUsed (integer) –

            The amount of space that’s being used in a storage system resource without accounting for compression or deduplication.

        • ResourceId (string) –

          The universally unique identifier (UUID) of the on-premises storage system resource.

        • ResourceType (string) –

          The type of on-premises storage system resource.