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
<a name="API_DescribeReservedNodes"></a>

Retorna informações sobre nós reservados para esta conta ou sobre um determinado nó reservado.

## Sintaxe da solicitação
<a name="API_DescribeReservedNodes_RequestSyntax"></a>

```
{
   "Duration": "string",
   "MaxResults": number,
   "NextToken": "string",
   "NodeType": "string",
   "OfferingType": "string",
   "ReservationId": "string",
   "ReservedNodesOfferingId": "string"
}
```

## Parâmetros da solicitação
<a name="API_DescribeReservedNodes_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [Duration](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-Duration"></a>
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: string  
Obrigatório: Não

 ** [MaxResults](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-MaxResults"></a>
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](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-NextToken"></a>
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á apenas os registros além do marcador, até o valor especificado por MaxRecords.  
Tipo: string  
Obrigatório: não

 ** [NodeType](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-NodeType"></a>
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](https://docs.aws.amazon.com/memorydb/latest/devguide/nodes.reserved.html#reserved-nodes-supported).  
Tipo: string  
Obrigatório: não

 ** [OfferingType](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-OfferingType"></a>
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” \$1"Pagamento adiantado parcial"\$1 “Sem adiantamento”  
Tipo: string  
Obrigatório: não

 ** [ReservationId](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-ReservationId"></a>
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: string  
Obrigatório: não

 ** [ReservedNodesOfferingId](#API_DescribeReservedNodes_RequestSyntax) **   <a name="MemoryDB-DescribeReservedNodes-request-ReservedNodesOfferingId"></a>
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: string  
Obrigatório: não

## Sintaxe da resposta
<a name="API_DescribeReservedNodes_ResponseSyntax"></a>

```
{
   "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
<a name="API_DescribeReservedNodes_ResponseElements"></a>

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](#API_DescribeReservedNodes_ResponseSyntax) **   <a name="MemoryDB-DescribeReservedNodes-response-NextToken"></a>
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á apenas os registros além do marcador, até o valor especificado por MaxRecords.  
Tipo: string

 ** [ReservedNodes](#API_DescribeReservedNodes_ResponseSyntax) **   <a name="MemoryDB-DescribeReservedNodes-response-ReservedNodes"></a>
Retorna informações sobre nós reservados para esta conta ou sobre um determinado nó reservado.  
Tipo: matriz de objetos [ReservedNode](API_ReservedNode.md)

## Erros
<a name="API_DescribeReservedNodes_Errors"></a>

Para obter informações sobre os erros comuns que são comuns em todas ações, consulte [Tipos de erro comuns](CommonErrors.md).

 ** 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
<a name="API_DescribeReservedNodes_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/memorydb-2021-01-01/DescribeReservedNodes) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/memorydb-2021-01-01/DescribeReservedNodes)