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