UpdateFileSystem

기존 파일 시스템의 처리량 모드 또는 프로비저닝된 처리량을 업데이트합니다.

Request Syntax

PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json

{
   "ProvisionedThroughputInMibps": number,
   "ThroughputMode": "string"
}

URI 요청 파라미터

요청은 다음 URI 파라미터를 사용합니다.

FileSystemId

업데이트할 파일 시스템의 ID입니다.

길이 제약: 최대 길이는 128입니다.

패턴: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

필수 사항 여부: Yes

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

ProvisionedThroughputInMibps

(선택 사항) 생성 중인 파일 시스템에 프로비저닝하려는 처리량 (초당 메비바이트 (MiBps)) ThroughputMode이 provisioned로 설정된 경우 필수입니다. 유효한 값은 MiBps 1-3414이며 상한은 지역에 따라 다릅니다. 이 한도를 늘리려면 문의하십시오. AWS Support자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서의 증가할 수 있는 Amazon EFS 할당량을 참조하세요.

유형: Double

유효한 범위: 최소값은 1.0입니다.

필수 여부: 아니요

ThroughputMode

(선택 사항)파일 시스템의 처리량 모드를 업데이트합니다. 처리량 모드를 업데이트하지 않는 경우 요청에 이 값을 제공할 필요가 없습니다. ThroughputMode를 provisioned로 변경하면 ProvisionedThroughputInMibps의 값도 설정해야 합니다.

타입: 문자열

유효 값: bursting | provisioned | elastic

필수 항목 여부: 아니요

응답 구문

HTTP/1.1 202
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "CreationTime": number,
   "CreationToken": "string",
   "Encrypted": boolean,
   "FileSystemArn": "string",
   "FileSystemId": "string",
   "FileSystemProtection": { 
      "ReplicationOverwriteProtection": "string"
   },
   "KmsKeyId": "string",
   "LifeCycleState": "string",
   "Name": "string",
   "NumberOfMountTargets": number,
   "OwnerId": "string",
   "PerformanceMode": "string",
   "ProvisionedThroughputInMibps": number,
   "SizeInBytes": { 
      "Timestamp": number,
      "Value": number,
      "ValueInArchive": number,
      "ValueInIA": number,
      "ValueInStandard": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "ThroughputMode": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 202 응답을 다시 전송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

AvailabilityZoneId

파일 시스템이 위치한 가용 영역의 고유하고 일관된 식별자로, One Zone 파일 시스템에만 유효합니다. 예를 들어 use1-az1 는 AWS 리전 us-east-1의 가용 영역 ID이며 모든 위치에서 동일한 위치를 가집니다. AWS 계정

타입: 문자열

AvailabilityZoneName

파일 시스템이 위치한 AWS 가용 영역을 설명하며, 이는 One Zone 파일 시스템에만 유효합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서의 EFS 스토리지 클래스 사용을 참조하세요.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

패턴: .+

CreationTime

파일 시스템이 생성된 시간(초)입니다(1970-01-01T00:00:00Z 이후).

유형: 타임스탬프

CreationToken

요청에 지정된 불투명한 문자열입니다.

유형: 문자열

길이 제한: 최소 길이는 1. 최대 길이는 64.

패턴: .+

Encrypted

true인 경우 파일 시스템이 암호화되었음을 나타내는 부울 값입니다.

타입: 부울

FileSystemArn

EFS 파일 시스템의 Amazon 리소스 이름(ARN)으로서 arn:aws:elasticfilesystem:region:account-id:file-system/file-system-id 형식입니다. 샘플 데이터를 사용한 예: arn:aws:elasticfilesystem:us-west-2:1111333322228888:file-system/fs-01234567

타입: 문자열

FileSystemId

Amazon EFS에서 할당한 파일 시스템의 ID입니다.

타입: 문자열

길이 제약: 최대 길이는 128입니다.

패턴: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

FileSystemProtection

파일 시스템의 보호를 설명합니다.

유형: FileSystemProtectionDescription객체

KmsKeyId

암호화된 파일 시스템을 보호하는 AWS KMS key 데 사용되는 ID입니다.

타입: 문자열

길이 제약: 최대 길이 2048.

패턴: ^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}|mrk-[0-9a-f]{32}|alias/[a-zA-Z0-9/_-]+|(arn:aws[-a-z]*:kms:[a-z0-9-]+:\d{12}:((key/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})|(key/mrk-[0-9a-f]{32})|(alias/[a-zA-Z0-9/_-]+))))$

LifeCycleState

파일 시스템의 수명 주기 단계입니다.

타입: 문자열

유효 값: creating | available | updating | deleting | deleted | error

Name

태그를 포함하여 파일 시스템에 Name 태그를 추가할 수 있습니다. 자세한 정보는 CreateFileSystem을 참조하세요. 파일 시스템에 Name 태그가 있는 경우 Amazon EFS는 이 필드에 값을 반환합니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

NumberOfMountTargets

파일 시스템에 있는 탑재 대상의 현재 수. 자세한 정보는 CreateMountTarget을 참조하세요.

유형: 정수

유효한 범위: 최소값은 0.

OwnerId

이로 인해 파일 AWS 계정 시스템이 생성되었습니다.

타입: 문자열

길이 제약 조건: 최대 길이는 14입니다.

패턴: ^(\d{12})|(\d{4}-\d{4}-\d{4})$

PerformanceMode

파일 시스템의 성능 모드입니다.

타입: 문자열

유효 값: generalPurpose | maxIO

ProvisionedThroughputInMibps

파일 시스템의 프로비저닝된 처리량 (단위) 입니다. MiBps provisioned로 설정된 ThroughputMode을 사용하는 파일 시스템에 유효합니다.

유형: Double

유효한 범위: 최소값은 1.0입니다.

SizeInBytes

파일 시스템에서 해당 Value 필드에 저장된 데이터의 가장 최근 알려진 측정 크기(바이트) 및 해당 Timestamp 필드에서 해당 크기가 결정된 시간입니다. Timestamp 값은 1970-01-01T00:00:00Z 이후의 정수 시간(초)입니다. 이 SizeInBytes 값은 파일 시스템의 일관된 스냅샷 크기를 나타내지는 않지만 파일 시스템에 쓰기가 없는 경우 최종적으로 일관성을 유지합니다. 즉, 몇 시간 이상 파일 시스템을 수정하지 않은 경우에만 SizeInBytes가 실제 크기를 나타냅니다. 그렇지 않으면 값이 특정 시점의 파일 시스템 크기와 정확히 일치하지 않습니다.

유형: FileSystemSize객체

Tags

파일 시스템과 연결된 태그로, Tag 객체 배열로 표시됩니다.

유형: Tag객체 어레이

ThroughputMode

파일 시스템의 처리량 모드를 표시합니다. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서의 처리량 모드를 참조하세요.

타입: 문자열

유효 값: bursting | provisioned | elastic

Errors

BadRequest

요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.

HTTP 상태 코드: 400

FileSystemNotFound

지정된 FileSystemId 값이 요청자의 값에 존재하지 않는 경우 반환됩니다. AWS 계정

HTTP 상태 코드: 404

IncorrectFileSystemLifeCycleState

파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.

HTTP 상태 코드: 409

InsufficientThroughputCapacity

추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주십시오.

HTTP 상태 코드: 503

InternalServerError

서버 측에서 오류가 발생한 경우 반환됩니다.

HTTP 상태 코드: 500

ThroughputLimitExceeded

처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.

HTTP 상태 코드: 400

TooManyRequests

처리량 모드를 변경하거나 프로비저닝된 처리량 값을 낮추기 전에 최소 24시간을 기다리지 않으면 반환됩니다.

HTTP 상태 코드: 429

참고 항목

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.

• AWS Command Line Interface

• AWS SDK for .NET

• AWS SDK for C++

• AWS Go v2를 위한 SDK

• AWS Java V2용 SDK

• AWS V3용 SDK JavaScript

• AWS PHP V3용 SDK

• AWS Python용 SDK

• AWS 루비 V3용 SDK