기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
ModifyMountTargetSecurityGroups
탑재 대상에 대해 유효한 보안 그룹 세트를 수정합니다.
탑재 대상을 생성하면 Amazon EFS는 새 네트워크 인터페이스도 생성합니다. 자세한 내용은 CreateMountTarget 단원을 참조하십시오. 이 작업은 탑재 대상과 연결된 네트워크 인터페이스에 적용되는 보안 그룹을 요청에 제공된 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
-
수정하려는 보안 그룹이 있는 탑재 대상의 ID.
길이 제약: 최소 길이는 13자. 최대 길이는 45입니다.
패턴:
^fsmt-[0-9a-f]{8,40}$필수 여부: 예
요청 본문
요청은 JSON 형식으로 다음 데이터를 받습니다.
- SecurityGroups
-
VPC 보안 그룹 IDs.
유형: 문자열 어레이
배열 멤버: 최대 항목 수는 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 할당량을 참조하세요(보안 그룹 테이블 참조).- 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