DataSync / Client / describe_storage_system_resource_metrics

describe_storage_system_resource_metrics

DataSync.Client.describe_storage_system_resource_metrics(**kwargs)

Returns information, including performance data and capacity usage, which DataSync Discovery collects about a specific resource in your-premises storage system.

See also: AWS API Documentation

Request Syntax

response = client.describe_storage_system_resource_metrics(
    DiscoveryJobArn='string',
    ResourceType='SVM'|'VOLUME'|'CLUSTER',
    ResourceId='string',
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    MaxResults=123,
    NextToken='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.

• MaxResults (integer) – Specifies how many results that you want in the response.

• NextToken (string) – Specifies an opaque string that indicates the position to begin the next list of results in the 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'
        },
    ],
    'NextToken': 'string'
}

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.

  • NextToken (string) –

    The opaque string that indicates the position to begin the next list of results in the response.

Exceptions

• DataSync.Client.exceptions.InvalidRequestException

• DataSync.Client.exceptions.InternalException