기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeStorageSystem
DataSyncDiscovery와 함께 사용 중인 온프레미스 스토리지 시스템에 대한 정보를 반환합니다.
요청 구문
{
"StorageSystemArn": "string
"
}
요청 파라미터
모든 작업에서 사용하는 파라터에 대한 자세한 내용은 범용 파라터에 대한 세부 정보입니다.
요청은 JSON 형식의 다음 데이터를 받습니다.
- StorageSystemArn
-
Discovery가 사용하는 온프레미스 스토리지 시스템의 Amazon 리소스 이름 (ARN) 을 DataSync 지정합니다.
유형: String
길이 제약: 최대 길이는 128입니다.
패턴:
^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}$
Required: Yes
응답 구문
{
"AgentArns": [ "string" ],
"CloudWatchLogGroupArn": "string",
"ConnectivityStatus": "string",
"CreationTime": number,
"ErrorMessage": "string",
"Name": "string",
"SecretsManagerArn": "string",
"ServerConfiguration": {
"ServerHostname": "string",
"ServerPort": number
},
"StorageSystemArn": "string",
"SystemType": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- AgentArns
-
온프레미스 스토리지 시스템에 연결하고 해당 시스템에서 데이터를 읽는 DataSync 에이전트의 ARN입니다.
유형: 문자열 배열
배열 멤버: 고정된 항목 수는 1개입니다.
길이 제약: 최대 길이는 128입니다.
패턴:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$
- CloudWatchLogGroupArn
-
검색 작업 이벤트를 모니터링하고 기록하는 데 사용되는 Amazon CloudWatch 로그 그룹의 ARN입니다.
유형: String
길이 제약: 최대 길이는 562입니다.
패턴:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$
- ConnectivityStatus
-
DataSync에이전트가 온프레미스 스토리지 시스템에 연결할 수 있는지 여부를 나타냅니다.
유형: String
유효한 값:
PASS | FAIL | UNKNOWN
- CreationTime
-
온프레미스 스토리지 시스템을 DataSync Discovery에 추가한 시간입니다.
유형: Timestamp
- ErrorMessage
-
DataSync에이전트가 온-프레미스 스토리지 시스템에서 발생하는 연결 오류를 설명합니다.
유형: String
길이 제약: 최대 길이는 128입니다.
패턴:
.*
- Name
-
온프레미스 스토리지 시스템을 DataSync Discovery에 추가할 때 지정한 이름입니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이 256.
Pattern:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$
- SecretsManagerArn
-
온프레미스 스토리지 시스템의 자격 증명을 저장하는 암호의 ARN입니다. DataSync디스커버리는 이러한 자격 증명을 에 저장합니다 AWS Secrets Manager.
유형: String
길이 제약: 최대 길이는 2,048입니다.
패턴:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):secretsmanager:[a-z\-0-9]+:[0-9]{12}:secret:.*
- ServerConfiguration
-
온프레미스 스토리지 시스템의 관리 인터페이스에 연결하는 데 필요한 서버 이름 및 네트워크 포트입니다.
유형: DiscoveryServerConfiguration 객체
- StorageSystemArn
-
검색 작업에서 살펴본 온프레미스 스토리지 시스템의 ARN입니다.
유형: String
길이 제약: 최대 길이는 128입니다.
패턴:
^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}$
- SystemType
-
온프레미스 스토리지 시스템의 유형.
참고
DataSync디스커버리는 현재 ONTAP NetApp 9.7 이상을 실행하는 FAS (패브릭 연결 스토리지) 및 AFF (올 플래시 FAS) 시스템만 지원합니다.
유형: String
유효한 값:
NetAppONTAP
오류
모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.