# Digitalocean

{% code fullWidth="true" %}

```
NAME:
   singularity storage create s3 digitalocean - DigitalOcean Spaces

USAGE:
   singularity storage create s3 digitalocean [command options] [arguments...]

DESCRIPTION:
   --env-auth
      런타임(환경 변수 또는 env vars이 없으면 EC2/ECS 메타 데이터에서)에서 AWS 자격 증명 가져오기.
      
      access_key_id와 secret_access_key가 비어있을 때만 적용됩니다.

      예:
         | false | 다음 단계에서 AWS 자격 증명을 입력하세요.
         | true  | 환경(환경 변수 또는 IAM)에서 AWS 자격 증명 가져 오기.

   --access-key-id
      AWS Access Key ID.
      
      익명 액세스 또는 런타임 자격 증명을 위해 비워 두세요.

   --secret-access-key
      AWS Secret Access Key (비밀번호).
      
      익명 액세스 또는 런타임 자격 증명을 위해 비워 두세요.

   --region
      연결할 지역.
      
      S3 클론을 사용하고 지역이 없을 경우 비워둡니다.

      예:
         | <unset>            | 확실하지 않으면 사용하세요.
         |                    | v4 서명과 빈 지역을 사용합니다.
         | other-v2-signature | v4 서명이 작동하지 않는 경우에만 사용하십시오.
         |                    | 예: pre Jewel/v10 CEPH.

   --endpoint
      S3 API의 엔드포인트.
      
      S3 클론을 사용하는 경우 필요합니다.

      예:
         | syd1.digitaloceanspaces.com | DigitalOcean Spaces 시드니 1
         | sfo3.digitaloceanspaces.com | DigitalOcean Spaces 샌프란시스코 3
         | fra1.digitaloceanspaces.com | DigitalOcean Spaces 프랑크푸르트 1
         | nyc3.digitaloceanspaces.com | DigitalOcean Spaces 뉴욕 3
         | ams3.digitaloceanspaces.com | DigitalOcean Spaces 암스테르담 3
         | sgp1.digitaloceanspaces.com | DigitalOcean Spaces 싱가포르 1

   --location-constraint
      위치 구속 조건 - 지역과 일치해야 함.
      
      확실하지 않으면 비워두세요. 버킷을 만들 때만 사용됩니다.

   --acl
      버킷을 만들거나 객체를 저장하거나 복사할 때 사용되는 캐닝 ACL.
      
      이 ACL은 객체를 생성하는 데 사용되며, bucket_acl이 설정되지 않으면 버킷을 생성하는 데도 사용됩니다.
      
      자세한 내용은 [AmazonS3 사용자 지정 ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) 문서를 확인하세요.
      
      확실하지 않으면 ACL이 빈 문자열인 경우 X-Amz-Acl: 헤더가 추가되지 않으며 기본값(비공개)이 사용됩니다.
      

   --bucket-acl
      버킷을 만들 때 사용되는 캐닝 ACL.
      
      자세한 내용은 [AmazonS3 사용자 지정 ACL](https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#canned-acl) 문서를 확인하세요.
      
      이 ACL은 버킷을 생성할 때만 적용됩니다. 설정되지 않은 경우 "acl"을 대신 사용합니다.
      
      "acl" 및 "bucket_acl"이 빈 문자열인 경우 X-Amz-Acl: 헤더가 추가되지 않으며 기본값(비공개)이 사용됩니다.
      

      예:
         | private            | 소유자에게 FULL_CONTROL이 부여됩니다.
         |                    | 다른 사람에게 액세스 권한이 없습니다(기본값).
         | public-read        | 소유자에게 FULL_CONTROL이 부여됩니다.
         |                    | AllUsers 그룹에게 읽기 액세스가 부여됩니다.
         | public-read-write  | 소유자에게 FULL_CONTROL이 부여됩니다.
         |                    | AllUsers 그룹에게 읽기 및 쓰기 액세스가 부여됩니다.
         |                    | 버킷에 대해 이를 허용하는 것은 권장되지 않습니다.
         | authenticated-read | 소유자에게 FULL_CONTROL이 부여됩니다.
         |                    | AuthenticatedUsers 그룹에게 읽기 액세스가 부여됩니다.

   --upload-cutoff
      청크 업로드로 전환하는 임계 값.
      
      이보다 큰 파일은 chunk_size의 청크로 업로드됩니다.
      최소값은 0이고 최대값은 5 GiB입니다.

   --chunk-size
      업로드에 사용할 청크 크기.
      
      upload_cutoff보다 큰 파일 또는 크기를 알 수없는 파일(예: "rclone rcat"으로 업로드되는 파일이나 "rclone mount"로 업로드되는 파일 또는 Google Photos 또는 Google 문서)을 업로드 할 때
      이 청크 크기를 사용하여 멀티파트 업로드됩니다.
      
      참고로 "--s3-upload-concurrency"는 이 크기의 청크를 전송마다 메모리에 버퍼링합니다.
      
      고속 링크에서 큰 파일을 전송하고 충분한 메모리가 있다면 이를 더 크게하면 전송 속도가 향상됩니다.
      
      rclone은 10,000개 이하의 청크 제한을 유지하기 위해 알려진 크기의 대형 파일을 업로드 할 때 자동으로 청크 크기를 증가시킵니다.
      
      크기를 알 수없는 파일은 구성된 chunk_size로 업로드됩니다. 기본 청크 크기가 5 MiB이고 최대 10,000 개의 청크가있을 수 있으므로 기본적으로 스트리밍 업로드 할 수있는 파일의 최대 크기는 48 GiB입니다. 
      더 큰 파일을 스트리밍 업로드하려면 chunk_size를 늘려야합니다.
      
      청크 크기를 늘리면 "-P" 플래그로 표시되는 진행 상태의 정확도가 낮아집니다. rclone은 AWS SDK에 의해 버퍼링 될 때 청크가 전송된 것으로 처리하고 있지만 아직 업로드 중일 수 있습니다.
      더 큰 청크 크기는 더 큰 AWS SDK 버퍼와 진행률 보고서를 진실과 멀리 벗어나게합니다.
      

   --max-upload-parts
      멀티파트 업로드에서 사용할 최대 부분 수.
      
      이 옵션은 멀티파트 업로드를 수행 할 때 사용할 멀티파트 청크의 최대 수를 정의합니다.
      
      만약 서비스가 10,000개 이하의 청크를 지원하지 않는 경우 유용 할 수 있습니다.
      
      rclone은 10,000 개 이하의 청크 수를 제한하기 위해 알려진 크기의 대형 파일을 업로드 할 때 자동으로 청크 크기를 증가시킵니다.
      

   --copy-cutoff
      멀티파트로 복사하는 임계 값.
      
      서버간에 복사해야하는 이 크기보다 큰 파일은 이 크기의 청크로 복사됩니다.
      
      최소값은 0이고 최대값은 5 GiB입니다.

   --disable-checksum
      객체 메타데이터에 MD5 체크섬을 저장하지 않습니다.
      
      일반적으로 rclone은 업로드하기 전에 입력의 MD5 체크섬을 계산하여 객체 메타데이터에 추가하기 때문에 대형 파일을 업로드하기 시작할 때 장기간 대기 될 수 있습니다.

   --shared-credentials-file
      공유 자격 증명 파일의 경로.
      
      env_auth = true 경우 rclone은 공유 자격 증명 파일을 사용할 수 있습니다.
      
      이 변수가 비어 있으면 rclone은 "AWS_SHARED_CREDENTIALS_FILE" 환경 변수를 찾습니다. 환경 값이 비어 있으면 기본값으로 현재 사용자의 홈 디렉토리를 사용합니다.
      
          Linux/OSX: "$HOME/.aws/credentials"
          Windows:   "%USERPROFILE%\.aws\credentials"
      

   --profile
      공유 자격 증명 파일에서 사용 할 프로파일.
      
      env_auth = true일 때 rclone은 공유 자격 증명 파일을 사용할 수 있습니다. 이 변수는 파일에서 사용 할 프로필을 제어합니다.
      
      비어 있으면 "AWS_PROFILE" 또는 환경 변수 "default"를 기본값으로 사용합니다.
      

   --session-token
      AWS 세션 토큰.

   --upload-concurrency
      멀티파트 업로드의 동시성.
      
      동일한 파일의 청크 몇 개를 동시에 업로드합니다.
      
      고속링크에서 고속 링크를 통해 전혀 대역폭을 활용하지 못하는 소량의 대형 파일을 업로드하는 경우 이를 늘리는 것이 전송 속도를 높이는 데 도움이 될 수 있습니다.

   --force-path-style
      경우에 따라 경로 스타일 액세스(true) 또는 가상 호스팅 스타일 액세스(false)를 사용합니다.
      
      이 값이 true(기본값)인 경우 rclone은 경로 스타일 액세스를 사용하고 false인 경우 rclone은 가상 경로 스타일을 사용합니다. 사용 방법에 대한 자세한 내용은 [AWS S3 문서](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro)를 참조하세요.
      
      일부 공급 업체(AWS, Aliyun OSS, Netease COS 또는 Tencent COS 등)는이 값을 false로 설정해야합니다. rclone은 제공자 설정에 따라이 작업을 자동으로 수행합니다.

   --v2-auth
      v2 인증을 사용함(true) 또는 v4 인증을 사용함(false).
      
      이 값이 false(기본값)인 경우 rclone은 v4 인증을 사용합니다. 설정된 경우 rclone은 v2 인증을 사용합니다.
      
      v4 서명이 작동하지 않으면 (예: v10 Jewel 이전의 CEPH)만 사용하세요.

   --list-chunk
      목록 청크의 크기 (각 ListObject S3 요청에 대한 응답 목록).
      
      이 옵션은 AWS S3 사양의 "MaxKeys", "max-items" 또는 "page-size"로 알려진 것과 같습니다.
      대부분의 서비스는 요청보다 많이 요청하더라도 응답 목록을 1000개로 자릅니다.
      AWS S3에서는 이것이 전체 최대값이며 변경할 수 없습니다. [AWS S3](https://docs.aws.amazon.com/cli/latest/reference/s3/ls.html) 참조.
      Ceph에서는 "rgw list buckets max chunk" 옵션으로 증가 할 수 있습니다.
      

   --list-version
      사용할 ListObjects 버전: 1, 2 또는 자동(0).
      
      S3가 처음 출시 될 때 버킷의 개체를 열거하기위한 ListObjects 호출 만 제공했습니다.
      
      그러나 2016 년 5 월에는 ListObjectsV2 호출이 도입되었습니다. 이것은 매우 높은 성능을 제공하며 가능한 경우 사용해야합니다.
      
      기본값 0으로 설정되어 있으면 rclone은 제공자 설정에 따라 호출할 목록 개체 방법을 추측합니다. 있을 경우 수동으로 설정할 수 있습니다.
      


   --list-url-encode
      목록을 URL 인코딩 할지 여부 : true/false/unset
      
      일부 프로바이더는 목록을 URL 인코딩하도록 지원하며,이를 사용할 수있는 경우 파일 이름에 제어 문자를 사용할 때 더 안정적입니다. 
      unset (기본값)으로 설정되어있는 경우 rclone은 프로바이더 설정에 따라 적용할 내용을 선택하지만 여기에서 rclone의 선택 사항을 재정의 할 수 있습니다.
      

   --no-check-bucket
      버킷의 존재를 확인하거나 생성하지 않으려면 설정하세요.
      
      버킷이 이미 존재하는 것을 알고있는 경우 rclone이 수행하는 트랜잭션 수를 최소화하려고 할 때 유용 할 수 있습니다.
      
      또한 사용자가 버킷 생성 권한이없는 경우 필요할 수 있습니다. v1.52.0 이전에는 버그 때문에 이렇게 설정된 경우 정상적으로 전달되지 않았습니다.
      

   --no-head
      업로드 된 객체의 무결성을 확인하기 위해 HEAD하지 않습니다.
      
      rclone이 PUT 호출 후 200 OK 메시지를 받으면 올바르게 업로드되었다고 가정합니다.
      
      특히 다음을 가정합니다.
      
      - 메타 데이터(수정 시간, 저장 클래스 및 컨텐츠 유형 포함)은 업로드 된 것과 동일합니다.
      - 크기는 업로드 된 것과 동일합니다.
      
      단일 부분 PUT의 응답에서 다음 항목을 읽습니다.
      
      - MD5SUM
      - 업로드된 날짜
      
      멀티파트 업로드의 경우 이러한 항목이 읽히지 않습니다.
      
      길이를 알 수없는 소스 개체를 업로드하는 경우 rclone은 HEAD 요청을 수행합니다.
      
      이 플래그를 설정하면 잘못된 크기와 같은 감지되지 않은 업로드 실패의 가능성이 높아지므로 정상적인 동작에 권장되지 않습니다. 실제로 감지되지 않은 업로드 실패 가능성은 매우 작습니다.
      

   --no-head-object
      객체를 가져오기 전에 HEAD를 사용하지 않습니다.

   --encoding
      백엔드에 대한 인코딩.
      
      자세한 내용은 [개요의 인코딩 섹션](/overview/#encoding)을 참조하세요.

   --memory-pool-flush-time
      내부 메모리 버퍼 풀이 플러시될 때까지의 시간 간격.
      
      추가 버퍼를 필요로하는 업로드 (예 : 멀티파트)에서는 메모리 풀을 사용하여 할당 될 수 있습니다.
      이 옵션은 사용되지 않은 버퍼가 풀에서 제거 될 때마다 제어합니다.

   --memory-pool-use-mmap
      내부 메모리 풀에서 mmap 버퍼를 사용할지 여부.

   --disable-http2
      S3 백엔드에서 http2 사용을 비활성화합니다.
      
      현재 s3 (특히 minio) 백엔드와 HTTP/2에 관련하여 해결되지 않은 문제가 있습니다. S3 백엔드의 기본값은 HTTP/2입니다만 여기에서 비활성화할 수 있습니다. 문제가 해결되면이 플래그가 제거됩니다.
      
      참조 : https://github.com/rclone/rclone/issues/4673, https://github.com/rclone/rclone/issues/3631
      
      

   --download-url
      다운로드를위한 사용자 지정 엔드포인트.
      대개 AWS S3는 CloudFront CDN URL로 설정되며 CloudFront 네트워크를 통해 데이터를 다운로드하는 경우 더 저렴한 이중 출구를 제공합니다.

   --use-multipart-etag
      확인을 위해 멀티파트 업로드에 ETag를 사용할지 여부
      
      이 값을 true, false 또는 설정되지 않은대로 설정하면 기본값이 제공자에 의해 사용됩니다.
      

   --use-presigned-request
      단일 부분 업로드에 서명 된 요청 또는 PutObject를 사용할지 여부
      
      이 값이 false이면 rclone은 객체를 업로드하기 위해 AWS SDK에서 PutObject를 사용합니다.
      
      rclone의 버전 <1.59은 단일 부분 객체를 업로드하기 위해 서명 된 요청을 사용하며이 플래그를 true로 설정하면 해당 기능이 다시 활성화됩니다. 이는 특수한 경우 또는 테스트에만 필요합니다.
      

   --versions
      디렉토리 목록에 이전 버전 포함.

   --version-at
      지정된 시간에 파일 버전 표시.
      
      매개 변수는 날짜, "2006-01-02", 시간 "2006-01-02 15:04:05" 또는 그 때의 기간, 예를 들어 "100d" 또는 "1h" 일 수있습니다.
      
      이를 사용하면 파일 쓰기 작업이 허용되지 않으므로 파일을 업로드하거나 삭제 할 수 없습니다.
      
      유효한 형식은 [시간 옵션 문서](/docs/#time-option)를 참조하세요.
      

   --decompress
      gzip으로 인코딩된 객체를 해제합니다.
      
      S3로 "Content-Encoding: gzip" 업로드 한 객체도 압축된 개체로 다운로드됩니다.
      
      이 플래그가 설정되면 rclone은 이러한 파일을 도착시 "Content-Encoding: gzip"로 해제합니다. 이는 rclone이 크기와 해시를 확인하지 않지만 파일 내용은 해제됩니다.
      

   --might-gzip
      백엔드가 개체를 gzip으로 압축 할 수 있는 경우 설정하세요.
      
      일반적으로 제공 업체는 개체가 다운로드 될 때 변경하지 않습니다. "Content-Encoding: gzip"로 업로드 된 개체가 아니면 다운로드시 설정되지 않습니다.
      
      그러나 일부 공급 업체는 (Cloudflare)와 같이 "Content-Encoding: gzip로 업로드되지 않았더라도 개체를 gzip으로 압축 할 수 있습니다.
      
      이경우에는 
          
          ERROR corrupted on transfer: sizes differ NNN vs MMM
      
      와 같은 오류를 수신합니다
      
      이 플래그를 설정하고 rclone이 Content-Encoding을 설정하고 청크 전송 인코딩을 gzip으로 수신하는 개체를 다운로드하면 rclone은 개체를 동적으로 해제합니다.
      
      unset (기본값)로 설정되어 있다면 rclone은 프로바이더 설정에 따라 적용할 내용을 선택하지만 여기에서 rclone의 선택을 재정의 할 수 있습니다.
      

   --no-system-metadata
      시스템 메타 데이터의 설정 및 읽기를 억제합니다.


OPTIONS:
   --access-key-id value        AWS Access Key ID. [$ACCESS_KEY_ID]
   --acl value                  버킷을 만들거나 객체를 저장하거나 복사할 때 사용되는 캐닝 ACL. [$ACL]
   --endpoint value             S3 API의 엔드포인트. [$ENDPOINT]
   --env-auth                   런타임(환경 변수 또는 env vars이 없으면 EC2/ECS 메타 데이터에서)에서 AWS 자격 증명 가져오기. (default: false) [$ENV_AUTH]
   --help, -h                   도움말 표시
   --location-constraint value  위치 구속 조건 - 지역과 일치해야 함. [$LOCATION_CONSTRAINT]
   --region value               연결할 지역. [$REGION]
   --secret-access-key value    AWS Secret Access Key (비밀번호). [$SECRET_ACCESS_KEY]

   Advanced

   --bucket-acl value               버킷을 만들 때 사용되는 캐닝 ACL. [$BUCKET_ACL]
   --chunk-size value               업로드에 사용할 청크 크기. (default: "5Mi") [$CHUNK_SIZE]
   --copy-cutoff value              멀티파트로 복사하는 임계 값. (default: "4.656Gi") [$COPY_CUTOFF]
   --decompress                     gzip으로 인코딩된 객체를 해제합니다. (default: false) [$DECOMPRESS]
   --disable-checksum               객체 메타데이터에 MD5 체크섬을 저장하지 않습니다. (default: false) [$DISABLE_CHECKSUM]
   --disable-http2                  S3 백엔드에서 http2 사용을 비활성화합니다. (default: false) [$DISABLE_HTTP2]
   --download-url value             다운로드를위한 사용자 지정 엔드포인트. [$DOWNLOAD_URL]
   --encoding value                 백엔드에 대한 인코딩. (default: "Slash,InvalidUtf8,Dot") [$ENCODING]
   --force-path-style               경우에 따라 경로 스타일 액세스(true) 또는 가상 호스팅 스타일 액세스(false)를 사용합니다. (default: true) [$FORCE_PATH_STYLE]
   --list-chunk value               목록 청크의 크기 (각 ListObject S3 요청에 대한 응답 목록). (default: 1000) [$LIST_CHUNK]
   --list-url-encode value          목록을 URL 인코딩 할지 여부 : true/false/unset (default: "unset") [$LIST_URL_ENCODE]
   --list-version value             사용할 ListObjects 버전: 1, 2 또는 자동(0). (default: 0) [$LIST_VERSION]
   --max-upload-parts value         멀티파트 업로드에서 사용할 최대 부분 수. (default: 10000) [$MAX_UPLOAD_PARTS]
   --memory-pool-flush-time value   내부 메모리 버퍼 풀이 플러시될 때까지의 시간 간격. (default: "1m0s") [$MEMORY_POOL_FLUSH_TIME]
   --memory-pool-use-mmap           내부 메모리 풀에서 mmap 버퍼를 사용할지 여부. (default: false) [$MEMORY_POOL_USE_MMAP]
   --might-gzip value               백엔드가 개체를 gzip으로 압축 할 수 있는 경우 설정하세요. (default: "unset") [$MIGHT_GZIP]
   --no-check-bucket                버킷의 존재를 확인하거나 생성하지 않으려면 설정하세요. (default: false) [$NO_CHECK_BUCKET]
   --no-head                        업로드 된 객체의 무결성을 확인하기 위해 HEAD하지 않습니다. (default: false) [$NO_HEAD]
   --no-head-object                 객체를 가져오기 전에 HEAD를 사용하지 않습니다. (default: false) [$NO_HEAD_OBJECT]
   --no-system-metadata             시스템 메타 데이터의 설정 및 읽기를 억제합니다. (default: false) [$NO_SYSTEM_METADATA]
   --profile value                  공유 자격 증명 파일에서 사용 할 프로파일. [$PROFILE]
   --session-token value            AWS 세션 토큰. [$SESSION_TOKEN]
   --shared-credentials-file value  공유 자격 증명 파일의 경로. [$SHARED_CREDENTIALS_FILE]
   --upload-concurrency value       멀티파트 업로드의 동시성. (default: 4) [$UPLOAD_CONCURRENCY]
   --upload-cutoff value            청크 업로드로 전환하는 임계 값. (default: "200Mi") [$UPLOAD_CUTOFF]
   --use-multipart-etag value       확인을 위해 멀티파트 업로드에 ETag를 사용할지 여부 (default: "unset") [$USE_MULTIPART_ETAG]
   --use-presigned-request          단일 부분 업로드에 서명 된 요청 또는 PutObject를 사용할지 여부 (default: false) [$USE_PRESIGNED_REQUEST]
   --v2-auth                        v2 인증을 사용함(true). (default: false) [$V2_AUTH]
   --version-at value               지정된 시간에 파일 버전 표시. (default: "off") [$VERSION_AT]
   --versions                       디렉토리 목록에 이전 버전 포함. (default: false) [$VERSIONS]

   General

   --name value  스토리지의 이름 (기본값: 자동 생성)
   --path value  스토리지의 경로

```

{% endcode %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://data-programs.gitbook.io/singularity/kr/cli-reference/storage/create/s3/digitalocean.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.