TransformDBClusterPayType - PolarDB - Centro de documentación de Alibaba Cloud

Cambia el método de facturación de un clúster de PolarDB.

Descripción de la operación

Nota

Los clústeres de PolarDB admiten los métodos de facturación de suscripción y de pago por uso. Puede cambiar de suscripción a pago por uso o de pago por uso a suscripción según los requisitos de su negocio. Para obtener más información, consulte Cambiar de suscripción a pago por uso y Cambiar de pago por uso a suscripción.
Si el saldo de su cuenta de Alibaba Cloud es insuficiente, no se puede cambiar el método de facturación de pago por uso a suscripción.
Cuando cambia de suscripción a pago por uso, el sistema reembolsa automáticamente el saldo restante de las tarifas que ha pagado.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

La siguiente tabla describe la autorización necesaria para invocar esta API. Puede definirla en una directiva de Resource Access Management (RAM). A continuación, se detallan las columnas de la tabla:

Action: Estas acciones se utilizan en el elemento Action de las declaraciones de directivas de permisos de RAM para otorgar permisos que permitan realizar la operación.
API: La API que debe invocarse para llevar a cabo la acción.
Nivel de acceso: Nivel de acceso predefinido que se concede para cada API. Valores válidos: create, list, get, update y delete.
Tipo de recurso: Tipo de recurso que admite autorización para ejecutar la acción. Indica si la acción es compatible con permisos a nivel de recurso. El recurso especificado debe ser compatible con la acción; de lo contrario, la directiva no surtirá efecto.
- En las API con permisos a nivel de recurso, los tipos de recursos obligatorios se marcan con un asterisco (*). Especifique el Alibaba Cloud Resource Name (ARN) correspondiente en el elemento Resource de la directiva.
- Para las API sin permisos a nivel de recurso, se muestra All Resources. Utilice un asterisco (*) en el elemento Resource de la directiva.
Clave de condición: Claves de condición definidas por el servicio. Permiten un control granular y se aplican ya sea solo a acciones o a acciones asociadas con recursos específicos. Además de las claves de condición específicas del servicio, Alibaba Cloud proporciona un conjunto de common condition keys aplicables a todos los servicios compatibles con RAM.
Acción dependiente: Acciones dependientes necesarias para ejecutar la acción principal. Para completar la operación, el usuario de RAM o el rol de RAM debe contar con permisos para realizar todas las acciones dependientes.

Action

Nivel de acceso

Tipo de recurso

Clave de condición

Acción dependiente

polardb:TransformDBClusterPayType

update

*DBCluster.

acs:polardb:{#regionId}:{#accountId}:dbcluster/{#dbclusterId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
DBClusterId	string	Sí	El ID del clúster de PolarDB.	pc-bp10gr51qasnl****
PayType	string	Sí	El método de facturación de la instancia. Valores válidos: Postpaid: pago por uso Prepaid: suscripción	Prepaid
RegionId	string	Sí	El ID de la región.	cn-hangzhou
UsedTime	string	No	La duración de la suscripción. Valores válidos: Si Period se establece en Year, establezca UsedTime en un valor de 1 a 3. Si Period se establece en Month, establezca UsedTime en un valor de 1 a 9. Nota Este parámetro es obligatorio cuando PayType se establece en Prepaid.	1
Period	string	No	La unidad de duración de la suscripción para la instancia. Valores válidos: Year: suscripción anual Month: suscripción mensual Nota Este parámetro es obligatorio cuando PayType se establece en Prepaid.	Month
ResourceGroupId	string	No	El ID del grupo de recursos.	rg-acfm3f4un32****
ClientToken	string	No	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. El valor de este parámetro lo genera el cliente y debe ser único entre las distintas solicitudes. El token distingue entre mayúsculas y minúsculas y no puede superar los 64 caracteres ASCII de longitud.	6000170000591aed949d0f5********************
AutoUseCoupon	boolean	No	Especifica si se deben usar cupones automáticamente. Valores válidos: true (valor predeterminado): usar cupones. false: no usar cupones.
PromotionCode	string	No	El código de cupón. Si no especifica este parámetro, se utiliza el cupón predeterminado.	727xxxxxx934

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Esquema de la respuesta.
RequestId	string	El ID de la solicitud.	5E71541A-6007-4DCC-A38A-F872C31FEB45
ChargeType	string	El método de facturación de la instancia. Valores válidos: Postpaid: pago por uso Prepaid: suscripción	Prepaid
DBClusterId	string	El ID del clúster de PolarDB.	pc-bp10gr51qasnl****
ExpiredTime	string	La hora de vencimiento de la instancia. Nota Este parámetro de respuesta se devuelve solo cuando PayType se establece en Prepaid. La hora sigue el estándar ISO 8601 en el formato AAAA-MM-DDTHH:mm:ssZ. La hora se muestra en UTC.	2020-04-20T10:00:00Z
OrderId	string	El ID del pedido.	20515760028****

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "5E71541A-6007-4DCC-A38A-F872C31FEB45",
  "ChargeType": "Prepaid",
  "DBClusterId": "pc-bp10gr51qasnl****",
  "ExpiredTime": "2020-04-20T10:00:00Z",
  "OrderId": "20515760028****"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	InvalidOrderCharge.NotSupport	The specified order charge does not support in PolarDB.
400	InvalidOrderTask.NotSupport	The Current ClusterId exist Order Task in PolarDB.
400	InvalidPaymentMethod.Incomplete	No payment method is specified for your account. We recommend that you add a payment method.	La cuenta actual no tiene un método de pago válido (cupón). Agregue un método de pago.
400	InvalidPayType.Malformed	The specified parameter PayType is not valid.	El parámetro PayType especificado no es válido.
400	InvalidPeriod.Malformed	The specified parameter Period is not valid.	El parámetro Period especificado no es válido.
400	InvalidUsedTime.Malformed	The specified parameter UsedTime is not valid.	El parámetro UsedTime especificado no es válido.
400	InvalidPeriodUnit.Malformed	The specified parameter PeriodUnit is not valid.	El parámetro PeriodUnit especificado no es válido.
403	OperationDenied.LockMode	The operation is not permitted when the instance is locked.	La operación falló porque la instancia está en el estado Locked y no admite esta operación.
403	OperationDenied.DBClusterDeletionLock	The operation is not permitted due to the deletion lock of cluster.	La operación falló porque el clúster tiene un bloqueo de clúster que no admite la operación actual.
404	InvalidDBCluster.NotFound	The specified DBClusterId is not found.	La operación falló. El ID de instancia del cluster especificado no existe.
404	InvalidDBClusterId.Malformed	The specified parameter DBClusterId is not valid.	El DBClusterId especificado no existe en nuestros registros.

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.