기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
StartDiscoveryJob
온프레미스 스토리지 시스템에서DataSync 검색 작업을 실행합니다. DataSyncDiscovery에 스토리지 시스템을 아직 추가하지 않은 경우 먼저 AddStorageSystem작업을 사용하여 스토리지 시스템을 추가하세요.
요청 구문
{
"ClientToken": "string",
"CollectionDurationMinutes": number,
"StorageSystemArn": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}요청 파라미터
모든 작업에 공통되는 파라미터 정보는 범용 파라미터 항목을 참조하십시오.
요청은 JSON 형식의 다음 데이터를 받습니다.
- ClientToken
-
이 API 작업과 관련된 요청의 유효성이 동일한지 확인하기 위한 클라이언트 토큰을 지정합니다. 클라이언트 토큰을 지정하지 않으면 자동으로DataSync 생성합니다.
유형: String
패턴:
[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}필수 항목 여부: 예
- CollectionDurationMinutes
-
검색 작업을 실행할 기간을 분 단위로 지정합니다.
참고
더 정확한 권장 사항을 보려면 최소 14일 이상을 권장합니다. 지속 시간이 길어질수록 충분한 수의 데이터 포인트를 수집하고 스토리지 성능 및 활용도를 사실적으로 표현할 수 있습니다.
유형: Integer
유효한 범위: 최소값은 60이고 최대값은 4,000입니다.
필수 항목 여부: 예
- StorageSystemArn
-
검색 작업을 실행할 온프레미스 스토리지 시스템의 Amazon 리소스 이름 (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}$필수 항목 여부: 예
- Tags
-
AWS 리소스를 분류, 필터링 및 검색하는 데 도움이 되는 레이블을 지정합니다.
유형: TagListEntry 객체 배열
배열 멤버: 최소 항목 수는 0개입니다. 최대 항목 수 50개.
필수 항목 여부: 아니요
응답 구문
{
"DiscoveryJobArn": "string"
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- DiscoveryJobArn
-
시작한 검색 작업의 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}$
오류
모든 작업에 공통적으로 발생하는 오류에 대한 자세한 내용은 을 참조하십시오일반적인 오류.
- InternalException
-
이 예외는AWS DataSync 서비스에 오류가 발생할 때 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
이 예외는 클라이언트가 잘못된 형식의 요청을 제출할 때 발생합니다.
HTTP 상태 코드: 400
참고 항목
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
