ModifyCommonBandwidthPackageSpec - Internet Shared Bandwidth - Centro de documentación de Alibaba Cloud

Llama a la operación ModifyCommonBandwidthPackageSpec para modificar el ancho de banda máximo de una instancia de Ancho de Banda Compartido de Internet.

Descripción de la operación

Antes de llamar a esta operación, tenga en cuenta la siguiente información:

ModifyCommonBandwidthPackageSpec es una operación asíncrona. Después de enviar una solicitud, el sistema devuelve un ID de solicitud, pero el ancho de banda máximo de la instancia de Ancho de Banda Compartido de Internet aún no se ha modificado. La tarea de modificación sigue ejecutándose en segundo plano. Puede llamar a DescribeCommonBandwidthPackages para consultar el estado de la instancia de Ancho de Banda Compartido de Internet.
- Si la instancia de Ancho de Banda Compartido de Internet está en estado Modifying, el ancho de banda máximo se está modificando. En este estado, solo puede realizar operaciones de consulta y no puede realizar otras operaciones.
- Si la instancia de Ancho de Banda Compartido de Internet está en estado Available, el ancho de banda máximo se ha modificado.
ModifyCommonBandwidthPackageSpec no admite modificaciones simultáneas del ancho de banda máximo de la misma instancia de Ancho de Banda Compartido de Internet.

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

vpc:ModifyCommonBandwidthPackageSpec

update

*BandwidthPackage

acs:vpc:{#regionId}:{#accountId}:combandwidthpackage/{#BandwidthPackageId}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
RegionId	string	Sí	El ID de región de la instancia de Ancho de Banda Compartido de Internet. Puede llamar a DescribeRegions para consultar el ID de región.	cn-hangzhou
BandwidthPackageId	string	Sí	El ID de la instancia de Ancho de Banda Compartido de Internet.	cbwp-2ze2ic1xd2qeqk145****
Bandwidth	string	Sí	El ancho de banda máximo de la instancia de Ancho de Banda Compartido de Internet. Unidad: Mbit/s. Valores válidos: 1 a 1000.	1000

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
RequestId	string	El ID de la solicitud.	7F129000-F929-4AF5-BE8D-BAE434C795306

Ejemplos

Respuesta exitosa

JSON Formato

{
  "RequestId": "7F129000-F929-4AF5-BE8D-BAE434C795306"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ResourceNotEnough.Bandwidth	The specified resource of Bandwidth is not enough.	The specified resource of Bandwidth is insufficient.
400	InvalidParameter.Bandwidth	The specified bandwidth is not valid.
400	InvalidBandwidthPackageId.NotFound	The specified BandwidthPackageId not exist.
400	InvalidCommonBandwidthPackageId.NotFound	The specified BandwidthPackageId is not found.
400	IncorrectStatus.ResourceStatus	Resource status is abnormal for renew.
400	SYSTEM.SALE_VALIDATE_UNEXPECTED_ERROR	You have arrears and do not meet the purchase conditions.
400	OperationFailed.SyncOrderToSub	SyncOrderToSub error.	The operation failed.
400	OperationFailed.SaleValidate	Validate sale condition with subArticle failed.	Failed to validate the sales condition with a subproject.
400	OperationFailed.QueryCommodityInfo	Operation failed because quey commodity info error.
400	OperationFailed.QueryPrice	Query price failed when create order.	Failed to query the price when creating the order.
400	Forbidden.ChargeTypeIsPrepaid	It's forbidden to change prepaid CBWP's bandwidth by API. It can be changed on Aliyun web console.
400	IncorrectStatus.CbwpModifying	Cbwp Modifying status is invalid.
500	OrderError.BandwidthPackage	The Account failed to create order.
404	InvalidRegionId.NotFound	The specified RegionId does not exist in our records.
404	InvalidBandwidthPackageId.NotFound	The specified BandwidthPackageId does not exist in our records.
404	InvalidBandwidth.ValueNotSupported	The specified value of Bandwidth not supported.
404	BandwidthPackage.FinancialLocked	The specified BandwidthPackage has been Financial Lock.

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.