ModifyMountTargetSecurityGroups - Amazon Elastic File System

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

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}$

필수 사항 여부: Yes

요청 본문

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

SecurityGroups

VPC 보안 그룹 ID 최대 5개의 배열.

유형: 문자열 어레이

배열 멤버: 최대 항목 수는 100개입니다.

길이 제약: 최소 길이는 11입니다. 최대 길이는 43입니다.

패턴: ^sg-[0-9a-f]{8,40}

필수 여부: 아니요

응답 구문

HTTP/1.1 204

Response Elements

액션이 성공하면 해당 서비스는 빈 HTTP 본문과 함께 HTTP 204 응답을 되돌려줍니다.

Errors

BadRequest

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

HTTP 상태 코드: 400

IncorrectMountTargetState

탑재 대상이 작업에 적합한 올바른 상태가 아닌 경우 반환됩니다.

HTTP 상태 코드: 409

InternalServerError

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

HTTP 상태 코드: 500

MountTargetNotFound

호출자의 AWS 계정에 지정된 ID의 탑재 대상이 없는 경우 반환됩니다.

HTTP 상태 코드: 404

SecurityGroupLimitExceeded

요청에 지정된 SecurityGroups의 크기가 5보다 큰 경우 반환됩니다.

HTTP 상태 코드: 400

SecurityGroupNotFound

지정된 보안 그룹 중 하나가 서브넷의 Virtual Private Cloud(VPC)에 존재하지 않는 경우 반환됩니다.

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 SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.