기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AddStorageSystem
DataSyncDiscovery에서 정보를 수집하려는 온프레미스 스토리지 시스템용 AWS 리소스를 생성합니다.
요청 구문
{
"AgentArns": [ "string
" ],
"ClientToken": "string
",
"CloudWatchLogGroupArn": "string
",
"Credentials": {
"Password": "string
",
"Username": "string
"
},
"Name": "string
",
"ServerConfiguration": {
"ServerHostname": "string
",
"ServerPort": number
},
"SystemType": "string
",
"Tags": [
{
"Key": "string
",
"Value": "string
"
}
]
}
요청 파라미터
모든 작업에 공통적인 파라미터에 대한 내용은 범용 파라을 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- AgentArns
-
온프레미스 스토리지 시스템의 관리 인터페이스에 연결하고 이 인터페이스를 읽는 DataSync 에이전트의 Amazon 리소스 이름 (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}$
필수 항목 여부: 예
- ClientToken
-
이 API 작업에 대한 요청이 동일한지 확인하기 위한 클라이언트 토큰을 지정합니다. 클라이언트 토큰을 지정하지 않은 경우 자동으로 DataSync 생성됩니다.
유형: String
패턴:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}
필수 항목 여부: 예
- CloudWatchLogGroupArn
-
검색 작업 이벤트를 모니터링하고 기록하기 위한 Amazon CloudWatch 로그 그룹의 ARN을 지정합니다.
유형: String
길이 제약: 최대 길이는 56입니다.
패턴:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):logs:[a-z\-0-9]+:[0-9]{12}:log-group:([^:\*]*)(:\*)?$
필수 항목 여부: 아니요
- Credentials
-
온프레미스 스토리지 시스템의 관리형 인터페이스에 액세스하는 데 필요한 사용자 이름 및 암호를 지정합니다.
유형: Credentials 객체
필수 항목 여부: 예
- Name
-
온프레미스 스토리지 시스템의 친숙한 이름을 지정합니다.
유형: String
길이 제약: 최소 길이는 1입니다. 최대 길이 256.
Pattern:
^[\p{L}\p{M}\p{N}\s+=._:@\/-]+$
필수 항목 여부: 아니요
- ServerConfiguration
-
온프레미스 스토리지 시스템의 관리 인터페이스에 연결하는 데 필요한 서버 이름과 네트워크 포트를 지정합니다.
유형: DiscoveryServerConfiguration 객체
필수 항목 여부: 예
- SystemType
-
DataSyncDiscovery에서 정보를 수집하려는 온프레미스 스토리지 시스템의 유형을 지정합니다.
참고
DataSync디스커버리는 현재 NetApp ONTAP 9.7 이상을 실행하는 FAS (패브릭 연결 스토리지) 및 AFF (올 플래시 FAS) 시스템을 지원합니다.
유형: String
유효한 값:
NetAppONTAP
필수 항목 여부: 예
- Tags
-
AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다. 온프레미스 스토리지 시스템에 대한 이름 태그를 이상 이상 이상 이상, 온프레미스 스토리지 시스템에 대한 이름을 좋습니다.
유형: TagListEntry 객체 배열
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.
필수 항목 여부: 아니요
응답 구문
{
"StorageSystemArn": "string"
}
응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- StorageSystemArn
-
Discovery와 함께 DataSync 사용할 수 있는 온프레미스 스토리지 시스템의 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}$
오류
모든 작업에 공통적으로 나타나는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는 AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
예시
예제 요청
다음 예에서는 DataSync Discovery에 온프레미스 스토리지 시스템을 추가합니다.
{ "ServerConfiguration": { "ServerHostname": "172.16.0.0", "ServerPort": 443 }, "SystemType": "NetAppONTAP", "AgentArns": [ "arn:aws:datasync:us-east-1:111222333444:agent/agent-012345abcde012345" ], "CloudWatchLogGroupArn": "arn:aws:logs:us-east-1:111222333444:log-group:/aws/datasync/discovery:*", "Tags": [ { "Key": "Migration Plan", "Value": "1" } ], "Name": "MyOnPremStorage", "Credentials": { "Username": "admin", "Password": "1234" } }
샘플 응답
응답은 방금 Discovery에 추가한 온프레미스 스토리지 시스템의 ARN을 DataSync 반환합니다.
{ "StorageSystemArn": "arn:aws:datasync:us-east-1:111222333444:system/storage-system-abcdef01234567890" }
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.