DataSync / Client / describe_storage_system_resources

describe_storage_system_resources#

DataSync.Client.describe_storage_system_resources(**kwargs)#

Returns information that DataSync Discovery collects about resources in your on-premises storage system.

See also: AWS API Documentation

Request Syntax

response = client.describe_storage_system_resources(
    DiscoveryJobArn='string',
    ResourceType='SVM'|'VOLUME'|'CLUSTER',
    ResourceIds=[
        'string',
    ],
    Filter={
        'string': [
            'string',
        ]
    },
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • DiscoveryJobArn (string) –

    [REQUIRED]

    Specifies the Amazon Resource Name (ARN) of the discovery job that’s collecting data from your on-premises storage system.

  • ResourceType (string) –

    [REQUIRED]

    Specifies what kind of storage system resources that you want information about.

  • ResourceIds (list) –

    Specifies the universally unique identifiers (UUIDs) of the storage system resources that you want information about. You can’t use this parameter in combination with the Filter parameter.

    • (string) –

  • Filter (dict) –

    Filters the storage system resources that you want returned. For example, this might be volumes associated with a specific storage virtual machine (SVM).

    • (string) –

      • (list) –

        • (string) –

  • MaxResults (integer) – Specifies the maximum number of storage system resources that you want to list in a 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

{
    'ResourceDetails': {
        'NetAppONTAPSVMs': [
            {
                'ClusterUuid': 'string',
                'ResourceId': 'string',
                'SvmName': 'string',
                'CifsShareCount': 123,
                'EnabledProtocols': [
                    'string',
                ],
                'TotalCapacityUsed': 123,
                'TotalCapacityProvisioned': 123,
                'TotalLogicalCapacityUsed': 123,
                'MaxP95Performance': {
                    'IopsRead': 123.0,
                    'IopsWrite': 123.0,
                    'IopsOther': 123.0,
                    'IopsTotal': 123.0,
                    'ThroughputRead': 123.0,
                    'ThroughputWrite': 123.0,
                    'ThroughputOther': 123.0,
                    'ThroughputTotal': 123.0,
                    'LatencyRead': 123.0,
                    'LatencyWrite': 123.0,
                    'LatencyOther': 123.0
                },
                'Recommendations': [
                    {
                        'StorageType': 'string',
                        'StorageConfiguration': {
                            'string': 'string'
                        },
                        'EstimatedMonthlyStorageCost': 'string'
                    },
                ],
                'NfsExportedVolumes': 123,
                'RecommendationStatus': 'NONE'|'IN_PROGRESS'|'COMPLETED'|'FAILED',
                'TotalSnapshotCapacityUsed': 123
            },
        ],
        'NetAppONTAPVolumes': [
            {
                'VolumeName': 'string',
                'ResourceId': 'string',
                'CifsShareCount': 123,
                'SecurityStyle': 'string',
                'SvmUuid': 'string',
                'SvmName': 'string',
                'CapacityUsed': 123,
                'CapacityProvisioned': 123,
                'LogicalCapacityUsed': 123,
                'NfsExported': True|False,
                'SnapshotCapacityUsed': 123,
                'MaxP95Performance': {
                    'IopsRead': 123.0,
                    'IopsWrite': 123.0,
                    'IopsOther': 123.0,
                    'IopsTotal': 123.0,
                    'ThroughputRead': 123.0,
                    'ThroughputWrite': 123.0,
                    'ThroughputOther': 123.0,
                    'ThroughputTotal': 123.0,
                    'LatencyRead': 123.0,
                    'LatencyWrite': 123.0,
                    'LatencyOther': 123.0
                },
                'Recommendations': [
                    {
                        'StorageType': 'string',
                        'StorageConfiguration': {
                            'string': 'string'
                        },
                        'EstimatedMonthlyStorageCost': 'string'
                    },
                ],
                'RecommendationStatus': 'NONE'|'IN_PROGRESS'|'COMPLETED'|'FAILED'
            },
        ],
        'NetAppONTAPClusters': [
            {
                'CifsShareCount': 123,
                'NfsExportedVolumes': 123,
                'ResourceId': 'string',
                'ClusterName': 'string',
                'MaxP95Performance': {
                    'IopsRead': 123.0,
                    'IopsWrite': 123.0,
                    'IopsOther': 123.0,
                    'IopsTotal': 123.0,
                    'ThroughputRead': 123.0,
                    'ThroughputWrite': 123.0,
                    'ThroughputOther': 123.0,
                    'ThroughputTotal': 123.0,
                    'LatencyRead': 123.0,
                    'LatencyWrite': 123.0,
                    'LatencyOther': 123.0
                },
                'ClusterBlockStorageSize': 123,
                'ClusterBlockStorageUsed': 123,
                'ClusterBlockStorageLogicalUsed': 123,
                'Recommendations': [
                    {
                        'StorageType': 'string',
                        'StorageConfiguration': {
                            'string': 'string'
                        },
                        'EstimatedMonthlyStorageCost': 'string'
                    },
                ],
                'RecommendationStatus': 'NONE'|'IN_PROGRESS'|'COMPLETED'|'FAILED'
            },
        ]
    },
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • ResourceDetails (dict) –

      The information collected about your storage system’s resources. A response can also include Amazon Web Services storage service recommendations.

      For more information, see storage resource information collected by and recommendations provided by DataSync Discovery.

      • NetAppONTAPSVMs (list) –

        The information that DataSync Discovery collects about storage virtual machines (SVMs) in your on-premises storage system.

        • (dict) –

          The information that DataSync Discovery collects about a storage virtual machine (SVM) in your on-premises storage system.

          • ClusterUuid (string) –

            The universally unique identifier (UUID) of the cluster associated with the SVM.

          • ResourceId (string) –

            The UUID of the SVM.

          • SvmName (string) –

            The name of the SVM

          • CifsShareCount (integer) –

            The number of CIFS shares in the SVM.

          • EnabledProtocols (list) –

            The data transfer protocols (such as NFS) configured for the SVM.

            • (string) –

          • TotalCapacityUsed (integer) –

            The storage space that’s being used in the SVM.

          • TotalCapacityProvisioned (integer) –

            The total storage space that’s available in the SVM.

          • TotalLogicalCapacityUsed (integer) –

            The storage space that’s being used in the SVM without accounting for compression or deduplication.

          • MaxP95Performance (dict) –

            The performance data that DataSync Discovery collects about the SVM.

            • IopsRead (float) –

              Peak IOPS related to read operations.

            • IopsWrite (float) –

              Peak IOPS related to write operations.

            • IopsOther (float) –

              Peak IOPS unrelated to read and write operations.

            • IopsTotal (float) –

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

            • ThroughputRead (float) –

              Peak throughput related to read operations.

            • ThroughputWrite (float) –

              Peak throughput related to write operations.

            • ThroughputOther (float) –

              Peak throughput unrelated to read and write operations.

            • ThroughputTotal (float) –

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

            • LatencyRead (float) –

              Peak latency for read operations.

            • LatencyWrite (float) –

              Peak latency for write operations.

            • LatencyOther (float) –

              Peak latency for operations unrelated to read and write operations.

          • Recommendations (list) –

            The Amazon Web Services storage services that DataSync Discovery recommends for the SVM. For more information, see Recommendations provided by DataSync Discovery.

            • (dict) –

              The details about an Amazon Web Services storage service that DataSync Discovery recommends for a resource in your on-premises storage system.

              For more information, see Recommendations provided by DataSync Discovery.

              • StorageType (string) –

                A recommended Amazon Web Services storage service that you can migrate data to based on information that DataSync Discovery collects about your on-premises storage system.

              • StorageConfiguration (dict) –

                Information about how you can set up a recommended Amazon Web Services storage service.

                • (string) –

                  • (string) –

              • EstimatedMonthlyStorageCost (string) –

                The estimated monthly cost of the recommended Amazon Web Services storage service.

          • NfsExportedVolumes (integer) –

            The number of NFS volumes in the SVM.

          • RecommendationStatus (string) –

            Indicates whether DataSync Discovery recommendations for the SVM are ready to view, incomplete, or can’t be determined.

            For more information, see Recommendation statuses.

          • TotalSnapshotCapacityUsed (integer) –

            The amount of storage in the SVM that’s being used for snapshots.

      • NetAppONTAPVolumes (list) –

        The information that DataSync Discovery collects about volumes in your on-premises storage system.

        • (dict) –

          The information that DataSync Discovery collects about a volume in your on-premises storage system.

          • VolumeName (string) –

            The name of the volume.

          • ResourceId (string) –

            The universally unique identifier (UUID) of the volume.

          • CifsShareCount (integer) –

            The number of CIFS shares in the volume.

          • SecurityStyle (string) –

            The volume’s security style (such as Unix or NTFS).

          • SvmUuid (string) –

            The UUID of the storage virtual machine (SVM) associated with the volume.

          • SvmName (string) –

            The name of the SVM associated with the volume.

          • CapacityUsed (integer) –

            The storage space that’s being used in the volume.

          • CapacityProvisioned (integer) –

            The total storage space that’s available in the volume.

          • LogicalCapacityUsed (integer) –

            The storage space that’s being used in the volume without accounting for compression or deduplication.

          • NfsExported (boolean) –

            The number of NFS volumes in the volume.

          • SnapshotCapacityUsed (integer) –

            The amount of storage in the volume that’s being used for snapshots.

          • MaxP95Performance (dict) –

            The performance data that DataSync Discovery collects about the volume.

            • IopsRead (float) –

              Peak IOPS related to read operations.

            • IopsWrite (float) –

              Peak IOPS related to write operations.

            • IopsOther (float) –

              Peak IOPS unrelated to read and write operations.

            • IopsTotal (float) –

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

            • ThroughputRead (float) –

              Peak throughput related to read operations.

            • ThroughputWrite (float) –

              Peak throughput related to write operations.

            • ThroughputOther (float) –

              Peak throughput unrelated to read and write operations.

            • ThroughputTotal (float) –

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

            • LatencyRead (float) –

              Peak latency for read operations.

            • LatencyWrite (float) –

              Peak latency for write operations.

            • LatencyOther (float) –

              Peak latency for operations unrelated to read and write operations.

          • Recommendations (list) –

            The Amazon Web Services storage services that DataSync Discovery recommends for the volume. For more information, see Recommendations provided by DataSync Discovery.

            • (dict) –

              The details about an Amazon Web Services storage service that DataSync Discovery recommends for a resource in your on-premises storage system.

              For more information, see Recommendations provided by DataSync Discovery.

              • StorageType (string) –

                A recommended Amazon Web Services storage service that you can migrate data to based on information that DataSync Discovery collects about your on-premises storage system.

              • StorageConfiguration (dict) –

                Information about how you can set up a recommended Amazon Web Services storage service.

                • (string) –

                  • (string) –

              • EstimatedMonthlyStorageCost (string) –

                The estimated monthly cost of the recommended Amazon Web Services storage service.

          • RecommendationStatus (string) –

            Indicates whether DataSync Discovery recommendations for the volume are ready to view, incomplete, or can’t be determined.

            For more information, see Recommendation statuses.

      • NetAppONTAPClusters (list) –

        The information that DataSync Discovery collects about the cluster in your on-premises storage system.

        • (dict) –

          The information that DataSync Discovery collects about an on-premises storage system cluster.

          • CifsShareCount (integer) –

            The number of CIFS shares in the cluster.

          • NfsExportedVolumes (integer) –

            The number of NFS volumes in the cluster.

          • ResourceId (string) –

            The universally unique identifier (UUID) of the cluster.

          • ClusterName (string) –

            The name of the cluster.

          • MaxP95Performance (dict) –

            The performance data that DataSync Discovery collects about the cluster.

            • IopsRead (float) –

              Peak IOPS related to read operations.

            • IopsWrite (float) –

              Peak IOPS related to write operations.

            • IopsOther (float) –

              Peak IOPS unrelated to read and write operations.

            • IopsTotal (float) –

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

            • ThroughputRead (float) –

              Peak throughput related to read operations.

            • ThroughputWrite (float) –

              Peak throughput related to write operations.

            • ThroughputOther (float) –

              Peak throughput unrelated to read and write operations.

            • ThroughputTotal (float) –

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

            • LatencyRead (float) –

              Peak latency for read operations.

            • LatencyWrite (float) –

              Peak latency for write operations.

            • LatencyOther (float) –

              Peak latency for operations unrelated to read and write operations.

          • ClusterBlockStorageSize (integer) –

            The total storage space that’s available in the cluster.

          • ClusterBlockStorageUsed (integer) –

            The storage space that’s being used in a cluster.

          • ClusterBlockStorageLogicalUsed (integer) –

            The storage space that’s being used in the cluster without accounting for compression or deduplication.

          • Recommendations (list) –

            The Amazon Web Services storage services that DataSync Discovery recommends for the cluster. For more information, see Recommendations provided by DataSync Discovery.

            • (dict) –

              The details about an Amazon Web Services storage service that DataSync Discovery recommends for a resource in your on-premises storage system.

              For more information, see Recommendations provided by DataSync Discovery.

              • StorageType (string) –

                A recommended Amazon Web Services storage service that you can migrate data to based on information that DataSync Discovery collects about your on-premises storage system.

              • StorageConfiguration (dict) –

                Information about how you can set up a recommended Amazon Web Services storage service.

                • (string) –

                  • (string) –

              • EstimatedMonthlyStorageCost (string) –

                The estimated monthly cost of the recommended Amazon Web Services storage service.

          • RecommendationStatus (string) –

            Indicates whether DataSync Discovery recommendations for the cluster are ready to view, incomplete, or can’t be determined.

            For more information, see Recommendation statuses.

    • 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