기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 작업
다음 작업이 지원됩니다.
+ [CreateAccessPoint](API_CreateAccessPoint.md)
+ [CreateFileSystem](API_CreateFileSystem.md)
+ [CreateMountTarget](API_CreateMountTarget.md)
+ [CreateReplicationConfiguration](API_CreateReplicationConfiguration.md)
+ [CreateTags](API_CreateTags.md)
+ [DeleteAccessPoint](API_DeleteAccessPoint.md)
+ [DeleteFileSystem](API_DeleteFileSystem.md)
+ [DeleteFileSystemPolicy](API_DeleteFileSystemPolicy.md)
+ [DeleteMountTarget](API_DeleteMountTarget.md)
+ [DeleteReplicationConfiguration](API_DeleteReplicationConfiguration.md)
+ [DeleteTags](API_DeleteTags.md)
+ [DescribeAccessPoints](API_DescribeAccessPoints.md)
+ [DescribeAccountPreferences](API_DescribeAccountPreferences.md)
+ [DescribeBackupPolicy](API_DescribeBackupPolicy.md)
+ [DescribeFileSystemPolicy](API_DescribeFileSystemPolicy.md)
+ [DescribeFileSystems](API_DescribeFileSystems.md)
+ [DescribeLifecycleConfiguration](API_DescribeLifecycleConfiguration.md)
+ [DescribeMountTargets](API_DescribeMountTargets.md)
+ [DescribeMountTargetSecurityGroups](API_DescribeMountTargetSecurityGroups.md)
+ [DescribeReplicationConfigurations](API_DescribeReplicationConfigurations.md)
+ [DescribeTags](API_DescribeTags.md)
+ [ListTagsForResource](API_ListTagsForResource.md)
+ [ModifyMountTargetSecurityGroups](API_ModifyMountTargetSecurityGroups.md)
+ [PutAccountPreferences](API_PutAccountPreferences.md)
+ [PutBackupPolicy](API_PutBackupPolicy.md)
+ [PutFileSystemPolicy](API_PutFileSystemPolicy.md)
+ [PutLifecycleConfiguration](API_PutLifecycleConfiguration.md)
+ [TagResource](API_TagResource.md)
+ [UntagResource](API_UntagResource.md)
+ [UpdateFileSystem](API_UpdateFileSystem.md)
+ [UpdateFileSystemProtection](API_UpdateFileSystemProtection.md)
# CreateAccessPoint
EFS 액세스 포인트를 생성합니다. 액세스 포인트는 운영 체제 사용자 및 그룹 및 파일 시스템 경로를 액세스 포인트를 통해 이루어지는 모든 파일 시스템 요청에 적용하는 EFS 파일 시스템에 대한 애플리케이션별 보기입니다. 운영 체제 사용자 및 그룹은 NFS 클라이언트에서 제공하는 모든 자격 증명 정보를 재정의합니다. 파일 시스템 경로는 액세스 포인트의 루트 디렉터리로 노출됩니다. 액세스 포인트를 사용하는 애플리케이션은 자체 디렉터리 및 해당 하위 디렉터리의 데이터에만 액세스할 수 있습니다. 파일 시스템은 증가를 요청하지 않는 한 최대 10,000개의 액세스 포인트를 가질 수 있습니다. 자세한 내용을 알아보려면 [EFS 액세스 포인트를 사용하여 파일 시스템 탑재](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html)를 참조하세요.
**참고**
동일한 파일 시스템에 액세스 포인트를 생성하라는 여러 요청을 연속으로 빠르게 전송하고 파일 시스템이 액세스 포인트 한도에 가까워지면 이러한 요청에 대한 응답이 제한될 수 있습니다. 이는 파일 시스템이 명시된 액세스 포인트 제한을 초과하지 않도록 하기 위한 것입니다.
이 작업에는 `elasticfilesystem:CreateAccessPoint` 액션에 대한 권한이 필요합니다.
액세스 포인트를 만들 때 태그를 지정할 수 있습니다. 생성 작업에서 태그가 지정되면 IAM은 `elasticfilesystem:TagResource` 작업에서 추가 권한 부여를 수행해 사용자에게 태그를 생성할 권한이 있는지 확인합니다. 따라서 사용자는 `elasticfilesystem:TagResource` 작업을 사용할 명시적 권한도 가지고 있어야 합니다. 자세한 내용은 [생성 시 리소스 태그 지정에 대한 권한 부여](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html)를 참조하세요.
## Request Syntax
```
POST /2015-02-01/access-points HTTP/1.1
Content-type: application/json
{
"ClientToken": "string",
"FileSystemId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [ClientToken](#API_CreateAccessPoint_RequestSyntax) **
Amazon EFS가 멱등성 생성을 보장하기 위해 사용하는 최대 64개의 ASCII 문자로 구성된 문자열입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
필수 여부: 예
** [FileSystemId](#API_CreateAccessPoint_RequestSyntax) **
액세스 포인트가 액세스를 제공하는 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})$`
필수 여부: 예
** [PosixUser](#API_CreateAccessPoint_RequestSyntax) **
액세스 포인트를 사용하여 이루어진 모든 파일 시스템 요청에 적용되는 운영 체제 사용자 및 그룹입니다.
유형: [PosixUser](API_PosixUser.md)객체
필수 여부: 아니요
** [RootDirectory](#API_CreateAccessPoint_RequestSyntax) **
액세스 포인트가 액세스 포인트를 사용하여 NFS 클라이언트에 사용자의 파일 시스템의 루트 디렉터리로 노출하는 EFS 파일 시스템의 디렉터리를 지정합니다. 액세스 포인트를 사용하는 클라이언트는 루트 디렉터리 및 해당 하위 디렉터리에 대한 액세스만 수행할 수 있습니다. 지정된 `RootDirectory` > `Path`가 없으면 클라이언트가 액세스 포인트에 연결할 때 Amazon EFS가 이를 생성하고 `CreationInfo` 설정을 적용합니다. `RootDirectory`를 지정할 때는 `Path` 및 `CreationInfo`를 제공해야 합니다.
Amazon EFS는 사용자가 CreationInfo(OwNuID, ownGID 및 디렉터리에 대한 권한)를 제공한 경우에만 루트 디렉터리를 생성합니다. 이 정보를 제공하지 않으면 Amazon EFS는 루트 디렉터리를 생성하지 않습니다. 루트 디렉터리가 없으면 액세스 포인트를 사용하는 탑재 시도가 실패합니다.
유형: [RootDirectory](API_RootDirectory.md)객체
필수 여부: 아니요
** [Tags](#API_CreateAccessPoint_RequestSyntax) **
액세스 포인트와 연결된 태그를 생성합니다. 모든 태그는 키-값 페어이며, 각 키는 고유해야 합니다. 자세한 내용은 * AWS 일반 참조 안내서*의 [AWS 리소스 태그 지정](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)을 참조하세요.
타입: [Tag](API_Tag.md)객체 배열
필수: 아니요
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AccessPointArn](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트와 연결된 고유한 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$`
** [AccessPointId](#API_CreateAccessPoint_ResponseSyntax) **
Amazon EFS에서 할당한 액세스 포인트의 ID입니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [ClientToken](#API_CreateAccessPoint_ResponseSyntax) **
멱등성 생성을 보장하기 위해 요청에 지정된 불투명한 문자열입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [FileSystemId](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트가 적용되는 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})$`
** [LifeCycleState](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트의 수명 주기 단계를 식별합니다.
타입: 문자열
유효 값: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateAccessPoint_ResponseSyntax) **
이 액세스 포인트의 이름입니다. `Name` 태그의 값입니다.
유형: 문자열
** [OwnerId](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트 리소스를 소유 AWS 계정 한를 식별합니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PosixUser](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트를 사용하여 NFS 클라이언트가 수행하는 모든 파일 작업에 사용되는 액세스 포인트에서 사용자 ID, 그룹 ID 및 보조 그룹 ID를 포함한 전체 POSIX ID입니다.
유형: [PosixUser](API_PosixUser.md)객체
** [RootDirectory](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트가 액세스 포인트를 사용하는 NFS 클라이언트에 루트 디렉터리로 노출하는 EFS 파일 시스템의 디렉터리입니다.
유형: [RootDirectory](API_RootDirectory.md)객체
** [Tags](#API_CreateAccessPoint_ResponseSyntax) **
액세스 포인트와 관련된 태그는 태그 객체의 배열로 표시됩니다.
타입: [Tag](API_Tag.md) 객체 배열
## 오류
** AccessPointAlreadyExists **
생성하려는 액세스 포인트가 요청에서 제공한 생성 토큰과 함께 이미 존재하는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** AccessPointLimitExceeded **
AWS 계정 가 파일 시스템당 허용되는 최대 액세스 포인트 수를 이미 생성한 경우 반환됩니다. 자세한 내용은 [https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region) 섹션을 참조하세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 403
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ThrottlingException **
`CreateAccessPoint` API 작업이 너무 빨리 직접 호출되고 파일 시스템의 액세스 포인트 수가 [120개 제한](https://docs.aws.amazon.com/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region)에 근접할 때 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 429
## 참고 항목
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateAccessPoint)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateAccessPoint)
# CreateFileSystem
빈 파일 시스템을 새로 생성합니다. 이 작업에는 Amazon EFS가 멱등성 생성을 보장하기 위해 사용하는 요청에 생성 토큰이 필요합니다(동일한 생성 토큰으로 작업을 직접 호출해도 효과가 없음). AWS 계정 지정된 생성 토큰으로 호출자의가 소유한 파일 시스템이 현재 존재하지 않는 경우이 작업은 다음을 수행합니다.
+ 빈 파일 시스템을 새로 생성합니다. 파일 시스템에는 Amazon EFS 할당 ID와 초기 수명 주기 상태 `creating`이 있습니다.
+ 생성된 파일 시스템의 설명과 함께 반환됩니다.
그렇지 않으면 이 작업을 수행하면 기존 파일 시스템의 ID와 함께 `FileSystemAlreadyExists` 오류가 반환됩니다.
**참고**
기본 사용 사례의 경우 무작위로 생성된 UUID를 생성 토큰으로 사용할 수 있습니다.
멱등성 작업을 사용하면 추가 파일 시스템을 만들 위험 없이 `CreateFileSystem` 직접 호출을 재시도할 수 있습니다. 이는 초기 직접 호출이 실패하여 파일 시스템이 실제로 생성되었는지 여부가 불확실할 때 발생할 수 있습니다. 전송 수준 제한 시간이 초과되었거나 연결이 재설정되는 경우를 예로 들 수 있습니다. 동일한 생성 토큰을 사용하는 한, 초기 직접 호출에서 파일 시스템 생성에 성공한 경우 클라이언트는 `FileSystemAlreadyExists` 오류를 통해 파일 시스템의 존재를 알 수 있습니다.
자세한 내용은 Amazon EFS 사용 설명서**에서 [파일 시스템 만들기](https://docs.aws.amazon.com/efs/latest/ug/creating-using-create-fs.html#creating-using-create-fs-part1)를 참조하세요.
**참고**
파일 시스템의 수명 주기 상태가 `creating`으로 유지되는 동안 `CreateFileSystem` 직접 호출이 반환됩니다. [DescribeFileSystems](API_DescribeFileSystems.md) 작업을 호출하여 파일 시스템 생성 상태를 확인할 수 있습니다. 이 작업을 직접 호출하면 무엇보다도 파일 시스템 상태가 반환됩니다.
이 작업은 파일 시스템에 대해 선택한 선택적 `PerformanceMode` 파라미터를 받아들입니다. 모든 파일 시스템에 `generalPurpose` `PerformanceMode`를 사용하는 것이 좋습니다. 이 `maxIO` 모드는 `generalPurpose` 모드보다 긴 지연 시간을 견딜 수 있는 고도로 병렬화된 워크로드용으로 설계된 이전 세대 성능 유형입니다. 탄력적 처리량을 사용하는 파일 시스템 또는 One Zone 파일 시스템에는 `MaxIO` 모드가 지원되지 않습니다.
파일 시스템을 만든 후에는 `PerformanceMode`를 변경할 수 없습니다. 자세한 내용은 [Amazon EFS 성능 모드](https://docs.aws.amazon.com/efs/latest/ug/performance.html#performancemodes.html) 섹션을 참조하세요.
`ThroughputMode` 파라미터를 사용하여 파일 시스템에 대한 처리량 모드를 설정할 수 있습니다.
파일 시스템이 완전히 생성되면 Amazon EFS는 수명 주기 상태를 `available`로 설정합니다. 이 시점에서 VPC의 파일 시스템에 대한 탑재 대상을 하나 이상 생성할 수 있습니다. 자세한 내용은 [CreateMountTarget](API_CreateMountTarget.md) 단원을 참조하십시오. 탑재 대상을 사용해 VPC의 EC2 인스턴스에서 Amazon EFS 파일 시스템을 탑재합니다. 자세한 내용은 [Amazon EFS: 작동 방식](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html)을 참조하세요.
이 작업에는 `elasticfilesystem:CreateFileSystem` 액션에 대한 권한이 필요합니다.
파일 시스템은 생성 시 태그를 지정할 수 있습니다. 생성 작업에서 태그가 지정되면 IAM은 `elasticfilesystem:TagResource` 작업에서 추가 권한 부여를 수행해 사용자에게 태그를 생성할 권한이 있는지 확인합니다. 따라서 사용자는 `elasticfilesystem:TagResource` 작업을 사용할 명시적 권한도 가지고 있어야 합니다. 자세한 내용은 [생성 시 리소스 태그 지정에 대한 권한 부여](https://docs.aws.amazon.com/efs/latest/ug/using-tags-efs.html#supported-iam-actions-tagging.html)를 참조하세요.
## Request Syntax
```
POST /2015-02-01/file-systems HTTP/1.1
Content-type: application/json
{
"AvailabilityZoneName": "string",
"Backup": boolean,
"CreationToken": "string",
"Encrypted": boolean,
"KmsKeyId": "string",
"PerformanceMode": "string",
"ProvisionedThroughputInMibps": number,
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"ThroughputMode": "string"
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [AvailabilityZoneName](#API_CreateFileSystem_RequestSyntax) **
One Zone 파일 시스템의 경우 파일 시스템을 생성할 AWS 가용 영역을 지정합니다. `us-east-1a` 형식을 사용하여 가용 영역을 지정합니다. One Zone 파일 시스템에 대한 자세한 내용은 *Amazon EFS 사용 설명서*의 [EFS 파일 시스템 유형](https://docs.aws.amazon.com/efs/latest/ug/availability-durability.html#file-system-type) 섹션을 참조하십시오.
Amazon EFS를 사용할 수 AWS 리전 있는의 일부 가용 영역에서는 One Zone 파일 시스템을 사용할 수 없습니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
필수 여부: 아니요
** [Backup](#API_CreateFileSystem_RequestSyntax) **
생성 중인 파일 시스템에서 자동 백업을 활성화할지 여부를 지정합니다. 값을 `true`로 설정하여 자동 백업을 활성화합니다. One Zone 파일 시스템을 생성하는 경우 자동 백업이 기본적으로 활성화됩니다. 자세한 내용은 Amazon EFS 사용 설명서**의 [자동 백업](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups) 섹션을 참조하세요.
기본값은 `false`입니다. 그러나 `AvailabilityZoneName`을 지정하는 경우 기본값은 `true`입니다.
AWS Backup Amazon EFS를 사용할 수 AWS 리전 있는 모든에서를 사용할 수 있는 것은 아닙니다.
유형: 부울
필수 항목 여부: 아니요
** [CreationToken](#API_CreateFileSystem_RequestSyntax) **
최대 64자의 ASCII 문자로 구성된 문자열입니다. Amazon EFS는 이를 사용하여 멱등성 생성을 보장합니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
필수 여부: 예
** [Encrypted](#API_CreateFileSystem_RequestSyntax) **
true인 경우 암호화된 파일 시스템을 생성하는 부울 값입니다. 암호화된 파일 시스템을 생성할 때 기존 AWS Key Management Service 키(KMS 키)를 지정할 수 있습니다. KMS 키를 지정하지 않으면 암호화된 파일 시스템을 보호하는 데 Amazon EFS의 기본 KMS 키(`/aws/elasticfilesystem`)가 사용됩니다.
유형: 부울
필수 항목 여부: 아니요
** [KmsKeyId](#API_CreateFileSystem_RequestSyntax) **
암호화된 파일 시스템을 보호하는 데 사용할 KMS 키의 ID입니다. 기본값이 아닌 KMS 키를 사용할 경우에만 이 파라미터가 필수입니다. 이 파라미터가 지정되지 않으면 Amazon EFS의 기본 KMS 키가 사용됩니다. 다음 형식을 사용하여 KMS 키를 지정할 수 있습니다.
+ 키 ID - 키의 고유 식별자(예: `1234abcd-12ab-34cd-56ef-1234567890ab`)입니다.
+ ARN - 키의 Amazon 리소스 이름(ARN)입니다(예: `arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`).
+ 키 별칭 - 키에 대해 이전에 생성된 표시 이름입니다(예: `alias/projectKey1`).
+ 키 별칭 ARN - 키 별칭의 ARN입니다(예: `arn:aws:kms:us-west-2:444455556666:alias/projectKey1`).
`KmsKeyId`를 사용하는 경우 [CreateFileSystem:Encrypted](#efs-CreateFileSystem-request-Encrypted) 파라미터를 true로 설정해야 합니다.
EFS는 대칭 KMS 키만 허용합니다. Amazon EFS 파일 시스템에서는 비대칭 KMS 키를 사용할 수 없습니다.
유형: 문자열
길이 제약: 최대 길이 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/_-]+))))$`
필수 여부: 아니요
** [PerformanceMode](#API_CreateFileSystem_RequestSyntax) **
파일 시스템의 성능 모드입니다. 모든 파일 시스템에 `generalPurpose` 성능 모드를 사용하는 것이 좋습니다. `maxIO` 성능 모드를 사용하는 파일 시스템은 대부분의 파일 작업에 대해 지연 시간이 약간 더 길어지는 대가로 더 높은 수준의 집계 처리량 및 초당 작업 수로 확장할 수 있습니다. 파일 시스템을 만든 후에는 성능 모드를 변경할 수 없습니다. One Zone 파일 시스템에서는 `maxIO` 모드가 지원되지 않습니다.
최대 I/O에서는 작업당 지연 시간이 길어지기 때문에 모든 파일 시스템에 범용 성능 모드를 사용하는 것이 좋습니다.
기본값은 `generalPurpose`입니다.
타입: 문자열
유효 값: `generalPurpose | maxIO`
필수 여부: 아니요
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_RequestSyntax) **
생성 중인 파일 시스템에 대해 프로비저닝하고자 하는 처리량입니다. 초당 메비바이트(MiB/s)로 측정됩니다. `ThroughputMode`이 `provisioned`로 설정된 경우 필수입니다. 유효한 값은 1\$13414MiBps이며 상한은 리전에 따라 다릅니다. 이 제한을 늘리려면에 문의하세요 지원. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서**의 [증가할 수 있는 Amazon EFS 할당량](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)을 참조하세요.
유형: Double
유효한 범위: 최소값은 1.0입니다.
필수 여부: 아니요
** [Tags](#API_CreateFileSystem_RequestSyntax) **
파일 시스템과 연결된 하나 이상의 태그를 생성하는 데 사용합니다. 각 태그는 사용자가 정의하는 키-값 페어입니다. 생성 시 `"Key":"Name","Value":"{value}"` 키-값 페어를 포함시켜 파일 시스템 이름을 지정합니다. 각 키는 고유해야 합니다. 자세한 내용은 * AWS 일반 참조 안내서*의 [AWS 리소스 태그 지정](https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html)을 참조하세요.
타입: [Tag](API_Tag.md)객체 배열
필수: 아니요
** [ThroughputMode](#API_CreateFileSystem_RequestSyntax) **
파일 시스템의 처리량 모드를 지정합니다. 모드는 `bursting`, `provisioned` 또는 `elastic`일 수 있습니다. `ThroughputMode`를 `provisioned`로 설정하면 `ProvisionedThroughputInMibps`의 값도 설정해야 합니다. 파일 시스템을 생성한 후 파일 시스템의 프로비저닝 처리량을 줄이거나 특정 시간 제한이 있는 처리량 모드 간에 변경할 수 있습니다. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서**의 [프로비저닝 모드를 사용하여 처리량 지정](https://docs.aws.amazon.com/efs/latest/ug/performance.html#provisioned-throughput)을 참조하세요.
기본값은 `bursting`입니다.
타입: 문자열
유효 값: `bursting | provisioned | elastic`
필수 항목 여부: 아니요
## 응답 구문
```
HTTP/1.1 201
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 201 응답을 다시 전송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AvailabilityZoneId](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템이 위치한 가용 영역의 고유하고 일관된 식별자로, One Zone 파일 시스템에만 유효합니다. 예를 들어 `use1-az1`는 us-east-1의 가용 영역 ID AWS 리전이며 모든에서 위치가 동일합니다 AWS 계정.
유형: 문자열
** [AvailabilityZoneName](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템이 있는 AWS 가용 영역을 설명하며 One Zone 파일 시스템에만 유효합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서**의 [EFS 스토리지 클래스 사용](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)을 참조하세요.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [CreationTime](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템이 생성된 시간(초)입니다(1970-01-01T00:00:00Z 이후).
유형: 타임스탬프
** [CreationToken](#API_CreateFileSystem_ResponseSyntax) **
요청에 지정된 불투명한 문자열입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [Encrypted](#API_CreateFileSystem_ResponseSyntax) **
true인 경우 파일 시스템이 암호화되었음을 나타내는 부울 값입니다.
유형: Boolean
** [FileSystemArn](#API_CreateFileSystem_ResponseSyntax) **
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](#API_CreateFileSystem_ResponseSyntax) **
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](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템의 보호를 설명합니다.
유형: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)객체
** [KmsKeyId](#API_CreateFileSystem_ResponseSyntax) **
암호화된 파일 시스템을 보호하는 데 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](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템의 수명 주기 단계입니다.
타입: 문자열
유효 값: `creating | available | updating | deleting | deleted | error`
** [Name](#API_CreateFileSystem_ResponseSyntax) **
태그를 포함하여 파일 시스템에 `Name` 태그를 추가할 수 있습니다. 자세한 내용은 [CreateFileSystem](#API_CreateFileSystem) 단원을 참조하십시오. 파일 시스템에 `Name` 태그가 있는 경우 Amazon EFS는 이 필드에 값을 반환합니다.
유형: 문자열
길이 제약: 최대 길이 256.
패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템에 있는 탑재 대상의 현재 수. 자세한 내용은 [CreateMountTarget](API_CreateMountTarget.md) 단원을 참조하십시오.
유형: 정수
유효 범위: 최소값 0.
** [OwnerId](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템을 AWS 계정 생성한 입니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템의 성능 모드입니다.
타입: 문자열
유효 값: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_CreateFileSystem_ResponseSyntax) **
MiBps로 측정되는 프로비저닝된 파일 시스템 처리량을 정의합니다. `provisioned`로 설정된 `ThroughputMode`을 사용하는 파일 시스템에 유효합니다.
유형: Double
유효한 범위: 최소값은 1.0입니다.
** [SizeInBytes](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템에서 해당 `Value` 필드에 저장된 데이터의 가장 최근 알려진 측정 크기(바이트) 및 해당 `Timestamp` 필드에서 해당 크기가 결정된 시간입니다. `Timestamp` 값은 1970-01-01T00:00:00Z 이후의 정수 시간(초)입니다. 이 `SizeInBytes` 값은 파일 시스템의 일관된 스냅샷 크기를 나타내지는 않지만 파일 시스템에 쓰기가 없는 경우 최종적으로 일관성을 유지합니다. 즉, 몇 시간 이상 파일 시스템을 수정하지 않은 경우에만 `SizeInBytes`가 실제 크기를 나타냅니다. 그렇지 않으면 값이 특정 시점의 파일 시스템 크기와 정확히 일치하지 않습니다.
유형: [FileSystemSize](API_FileSystemSize.md)객체
** [Tags](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템과 연결된 태그로, `Tag` 객체 배열로 표시됩니다.
타입: [Tag](API_Tag.md)객체 배열
** [ThroughputMode](#API_CreateFileSystem_ResponseSyntax) **
파일 시스템의 처리량 모드를 표시합니다. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서**의 [처리량 모드](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)를 참조하세요.
타입: 문자열
유효 값: `bursting | provisioned | elastic`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemAlreadyExists **
생성하려는 파일 시스템이 사용자가 제공한 생성 토큰과 함께 이미 존재하는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** FileSystemLimitExceeded **
AWS 계정 가 계정당 허용되는 최대 파일 시스템 수를 이미 생성한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 403
** InsufficientThroughputCapacity **
추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 503
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ThroughputLimitExceeded **
처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** UnsupportedAvailabilityZone **
요청된 Amazon EFS 기능을 지정된 가용 영역에서 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 예
### 암호화된 EFS 파일 시스템 생성
다음 예제는 자동 백업이 활성화된 상태로 `us-west-2` 리전에 파일 시스템을 생성하라는 POST 요청을 보냅니다. 요청은 `myFileSystem1`을 멱등성을 위한 생성 토큰으로 지정합니다.
#### 샘플 요청
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem1",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"Encrypted": true,
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### 샘플 응답
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
### One Zone 가용성을 갖춘 암호화된 EFS 파일 시스템 생성
다음 예제는 자동 백업이 활성화된 상태로 `us-west-2` 리전에 파일 시스템을 생성하라는 POST 요청을 보냅니다. 파일 시스템은 `us-west-2b` 가용 영역에 One Zone 스토리지를 갖게 됩니다.
#### 샘플 요청
```
POST /2015-02-01/file-systems HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215117Z
Authorization: <...>
Content-Type: application/json
Content-Length: 42
{
"CreationToken" : "myFileSystem2",
"PerformanceMode" : "generalPurpose",
"Backup": true,
"AvailabilityZoneName": "us-west-2b",
"Encrypted": true,
"ThroughputMode": "elastic",
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
]
}
```
#### 샘플 응답
```
HTTP/1.1 201 Created
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 319
{
"ownerId":"251839141158",
"CreationToken":"myFileSystem1",
"Encrypted": true,
"AvailabilityZoneId": "usew2-az2",
"AvailabilityZoneName": "us-west-2b",
"PerformanceMode" : "generalPurpose",
"fileSystemId":"fs-01234567",
"CreationTime":"1403301078",
"LifeCycleState":"creating",
"numberOfMountTargets":0,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
},
"Tags":[
{
"Key": "Name",
"Value": "Test Group1"
}
],
"ThroughputMode": "elastic"
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateFileSystem)
# CreateMountTarget
파일 시스템의 탑재 대상을 생성합니다. 그런 다음 탑재 대상을 사용하여 EC2 인스턴스에 파일 시스템을 탑재할 수 있습니다. 탑재 대상에 대한 자세한 내용은 [탑재 대상 관리](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html)를 참조하세요.
파일 시스템에 대해 탑재 대상을 생성하려면 파일 시스템의 수명 주기 상태가 `available`이어야 합니다. 자세한 내용은 [DescribeFileSystems](API_DescribeFileSystems.md) 단원을 참조하십시오.
탑재 대상 생성 후 Amazon EFS는 `MountTargetId` 및 IP 주소(`IpAddress` 또는 `Ipv6Address`)를 포함한 응답을 반환합니다. EC2 인스턴스에 파일 시스템을 탑재할 때 이 IP 주소를 사용합니다. 파일 시스템을 탑재할 때 탑재 대상의 DNS 이름을 사용할 수도 있습니다. 탑재 대상을 사용하여 파일 시스템을 탑재한 EC2 인스턴스에서는 탑재 대상의 IP 주소에 대해 탑재 대상의 DNS 이름을 확인합니다. 자세한 내용은 [Amazon EFS 작동 방식](https://docs.aws.amazon.com/efs/latest/ug/how-it-works.html)을 참조하세요.
파일 시스템의 탑재 대상은 하나의 VPC에서만 만들 수 있으며, 가용 영역당 탑재 대상은 하나씩만 있을 수 있습니다. 자세한 내용은 [탑재 대상 생성](https://docs.aws.amazon.com/efs/latest/ug/manage-fs-access-create-delete-mount-targets.html)을 참조하세요.
요청이 요구 사항을 충족하는 경우 Amazon EFS는 다음을 수행합니다.
+ 지정된 서브넷에 새 탑재 대상을 생성합니다.
+ 서브넷에 다음과 같은 새 네트워크 인터페이스를 생성합니다.
+ 설명 `Mount target fsmt-id for file system fs-id ` 여기서 ` fsmt-id `는 탑재 대상 ID이며, ` fs-id `는 `FileSystemId`입니다.
+ 네트워크 인터페이스의 `requesterManaged` 속성은 `true`로 설정되고, `requesterId` 값은 `EFS`로 설정됩니다.
각 탑재 대상에는 해당하는 요청자 관리형 EC2 네트워크 인터페이스가 하나씩 있습니다. 네트워크 인터페이스가 생성되면 Amazon EFS는 탑재 대상 설명의 `NetworkInterfaceId` 필드를 네트워크 인터페이스 ID로 설정하고 IP 주소를 해당 주소로 설정합니다. 네트워크 인터페이스 생성에 실패하면 전체 `CreateMountTarget` 작업이 실패합니다.
**참고**
네트워크 인터페이스를 생성한 후에만 `CreateMountTarget` 직접 호출이 반환되지만 탑재 대상 상태가 여전히 `creating`인 동안에는 [DescribeMountTargets](API_DescribeMountTargets.md) 작업을 직접 호출하여 탑재 대상 생성 상태를 확인할 수 있습니다. 이 경우 무엇보다도 탑재 대상 상태가 반환됩니다.
이 작업에는 파일 시스템에서 다음 작업에 대한 권한이 필요합니다.
+ `elasticfilesystem:CreateMountTarget`
이 작업을 수행하려면 다음과 같은 Amazon EC2 작업에 대한 권한도 필요합니다.
+ `ec2:DescribeSubnets`
+ `ec2:DescribeNetworkInterfaces`
+ `ec2:CreateNetworkInterface`
## Request Syntax
```
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string",
"IpAddress": "string",
"IpAddressType": "string",
"Ipv6Address": "string",
"SecurityGroups": [ "string" ],
"SubnetId": "string"
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [FileSystemId](#API_CreateMountTarget_RequestSyntax) **
탑재 대상을 생성할 파일 시스템의 ID입니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
** [IpAddress](#API_CreateMountTarget_RequestSyntax) **
탑재 대상의 `IpAddressType`이 IPv4(`IPV4_ONLY` 또는 `DUAL_STACK`)인 경우 사용할 IPv4 주소를 지정합니다. `IpAddress`를 지정하지 않으면 Amazon EFS가 `SubnetId`로 지정된 서브넷에서 사용되지 않는 IP 주소를 선택합니다.
유형: 문자열
길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다.
패턴: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
필수 여부: 아니요
** [IpAddressType](#API_CreateMountTarget_RequestSyntax) **
탑재 대상의 IP 주소입니다. 가능한 값은 `IPV4_ONLY`(IPv4 주소만), `IPV6_ONLY`(IPv6 주소만), `DUAL_STACK`(듀얼 스택, IPv4 및 IPv6 주소 모두)입니다. `IpAddressType`를 지정하지 않으면 `IPV4_ONLY`가 사용됩니다.
`IPAddressType`은 서브넷의 IP 유형과 일치해야 합니다. 또한 `IPAddressType` 파라미터는 VPC의 서브넷에 대한 기본 IP 주소로 설정된 값을 재정의합니다. 예를 들어 `IPAddressType`이 `IPV4_ONLY`이고 `AssignIpv6AddressOnCreation`이 `true`인 경우 탑재 대상에 IPv4가 사용됩니다. 자세한 내용은 [서브넷의 IP 주소 지정 속성 수정](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html)을 참조하세요.
타입: 문자열
유효 값: `IPV4_ONLY | IPV6_ONLY | DUAL_STACK`
필수 여부: 아니요
** [Ipv6Address](#API_CreateMountTarget_RequestSyntax) **
탑재 대상의 `IPAddressType`이 IPv6(`IPV6_ONLY` 또는 `DUAL_STACK`)인 경우 사용할 IPv6 주소를 지정합니다. `Ipv6Address`를 지정하지 않으면 Amazon EFS가 `SubnetId`로 지정된 서브넷에서 사용되지 않는 IP 주소를 선택합니다.
유형: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다.
필수 여부: 아니요
** [SecurityGroups](#API_CreateMountTarget_RequestSyntax) **
VPC 보안 그룹 ID(`sg-xxxxxxxx` 형식)입니다. 이들은 지정된 서브넷과 동일한 VPC에 속해야 합니다. 보안 그룹의 최대 개수는 계정 할당량에 따라 다릅니다. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**보안 그룹** 테이블 참조). 보안 그룹을 지정하지 않으면 Amazon EFS는 해당 서브넷 VPC의 기본 보안 그룹을 사용합니다
유형: 문자열 어레이
배열 멤버: 최대 항목 수는 100개입니다.
길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다.
패턴: `^sg-[0-9a-f]{8,40}`
필수 여부: 아니요
** [SubnetId](#API_CreateMountTarget_RequestSyntax) **
탑재 대상을 추가할 서브넷의 ID입니다. One Zone 파일 시스템의 경우 파일 시스템의 가용 영역에 연결된 서브넷을 사용합니다. 서브넷 유형은 `IpAddressType`과 동일한 유형이어야 합니다.
유형: 문자열
길이 제약: 최소 길이는 15입니다. 최대 길이는 47입니다.
패턴: `^subnet-[0-9a-f]{8,40}$`
필수 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AvailabilityZoneId](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상이 위치한 가용 영역의 고유하고 일관된 식별자입니다. 예를 들어 `use1-az1`는 us-east-1 리전의 AZ ID이며 모든에서 위치가 동일합니다 AWS 계정.
유형: 문자열
** [AvailabilityZoneName](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상이 위치한 가용 영역의 이름입니다. 가용 영역은 각 가용 영역의 이름에 독립적으로 매핑됩니다 AWS 계정. 예를 들어의 가용 영역은 다른의 가용 영역과 동일한 위치가 아닐 `us-east-1a` AWS 계정 수 `us-east-1a` 있습니다 AWS 계정.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [FileSystemId](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상으로 의도된 파일 시스템의 ID입니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [IpAddress](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상의 IPv4 주소입니다.
유형: 문자열
길이 제약: 최소 길이는 7입니다. 최대 길이는 15입니다.
패턴: `^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$`
** [Ipv6Address](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상의 IPv6 주소입니다.
유형: 문자열
길이 제약 조건: 최소 길이는 3입니다. 최대 길이는 39입니다.
** [LifeCycleState](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상의 생명 주기 상태입니다.
타입: 문자열
유효 값: `creating | available | updating | deleting | deleted | error`
** [MountTargetId](#API_CreateMountTarget_ResponseSyntax) **
시스템에서 할당한 탑재 대상 ID.
유형: 문자열
길이 제약: 최소 길이는 13입니다. 최대 길이는 45입니다.
패턴: `^fsmt-[0-9a-f]{8,40}$`
** [NetworkInterfaceId](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상을 생성할 때 Amazon EFS가 생성한 네트워크 인터페이스의 ID입니다.
유형: 문자열
** [OwnerId](#API_CreateMountTarget_ResponseSyntax) **
AWS 계정 리소스를 소유한 ID입니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SubnetId](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상의 서브넷의 ID입니다.
유형: 문자열
길이 제약: 최소 길이는 15입니다. 최대 길이는 47입니다.
패턴: `^subnet-[0-9a-f]{8,40}$`
** [VpcId](#API_CreateMountTarget_ResponseSyntax) **
탑재 대상이 구성된 Virtual Private Cloud(VPC) ID입니다.
유형: 문자열
## 오류
** AvailabilityZonesMismatch **
탑재 대상에 지정된 가용 영역이 파일 시스템의 가용 영역과 다를 경우 반환됩니다. 자세한 내용은 [리전 및 One Zone 스토리지 중복성](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs)을 참조하세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** IpAddressInUse **
요청이 서브넷에서 이미 사용 중인 IP 주소(`IpAddress` 또는 `Ipv6Address`)를 지정한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** MountTargetConflict **
탑재 대상이 파일 시스템의 기존 탑재 대상을 기준으로 지정된 제한 사항 중 하나를 위반할 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** NetworkInterfaceLimitExceeded **
직접 호출 계정이 해당 AWS 리전의 탄력적 네트워크 인터페이스 한도에 도달했습니다. 일부 네트워크 인터페이스를 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**네트워크 인터페이스** 표의 **리전별 네트워크 인터페이스** 항목 참조).
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** NoFreeAddressesInSubnet **
요청에 `IpAddress` 또는 `Ipv6Address`가 제공되지 않았으며 지정된 서브넷에 사용 가능한 IP 주소가 없습니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** SecurityGroupLimitExceeded **
요청에 지정된 `SecurityGroups`의 수가 계정 할당량에 기반한 한도를 초과할 경우 반환됩니다. 일부 보안 그룹을 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**보안 그룹** 테이블 참조).
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** SecurityGroupNotFound **
지정된 보안 그룹 중 하나가 서브넷의 Virtual Private Cloud(VPC)에 존재하지 않는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** SubnetNotFound **
요청에 ID `SubnetId`가 제공된 서브넷이 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** UnsupportedAvailabilityZone **
요청된 Amazon EFS 기능을 지정된 가용 영역에서 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 예
### 서브넷의 사용 가능한 IPv4 주소에서 탑재 대상 생성
다음 요청은 탑재 대상에 대한 파일 시스템과 서브넷만 지정합니다. 대상은 VPC와 연결된 기본 보안 그룹을 사용하여 지정된 서브넷의 사용 가능한 IPv4 주소에서 생성됩니다.
#### 샘플 요청
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### 특정 IPv4 주소에서 탑재 대상 생성
다음 요청은 탑재 대상에 사용할 파일 시스템, 서브넷, 보안 그룹 및 IPv4 주소를 지정합니다.
#### 샘플 요청
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddress":"10.0.2.42",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### 특정 IPv6 주소에서 탑재 대상 생성
다음 요청은 탑재 대상에 사용할 파일 시스템, 서브넷, 보안 그룹 및 IPv6 주소를 지정합니다.
#### 샘플 요청
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"IpAddressType": "IPV6_ONLY",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-9a13661e",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState":"available",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId":"eni-1bcb7772"
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### 듀얼 스택 서브넷에서 사용 가능한 IPv4 주소에 탑재 대상 생성
다음 요청은 탑재 대상의 파일 시스템, 서브넷 및 주소 유형을 지정합니다. 대상은 VPC와 연결된 기본 보안 그룹을 사용하여 지정된 듀얼 스택 서브넷의 사용 가능한 IPv4 주소에서 생성됩니다.
#### 샘플 요청
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "251839141158",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId":"subnet-fd04ff94",
"LifeCycleState": "available",
"IpAddress": "172.31.22.183"
"Ipv6Address": "2a05:d01a:419:8611:3e57:75ab:5719:b238",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
### 듀얼 스택 서브넷의 특정 Ipv4 및 IPv6 주소에 탑재 대상 생성
다음 요청은 탑재 대상의 파일 시스템, 서브넷, 보안 그룹, IPv4 주소, IPv6 주소를 지정합니다. 대상은 듀얼 스택 서브넷의 지정된 IPv4 및 IPv6 주소에서 생성됩니다.
#### 샘플 요청
```
POST /2015-02-01/mount-targets HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"IpAddressType": "DUAL_STACK",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"SecurityGroups":[
"sg-01234567"
]
}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252
{
"OwnerId": "231243201240",
"MountTargetId": "fsmt-55a4413c",
"FileSystemId": "fs-01234567",
"SubnetId": "subnet-01234567",
"LifeCycleState": "available",
"IpAddress": "10.0.1.25",
"Ipv6Address":"2001:0db8:85a3:0000:0000:8a2e:0370:7334",
"NetworkInterfaceId": "eni-01234567",
"AvailabilityZoneId": "eus1-az2",
"AvailabilityZoneName": "eu-south-1b",
"VpcId": "vpc-08d45b31fa009a15e"
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS Go v2용 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateMountTarget)
# CreateReplicationConfiguration
새 EFS 파일 시스템 또는 기존 EFS 파일 시스템에 대한 복제 구성을 생성합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서**의 [Amazon EFS 복제](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html)를 참조하세요. 다음 복제 구성은 다음을 지정합니다.
+ **소스 파일 시스템** - 복제하려는 EFS 파일 시스템입니다.
+ **대상 파일 시스템** - 소스 파일 시스템이 복제되는 대상 파일 시스템입니다. 복제 구성에는 대상 파일 시스템이 하나만 있을 수 있습니다.
**참고**
파일 시스템은 하나의 복제 구성에만 포함될 수 있습니다.
복제 구성의 대상 파라미터는 새 파일 시스템에 복제하는지 기존 파일 시스템에 복제하는지 여부와 AWS 계정간에 복제하는지에 따라 달라집니다. 자세한 정보는 [DestinationToCreate](API_DestinationToCreate.md)을 참조하세요.
이 작업에는 `elasticfilesystem:CreateReplicationConfiguration` 액션에 대한 권한이 필요합니다. 또한 파일 시스템을 복제하는 방법에 따라 다른 권한이 필요합니다. 자세한 내용은 *Amazon EFS 사용 설명서*의 [복제를 위한 필수 권한](https://docs.aws.amazon.com/efs/latest/ug/efs-replication.html#efs-replication-permissions)을 참조하세요.
## Request Syntax
```
POST /2015-02-01/file-systems/SourceFileSystemId/replication-configuration HTTP/1.1
Content-type: application/json
{
"Destinations": [
{
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"KmsKeyId": "string",
"Region": "string",
"RoleArn": "string"
}
]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [SourceFileSystemId](#API_CreateReplicationConfiguration_RequestSyntax) **
복제하려는 Amazon EFS 파일 시스템을 지정합니다. 이 파일 시스템은 이미 다른 복제 구성의 소스 또는 대상 파일 시스템일 수 없습니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [Destinations](#API_CreateReplicationConfiguration_RequestSyntax) **
대상 구성 객체의 배열입니다. 대상 구성 객체는 하나만 지원됩니다.
타입: [DestinationToCreate](API_DestinationToCreate.md)객체 배열
필수 항목 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [CreationTime](#API_CreateReplicationConfiguration_ResponseSyntax) **
복제 구성을 만든 시기를 설명합니다.
유형: 타임스탬프
** [Destinations](#API_CreateReplicationConfiguration_ResponseSyntax) **
대상 객체의 배열입니다. 대상 개체는 하나만 지원됩니다.
타입: [Destination](API_Destination.md)객체 배열
** [OriginalSourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
복제 구성에 있는 원본 소스 EFS 파일 시스템의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
** [SourceFileSystemArn](#API_CreateReplicationConfiguration_ResponseSyntax) **
복제 구성에 있는 현재 소스 파일 시스템의 Amazon 리소스 이름(ARN)입니다.
유형: 문자열
** [SourceFileSystemId](#API_CreateReplicationConfiguration_ResponseSyntax) **
복제 중인 소스 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})$`
** [SourceFileSystemOwnerId](#API_CreateReplicationConfiguration_ResponseSyntax) **
소스 파일 시스템이 AWS 계정 있는의 ID입니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [SourceFileSystemRegion](#API_CreateReplicationConfiguration_ResponseSyntax) **
소스 EFS 파일 시스템이 있는 AWS 리전 입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `^[a-z]{2}-((iso[a-z]{0,1}-)|(gov-)){0,1}[a-z]+-{0,1}[0-9]{0,1}$`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** ConflictException **
복제본의 소스 파일 시스템은 암호화되었지만 대상 파일 시스템은 암호화되지 않은 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** FileSystemLimitExceeded **
AWS 계정 가 계정당 허용되는 최대 파일 시스템 수를 이미 생성한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 403
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InsufficientThroughputCapacity **
추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 503
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ReplicationNotFound **
지정된 파일 시스템에 복제 구성이 없는 경우 반환됩니다.
** ErrorCode **
ReplicationNotFound
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** ThroughputLimitExceeded **
처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** UnsupportedAvailabilityZone **
요청된 Amazon EFS 기능을 지정된 가용 영역에서 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** ValidationException **
요청이 이루어진 AWS 리전 에서 AWS Backup 서비스를 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateReplicationConfiguration)
# CreateTags
**참고**
더 이상 사용되지 않음 - `CreateTags`는 더 이상 사용되지 않으며 유지 관리되지 않습니다. EFS 리소스용 태그를 생성하려면 [TagResource](API_TagResource.md) API 작업을 사용하세요.
파일 시스템과 연결된 태그를 생성하거나 덮어씁니다. 각 태그는 키-값 페어입니다. 요청에 지정된 태그 키가 파일 시스템에 이미 있는 경우 이 작업은 해당 값을 요청에 제공된 값으로 덮어씁니다. 파일 시스템에 `Name` 태그를 추가하면 Amazon EFS는 [DescribeFileSystems](API_DescribeFileSystems.md) 작업에 대한 응답으로 태그를 반환합니다.
이 작업에는 `elasticfilesystem:CreateTags` 작업에 대한 권한이 필요합니다.
## Request Syntax
```
POST /2015-02-01/create-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_CreateTags_RequestSyntax) **
태그를 수정하려는 파일 시스템의 ID입니다(문자열). 이 작업은 태그만 수정하고 파일 시스템은 수정하지 않습니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [Tags](#API_CreateTags_RequestSyntax) **
추가할 `Tag` 객체 배열. 각 `Tag` 객체는 키-값 페어입니다.
타입: [Tag](API_Tag.md)객체 배열
필수 항목 여부: 예
## 응답 구문
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/CreateTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/CreateTags)
# DeleteAccessPoint
지정된 액세스 포인트를 삭제합니다. 삭제가 완료되면 새 클라이언트는 더 이상 액세스 포인트에 연결할 수 없습니다. 삭제 시 액세스 포인트에 연결된 클라이언트는 연결이 종료될 때까지 계속 작동합니다.
이 작업에는 `elasticfilesystem:DeleteAccessPoint` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
DELETE /2015-02-01/access-points/AccessPointId HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [AccessPointId](#API_DeleteAccessPoint_RequestSyntax) **
삭제할 액세스 포인트의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteAccessPoint)
# DeleteFileSystem
파일 시스템을 삭제하여 해당 콘텐츠에 대한 액세스를 영구적으로 차단합니다. 반환되면 파일 시스템은 더 이상 존재하지 않으며 삭제된 파일 시스템의 콘텐츠에 액세스할 수 없습니다.
EFS 파일 시스템을 삭제하려면 먼저 파일 시스템에 연결된 탑재 대상을 수동으로 삭제해야 합니다. 이 단계는 AWS 콘솔을 사용하여 파일 시스템을 삭제할 때 수행됩니다.
**참고**
EFS 복제 구성의 일부인 파일 시스템은 삭제할 수 없습니다. 복제 구성을 먼저 삭제해야 합니다.
사용 중인 파일 시스템은 삭제할 수 없습니다. 즉, 파일 시스템에 탑재 대상이 있는 경우 먼저 탑재 대상을 삭제해야 합니다. 자세한 내용은 [DescribeMountTargets](API_DescribeMountTargets.md) 및 [DeleteMountTarget](API_DeleteMountTarget.md) 섹션을 참조하세요.
**참고**
파일 시스템 상태가 아직 `deleting`일 때 `DeleteFileSystem` 직접 호출이 반환됩니다. [DescribeFileSystems](API_DescribeFileSystems.md) 작업을 직접 호출하여 파일 시스템 삭제 상태를 확인할 수 있습니다. 그러면 계정의 파일 시스템 목록이 반환됩니다. 삭제된 파일 시스템의 파일 시스템 ID 또는 생성 토큰을 전달하면 [DescribeFileSystems](API_DescribeFileSystems.md)가 `404 FileSystemNotFound` 오류를 반환합니다.
이 작업에는 `elasticfilesystem:DeleteFileSystem` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
DELETE /2015-02-01/file-systems/FileSystemId HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DeleteFileSystem_RequestSyntax) **
삭제하려는 파일 시스템의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemInUse **
파일 시스템에 탑재 대상이 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 파일 시스템 삭제
다음 예에서는 ID가 `fs-01234567`인 파일 시스템을 삭제하기 위해 `file-systems` 엔드포인트(`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems/fs-01234567`)에 DELETE 요청을 보냅니다.
#### 샘플 요청
```
DELETE /2015-02-01/file-systems/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T233021Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 204 No Content
x-amzn-RequestId: a2d125b3-7ebd-4d6a-ab3d-5548630bff33
Content-Length: 0
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystem)
# DeleteFileSystemPolicy
지정된 파일 시스템의 `FileSystemPolicy`를 삭제합니다. 기존 정책이 삭제되면 `FileSystemPolicy` 기본값이 적용됩니다. 기본 파일 시스템 정책에 대한 자세한 내용은 [EFS에서의 리소스 기반 정책 사용](https://docs.aws.amazon.com/efs/latest/ug/res-based-policies-efs.html)을 참조하세요.
이 작업에는 `elasticfilesystem:DeleteFileSystemPolicy` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
DELETE /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DeleteFileSystemPolicy_RequestSyntax) **
`FileSystemPolicy`를 삭제할 EFS 파일 시스템을 지정합니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
```
## Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteFileSystemPolicy)
# DeleteMountTarget
지정된 탑재 대상을 삭제합니다.
이 작업은 삭제되는 탑재 대상을 사용해서 파일 시스템의 모든 탑재를 강제로 해제하여, 이러한 탑대를 사용하는 인스턴스 또는 애플리케이션이 중단될 수 있습니다. 애플리케이션이 갑자기 중단되는 것을 방지하려면 가능하면 탑재 대상의 모든 탑재를 탑재 해제하는 것을 고려할 수 있습니다. 이 작업을 수행하면 관련 네트워크 인터페이스도 삭제됩니다. 커밋되지 않은 쓰기는 손실될 수 있지만 이 작업을 사용하여 탑재 대상을 해제해도 파일 시스템 자체는 손상되지 않습니다. 생성한 파일 시스템은 그대로 남아 있습니다. 다른 탑재 대상을 사용하여 VPC에 EC2 인스턴스를 탑재할 수 있습니다.
이 작업에는 파일 시스템에서 다음 작업에 대한 권한이 필요합니다.
+ `elasticfilesystem:DeleteMountTarget`
**참고**
탑재 대상 상태가 아직 `deleting`일 때 `DeleteMountTarget` 직접 호출이 반환됩니다. 해당 파일 시스템에 대한 탑재 대상 설명 목록을 반환하는 [DescribeMountTargets](API_DescribeMountTargets.md) 작업을 직접 호출하여 탑재 대상 삭제를 확인할 수 있습니다.
이 작업에는 탑재 대상의 네트워크 인터페이스에서 다음 Amazon EC2 작업에 대한 권한도 필요합니다.
+ `ec2:DeleteNetworkInterface`
## Request Syntax
```
DELETE /2015-02-01/mount-targets/MountTargetId HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [MountTargetId](#API_DeleteMountTarget_RequestSyntax) **
삭제할 탑재 대상의 ID입니다(문자열).
길이 제약: 최소 길이는 13자. 최대 길이는 45입니다.
패턴: `^fsmt-[0-9a-f]{8,40}$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** DependencyTimeout **
요청을 처리하는 중 서비스 시간이 초과되었으므로 클라이언트가 호출을 다시 시도해야 합니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 504
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** MountTargetNotFound **
호출자의 AWS 계정에 지정된 ID의 탑재 대상이 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
## 예제
### 파일 시스템의 탑재 대상 제거
다음 예제는 특정 탑재 대상을 삭제하기 위해 DELETE 요청을 보냅니다.
#### 샘플 요청
```
DELETE /2015-02-01/mount-targets/fsmt-9a13661e HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T232908Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteMountTarget)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteMountTarget)
# DeleteReplicationConfiguration
복제 구성을 삭제합니다. 복제 구성을 삭제하면 복제 프로세스가 종료됩니다. 복제 구성을 삭제하면 대상 파일 시스템이 `Writeable` 상태가 되고 그 복제 덮어쓰기 보호가 다시 활성화됩니다. 자세한 내용은 [복제 구성 삭제](https://docs.aws.amazon.com/efs/latest/ug/delete-replications.html) 섹션을 참조하십시오.
이 작업에는 `elasticfilesystem:DeleteReplicationConfiguration` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
DELETE /2015-02-01/file-systems/SourceFileSystemId/replication-configuration?deletionMode=DeletionMode HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [DeletionMode](#API_DeleteReplicationConfiguration_RequestSyntax) **
여러 AWS 계정 또는 여러 간에 복제할 때 AWS 리전 Amazon EFS는 기본적으로 소스 및 대상 계정 또는 리전(`ALL_CONFIGURATIONS`) 모두에서 복제 구성을 삭제합니다. Amazon EFS가 양쪽에서 복제 구성을 삭제하지 못하게 하는 구성 또는 권한 문제가 있는 경우 `LOCAL_CONFIGURATION_ONLY` 모드를 사용하여 로컬 측(삭제가 수행되는 계정 또는 리전)에서만 복제 구성을 삭제할 수 있습니다.
Amazon EFS가 소스 및 대상 계정 또는 리전 모두에서 복제 구성을 삭제할 수 없는 경우에만 `LOCAL_CONFIGURATION_ONLY` 모드를 사용합니다. 로컬 구성을 삭제하면 구성을 다른 계정 또는 리전에서 복구할 수 없습니다.
또한 동일한 계정, 동일한 리전 복제에는이 모드를 사용하지 마세요. 이렇게 하면 BadRequest 예외 오류가 발생합니다.
유효한 값: `ALL_CONFIGURATIONS | LOCAL_CONFIGURATION_ONLY`
** [SourceFileSystemId](#API_DeleteReplicationConfiguration_RequestSyntax) **
복제 구성의 소스 파일 시스템 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ReplicationNotFound **
지정된 파일 시스템에 복제 구성이 없는 경우 반환됩니다.
** ErrorCode **
ReplicationNotFound
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteReplicationConfiguration)
# DeleteTags
**참고**
더 이상 사용되지 않음 - `DeleteTags`는 더 이상 사용되지 않으며 유지 관리되지 않습니다. EFS 리소스에서 태그를 제거하려면 [UntagResource](API_UntagResource.md) API 작업을 사용합니다.
파일 시스템에서 지정된 태그를 삭제합니다. `DeleteTags` 요청에 존재하지 않는 태그 키가 포함된 경우 Amazon EFS는 해당 태그 키를 무시하고 오류를 발생시키지 않습니다. 태그 및 관련 제한에 대한 자세한 내용은 * AWS 결제 및 비용 관리 사용 설명서*의 [태그 제한을](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) 참조하세요.
이 작업에는 `elasticfilesystem:DeleteTags` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
POST /2015-02-01/delete-tags/FileSystemId HTTP/1.1
Content-type: application/json
{
"TagKeys": [ "string" ]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DeleteTags_RequestSyntax) **
태그를 삭제하려는 파일 시스템의 ID입니다(문자열).
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [TagKeys](#API_DeleteTags_RequestSyntax) **
삭제할 태그 키의 목록입니다.
타입: 문자열 배열
배열 멤버: 최소수는 1개입니다. 최대수 50개.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
필수 여부: 예
## 응답 구문
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DeleteTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DeleteTags)
# DescribeAccessPoints
`AccessPointId`가 제공된 경우 특정 Amazon EFS 액세스 포인트에 대한 설명을 반환합니다. EFS `FileSystemId`를 제공하면 해당 파일 시스템의 모든 액세스 포인트에 대한 설명이 반환됩니다. 요청에서 `AccessPointId` 또는 `FileSystemId`를 제공할 수 있지만 둘 다 제공할 수는 없습니다.
이 작업에는 `elasticfilesystem:DescribeAccessPoints` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/access-points?AccessPointId=AccessPointId&FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [AccessPointId](#API_DescribeAccessPoints_RequestSyntax) **
(선택 사항)응답에서 설명할 EFS 액세스 포인트를 지정합니다. `FileSystemId`와는 상호 배타적입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeAccessPoints_RequestSyntax) **
(선택 사항)`FileSystemId`를 제공하는 경우 EFS는 해당 파일 시스템에 대한 모든 액세스 포인트를 반환하며, `AccessPointId`와는 상호 배타적입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [MaxResults](#API_DescribeAccessPoints_RequestSyntax) **
(선택 사항)파일 시스템의 모든 액세스 포인트를 검색할 때, 선택적으로 `MaxItems` 파라미터를 지정하여 응답으로 반환되는 객체 수를 제한할 수 있습니다. 기본값은 100입니다.
유효 범위: 최소값 1.
** [NextToken](#API_DescribeAccessPoints_RequestSyntax) **
응답에 페이지가 매겨진 경우 `NextToken`이 나타납니다. 후속 요청에서 `NextMarker`를 사용하여 액세스 포인트 설명의 다음 페이지를 가져올 수 있습니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
## 요청 본문
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"AccessPointArn": "string",
"AccessPointId": "string",
"ClientToken": "string",
"FileSystemId": "string",
"LifeCycleState": "string",
"Name": "string",
"OwnerId": "string",
"PosixUser": {
"Gid": number,
"SecondaryGids": [ number ],
"Uid": number
},
"RootDirectory": {
"CreationInfo": {
"OwnerGid": number,
"OwnerUid": number,
"Permissions": "string"
},
"Path": "string"
},
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
],
"NextToken": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [AccessPoints](#API_DescribeAccessPoints_ResponseSyntax) **
액세스 포인트 설명 배열입니다.
타입: [AccessPointDescription](API_AccessPointDescription.md)객체 배열
** [NextToken](#API_DescribeAccessPoints_ResponseSyntax) **
응답에 반환된 것보다 많은 액세스 포인트가 있는 경우 제시하세요. 후속 요청에서 NextMarker를 사용하여 추가 설명을 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccessPoints)
# DescribeAccountPreferences
현재에서 요청을 하는 사용자와 AWS 계정 연결된에 대한 계정 기본 설정 설정을 반환합니다 AWS 리전.
## Request Syntax
```
GET /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"MaxResults": number,
"NextToken": "string"
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [MaxResults](#API_DescribeAccountPreferences_RequestSyntax) **
(선택 사항)계정 설정을 가져올 때 선택적으로 `MaxItems` 파라미터를 지정하여 응답으로 반환되는 객체 수를 제한할 수 있습니다. 기본 값은 100입니다.
타입: 정수
유효 범위: 최소값 1.
필수 여부: 아니요
** [NextToken](#API_DescribeAccountPreferences_RequestSyntax) **
(선택 사항)응답 페이로드가 페이지로 구분된 경우 후속 요청에서 `NextToken`을 사용하여 AWS 계정 설정의 다음 페이지를 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
필수 여부: 아니요
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [NextToken](#API_DescribeAccountPreferences_ResponseSyntax) **
응답으로 반환된 것보다 많은 레코드가 있는 경우 제시하세요. 후속 요청에서 `NextToken`을 사용하여 추가 설명을 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [ResourceIdPreference](#API_DescribeAccountPreferences_ResponseSyntax) **
현재에서 요청을 하는 사용자와 AWS 계정 연결된에 대한 리소스 ID 기본 설정을 설명합니다 AWS 리전.
타입: [ResourceIdPreference](API_ResourceIdPreference.md) 객체
## 오류
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeAccountPreferences)
# DescribeBackupPolicy
지정된 EFS 파일 시스템의 백업 정책을 반환합니다.
## Request Syntax
```
GET /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DescribeBackupPolicy_RequestSyntax) **
`BackupPolicy`를 검색할 EFS 파일 시스템을 지정합니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [BackupPolicy](#API_DescribeBackupPolicy_ResponseSyntax) **
자동 백업의 켜짐 또는 꺼짐을 나타내는 파일 시스템의 백업 정책을 설명합니다.
타입: [BackupPolicy](API_BackupPolicy.md) 객체
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** PolicyNotFound **
지정된 IAM 정책 또는 리소스 정책을 찾거나 액세스할 수 없는 경우 반환됩니다. 수행 중인 작업에 따라 EFS 파일 시스템에 기본 파일 시스템 정책이 적용되거나 백업 정책이 지정되지 않은 경우에도 오류가 반환될 수 있습니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** ValidationException **
요청이 이루어진 AWS 리전 에서 AWS Backup 서비스를 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeBackupPolicy)
# DescribeFileSystemPolicy
지정된 EFS 파일 시스템에 대한 `FileSystemPolicy`를 반환합니다.
이 작업에는 `elasticfilesystem:DescribeFileSystemPolicy` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DescribeFileSystemPolicy_RequestSyntax) **
`FileSystemPolicy`를 검색할 EFS 파일 시스템을 지정합니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [FileSystemId](#API_DescribeFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy`가 적용되는 EFS 파일 시스템을 지정합니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [Policy](#API_DescribeFileSystemPolicy_ResponseSyntax) **
EFS 파일 시스템을 위한 JSON 형식의 `FileSystemPolicy`입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 20000입니다.
패턴: `[\s\S]+`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** PolicyNotFound **
지정된 IAM 정책 또는 리소스 정책을 찾거나 액세스할 수 없는 경우 반환됩니다. 수행 중인 작업에 따라 EFS 파일 시스템에 기본 파일 시스템 정책이 적용되거나 백업 정책이 지정되지 않은 경우에도 오류가 반환될 수 있습니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
## 예제
### 예
이 예에서는 DescribeFileSystemPolicy의 한 가지 사용법을 보여줍니다.
#### 샘플 요청
```
GET /2015-02-01/file-systems/fs-01234567/policy HTTP/1.1
```
#### 샘플 응답
```
{
"FileSystemId": "fs-01234567",
"Policy": "{
"Version": "2012-10-17",
"Id": "efs-policy-wizard-cdef0123-aaaa-6666-5555-444455556666",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect" : "Deny",
"Principal": {
"AWS": "*"
},
"Action": "*",
"Resource": "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567",
"Condition": {
"Bool": {
"aws:SecureTransport": "false"
}
}
},
{
"Sid": "efs-statement-01234567-aaaa-3333-4444-111122223333",
"Effect": "Allow",
"Principal": {
"AWS": "*"
},
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Resource" : "arn:aws:elasticfilesystem:us-east-2:111122223333:file-system/fs-01234567"
}
]
}
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystemPolicy)
# DescribeFileSystems
파일 시스템 `CreationToken` 또는 `FileSystemId`가 제공된 경우 특정 Amazon EFS 파일 시스템에 대한 설명을 반환합니다. 그렇지 않으면 호출하려는 엔드포인트 AWS 리전 의 AWS 계정 에서 호출자의가 소유한 모든 파일 시스템에 대한 설명이 반환됩니다.
모든 파일 시스템 설명을 검색할 때 선택적으로 `MaxItems` 파라미터를 지정하여 응답의 설명 수를 제한할 수 있습니다. 이 숫자는 자동으로 100으로 설정됩니다. 파일 시스템 설명이 더 남아 있는 경우 Amazon EFS는 응답으로 불투명 토큰인 `NextMarker`를 반환합니다. 이 경우 `Marker` 요청 파라미터를 `NextMarker` 값으로 설정하여 후속 요청을 보내야 합니다.
파일 시스템 설명 목록을 검색하기 위해 이 작업을 반복 프로세스에서 사용합니다. 반복 프로세스에서는 `Marker`를 사용하지 않고 `DescribeFileSystems`를 먼저 직접 호출한 다음 `Marker` 파라미터를 이전 응답의 `NextMarker` 값으로 설정한 다음 응답에 `NextMarker`가 없을 때까지 계속 직접 호출합니다.
한 번의 `DescribeFileSystems` 직접 호출에 대한 응답으로 반환되는 파일 시스템의 순서와 다중 직접 호출 반복의 응답에서 반환되는 파일 시스템의 순서는 지정되지 않았습니다.
이 작업에는 `elasticfilesystem:DescribeFileSystems` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/file-systems?CreationToken=CreationToken&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [CreationToken](#API_DescribeFileSystems_RequestSyntax) **
(선택 사항)이 생성 토큰(문자열)이 있는 파일 시스템으로 목록을 제한합니다. Amazon EFS 파일 시스템 생성시 생성 토큰을 지정합니다.
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [FileSystemId](#API_DescribeFileSystems_RequestSyntax) **
(선택 사항)설명을 검색하려는 파일 시스템의 ID입니다(문자열).
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [Marker](#API_DescribeFileSystems_RequestSyntax) **
(선택 사항)이전 `DescribeFileSystems` 작업에서 반환된 불투명한 페이지 매김 토큰입니다(문자열). 존재하는 경우, 반환 직접 호출이 중단된 부분부터 목록을 계속하도록 지정합니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
** [MaxItems](#API_DescribeFileSystems_RequestSyntax) **
(선택 사항)응답에서 반환할 최대 파일 시스템 수를 지정합니다(정수). 이 숫자는 자동으로 100으로 설정됩니다. 파일 시스템이 100개 이상인 경우 응답은 페이지당 100페이지로 분류됩니다.
유효 범위: 최소값 1.
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystems": [
{
"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"
}
],
"Marker": "string",
"NextMarker": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [FileSystems](#API_DescribeFileSystems_ResponseSyntax) **
파일 시스템 설명 배열입니다.
타입: [FileSystemDescription](API_FileSystemDescription.md)객체 배열
** [Marker](#API_DescribeFileSystems_ResponseSyntax) **
요청에서 호출자가 제공한 경우 제시하세요(문자열).
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [NextMarker](#API_DescribeFileSystems_ResponseSyntax) **
응답에 반환된 것보다 많은 파일 시스템이 있는 경우 표시됩니다(문자열). 후속 요청에서 `NextMarker`를 사용하여 설명을 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 10개 파일 시스템 목록을 검색합니다.
다음 예제에서는 `file-systems` 엔드포인트(`elasticfilesystem.us-west-2.amazonaws.com/2015-02-01/file-systems`)에 GET 요청을 보냅니다. 요청은 파일 시스템 설명 수를 10개로 제한하는 `MaxItems` 쿼리 파라미터를 지정합니다.
#### 샘플 요청
```
GET /2015-02-01/file-systems?MaxItems=10 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191208Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 499
{
"FileSystems":[
{
"OwnerId":"251839141158",
"CreationToken":"MyFileSystem1",
"FileSystemId":"fs-01234567",
"PerformanceMode" : "generalPurpose",
"CreationTime":"1403301078",
"LifeCycleState":"created",
"Name":"my first file system",
"NumberOfMountTargets":1,
"SizeInBytes":{
"Timestamp": 1403301078,
"Value": 29313618372,
"ValueInArchive": 201156,
"ValueInIA": 675432,
"ValueInStandard": 29312741784
}
}
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeFileSystems)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeFileSystems)
# DescribeLifecycleConfiguration
지정된 EFS 파일 시스템에 대한 현재 `LifecycleConfiguration` 객체를 반환합니다. Lifecycle Management는 `LifecycleConfiguration` 객체를 사용하여 스토리지 클래스 간에 파일을 이동할 시기를 식별합니다. `LifecycleConfiguration` 객체가 없는 파일 시스템의 경우 호출은 응답에 빈 배열을 반환합니다.
이 작업에는 `elasticfilesystem:DescribeLifecycleConfiguration` 작업에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DescribeLifecycleConfiguration_RequestSyntax) **
`LifecycleConfiguration` 객체를 검색하려는 파일 시스템의 ID입니다(문자열).
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [LifecyclePolicies](#API_DescribeLifecycleConfiguration_ResponseSyntax) **
수명 주기 관리 정책들의 배열. EFS는 파일 시스템당 최대 하나의 정책을 지원합니다.
타입: [LifecyclePolicy](API_LifecyclePolicy.md)객체 배열
배열 멤버: 최대 항목 수는 3개입니다.
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 파일 시스템의 수명 주기 구성을 검색합니다.
다음 요청은 지정된 파일 시스템의 `LifecycleConfiguration` 객체를 검색합니다.
#### 샘플 요청
```
GET /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181120T221118Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_270_DAYS"
},
{
"TransitionToIA": "AFTER_14_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeLifecycleConfiguration)
# DescribeMountTargets
파일 시스템에 대한 모든 현재 탑재 대상 또는 특정 탑재 대상의 설명을 반환합니다. 현재 탑재 대상을 모두 요청하는 경우 응답에서 반환되는 탑재 대상의 순서는 지정되지 않습니다.
이 작업을 수행하려면 `FileSystemId`에서 지정한 파일 시스템 ID 또는 `MountTargetId`에서 지정한 탑재 대상의 파일 시스템에 대한 `elasticfilesystem:DescribeMountTargets` 작업 권한이 필요합니다.
해당 CLI 명령은 `describe-mount-targets`입니다.
## Request Syntax
```
GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [AccessPointId](#API_DescribeMountTargets_RequestSyntax) **
(선택 사항)탑재 대상을 나열하려는 액세스 포인트의 ID입니다. `FileSystemId` 또는 `MountTargetId`가 요청에 포함되지 않은 경우 요청에 포함되어야 합니다. 액세스 포인트 ID 또는 ARN을 입력으로 받아들입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$`
** [FileSystemId](#API_DescribeMountTargets_RequestSyntax) **
(선택 사항)탑재 대상을 나열하려는 파일 시스템의 ID (문자열). `AccessPointId` 또는 `MountTargetId`가 포함되지 않은 경우 요청에 포함되어야 합니다. 파일 시스템 ID 또는 ARN을 입력으로 받아들입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [Marker](#API_DescribeMountTargets_RequestSyntax) **
(선택 사항)이전 `DescribeMountTargets` 작업에서 반환된 불투명한 페이지 매김 토큰입니다(문자열). 존재하는 경우, 반환 직접 호출이 중단된 부분부터 목록을 계속하도록 지정합니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
** [MaxItems](#API_DescribeMountTargets_RequestSyntax) **
(선택 사항)응답에 반환될 최대 탑재 대상 수입니다. 현재 이 수는 자동으로 10으로 설정되며 다른 값은 무시됩니다. 탑재 대상이 100개가 넘는 경우 응답은 페이지당 100페이지로 분류됩니다.
유효 범위: 최소값 1.
** [MountTargetId](#API_DescribeMountTargets_RequestSyntax) **
(선택 사항)설명하려는 탑재 대상의 ID입니다(문자열). `FileSystemId`가 포함되지 않은 경우 요청에 포함해야 합니다. 탑재 대상 ID 또는 ARN을 입력으로 받아들입니다.
길이 제약: 최소 길이는 13자. 최대 길이는 45입니다.
패턴: `^fsmt-[0-9a-f]{8,40}$`
## 요청 본문
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"MountTargets": [
{
"AvailabilityZoneId": "string",
"AvailabilityZoneName": "string",
"FileSystemId": "string",
"IpAddress": "string",
"Ipv6Address": "string",
"LifeCycleState": "string",
"MountTargetId": "string",
"NetworkInterfaceId": "string",
"OwnerId": "string",
"SubnetId": "string",
"VpcId": "string"
}
],
"NextMarker": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [Marker](#API_DescribeMountTargets_ResponseSyntax) **
요청에 `Marker`가 포함된 경우 응답은 이 필드에 해당 값을 반환합니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [MountTargets](#API_DescribeMountTargets_ResponseSyntax) **
파일 시스템의 탑재 대상을 `MountTargetDescription` 객체의 배열로 반환합니다.
타입: [MountTargetDescription](API_MountTargetDescription.md)객체 배열
** [NextMarker](#API_DescribeMountTargets_ResponseSyntax) **
값이 있는 경우 반환할 탑재 대상이 더 많습니다. 후속 요청 시 요청에 `Marker`를 제공하여 다음 탑재 대상 세트를 검색할 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** MountTargetNotFound **
호출자의 AWS 계정에 지정된 ID의 탑재 대상이 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
## 예제
### 파일 시스템용으로 생성된 탑재 대상에 대한 설명을 검색합니다.
다음 요청은 지정된 파일 시스템에 대해 생성된 탑재 대상에 대한 설명을 검색합니다.
#### 샘플 요청
```
GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357
{
"MountTargets":[
{
"OwnerId":"251839141158",
"MountTargetId":"fsmt-01234567",
"FileSystemId":"fs-01234567",
"SubnetId":"subnet-01234567",
"LifeCycleState":"added",
"IpAddress":"10.0.2.42",
"NetworkInterfaceId":"eni-1bcb7772"
}
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargets)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargets)
# DescribeMountTargetSecurityGroups
현재 탑재 대상에 대해 유효한 보안 그룹을 반환합니다. 이 작업을 수행하려면 탑재 대상의 네트워크 인터페이스가 생성되고 탑재 대상의 수명 주기 상태는 `deleted`가 아니어야 합니다.
이 작업에는 다음 작업에 대한 권한이 필요합니다.
+ 탑재 대상의 파일 시스템에서의 `elasticfilesystem:DescribeMountTargetSecurityGroups` 작업
+ 탑재 대상의 네트워크 인터페이스에서의 `ec2:DescribeNetworkInterfaceAttribute` 작업
## Request Syntax
```
GET /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [MountTargetId](#API_DescribeMountTargetSecurityGroups_RequestSyntax) **
보안 그룹을 검색할 마운트 대상의 ID입니다.
길이 제약: 최소 길이는 13자. 최대 길이는 45입니다.
패턴: `^fsmt-[0-9a-f]{8,40}$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [SecurityGroups](#API_DescribeMountTargetSecurityGroups_ResponseSyntax) **
보안 그룹의 배열입니다.
유형: 문자열 어레이
배열 멤버: 최대 항목 수는 100개입니다.
길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다.
패턴: `^sg-[0-9a-f]{8,40}`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** IncorrectMountTargetState **
탑재 대상이 작업에 적합한 올바른 상태가 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** MountTargetNotFound **
호출자의 AWS 계정에 지정된 ID의 탑재 대상이 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
## 예제
### 파일 시스템에 적용되는 보안 그룹을 검색합니다.
다음 예에서는 탑재 대상과 관련된 네트워크 인터페이스에 적용되는 보안 그룹을 검색합니다.
#### 샘플 요청
```
GET /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223513Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeMountTargetSecurityGroups)
# DescribeReplicationConfigurations
특정 파일 시스템의 복제 구성을 검색합니다. 파일 시스템을 지정하지 않으면의 AWS 계정 에 대한 모든 복제 구성이 검색 AWS 리전 됩니다.
## Request Syntax
```
GET /2015-02-01/file-systems/replication-configurations?FileSystemId=FileSystemId&MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DescribeReplicationConfigurations_RequestSyntax) **
파일 시스템 ID를 제공하여 특정 파일 시스템의 복제 구성을 검색할 수 있습니다. 교차 계정, 교차 리전 복제의 경우 계정은 자체 리전의 파일 시스템에 대한 복제 구성만 설명할 수 있습니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [MaxResults](#API_DescribeReplicationConfigurations_RequestSyntax) **
(선택 사항)응답에서 반환되는 객체 수를 제한하려면 `MaxItems` 파라미터를 지정할 수 있습니다. 기본값은 100입니다.
유효 범위: 최소값 1.
** [NextToken](#API_DescribeReplicationConfigurations_RequestSyntax) **
응답에 페이지가 매겨진 경우 `NextToken`이 나타납니다. 후속 요청에서 다음 출력 페이지를 가져오는 데 `NextToken`을 사용할 수 있습니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
## 요청 본문
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Replications": [
{
"CreationTime": number,
"Destinations": [
{
"FileSystemId": "string",
"LastReplicatedTimestamp": number,
"OwnerId": "string",
"Region": "string",
"RoleArn": "string",
"Status": "string",
"StatusMessage": "string"
}
],
"OriginalSourceFileSystemArn": "string",
"SourceFileSystemArn": "string",
"SourceFileSystemId": "string",
"SourceFileSystemOwnerId": "string",
"SourceFileSystemRegion": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [NextToken](#API_DescribeReplicationConfigurations_ResponseSyntax) **
이전 응답의 `NextToken`를 후속 요청에서 사용하여 추가 설명을 가져올 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [Replications](#API_DescribeReplicationConfigurations_ResponseSyntax) **
반환된 복제 구성 컬렉션입니다.
타입: [ReplicationConfigurationDescription](API_ReplicationConfigurationDescription.md) 객체 배열
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ReplicationNotFound **
지정된 파일 시스템에 복제 구성이 없는 경우 반환됩니다.
** ErrorCode **
ReplicationNotFound
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** ValidationException **
요청이 이루어진 AWS 리전 에서 AWS Backup 서비스를 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeReplicationConfigurations)
# DescribeTags
**참고**
더 이상 사용되지 않음 - 이 `DescribeTags` 작업은 더 이상 사용되지 않으며 유지 관리되지 않습니다. EFS 리소스와 연결된 태그를 보려면 `ListTagsForResource` API 작업을 사용하세요.
파일 시스템과 연결된 태그를 반환합니다. 한 번의 `DescribeTags` 직접 호출에 대한 응답에서 반환되는 태그의 순서와 다중 직접 호출 반복(페이지 매김을 사용하는 경우)의 응답에서 반환되는 태그의 순서는 지정되지 않습니다.
이 작업에는 `elasticfilesystem:DescribeTags` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/tags/FileSystemId/?Marker=Marker&MaxItems=MaxItems HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_DescribeTags_RequestSyntax) **
태그 세트를 가져올 파일 시스템의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
** [Marker](#API_DescribeTags_RequestSyntax) **
(선택 사항)이전 `DescribeTags` 작업에서 반환된 불투명한 페이지 매김 토큰(문자열). 존재하는 경우, 이전 직접 호출이 중단된 부분부터 목록을 계속하도록 지정합니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
** [MaxItems](#API_DescribeTags_RequestSyntax) **
(선택 사항)응답에 반환될 최대 파일 시스템 태그 수입니다. 현재 이 숫자는 자동으로 100으로 설정되며 다른 값은 무시됩니다. 태그가 100개가 넘는 경우 응답은 페이지당 100페이지로 분류됩니다.
유효 범위: 최소값 1.
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"Marker": "string",
"NextMarker": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [Marker](#API_DescribeTags_ResponseSyntax) **
요청에 `Marker`가 포함된 경우 응답은 이 필드에 해당 값을 반환합니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [NextMarker](#API_DescribeTags_ResponseSyntax) **
값이 있는 경우 반환할 태그가 더 많습니다. 후속 요청에서 다음 태그 세트를 검색하기 위해 다음 요청의 `Marker` 파라미터의 값으로 `NextMarker`의 값을 제공할 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [Tags](#API_DescribeTags_ResponseSyntax) **
파일 시스템과 연결된 태그를 `Tag` 객체의 배열로 반환합니다.
타입: [Tag](API_Tag.md) 객체 배열
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 파일 시스템과 연결된 태그 검색
다음 요청은 지정된 파일 시스템과 연결된 태그(키-값 페어)를 검색합니다.
#### 샘플 요청
```
GET /2015-02-01/tags/fs-01234567/ HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T215404Z
Authorization: <...>
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 288
{
"Tags":[
{
"Key":"Name",
"Value":"my first file system"
},
{
"Key":"Fleet",
"Value":"Development"
},
{
"Key":"Developer",
"Value":"Alice"
}
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/DescribeTags)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/DescribeTags)
# ListTagsForResource
최상위 EFS 리소스에 대한 모든 태그를 나열합니다. 태그를 검색하려는 리소스에 대한 ID를 입력해야 합니다.
이 작업에는 `elasticfilesystem:DescribeAccessPoints` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
GET /2015-02-01/resource-tags/ResourceId?MaxResults=MaxResults&NextToken=NextToken HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [MaxResults](#API_ListTagsForResource_RequestSyntax) **
(선택 사항)응답에 반환될 최대 태그 객체 수를 지정합니다. 기본값은 100입니다.
유효 범위: 최소값 1.
** [NextToken](#API_ListTagsForResource_RequestSyntax) **
(선택 사항)응답 페이로드가 페이지로 구분된 경우 후속 요청에서 액세스 포인트 설명의 다음 페이지를 가져오는 데 `NextToken`을 사용할 수 있습니다.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `.+`
** [ResourceId](#API_ListTagsForResource_RequestSyntax) **
태그를 검색할 EFS 리소스를 지정합니다. 이 API 엔드포인트를 사용하여 EFS 파일 시스템 및 액세스 포인트에 대한 태그를 검색할 수 있습니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [NextToken](#API_ListTagsForResource_ResponseSyntax) **
응답 페이로드가 페이징된 경우 `NextToken`이 존재합니다. 후속 요청에서 액세스 포인트 설명의 다음 페이지를 가져오는 데 `NextToken`을 사용할 수 있습니다.
유형: 문자열
길이 제약: 최소 길이는 1. 최대 길이 128.
패턴: `.+`
** [Tags](#API_ListTagsForResource_ResponseSyntax) **
지정된 EFS 리소스에 대한 태그의 배열입니다.
타입: [Tag](API_Tag.md) 객체 배열
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ListTagsForResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ListTagsForResource)
# ModifyMountTargetSecurityGroups
탑재 대상에 대해 유효한 보안 그룹 세트를 수정합니다.
탑재 대상을 생성하면 Amazon EFS는 새 네트워크 인터페이스도 생성합니다. 자세한 내용은 [CreateMountTarget](API_CreateMountTarget.md) 단원을 참조하십시오. 이 작업은 탑재 대상과 연결된 네트워크 인터페이스에 적용되는 보안 그룹을 요청에 제공된 `SecurityGroups`로 대체합니다. 이 작업을 수행하려면 탑재 대상의 네트워크 인터페이스가 생성되고 탑재 대상의 수명 주기 상태는 `deleted`가 아니어야 합니다.
이 작업에는 다음 작업에 대한 권한이 필요합니다.
+ 탑재 대상의 파일 시스템에서의 `elasticfilesystem:ModifyMountTargetSecurityGroups` 작업
+ 탑재 대상의 네트워크 인터페이스에서의 `ec2:ModifyNetworkInterfaceAttribute` 작업
## Request Syntax
```
PUT /2015-02-01/mount-targets/MountTargetId/security-groups HTTP/1.1
Content-type: application/json
{
"SecurityGroups": [ "string" ]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [MountTargetId](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
수정하려는 보안 그룹이 있는 탑재 대상의 ID.
길이 제약: 최소 길이는 13자. 최대 길이는 45입니다.
패턴: `^fsmt-[0-9a-f]{8,40}$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [SecurityGroups](#API_ModifyMountTargetSecurityGroups_RequestSyntax) **
VPC 보안 그룹 ID의 배열.
유형: 문자열 어레이
배열 멤버: 최대 항목 수는 100개입니다.
길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다.
패턴: `^sg-[0-9a-f]{8,40}`
필수 여부: 아니요
## 응답 구문
```
HTTP/1.1 204
```
## Response Elements
액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.
## Errors
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** IncorrectMountTargetState **
탑재 대상이 작업에 적합한 올바른 상태가 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** MountTargetNotFound **
호출자의 AWS 계정에 지정된 ID의 탑재 대상이 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** SecurityGroupLimitExceeded **
요청에 지정된 `SecurityGroups`의 수가 계정 할당량에 기반한 한도를 초과할 경우 반환됩니다. 일부 보안 그룹을 삭제하거나 계정 할당량 상향을 요청하세요. 자세한 내용은 *Amazon VPC 사용 설명서*의 [Amazon VPC 할당량](https://docs.aws.amazon.com/vpc/latest/userguide/amazon-vpc-limits.html)을 참조하세요(**보안 그룹** 테이블 참조).
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** SecurityGroupNotFound **
지정된 보안 그룹 중 하나가 서브넷의 Virtual Private Cloud(VPC)에 존재하지 않는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 예
### 탑재 대상의 보안 그룹 교체
다음 예는 탑재 대상과 연결된 네트워크 인터페이스에 적용되는 보안 그룹을 대체합니다.
#### 샘플 요청
```
PUT /2015-02-01/mount-targets/fsmt-9a13661e/security-groups HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T223446Z
Authorization: <...>
Content-Type: application/json
Content-Length: 57
{
"SecurityGroups" : [
"sg-188d9f74"
]
}
```
#### 샘플 응답
```
HTTP/1.1 204 No Content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/ModifyMountTargetSecurityGroups)
# PutAccountPreferences
이 작업을 사용하면 새 EFS 파일 시스템 및 탑재 대상 리소스에 대해 긴 17자(63비트) 또는 짧은 8자(32비트) 리소스 ID를 사용하도록 현재 AWS 리전 의 계정 기본 설정을 설정할 수 있습니다. 모든 기존 리소스 ID는 변경의 영향을 받지 않습니다. 긴 리소스 ID로 EFS가 전환함에 따라 옵트인 기간 동안 ID 기본 설정을 지정할 수 있습니다. 자세한 내용은 [Amazon EFS 리소스 ID 관리](https://docs.aws.amazon.com/efs/latest/ug/manage-efs-resource-ids.html)를 참조하세요.
**참고**
2021년 10월부터 짧은 8자 형식의 리소스 ID를 사용하도록 계정 기본 설정을 지정하려고 하면 오류가 발생합니다. 오류가 발생하여 파일 시스템 및 탑재 대상 리소스에 짧은 IDs 사용해야 하는 경우 AWS 지원팀에 문의하세요.
## Request Syntax
```
PUT /2015-02-01/account-preferences HTTP/1.1
Content-type: application/json
{
"ResourceIdType": "string"
}
```
## URI 요청 파라미터
요청은 URI 파라미터를 사용하지 않습니다.
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [ResourceIdType](#API_PutAccountPreferences_RequestSyntax) **
현재에서 사용자의에 대해 설정할 EFS 리소스 ID 기본 설정을 AWS 리전`LONG_ID` (17자) 또는 `SHORT_ID` (8자) AWS 계정로 지정합니다.
2021년 10월부터 계정 기본 설정을 `SHORT_ID`로 지정할 때 오류 메시지가 표시됩니다. 오류가 발생하여 파일 시스템 및 탑재 대상 리소스에 짧은 IDs 사용해야 하는 경우 AWS 지원팀에 문의하세요.
타입: 문자열
유효 값: `LONG_ID | SHORT_ID`
필수 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"ResourceIdPreference": {
"ResourceIdType": "string",
"Resources": [ "string" ]
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [ResourceIdPreference](#API_PutAccountPreferences_ResponseSyntax) **
현재에서 리소스 유형과 사용자의 AWS 계정에 대한 ID 기본 설정을 설명합니다 AWS 리전.
타입: [ResourceIdPreference](API_ResourceIdPreference.md) 객체
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutAccountPreferences)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutAccountPreferences)
# PutBackupPolicy
파일 시스템의 백업 정책을 업데이트합니다. 이 작업을 사용하면 파일 시스템의 자동 백업을 시작하거나 중지할 수 있습니다.
## Request Syntax
```
PUT /2015-02-01/file-systems/FileSystemId/backup-policy HTTP/1.1
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_PutBackupPolicy_RequestSyntax) **
백업 정책을 업데이트할 EFS 파일 시스템을 지정합니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [BackupPolicy](#API_PutBackupPolicy_RequestSyntax) **
`PutBackupPolicy` 요청에 포함된 백업 정책.
타입: [BackupPolicy](API_BackupPolicy.md)객체
필수 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"BackupPolicy": {
"Status": "string"
}
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [BackupPolicy](#API_PutBackupPolicy_ResponseSyntax) **
자동 백업의 켜짐 또는 꺼짐을 나타내는 파일 시스템의 백업 정책을 설명합니다.
타입: [BackupPolicy](API_BackupPolicy.md) 객체
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ValidationException **
요청이 수행된 AWS 리전 에서 AWS Backup 서비스를 사용할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutBackupPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutBackupPolicy)
# PutFileSystemPolicy
Amazon EFS 파일 시스템에 Amazon EFS `FileSystemPolicy`를 적용합니다. 파일 시스템 정책은 IAM 리소스 기반 정책이며 여러 정책 명령문을 포함할 수 있습니다. 파일 시스템에는 항상 정확히 하나의 파일 시스템 정책이 있으며, 이는 기본 정책일 수도 있고 이 API 작업을 사용하여 설정되거나 업데이트된 명시적 정책일 수도 있습니다. EFS 파일 시스템 정책은 20,000자로 제한됩니다. 명시적 정책이 설정되면 기본 정책보다 우선합니다. 기본 파일 시스템 정책에 대한 자세한 내용은 [기본 EFS 파일 시스템 정책](https://docs.aws.amazon.com/efs/latest/ug/iam-access-control-nfs-efs.html#default-filesystempolicy) 섹션을 참조하십시오.
**참고**
EFS 파일 시스템 정책은 20,000자로 제한됩니다.
이 작업에는 `elasticfilesystem:PutFileSystemPolicy` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
PUT /2015-02-01/file-systems/FileSystemId/policy HTTP/1.1
Content-type: application/json
{
"BypassPolicyLockoutSafetyCheck": boolean,
"Policy": "string"
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_PutFileSystemPolicy_RequestSyntax) **
`FileSystemPolicy`를 생성 또는 업데이트하려는 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})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [BypassPolicyLockoutSafetyCheck](#API_PutFileSystemPolicy_RequestSyntax) **
(선택 사항)`FileSystemPolicy` 잠금 안전 검사를 우회할지 여부를 지정하는 부울입니다. 잠금 안전 검사는 요청의 정책이 요청을 하는 IAM 보안 주체를 잠글지 아니면 이 파일 시스템에 대해 향후 `PutFileSystemPolicy` 요청을 하지 못하도록 할지 결정합니다. 요청하는 IAM 보안 주체가 이 파일 시스템에서 후속 `PutFileSystemPolicy` 요청을 하지 않도록 하려는 경우에만 `BypassPolicyLockoutSafetyCheck`를 `True`로 설정합니다. 기본값은 `False`입니다.
유형: 부울
필수 항목 여부: 아니요
** [Policy](#API_PutFileSystemPolicy_RequestSyntax) **
생성하려는 `FileSystemPolicy`입니다. JSON 형식의 정책 정의를 수락합니다. EFS 파일 시스템 정책은 20,000자로 제한됩니다. 파일 시스템 정책을 구성하는 요소에 대해 자세히 알아보려면 [Amazon EFS 내 리소스 기반 정책](https://docs.aws.amazon.com/efs/latest/ug/security_iam_service-with-iam.html#security_iam_service-with-iam-resource-based-policies) 섹션을 참조하십시오.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 20000입니다.
패턴: `[\s\S]+`
필수 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"FileSystemId": "string",
"Policy": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [FileSystemId](#API_PutFileSystemPolicy_ResponseSyntax) **
`FileSystemPolicy`가 적용되는 EFS 파일 시스템을 지정합니다.
유형: 문자열
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
** [Policy](#API_PutFileSystemPolicy_ResponseSyntax) **
EFS 파일 시스템을 위한 JSON 형식의 `FileSystemPolicy`입니다.
유형: 문자열
길이 제약: 최소 길이 1. 최대 길이는 20000입니다.
패턴: `[\s\S]+`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** InvalidPolicyException **
`FileSystemPolicy`가 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다. 정책 록아웃 안전 검사 오류가 발생한 경우에 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
## 예
### EFS FileSystemPolicy 생성
다음 요청은 모든 AWS 보안 주체`FileSystemPolicy`가 읽기 및 쓰기 권한으로 지정된 EFS 파일 시스템을 탑재할 수 있도록 허용하는를 생성합니다.
#### 샘플 요청
```
PUT /2015-02-01/file-systems/fs-01234567/file-system-policy HTTP/1.1
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
}
]
}
```
#### 샘플 응답
```
{
"Version": "2012-10-17",
"Id": "1",
"Statement": [
{
"Sid": "efs-statement-abcdef01-1111-bbbb-2222-111122224444",
"Effect": "Allow",
"Action": [
"elasticfilesystem:ClientMount",
"elasticfilesystem:ClientWrite"
],
"Principal": {
"AWS": ["*"]
},
"Resource":"arn:aws:elasticfilesystem:us-east-1:1111222233334444:file-system/fs-01234567"
}
]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutFileSystemPolicy)
# PutLifecycleConfiguration
이 작업을 사용하면 파일 시스템의 스토리지를 관리할 수 있습니다. `LifecycleConfiguration`은 다음을 정의하는 하나 이상의 `LifecyclePolicy` 객체로 구성됩니다.
+ ** `TransitionToIA` ** - 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)에서 Inrequent Access(IA) 스토리지로 이동하는 시점입니다.
+ **`TransitionToArchive`** - 파일 시스템의 파일을 현재 스토리지 클래스(IA 또는 Standard 스토리지)에서 Archive 스토리지로 이동하는 시점입니다.
IA 스토리지로 전환하기 전에는 파일 시스템을 Archive 스토리지로 전환할 수 없습니다. 따라서 TransitionToArchive는 설정되지 않았거나 TransitionToIA 이후여야 합니다.
**참고**
Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
+ ** `TransitionToPrimaryStorageClass` ** - IA 또는 Archive 스토리지에서 액세스된 후 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)로 다시 이동할지 여부입니다.
자세한 내용은 [파일 시스템 스토리지 관리](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html) 섹션을 참조하십시오.
각 Amazon EFS 파일 시스템은 파일 시스템의 모든 파일에 적용되는 하나의 수명 주기 구성을 지원합니다. 지정된 파일 시스템에 대한 `LifecycleConfiguration` 객체가 이미 존재하는 경우 `PutLifecycleConfiguration` 직접 호출을 통해 기존 구성이 수정됩니다. 요청 본문에 빈 `LifecyclePolicies` 배열을 `PutLifecycleConfiguration`으로 직접 호출하면 기존 `LifecycleConfiguration`이 모두 삭제됩니다. 요청에서 다음을 지정합니다.
+ 수명 주기 관리를 활성화, 비활성화 또는 수정하려는 파일 시스템의 ID
+ 파일을 IA 스토리지로, Archive 스토리지로, 다시 기본 스토리지로 이동하는 시점을 정의하는 `LifecyclePolicy` 객체의 `LifecyclePolicies` 배열입니다.
**참고**
Amazon EFS에서는 각 `LifecyclePolicy` 객체에 단일 전환만 포함해야 하므로 `LifecyclePolicies` 배열을 별도의 `LifecyclePolicy` 객체로 구성해야 합니다. 자세한 내용을 알아보려면 다음 섹션의 예제 요청을 참조하세요.
이 작업에는 `elasticfilesystem:PutLifecycleConfiguration` 작업에 대한 권한이 필요합니다.
암호화된 파일 시스템에 `LifecycleConfiguration` 객체를 적용하려면 암호화된 파일 시스템을 생성할 때와 동일한 AWS Key Management Service 권한이 필요합니다.
## Request Syntax
```
PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **
`LifecycleConfiguration` 객체(문자열)를 생성할 파일 시스템의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **
파일 시스템의 `LifecycleConfiguration` 객체를 정의하는 `LifecyclePolicy` 객체의 배열입니다. `LifecycleConfiguration` 객체는 수명 주기 관리에 다음 사항을 알립니다.
+ ** `TransitionToIA` ** - 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)에서 Inrequent Access(IA) 스토리지로 이동하는 시점입니다.
+ **`TransitionToArchive`** - 파일 시스템의 파일을 현재 스토리지 클래스(IA 또는 Standard 스토리지)에서 Archive 스토리지로 이동하는 시점입니다.
IA 스토리지로 전환하기 전에는 파일 시스템을 Archive 스토리지로 전환할 수 없습니다. 따라서 TransitionToArchive는 설정되지 않았거나 TransitionToIA 이후여야 합니다.
**참고**
Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
+ ** `TransitionToPrimaryStorageClass` ** - IA 또는 Archive 스토리지에서 액세스된 후 파일 시스템의 파일을 기본 스토리지(Standard 스토리지 클래스)로 다시 이동할지 여부입니다.
`put-lifecycle-configuration` CLI 명령 또는 `PutLifecycleConfiguration` API 작업을 사용할 때, Amazon EFS에서는 각 `LifecyclePolicy` 객체에 단일 전환만 포함하도록 요구합니다. 즉, 요청 본문에서 `LifecyclePolicies`는 각 스토리지 전환 시 하나의 객체인 `LifecyclePolicy` 객체의 배열로 구조화되어야 합니다. 자세한 내용을 알아보려면 다음 섹션의 예제 요청을 참조하세요.
타입: [LifecyclePolicy](API_LifecyclePolicy.md)객체 배열
배열 멤버: 최대 항목 수는 3개입니다.
필수 항목 여부: 예
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"LifecyclePolicies": [
{
"TransitionToArchive": "string",
"TransitionToIA": "string",
"TransitionToPrimaryStorageClass": "string"
}
]
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **
수명 주기 관리 정책들의 배열. EFS는 파일 시스템당 최대 하나의 정책을 지원합니다.
타입: [LifecyclePolicy](API_LifecyclePolicy.md)객체 배열
배열 멤버: 최대 항목 수는 3개입니다.
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 수명 주기 구성 생성
다음 예제에서는 `PutLifecycleConfiguration` 액션을 사용하여 `LifecyclePolicy` 객체를 만듭니다. 이 예시에서는 EFS에 다음을 수행하도록 지시하는 수명 주기 정책을 생성합니다.
+ Standard 스토리지에서 지난 30일 동안 액세스하지 않은 파일 시스템 내 파일을 모두 IA 스토리지로 이동합니다.
+ Standard 스토리지에서 지난 90일 동안 액세스하지 않은 파일 시스템 내 파일을 모두 Archive 스토리지로 이동합니다.
+ IA 또는 Archive 스토리지에서 액세스한 파일은 다시 Standard 스토리지로 이동합니다. Archive 스토리지 클래스는 탄력적 처리량 모드 및 범용 성능 모드를 사용하는 파일 시스템에만 사용할 수 있습니다.
자세한 내용은 [EFS 스토리지 클래스](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) 및 [파일 시스템 스토리지 관리](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html) 섹션을 참조하십시오.
#### 샘플 요청
```
PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorage": "AFTER_1_ACCESS"
}
]
}
```
### put-lifecycle-configuration CLI 요청 예제
이 예제는 PutLifecycleConfiguration의 한 가지 사용법을 보여줍니다.
#### 샘플 요청
```
aws efs put-lifecycle-configuration \
--file-system-id fs-0123456789abcdefb \
--lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
{"TransitionToIA":"AFTER_30_DAYS"},
{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]
--region us-west-2 \
--profile adminuser
```
#### 샘플 응답
```
{
"LifecyclePolicies": [
{
"TransitionToArchive": "AFTER_90_DAYS"
},
{
"TransitionToIA": "AFTER_30_DAYS"
},
{
"TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
}
]
}
```
### 수명 주기 관리 비활성화
다음 예제에서는 지정된 파일 시스템의 수명 주기 관리를 비활성화합니다.
#### 샘플 요청
```
PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
#### 샘플 응답
```
HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86
{
"LifecyclePolicies": [ ]
}
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)
# TagResource
EFS 리소스용 태그를 생성합니다. 이 API 작업을 사용하여 EFS 파일 시스템 및 액세스 포인트를 위한 태그를 생성할 수 있습니다.
이 작업에는 `elasticfilesystem:TagResource` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
POST /2015-02-01/resource-tags/ResourceId HTTP/1.1
Content-type: application/json
{
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [ResourceId](#API_TagResource_RequestSyntax) **
태그를 생성하려는 EFS 리소스를 지정하는 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [Tags](#API_TagResource_RequestSyntax) **
추가할 `Tag` 객체 배열. 각 `Tag` 객체는 키-값 페어입니다.
타입: [Tag](API_Tag.md)객체 배열
필수 항목 여부: 예
## 응답 구문
```
HTTP/1.1 200
```
## Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 예제
### 파일 시스템에 태그 생성
다음 요청은 지정된 파일 시스템에 세 개의 태그(`"key1"`, `"key2"`, 및 `"key3"`)를 생성합니다.
#### 샘플 요청
```
POST /2015-02-01/tag-resource/fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160
{
"Tags": [
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
},
{
"Key": "key3",
"Value": "value3"
}
]
}
```
#### 샘플 응답
```
HTTP/1.1 204 no content
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
```
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/TagResource)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/TagResource)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/TagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/TagResource)
# UntagResource
EFS 리소스에서 태그를 제거합니다. 이 API 작업을 사용하여 EFS 파일 시스템 및 액세스 포인트를 위한 태그를 제거할 수 있습니다.
이 작업에는 `elasticfilesystem:UntagResource` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
DELETE /2015-02-01/resource-tags/ResourceId?tagKeys=TagKeys HTTP/1.1
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [ResourceId](#API_UntagResource_RequestSyntax) **
태그를 제거할 EFS 리소스를 지정합니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:(access-point/fsap|file-system/fs)-[0-9a-f]{8,40}|fs(ap)?-[0-9a-f]{8,40})$`
필수 여부: 예
** [TagKeys](#API_UntagResource_RequestSyntax) **
지정된 EFS 리소스에서 제거하려는 키-값 태그 페어 키입니다.
배열 멤버: 최소수는 1개입니다. 최대수 50개.
길이 제약: 최소 길이 1. 최대 길이 128.
패턴: `^(?![aA]{1}[wW]{1}[sS]{1}:)([\p{L}\p{Z}\p{N}_.:/=+\-@]+)$`
필수 여부: 예
## Request Body
해당 요청에는 본문이 없습니다.
## Response Syntax
```
HTTP/1.1 200
```
## Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 다시 전송합니다.
## 오류
** AccessPointNotFound **
지정된 `AccessPointId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
## 참고
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UntagResource)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UntagResource)
# UpdateFileSystem
기존 파일 시스템의 처리량 모드 또는 프로비저닝된 처리량을 업데이트합니다.
## Request Syntax
```
PUT /2015-02-01/file-systems/FileSystemId HTTP/1.1
Content-type: application/json
{
"ProvisionedThroughputInMibps": number,
"ThroughputMode": "string"
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_UpdateFileSystem_RequestSyntax) **
업데이트할 파일 시스템의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_RequestSyntax) **
(선택 사항)생성 중인 파일 시스템에 대해 프로비저닝하고자 하는 처리량입니다. 초당 메비바이트(MiBps)로 측정됩니다. `ThroughputMode`이 `provisioned`로 설정된 경우 필수입니다. 유효한 값은 1\$13414MiBps이며 상한은 리전에 따라 다릅니다. 이 제한을 늘리려면에 문의하세요 지원. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서**의 [증가할 수 있는 Amazon EFS 할당량](https://docs.aws.amazon.com/efs/latest/ug/limits.html#soft-limits)을 참조하세요.
유형: Double
유효한 범위: 최소값은 1.0입니다.
필수 여부: 아니요
** [ThroughputMode](#API_UpdateFileSystem_RequestSyntax) **
(선택 사항)파일 시스템의 처리량 모드를 업데이트합니다. 처리량 모드를 업데이트하지 않는 경우 요청에 이 값을 제공할 필요가 없습니다. `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](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템이 위치한 가용 영역의 고유하고 일관된 식별자로, One Zone 파일 시스템에만 유효합니다. 예를 들어 `use1-az1`는 us-east-1의 가용 영역 ID AWS 리전이며 모든에서 위치가 동일합니다 AWS 계정.
유형: 문자열
** [AvailabilityZoneName](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템이 있는 AWS 가용 영역을 설명하며 One Zone 파일 시스템에만 유효합니다. 자세한 내용을 알아보려면 Amazon EFS 사용 설명서**의 [EFS 스토리지 클래스 사용](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html)을 참조하세요.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [CreationTime](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템이 생성된 시간(초)입니다(1970-01-01T00:00:00Z 이후).
유형: 타임스탬프
** [CreationToken](#API_UpdateFileSystem_ResponseSyntax) **
요청에 지정된 불투명한 문자열입니다.
유형: 문자열
길이 제한: 최소 길이는 1. 최대 길이는 64.
패턴: `.+`
** [Encrypted](#API_UpdateFileSystem_ResponseSyntax) **
true인 경우 파일 시스템이 암호화되었음을 나타내는 부울 값입니다.
유형: Boolean
** [FileSystemArn](#API_UpdateFileSystem_ResponseSyntax) **
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](#API_UpdateFileSystem_ResponseSyntax) **
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](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템의 보호를 설명합니다.
유형: [FileSystemProtectionDescription](API_FileSystemProtectionDescription.md)객체
** [KmsKeyId](#API_UpdateFileSystem_ResponseSyntax) **
암호화된 파일 시스템을 보호하는 데 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](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템의 수명 주기 단계입니다.
타입: 문자열
유효 값: `creating | available | updating | deleting | deleted | error`
** [Name](#API_UpdateFileSystem_ResponseSyntax) **
태그를 포함하여 파일 시스템에 `Name` 태그를 추가할 수 있습니다. 자세한 내용은 [CreateFileSystem](API_CreateFileSystem.md) 단원을 참조하십시오. 파일 시스템에 `Name` 태그가 있는 경우 Amazon EFS는 이 필드에 값을 반환합니다.
유형: 문자열
길이 제약: 최대 길이 256.
패턴: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$`
** [NumberOfMountTargets](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템에 있는 탑재 대상의 현재 수. 자세한 내용은 [CreateMountTarget](API_CreateMountTarget.md) 단원을 참조하십시오.
유형: 정수
유효 범위: 최소값 0.
** [OwnerId](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템을 AWS 계정 생성한 입니다.
유형: 문자열
길이 제약 조건: 최대 길이는 14입니다.
패턴: `^(\d{12})|(\d{4}-\d{4}-\d{4})$`
** [PerformanceMode](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템의 성능 모드입니다.
타입: 문자열
유효 값: `generalPurpose | maxIO`
** [ProvisionedThroughputInMibps](#API_UpdateFileSystem_ResponseSyntax) **
MiBps로 측정되는 프로비저닝된 파일 시스템 처리량을 정의합니다. `provisioned`로 설정된 `ThroughputMode`을 사용하는 파일 시스템에 유효합니다.
유형: Double
유효한 범위: 최소값은 1.0입니다.
** [SizeInBytes](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템에서 해당 `Value` 필드에 저장된 데이터의 가장 최근 알려진 측정 크기(바이트) 및 해당 `Timestamp` 필드에서 해당 크기가 결정된 시간입니다. `Timestamp` 값은 1970-01-01T00:00:00Z 이후의 정수 시간(초)입니다. 이 `SizeInBytes` 값은 파일 시스템의 일관된 스냅샷 크기를 나타내지는 않지만 파일 시스템에 쓰기가 없는 경우 최종적으로 일관성을 유지합니다. 즉, 몇 시간 이상 파일 시스템을 수정하지 않은 경우에만 `SizeInBytes`가 실제 크기를 나타냅니다. 그렇지 않으면 값이 특정 시점의 파일 시스템 크기와 정확히 일치하지 않습니다.
유형: [FileSystemSize](API_FileSystemSize.md)객체
** [Tags](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템과 연결된 태그로, `Tag` 객체 배열로 표시됩니다.
타입: [Tag](API_Tag.md)객체 배열
** [ThroughputMode](#API_UpdateFileSystem_ResponseSyntax) **
파일 시스템의 처리량 모드를 표시합니다. 자세한 내용을 알아보려면 Amazon Elastic File System 사용 설명서**의 [처리량 모드](https://docs.aws.amazon.com/efs/latest/ug/performance.html#throughput-modes)를 참조하세요.
타입: 문자열
유효 값: `bursting | provisioned | elastic`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InsufficientThroughputCapacity **
추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 503
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ThroughputLimitExceeded **
처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** TooManyRequests **
처리량 모드를 변경하거나 프로비저닝된 처리량 값을 낮추기 전에 최소 24시간을 기다리지 않으면 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 429
## 참고 항목
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystem)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystem)
# UpdateFileSystemProtection
파일 시스템의 보호를 업데이트합니다.
이 작업에는 `elasticfilesystem:UpdateFileSystemProtection` 액션에 대한 권한이 필요합니다.
## Request Syntax
```
PUT /2015-02-01/file-systems/FileSystemId/protection HTTP/1.1
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## URI 요청 파라미터
요청은 다음 URI 파라미터를 사용합니다.
** [FileSystemId](#API_UpdateFileSystemProtection_RequestSyntax) **
업데이트할 파일 시스템의 ID입니다.
길이 제약: 최대 길이는 128입니다.
패턴: `^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$`
필수 여부: 예
## 요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_RequestSyntax) **
파일 시스템의 복제 덮어쓰기 보호 상태입니다.
+ `ENABLED` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용할 수 없습니다. 파일 시스템은 쓰기 가능합니다. 복제 덮어쓰기 보호는 기본적으로 `ENABLED` 상태입니다.
+ `DISABLED` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용할 수 있습니다. 파일 시스템은 읽기 전용이며 EFS 복제를 통해서만 수정할 수 있습니다.
+ `REPLICATING` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용 중입니다. 파일 시스템은 읽기 전용이며 EFS 복제를 통해서만 수정됩니다.
복제 구성을 삭제하면 파일 시스템의 복제 덮어쓰기 보호가 다시 활성화되고 파일 시스템은 쓰기 가능해집니다.
타입: 문자열
유효 값: `ENABLED | DISABLED | REPLICATING`
필수 항목 여부: 아니요
## 응답 구문
```
HTTP/1.1 200
Content-type: application/json
{
"ReplicationOverwriteProtection": "string"
}
```
## 응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
** [ReplicationOverwriteProtection](#API_UpdateFileSystemProtection_ResponseSyntax) **
파일 시스템의 복제 덮어쓰기 보호 상태입니다.
+ `ENABLED` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용할 수 없습니다. 파일 시스템은 쓰기 가능합니다. 복제 덮어쓰기 보호는 기본적으로 `ENABLED` 상태입니다.
+ `DISABLED` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용할 수 있습니다. 파일 시스템은 읽기 전용이며 EFS 복제를 통해서만 수정할 수 있습니다.
+ `REPLICATING` – 파일 시스템은 복제 구성의 대상 파일 시스템으로 사용 중입니다. 파일 시스템은 읽기 전용이며 EFS 복제를 통해서 수정됩니다.
복제 구성을 삭제하면 파일 시스템의 복제 덮어쓰기 보호가 다시 활성화되고 파일 시스템은 쓰기 가능해집니다.
타입: 문자열
유효 값: `ENABLED | DISABLED | REPLICATING`
## 오류
** BadRequest **
요청이 잘못되었거나 잘못된 파라미터 값 또는 필수 파라미터 누락 등의 오류가 있는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** FileSystemNotFound **
지정된 `FileSystemId` 값이 요청자의에 없는 경우 반환됩니다 AWS 계정.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 404
** IncorrectFileSystemLifeCycleState **
파일 시스템의 수명 주기 상태가 “사용 가능”이 아닌 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** InsufficientThroughputCapacity **
추가 처리량을 프로비저닝할 용량이 충분하지 않은 경우 반환됩니다. 프로비저닝된 처리량 모드에서 파일 시스템을 생성하려고 할 때, 기존 파일 시스템의 프로비저닝된 처리량을 늘리려고 할 때 또는 기존 파일 시스템을 버스팅 처리량에서 프로비저닝된 처리량 모드로 변경하려고 할 때 이 값이 반환될 수 있습니다. 나중에 다시 시도해 주세요.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 503
** InternalServerError **
서버 측에서 오류가 발생한 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 500
** ReplicationAlreadyExists **
파일 시스템이 복제 구성에 이미 포함되어 있는 경우 반환됩니다.>
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 409
** ThroughputLimitExceeded **
처리량 한도인 1024MiB/s에 도달하여 처리량 모드 또는 프로비저닝된 처리량을 변경할 수 없는 경우 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 400
** TooManyRequests **
처리량 모드를 변경하거나 프로비저닝된 처리량 값을 낮추기 전에 최소 24시간을 기다리지 않으면 반환됩니다.
** ErrorCode **
오류 코드는 오류 상태를 식별하는 고유한 문자열입니다. 이 코드는 오류를 감지하여 유형별로 처리하는 프로그램에서 판독하고 이해하기 위한 것입니다.
** Message **
오류 메시지는 오류 상태에 관한 일반적인 설명을 담고 있으며 영어로 제공됩니다. 이는 기계가 아닌 사람을 위한 것입니다. 간단한 프로그램은 자체적으로 확인되지 않거나 어떻게 처리해야 할지 모르는 오류 상태가 발생하면 최종 사용자에게 직접 메시지를 표시합니다. 좀 더 포괄적인 오류 처리 기능을 갖고 있고 적절히 국제화된 고급 프로그램은 오류 메시지를 무시할 가능성이 큽니다.
HTTP 상태 코드: 429
## 참고 항목
언어별 AWS SDKs
+ [AWS 명령줄 인터페이스 V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS .NET V4용 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS Go용 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS Java V2용 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS PHP V3용 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS Python용 SDK](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/UpdateFileSystemProtection)