AWS Systems Manager Change Manager는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 AWS Systems Manager Change Manager 가용성 변경을 참조하세요.
Session 문서 스키마
다음 정보는 Session 문서의 스키마 요소에 대해 설명합니다. AWS Systems Manager Session Manager는 Session 문서를 사용하여 표준 세션, 포트 전달 세션 또는 대화형 명령을 실행하는 세션 등 시작할 세션 유형을 결정합니다.
- schemaVersion
-
Session 문서의 스키마 버전입니다. Session 문서는 버전 1.0만 지원합니다.
유형: 문자열
필수 항목 여부: 예
- description
-
Session 문서에 대해 지정하는 설명입니다. 예를 들면 “Session Manager로 포트 전달 세션을 시작하기 위한 문서“입니다.
유형: 문자열
필수 여부: 아니요
- sessionType
-
Session 문서가 설정하는 데 사용되는 세션 유형입니다.
유형: 문자열
필수 항목 여부: 예
유효한 값:
InteractiveCommands|NonInteractiveCommands|Port|Standard_Stream - inputs
-
이 Session 문서를 사용하여 설정된 세션에 사용할 세션 기본 설정입니다. 이 요소는
Standard_Stream세션을 생성하는 데 사용되는 Session 문서에 필요합니다.유형: StringMap
필수 여부: 아니요
- s3BucketName
-
세션 종료 시 세션 로그를 보내려는 Amazon Simple Storage Service(Amazon S3) 버킷입니다.
유형: 문자열
필수 여부: 아니요
- s3KeyPrefix
-
s3BucketName입력에 지정한 Amazon S3 버킷으로 로그를 보낼 때 사용할 접두사입니다. Amazon S3에 저장된 객체에 공유 접두사 사용에 대한 자세한 내용은 Amazon Simple Storage Service 사용 설명서의 S3 버킷에서 폴더를 어떻게 사용하나요?를 참조하세요.유형: 문자열
필수 여부: 아니요
- s3EncryptionEnabled
-
true로 설정하면s3BucketName입력에 지정한 Amazon S3 버킷을 암호화해야 합니다.유형: 부울
필수 여부: 예
- cloudWatchLogGroupName
-
세션 종료 시 세션 로그를 보내려는 Amazon CloudWatch Logs(CloudWatch Logs) 그룹의 이름입니다.
유형: 문자열
필수 여부: 아니요
- cloudWatchEncryptionEnabled
-
true로 설정하면cloudWatchLogGroupName입력에 지정한 로그 그룹을 암호화해야 합니다.유형: 부울
필수 여부: 예
- cloudWatchStreamingEnabled
-
true로 설정하면 세션 데이터 로그의 연속 스트림이cloudWatchLogGroupName입력에 지정한 로그 그룹으로 전송됩니다.false로 설정하면 세션 로그가 세션 종료 시cloudWatchLogGroupName입력에 지정한 로그 그룹으로 전송됩니다.유형: 부울
필수 여부: 예
- kmsKeyId
-
로컬 클라이언트 시스템과 연결하는 Amazon Elastic Compute Cloud(Amazon EC2) 관리형 노드 간의 데이터를 추가로 암호화하는 데 사용할 AWS KMS key의 ID입니다.
유형: 문자열
필수 여부: 아니요
- runAsEnabled
-
true로 설정하면runAsDefaultUser입력에 연결할 관리형 노드에 존재하는 사용자 계정을 지정해야 합니다. 그렇지 않으면 세션이 시작되지 않습니다. 기본적으로 세션은 AWS Systems Manager SSM Agent에서 생성된ssm-user계정을 사용하여 시작됩니다. 다음으로 실행 기능은 Linux 및 macOS 관리형 노드에 연결하는 경우에만 지원됩니다.유형: 부울
필수 여부: 예
- runAsDefaultUser
-
runAsEnabled입력이true로 설정된 경우 Linux 및 macOS 관리형 노드에서 세션을 시작할 사용자 계정의 이름입니다. 이 입력에 대해 지정한 사용자 계정은 연결할 관리형 노드에 있어야 합니다. 그렇지 않으면 세션이 시작되지 않습니다.유형: 문자열
필수 여부: 아니요
- idleSessionTimeout
-
세션이 종료되기 전에 허용할 비활성 시간입니다. 이 입력은 분 단위로 측정됩니다.
유형: 문자열
유효한 값은 1~60입니다.
필수 여부: 아니요
- maxSessionDuration
-
세션이 종료되기 전에 허용할 최대 시간입니다. 이 입력은 분 단위로 측정됩니다.
유형: 문자열
유효한 값은 1~1,440입니다.
필수 여부: 아니요
- shellProfile
-
셸 기본 설정, 환경 변수, 작업 디렉터리 및 세션 시작 시 여러 명령 실행과 같이 세션 내에서 적용할 운영 체제별로 지정하는 기본 설정입니다.
유형: StringMap
필수 여부: 아니요
- parameters
-
문서가 허용하는 파라미터를 정의하는 객체입니다. 문서 파라미터 정의에 대한 자세한 내용은 최상위 데이터 요소의 파라미터를 참조하세요. 자주 참조하는 파라미터의 경우에는 먼저 Systems Manager Parameter Store에 저장한 후 참조하는 것이 좋습니다. 이 문서 섹션에서는
String및StringListParameter Store 파라미터를 참조할 수 있습니다. 이 문서 섹션에서는SecureStringParameter Store 파라미터를 참조할 수 없습니다. 다음 형식을 사용하여 Parameter Store 파라미터를 참조할 수 있습니다.{{ssm:parameter-name}}Parameter Store에 대한 자세한 내용은 AWS Systems Manager Parameter Store 섹션을 참조하세요.
유형: StringMap
필수 여부: 아니요
- properties
-
StartSessionAPI 작업에 사용되는 값을 지정하는 객체입니다.InteractiveCommands세션에 사용되는 Session 문서의 경우 속성 객체에는 지정한 운영 체제에서 실행할 명령이 포함됩니다.runAsElevated부울 속성을 사용하여 명령이root로 실행되는지도 판단할 수 있습니다. 자세한 내용은 세션의 명령에 대한 액세스 제한을 참조하세요.Port세션에 사용되는 Session 문서의 경우 속성 객체에는 트래픽이 리디렉션되어야 하는 포트 번호가 포함됩니다. 예를 들어 이 주제 뒷부분의Port유형 Session 문서 예를 참조하세요.유형: StringMap
필수 여부: 아니요
Standard_Stream 유형 Session 문서 예
InteractiveCommands 유형 Session 문서 예
Port 유형 Session 문서 예
특수 문자가 있는 Session 문서 예