CreateQuotaApplication - Quota Center - Centro de documentación de Alibaba Cloud

Crea una solicitud de aumento de cuota.

Descripción de la operación

Nota

Después de crear una solicitud de aumento de cuota, puede llamar a la operación ListQuotaApplications para ver el resultado de la aprobación. Si el valor de Status es Agree, la solicitud se aprueba.

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

quotas:CreateQuotaApplication

create

*QuotaApplication

acs:quotas:{#regionId}:{#accountId}:quota/{#ProductCode}/{#QuotaActionCode}

Ninguna

Parámetros de la solicitud

Parámetro	Tipo	Obligatorio	Descripción	Ejemplo
ProductCode	string	Sí	La abreviatura del nombre del servicio en la nube. Nota Para obtener información sobre cómo conseguir la abreviatura del nombre de un servicio en la nube, consulte `ProductCode` en ListProductQuotas.	ecs
QuotaActionCode	string	Sí	El ID de la cuota. Nota Para obtener información sobre cómo conseguir el ID de cuota de un servicio en la nube, consulte `QuotaActionCode` en ListProductQuotas.	q_security-groups
DesireValue	number	Sí	El valor de cuota solicitado. Nota Establezca el valor de cuota solicitado basándose en `TotalUsage` (uso de la cuota) y `ApplicableRange` (rango aplicable de la cuota) de la cuota objetivo en ListProductQuotas. Las solicitudes de aumento de cuota son revisadas por el soporte técnico de cada servicio en la nube. Para aumentar las posibilidades de aprobación, proporcione un valor solicitado razonable y un motivo detallado al enviar la solicitud.	804
Reason	string	Sí	El motivo de la solicitud de aumento de cuota. Nota Las solicitudes de aumento de cuota son revisadas por el soporte técnico de cada servicio en la nube. Para aumentar las posibilidades de aprobación, proporcione un valor solicitado razonable y un motivo detallado al enviar la solicitud.	Scale Out
NoticeType	integer	No	Especifica si se debe enviar una notificación sobre el resultado de la solicitud. Valores válidos: 0 (predeterminado): no envía notificación. 3: envía una notificación. Valores válidos: 0 : Sin notificación. 3 : Notificación.	0
Dimensions	array<object>	No	Las dimensiones de la cuota. Las dimensiones son atributos de la cuota. La combinación de dimensiones (Dimensions) y el ID de cuota (QuotaActionCode) identifica de forma única una cuota. Nota Algunos servicios en la nube requieren dimensiones. Puede llamar a ListProductQuotaDimensions para consultar las dimensiones de cuota que admite un servicio en la nube. El parámetro de respuesta `Requisite` indica si una dimensión es obligatoria.
	object	No	Las dimensiones de la cuota.
Key	string	No	La clave de la dimensión de la cuota. Nota `Dimensions.N.Key` y `Dimensions.N.Value` deben especificarse juntos. Los valores válidos de N dependen del número de dimensiones que admite el servicio en la nube. Puede llamar a ListProductQuotaDimensions para consultar las dimensiones de cuota que admite un servicio en la nube. La longitud del array devuelto es el valor de N.	regionId
Value	string	No	El valor de la dimensión de la cuota. Nota `Dimensions.N.Key` y `Dimensions.N.Value` deben especificarse juntos. Los valores válidos de N dependen del número de dimensiones que admite el servicio en la nube. Puede llamar a ListProductQuotaDimensions para consultar las dimensiones de cuota que admite un servicio en la nube. La longitud del array devuelto es el valor de N.	cn-hangzhou
QuotaCategory	string	No	El tipo de cuota. Valor predeterminado: CommonQuota. Valores válidos: FlowControl : Límite de velocidad de API. WhiteListLabel : Privilegio. CommonQuota : Cuota general.	CommonQuota
AuditMode	string	No	Importante Este parámetro está obsoleto y no se recomienda su uso. El modo de revisión de la cuota. Valores válidos: Async : Revisión asíncrona. Sync : Revisión síncrona.	Sync
EnvLanguage	string	No	El idioma de la notificación de alerta de cuota. Valores válidos: en : Inglés. zh : Chino.	zh
ExpireTime	string	No	La hora UTC en la que caduca la cuota. Este parámetro solo es aplicable a los privilegios (WhiteListLabel). Nota Si no especifica una hora de caducidad, el valor predeterminado es la hora de envío.	2021-01-20T09:25:56Z
EffectiveTime	string	No	La hora UTC en la que entra en vigor la cuota. Este parámetro solo es aplicable a los privilegios (WhiteListLabel). Nota Si no especifica un periodo de vigencia, el valor predeterminado es de 99 años a partir de la hora de inicio de la cuota actual.	2021-01-19T09:25:56Z

Elementos de la respuesta

Elemento	Tipo	Descripción	Ejemplo
	object	Los parámetros de respuesta.
ApplicationId	string	El ID de la solicitud de aumento de cuota.	d314d6ae-867d-484c-9009-3d421a80****
ApplyTime	string	La hora en la que se envió la solicitud de aumento de cuota. La hora está en formato ISO 8601 y en UTC. El valor termina con Z.	2021-01-19T09:25:56Z
ApproveValue	number	El valor de cuota aprobado.	804
AuditReason	string	Los comentarios de revisión sobre la solicitud de aumento de cuota.	Agree
DesireValue	integer	El valor de cuota solicitado.	804
Dimension	object	Las dimensiones de la cuota.	{"regionId":"cn-hangzhou"}
EffectiveTime	string	El periodo de vigencia de la cuota. La hora está en formato ISO 8601 y en UTC. El valor termina con Z.	2021-01-19T09:25:56Z
ExpireTime	string	La hora en la que caduca la cuota. La hora está en formato ISO 8601 y en UTC. El valor termina con Z.	2021-01-20T09:25:56Z
NoticeType	integer	Indica si se envía una notificación sobre el resultado de la solicitud. Valores válidos: 0: no se envía ninguna notificación. 3: se envía una notificación. Valores válidos: 0 : Sin notificación. 3 : Notificación.	3
ProductCode	string	La abreviatura del nombre del servicio en la nube.	ecs
QuotaActionCode	string	El ID de la cuota.	q_security-groups
QuotaArn	string	El Nombre de Recurso de Alibaba Cloud (ARN) de la cuota.	acs:quotas::141339776561****:quota/ecs/q_security-groups
QuotaDescription	string	La descripción de la cuota.	The maximum number of security groups that can be owned by the current account
QuotaName	string	El nombre de la cuota.	Maximum Number of Security Groups
QuotaUnit	string	La unidad de la cuota.	AMOUNT
Reason	string	El motivo de la solicitud de aumento de cuota.	Scale Out
RequestId	string	El ID de la solicitud.	D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053
Status	string	El estado de aprobación de la solicitud de aumento de cuota. Valores válidos: Cancel : Cerrada. Agree : Aprobada. Process : En revisión. Disagree : Rechazada.	Process

Ejemplos

Respuesta exitosa

JSON Formato

{
  "ApplicationId": "d314d6ae-867d-484c-9009-3d421a80****",
  "ApplyTime": "2021-01-19T09:25:56Z",
  "ApproveValue": 804,
  "AuditReason": "Agree",
  "DesireValue": 804,
  "Dimension": {
    "regionId": "cn-hangzhou"
  },
  "EffectiveTime": "2021-01-19T09:25:56Z",
  "ExpireTime": "2021-01-20T09:25:56Z",
  "NoticeType": 3,
  "ProductCode": "ecs",
  "QuotaActionCode": "q_security-groups",
  "QuotaArn": "acs:quotas::141339776561****:quota/ecs/q_security-groups",
  "QuotaDescription": "The maximum number of security groups that can be owned by the current account.",
  "QuotaName": "Maximum Number of Security Groups",
  "QuotaUnit": "AMOUNT",
  "Reason": "Scale Out",
  "RequestId": "D47B3A10-CDAC-5412-B2EE-EC9A3DBE9053",
  "Status": "Process"
}

Códigos de error

Código de estado HTTP	Código de error	Mensaje de error	Descripción
400	ACQUIRE.LOCK.FAIL	The request is too frequent. Please try again later.	Too many attempts. Try again later.
400	InvalidNoticeType	Invalid NoticeType	The specified NoticeType parameter is invalid.
400	InvalidDesireValue	Invalid DesireValue	The specified DesireValue parameter is invalid.
400	QUOTA.NOT.ADJUSTABLE	Quota is not adjustable	The quota is not adjustable.
400	QUOTA.NOT.FOUND	The quota does not exist.	The quota does not exist.
400	QUOTA.APPLICATION.PROCESS	The quota adjustment application is being processed. Please try again later.	The quota application is being processed. You cannot submit an application at the time being.
400	QUOTA.DESIREVALUE.ILLEGAL	The applied quota value is invalid.
400	QUOTA.APPLICATION.TIME.ERROE	ExpireTime cannot be earlier than the current time or EffectiveTime.	ExpireTime cannot be earlier than the current time or EffectiveTime.

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.