

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Snowball Edge와의 데이터 전송에 지원되는 AWS CLI 명령
<a name="using-adapter-cli"></a>

아래에서 Snowball Edge의 Amazon S3 어댑터 또는 Amazon S3 호환 스토리지를 해당 AWS Command Line Interface (AWS CLI) 명령의 엔드포인트로 지정하는 방법에 대한 정보를 찾을 수 있습니다. 어댑터 또는 Snowball Edge의 Amazon S3 호환 스토리지를 사용하여 AWS Snowball Edge 디바이스로 데이터를 전송하는 데 지원되는 Amazon S3에 대한 AWS CLI 명령 목록을 찾을 수도 있습니다.

**참고**  
 AWS CLI 호출할 리전 지정 AWS CLI을 포함하여 설치 및 설정에 대한 자세한 내용은 [AWS Command Line Interface 사용 설명서를](https://docs.aws.amazon.com/cli/latest/userguide/) 참조하세요.

현재 Snowball Edge 디바이스는 Amazon S3 어댑터를 사용할 경우 버전 1.16.14 이하 버전만 지원합니다. [Snowball Edge 클라이언트 버전 찾기](using-adapter.md#aws-cli-version)을(를) 참조하세요. Snowball Edge에서 Amazon S3 호환 스토리지를 사용하는 경우 최신 버전의를 사용할 수 있습니다 AWS CLI. 최신 버전을 다운로드하여 사용하려면 [AWS Command Line Interface 사용 설명서](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)를 참조하세요.

**참고**  
 AWS CLI버전 1.16.14를 설치하기 전에 Python 2.6.5\$1 또는 3.4\$1 버전을 설치해야 합니다.

## Amazon S3 및 Snowball Edge를 사용한 데이터 전송에 지원되는 AWS CLI 명령
<a name="using-adapter-cli-commands"></a>

다음은 AWS Snowball Edge 디바이스가 지원하는 Amazon S3에 대한 AWS CLI 명령 및 옵션의 하위 집합에 대한 설명입니다. 나열되지 않은 명령이나 옵션은 지원되지 않습니다. `--sse`, `--storage-class` 등과 같은 일부 지원되지 않는 옵션을 명령과 함께 선언할 수 있습니다. 하지만 이러한 옵션은 무시되며 데이터를 가져오는 방식에 영향을 미치지 않습니다.
+ [cp](https://docs.aws.amazon.com/cli/latest/reference/s3/cp.html) - AWS Snowball Edge 디바이스에서 파일 또는 객체를 복사합니다. 다음은 이 명령에 사용되는 옵션입니다.
  + `--dryrun`(부울) - 지정된 명령을 사용하여 수행될 작업이 실행되지 않고 표시됩니다.
  + `--quiet`(부울) - 지정된 명령에 의해 수행되는 작업이 표시되지 않습니다.
  + `--include`(문자열) - 지정한 패턴과 일치하는 파일 또는 객체를 명령에서 제외하지 않습니다. 자세한 내용은 *AWS CLI 명령 참조*의 [제외 및 포함 필터 사용](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)을 참조하세요.
  + `--exclude`(문자열) - 지정한 패턴과 일치하는 모든 파일 또는 객체를 명령에서 제외합니다.
  + `--follow-symlinks | --no-follow-symlinks`(부울) - 로컬 파일 시스템에서 Amazon S3로 업로드하는 경우에만 심볼 링크(symlinks)를 따릅니다. Amazon S3는 심볼 링크를 지원하지 않으므로 링크 대상의 콘텐츠는 링크 이름 아래에 업로드됩니다. 두 가지 옵션을 모두 지정하지 않는 경우 기본값은 symlink를 따르는 것입니다.
  + `--only-show-errors`(부울) - 오류와 경고만 표시됩니다. 다른 모든 출력은 억제됩니다.
  + `--recursive`(부울) - 지정된 디렉터리 또는 접두사 아래의 모든 파일 또는 객체에 대해 명령이 수행됩니다.
  + `--page-size`(정수) - 나열 작업에 대한 각 응답으로 반환할 결과 수입니다. 기본값은 1,000(허용되는 최대값)입니다. 작업 시간이 초과된 경우 더 낮은 값을 사용하면 도움이 될 수 있습니다.
  + `--metadata`(맵) - Amazon S3에 객체와 함께 저장할 메타데이터 맵입니다. 이 맵은 이 요청에 속한 모든 객체에 적용됩니다. 동기화에서 이 기능은 변경되지 않은 파일은 새 메타데이터를 받지 않음을 뜻합니다. 두 Amazon S3 위치 간에 복사할 때 별도로 지정하지 않은 경우 `metadata-directive` 인수의 기본값은 `REPLACE`입니다.
+ [ls](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) - AWS Snowball Edge 디바이스의 객체를 나열합니다. 다음은 이 명령에 사용되는 옵션입니다.
  + `--human-readable`(부울) - 파일 크기가 사람이 읽을 수 있는 형식으로 표시됩니다.
  + `--summarize`(부울) - 요약 정보가 표시됩니다. 이 정보는 객체의 수와 총 크기입니다.
  + `--recursive`(부울) - 지정된 디렉터리 또는 접두사 아래의 모든 파일 또는 객체에 대해 명령이 수행됩니다.
  + `--page-size`(정수) - 나열 작업에 대한 각 응답으로 반환할 결과 수입니다. 기본값은 1,000(허용되는 최대값)입니다. 작업 시간이 초과된 경우 더 낮은 값을 사용하면 도움이 될 수 있습니다.
+ [rm](https://docs.aws.amazon.com/cli/latest/reference/s3/rm.html) - AWS Snowball Edge 디바이스에서 객체를 삭제합니다. 다음은 이 명령에 사용되는 옵션입니다.
  + `--dryrun`(부울) - 지정된 명령을 사용하여 수행될 작업이 실행되지 않고 표시됩니다.
  + `--include`(문자열) - 지정한 패턴과 일치하는 파일 또는 객체를 명령에서 제외하지 않습니다. 자세한 내용은 *AWS CLI 명령 참조*의 [제외 및 포함 필터 사용](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)을 참조하세요.
  + `--exclude`(문자열) - 지정한 패턴과 일치하는 모든 파일 또는 객체를 명령에서 제외합니다.
  + `--recursive`(부울) - 지정된 디렉터리 또는 접두사 아래의 모든 파일 또는 객체에 대해 명령이 수행됩니다.
  + `--page-size`(정수) - 나열 작업에 대한 각 응답으로 반환할 결과 수입니다. 기본값은 1,000(허용되는 최대값)입니다. 작업 시간이 초과된 경우 더 낮은 값을 사용하면 도움이 될 수 있습니다.
  + `--only-show-errors`(부울) - 오류와 경고만 표시됩니다. 다른 모든 출력은 억제됩니다.
  + `--quiet`(부울) - 지정된 명령에 의해 수행되는 작업이 표시되지 않습니다.
+ [sync](https://docs.aws.amazon.com/cli/latest/reference/s3/sync.html) - 디렉터리와 접두사를 동기화합니다. 이 명령은 소스 디렉터리의 새 파일 및 업데이트된 파일을 대상에 복사합니다. 이 명령은 하나 이상의 파일이 포함된 경우에만 대상에 디렉터리를 만듭니다.
**중요**  
동일한 Snowball Edge에 있는 디렉터리끼리 동기화하는 것은 지원되지 않습니다.  
한 AWS Snowball Edge 디바이스에서 다른 AWS Snowball Edge 디바이스로의 동기화는 지원되지 않습니다.  
이 옵션은 온프레미스 데이터 스토리지와 Snowball Edge 사이의 콘텐츠를 동기화하는 데만 사용할 수 있습니다.
  + `--dryrun`(부울) - 지정된 명령을 사용하여 수행될 작업이 실행되지 않고 표시됩니다.
  + `--quiet`(부울) - 지정된 명령에 의해 수행되는 작업이 표시되지 않습니다.
  + `--include`(문자열) - 지정한 패턴과 일치하는 파일 또는 객체를 명령에서 제외하지 않습니다. 자세한 내용은 *AWS CLI 명령 참조*의 [제외 및 포함 필터 사용](https://docs.aws.amazon.com/cli/latest/reference/s3/index.html#use-of-exclude-and-include-filters)을 참조하세요.
  + `--exclude`(문자열) - 지정한 패턴과 일치하는 모든 파일 또는 객체를 명령에서 제외합니다.
  + `--follow-symlinks` 또는 `--no-follow-symlinks`(부울) - 로컬 파일 시스템에서 Amazon S3로 업로드하는 경우에만 심볼 링크(symlinks)를 따릅니다. Amazon S3는 심볼 링크를 지원하지 않으므로 링크 대상의 콘텐츠는 링크 이름 아래에 업로드됩니다. 두 가지 옵션을 모두 지정하지 않는 경우 기본값은 symlink를 따르는 것입니다.
  + `--only-show-errors`(부울) - 오류와 경고만 표시됩니다. 다른 모든 출력은 억제됩니다.
  + `--no-progress`(부울) - 파일 전송 진행 상항이 표시되지 않습니다. 이 옵션은 `--quiet` 및 `--only-show-errors` 옵션을 입력하지 않는 경우에 한해 적용됩니다.
  + `--page-size`(정수) - 나열 작업에 대한 각 응답으로 반환할 결과 수입니다. 기본값은 1,000(허용되는 최대값)입니다. 작업 시간이 초과된 경우 더 낮은 값을 사용하면 도움이 될 수 있습니다.
  + `--metadata`(맵) - Amazon S3에 객체와 함께 저장할 메타데이터 맵입니다. 이 맵은 이 요청에 속한 모든 객체에 적용됩니다. 동기화에서 이 기능은 변경되지 않은 파일은 새 메타데이터를 받지 않음을 뜻합니다. 두 Amazon S3 위치 간에 복사할 때 별도로 지정하지 않은 경우 `metadata-directive` 인수의 기본값은 `REPLACE`입니다.
**중요**  
동일한 Snowball Edge에 있는 디렉터리끼리 동기화하는 것은 지원되지 않습니다.  
한 AWS Snowball Edge 디바이스에서 다른 AWS Snowball Edge 디바이스로의 동기화는 지원되지 않습니다.  
이 옵션은 온프레미스 데이터 스토리지와 Snowball Edge 사이의 콘텐츠를 동기화하는 데만 사용할 수 있습니다.
  + `--size-only`(부울) - 이 옵션에서 각 키의 크기는 원본에서 대상으로 동기화할지 여부를 결정하는 데 사용되는 유일한 조건입니다.
  + `--exact-timestamps`(부울) - Amazon S3에서 로컬 스토리지로 동기화할 때 타임스탬프가 정확히 일치하는 경우에만 같은 크기의 항목이 무시됩니다. 로컬 버전이 Amazon S3 버전보다 최신이 아닐 경우 기본 동작은 같은 크기의 항목을 무시하는 것입니다.
  + `--delete`(부울) - 대상에는 있지만 원본에는 없는 파일이 동기화 중에 삭제됩니다.

이름에 공백이 있는 파일 또는 폴더(예: `my photo.jpg` 또는 `My Documents`)로 작업할 수 있습니다. 그러나 AWS CLI 명령에서 공백을 올바르게 처리해야 합니다. 자세한 내용은 *AWS Command Line Interface 사용 설명서*의 [AWS CLI의 파라미터 값 지정](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html)을 참조하세요.