Tous les produits
Search
Centre de documentation

Elastic Compute Service:DescribeReservedInstanceAutoRenewAttribute

Dernière mise à jour :Aug 18, 2026

Consulte les attributs de renouvellement automatique d'une ou plusieurs instances réservées, y compris la durée de renouvellement automatique et l'état du renouvellement automatique.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

  • Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.

  • API : l'API que vous pouvez appeler pour exécuter l'action.

  • Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.

  • Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.

    • Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.

    • Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.

  • Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.

  • Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ecs:DescribeReservedInstanceAutoRenewAttribute

get

*ReservedInstance

acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#ReservedInstanceId}

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

RegionId

string

Oui

L'identifiant de la région de l'instance réservée.

Vous pouvez appeler l'opération DescribeRegions pour obtenir la liste des régions la plus récente.

cn-hangzhou

ReservedInstanceId

array

Non

Les identifiants des instances réservées.

string

Non

L'identifiant de l'instance réservée. Vous pouvez appeler l'opération DescribeReservedInstances pour obtenir les identifiants des instances réservées que vous avez achetées.

Vous pouvez spécifier jusqu'à 100 identifiants d'instances réservées dans une seule requête.

ecsri-ajdfaj****

Éléments de réponse

Élément

Type

Description

Exemple

object

RequestId

string

L'identifiant de la requête.

04F0F334-1335-436C-A1D7-6C044FE7****

ReservedInstanceRenewAttributes

object

ReservedInstanceRenewAttribute

array<object>

Détails sur les paramètres de renouvellement automatique des instances réservées.

object

PeriodUnit

string

The unit of the renewal period.

Valid value: Year.

Month

Duration

integer

The auto-renewal duration.

1

ReservedInstanceId

string

The ID of the reserved instance.

ecsri-ajdfaj****

RenewalStatus

string

The auto-renewal status of the reserved instance. Valid values:

  • AutoRenewal: auto-renewal is enabled.

  • Normal: manual renewal.

AutoRenewal

Exemples

JSON format

{
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE7****",
  "ReservedInstanceRenewAttributes": {
    "ReservedInstanceRenewAttribute": [
      {
        "PeriodUnit": "Month",
        "Duration": 1,
        "ReservedInstanceId": "ecsri-ajdfaj****",
        "RenewalStatus": "AutoRenewal"
      }
    ]
  }
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

403 ChargeTypeViolation Pay-As-You-Go dedicated host do not support this operation.
403 MissingParamter.InstanceId ReservedInstanceId should not be null. The ReservedInstanceId cannot be empty.
403 InvalidParameter.ToManyInstanceIds ReservedInstanceId should be less than 100.
403 InValidParameter Parameter invalid.%s
403 ResourceStatusViolation The operation is not permitted due to resource status of the instance.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.