As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
DescribeReservedNodes
Retorna informações sobre nós reservados para esta conta ou sobre um determinado nó reservado.
Sintaxe da Solicitação
{
"Duration": "string",
"MaxResults": number,
"NextToken": "string",
"NodeType": "string",
"OfferingType": "string",
"ReservationId": "string",
"ReservedNodesOfferingId": "string"
}Parâmetros da solicitação
Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- Duration
-
O valor do filtro de duração, especificado em anos ou segundos. Use esse parâmetro para mostrar somente reservas para esse período.
Tipo: sequência
Obrigatório: Não
- MaxResults
-
O número máximo de registros a serem incluídos na resposta. Se existirem mais registros do que o MaxRecords valor especificado, um marcador será incluído na resposta para que os resultados restantes possam ser recuperados.
Tipo: inteiro
Obrigatório: não
- NextToken
-
Um marcador opcional retornado de uma solicitação anterior. Use esse marcador para paginação dos resultados dessa operação. Se esse parâmetro for especificado, a resposta incluirá somente registros além do marcador, até o valor especificado por MaxRecords.
Tipo: sequência
Obrigatório: não
- NodeType
-
O valor do filtro de tipo de nó. Use este parâmetro para mostrar somente as reservas que correspondem ao tipo de nó especificado. Para obter mais informações, consulte Tipos de nó suportados.
Tipo: sequência
Obrigatório: não
- OfferingType
-
O valor do filtro de tipo de oferta. Use este parâmetro para mostrar somente as ofertas disponíveis correspondentes ao tipo de oferta especificado. Valores válidos: “Tudo antecipado” |"Pagamento adiantado parcial"| “Sem adiantamento”
Tipo: sequência
Obrigatório: não
- ReservationId
-
O valor do filtro do identificador do nó reservado. Use esse parâmetro para mostrar somente a reserva que corresponde ao ID de reserva especificado.
Tipo: sequência
Obrigatório: não
- ReservedNodesOfferingId
-
O valor do filtro de identificador de oferta. Use esse parâmetro para mostrar somente as reservas compradas que correspondam ao identificador de oferta especificado.
Tipo: sequência
Obrigatório: não
Sintaxe da Resposta
{
"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"
}
]
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- NextToken
-
Um marcador opcional retornado de uma solicitação anterior. Use esse marcador para paginação dos resultados dessa operação. Se esse parâmetro for especificado, a resposta incluirá somente registros além do marcador, até o valor especificado por MaxRecords.
Tipo: sequência
- ReservedNodes
-
Retorna informações sobre nós reservados para esta conta ou sobre um determinado nó reservado.
Tipo: matriz de objetos ReservedNode
Erros
Para obter informações sobre os erros comuns que são comuns em todas ações, consulte Erros comuns.
- InvalidParameterCombinationException
-
Código de Status HTTP: 400
- InvalidParameterValueException
-
Código de Status HTTP: 400
- ReservedNodeNotFoundFault
-
O nó solicitado não existe.
Código de Status HTTP: 400
- ServiceLinkedRoleNotFoundFault
-
Código de Status HTTP: 400
Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte:
