기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
StopServer
File Transfer 프로토콜이 활성화된 서버의 상태를 OFFLINE에서 ONLINE로 변경합니다. OFFLINE 서버는 File Transfer 작업을 수락하고 처리할 수 없습니다. 서버 및 사용자 속성과 같이 서버에 연결된 정보는 서버를 중지해도 영향을 받지 않습니다.
참고
서버를 중지해도 File Transfer 프로토콜 엔드포인트 청구가 줄어들거나 영향을 미치지는 않습니다. 요금 청구를 중지하려면 서버를 삭제해야 합니다.
STOPPING 상태는 서버가 완전히 응답할 수 없거나 완전히 오프라인 상태가 아닌 중간 상태임을 나타냅니다. STOP_FAILED의 값은 오류 상태를 나타낼 수 있습니다.
이 직접 호출에서 응답이 반환되지 않습니다.
구문 요청
{
"ServerId": "string"
}요청 파라미터
모든 작업에서 사용하는 파라미터에 대한 자세한 내용은 범용 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- ServerId
-
중지한 서버에 대해 시스템에서 할당한 고유 식별자.
유형: 문자열
길이 제약 조건: 고정 길이는 19입니다.
패턴:
s-([0-9a-f]{17})필수 여부: 예
Response Elements
작업이 성공하면 서비스가 비어 있는 HTTP 본문과 함께 HTTP 200 응답을 반송합니다.
Errors
모든 작업에서 발생하는 흔한 오류에 대한 자세한 내용은 일반적인 오류 단원을 참조하십시오.
- InternalServiceError
-
AWS Transfer Family 서비스에 오류가 발생하면 이 예외가 발생합니다.
HTTP 상태 코드: 500
- InvalidRequestException
-
클라이언트가 잘못된 형식의 요청을 제출하면 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ResourceNotFoundException
-
AWSTransfer Family 서비스에서 리소스를 찾을 수 없는 경우 이 예외가 발생합니다.
HTTP 상태 코드: 400
- ServiceUnavailableException
-
AWSTransfer Family 서비스를 이용할 수 없어 요청이 실패했습니다.
HTTP 상태 코드: 500
- ThrottlingException
-
요청 제한 때문에 요청이 거부되었습니다.
HTTP 상태 코드: 400
예
예제
다음 예제에서는 서버를 중지합니다.
샘플 요청
{
"ServerId": "s-01234567890abcdef"
}예
다음은 이 API 직접 호출에 대한 샘플 응답입니다.
샘플 응답
{
"ServerId": "s-01234567890abcdef"
}참고
이 API를 언어별 AWS SDK 중 하나로 사용하는 방법에 대한 자세한 설명은 다음을 참조하세요.
