기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeStorageSystemResourceMetrics
DataSyncDiscovery가 프레미스 스토리지 시스템의 특정 리소스에 대해 수집한 성능 데이터 및 용량 사용량을 비롯한 정보를 반환합니다.
요청 구문
{
"DiscoveryJobArn": "string",
"EndTime": number,
"MaxResults": number,
"NextToken": "string",
"ResourceId": "string",
"ResourceType": "string",
"StartTime": number
}요청 파라미터
모든 작업에 공통인 매개 변수에 대한 자세한 내용은 일반 매개 변수를 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- DiscoveryJobArn
-
온프레미스 스토리지 시스템에 대한 정보를 수집하는 검색 작업의 Amazon 리소스 이름 (ARN) 을 지정합니다.
유형: String
길이 제약: 최대 길이는 256입니다.
패턴:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:system/storage-system-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}/job/discovery-job-[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}$필수 항목 여부: 예
- EndTime
-
검색 작업이 실행된 총 기간 내의 시간을 지정합니다. 특정 기간 동안 수집된 정보를 보려면 이 매개 변수를 와 함께 사용하십시오
StartTime.유형: Timestamp
필수 항목 여부: 아니요
- MaxResults
-
응답에서 원하는 결과 수를 지정합니다.
유형: Integer
유효한 범위: 최소값 1. 최대값 100입니다.
필수 항목 여부: 아니요
- NextToken
-
응답에서 다음 결과 목록을 시작할 위치를 나타내는 불투명 문자열을 지정합니다.
유형: String
길이 제약: 최대 길이는 65535입니다.
패턴:
[a-zA-Z0-9=_-]+필수 항목 여부: 아니요
- ResourceId
-
정보를 확인할 스토리지 시스템 리소스의 UUID (범용 고유 식별자) 를 지정합니다.
유형: String
패턴:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}필수 항목 여부: 예
- ResourceType
-
정보를 보려는 스토리지 시스템 리소스의 종류를 지정합니다.
유형: String
유효한 값:
SVM | VOLUME | CLUSTER필수 항목 여부: 예
- StartTime
-
검색 작업이 실행된 총 기간 내의 시간을 지정합니다. 특정 기간 동안 수집된 정보를 보려면 이 매개 변수를 와 함께 사용하십시오
EndTime.유형: Timestamp
필수 항목 여부: 아니요
응답 구문
{
"Metrics": [
{
"Capacity": {
"LogicalUsed": number,
"Provisioned": number,
"Used": number
},
"P95Metrics": {
"IOPS": {
"Other": number,
"Read": number,
"Total": number,
"Write": number
},
"Latency": {
"Other": number,
"Read": number,
"Write": number
},
"Throughput": {
"Other": number,
"Read": number,
"Total": number,
"Write": number
}
},
"ResourceId": "string",
"ResourceType": "string",
"Timestamp": number
}
],
"NextToken": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- Metrics
-
검색 작업에서 스토리지 시스템 리소스에 대해 수집한 세부 정보
유형: ResourceMetrics 객체 배열
- NextToken
-
응답에서 다음 결과 목록을 시작할 위치를 나타내는 불투명 문자열입니다.
유형: String
길이 제약: 최대 길이는 65535입니다.
패턴:
[a-zA-Z0-9=_-]+
오류
모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
예시
예제 요청
다음 예에서는 온프레미스 스토리지 시스템의 볼륨에 대한 정보를 요청합니다.
{ "DiscoveryJobArn": "arn:aws:datasync:us-east-1:123456789012:system/storage-system-abcdef01234567890/job/discovery-job-12345678-90ab-cdef-0abc-021345abcdef6", "ResourceType": "VOLUME", "ResourceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }
샘플 응답
다음 예제 응답에는 볼륨에 대한 성능 및 용량 정보가 포함되어 있습니다.
{ "Metrics": [ { "Timestamp": "2023-01-10T13:54:11-05:00", "P95Metrics": { "IOPS": { "Read": 251.0, "Write": 44.0, "Other": 17.0, "Total": 345.0 }, "Throughput": { "Read": 2.06, "Write": 0.88, "Other": 0.11, "Total": 2.17 }, "Latency": { "Read": 0.06, "Write": 0.07, "Other": 0.13 } }, "Capacity": { "Used": 409600, "Provisioned": 1099511627776 }, "ResourceId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ResourceType": "VOLUME" } ] }
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
