기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
DescribeReservedNodes
이 계정의 예약 노드 또는 지정된 예약 노드에 대한 정보를 반환합니다.
구문 요청
{
"Duration": "string",
"MaxResults": number,
"NextToken": "string",
"NodeType": "string",
"OfferingType": "string",
"ReservationId": "string",
"ReservedNodesOfferingId": "string"
}요청 파라미터
모든 작업에 공통되는 파라미터에 대한 자세한 설명은 공통 파라미터를 참조하세요.
요청은 JSON 형식으로 다음 데이터를 받습니다.
- Duration
-
연 또는 초 단위로 지정되는 기간 필터 값입니다. 이 기간 동안의 예약만 표시하려면 이 파라미터를 사용하십시오.
유형: 문자열
필수 항목 여부: 아니요
- MaxResults
-
응답에 포함되는 최대 레코드 수입니다. 지정된 MaxRecords 값보다 레코드 수가 많으면 나머지 결과를 검색할 수 있도록 응답에 마커가 포함됩니다.
유형: 정수
필수 항목 여부: 아니요
- NextToken
-
이전 요청에서 반환된 선택적 마커입니다. 이 작업의 결과 페이지를 매기는 데 이 마커를 사용합니다. 이 파라미터를 지정한 경우, 마커 이후부터 MaxRecords에 지정된 값까지의 레코드만 응답에 포함됩니다.
유형: 문자열
필수 항목 여부: 아니요
- NodeType
-
노드 유형 필터 값입니다. 이 파라미터를 사용하면 지정된 노드 유형과 일치하는 예약만 표시할 수 있습니다. 자세한 내용은 지원되는 노드 유형 섹션을 참조하세요.
유형: 문자열
필수 항목 여부: 아니요
- OfferingType
-
제공 유형 필터 값입니다. 지정된 제공 유형과 일치하는 사용 가능한 제공만 표시하려면 이 파라미터를 사용하십시오. 유효한 값: “전체 선결제”|"부분 선결제”| “선수금 없음”
유형: 문자열
필수 항목 여부: 아니요
- ReservationId
-
예약 노드 식별자 필터 값입니다. 이 파라미터를 사용하면 지정된 예약 ID와 일치하는 예약만 표시할 수 있습니다.
유형: 문자열
필수 항목 여부: 아니요
- ReservedNodesOfferingId
-
상품 식별자 필터 값입니다. 이 파라미터를 사용하면 지정된 상품 식별자와 일치하는 구매한 예약만 표시할 수 있습니다.
유형: 문자열
필수사항: 아니요
응답 구문
{
"NextToken": "string",
"ReservedNodes": [
{
"ARN": "string",
"Duration": number,
"FixedPrice": number,
"NodeCount": number,
"NodeType": "string",
"OfferingType": "string",
"RecurringCharges": [
{
"RecurringChargeAmount": number,
"RecurringChargeFrequency": "string"
}
],
"ReservationId": "string",
"ReservedNodesOfferingId": "string",
"StartTime": number,
"State": "string"
}
]
}응답 요소
작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.
다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.
- NextToken
-
이전 요청에서 반환된 선택적 마커입니다. 이 작업의 결과 페이지를 매기는 데 이 마커를 사용합니다. 이 파라미터를 지정한 경우, 마커 이후부터 MaxRecords에 지정된 값까지의 레코드만 응답에 포함됩니다.
유형: 문자열
- ReservedNodes
-
이 계정의 예약 노드 또는 지정된 예약 노드에 대한 정보를 반환합니다.
타입: ReservedNode 객체 배열
오류
모든 작업에서 공통적으로 발생하는 오류에 대한 자세한 내용은 일반적인 오류 섹션을 참조하세요.
- InvalidParameterCombinationException
-
HTTP 상태 코드: 400
- InvalidParameterValueException
-
HTTP 상태 코드: 400
- ReservedNodeNotFoundFault
-
요청된 노드가 존재하지 않습니다.
HTTP 상태 코드: 400
- ServiceLinkedRoleNotFoundFault
-
HTTP 상태 코드: 400
참고
언어별 AWS SDKs
