Esta documentación es para la versión 1 de AWS CLI. Para obtener documentación relacionada con la versión 2 de AWS CLI, consulte la Guía del usuario de la versión 2.
Ejemplos de Service Quotas que utilizan la AWS CLI
En los siguientes ejemplos de código, se muestra cómo realizar acciones e implementar escenarios comunes usando AWS Command Line Interface con Service Quotas.
Las acciones son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.
En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.
Temas
Acciones
En el siguiente ejemplo de código, se muestra cómo utilizar get-aws-default-service-quota
.
- AWS CLI
-
Para describir una cuota de servicio predeterminada
En el siguiente ejemplo de
get-aws-default-service-quota
, se muestran los detalles de la cuota especificada.aws service-quotas get-aws-default-service-quota \ --service-code
ec2
\ --quota-codeL-1216C47A
Salida:
{ "Quota": { "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaArn": "arn:aws:servicequotas:us-east-2::ec2/L-1216C47A", "QuotaCode": "L-1216C47A", "QuotaName": "Running On-Demand Standard (A, C, D, H, I, M, R, T, Z) instances", "Value": 5.0, "Unit": "None", "Adjustable": true, "GlobalQuota": false, "UsageMetric": { "MetricNamespace": "AWS/Usage", "MetricName": "ResourceCount", "MetricDimensions": { "Class": "Standard/OnDemand", "Resource": "vCPU", "Service": "EC2", "Type": "Resource" }, "MetricStatisticRecommendation": "Maximum" } } }
-
Para obtener información sobre la API, consulte GetAwsDefaultServiceQuota
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar get-requested-service-quota-change
.
- AWS CLI
-
Para describir una solicitud de un aumento de la cuota de servicio
En el siguiente ejemplo de
get-requested-service-quota-change
, se describe la solicitud de incremento de la cuota especificada.aws service-quotas get-requested-service-quota-change \ --request-id
d187537d15254312a9609aa51bbf7624u7W49tPO
Salida:
{ "RequestedQuota": { "Id": "d187537d15254312a9609aa51bbf7624u7W49tPO", "CaseId": "6780195351", "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaCode": "L-20F13EBD", "QuotaName": "Running Dedicated c5n Hosts", "DesiredValue": 2.0, "Status": "CASE_OPENED", "Created": 1580446904.067, "LastUpdated": 1580446953.265, "Requester": "{\"accountId\":\"123456789012\",\"callerArn\":\"arn:aws:iam::123456789012:root\"}", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-20F13EBD", "GlobalQuota": false, "Unit": "None" } }
-
Para obtener información sobre la API, consulte GetRequestedServiceQuotaChange
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar get-service-quota
.
- AWS CLI
-
Para describir una cuota de servicio
En el siguiente ejemplo de
get-service-quota
, se muestran los detalles de la cuota especificada.aws service-quotas get-service-quota \ --service-code
ec2
\ --quota-codeL-1216C47A
Salida:
{ "Quota": { "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-1216C47A", "QuotaCode": "L-1216C47A", "QuotaName": "Running On-Demand Standard (A, C, D, H, I, M, R, T, Z) instances", "Value": 1920.0, "Unit": "None", "Adjustable": true, "GlobalQuota": false, "UsageMetric": { "MetricNamespace": "AWS/Usage", "MetricName": "ResourceCount", "MetricDimensions": { "Class": "Standard/OnDemand", "Resource": "vCPU", "Service": "EC2", "Type": "Resource" }, "MetricStatisticRecommendation": "Maximum" } } }
-
Para obtener información sobre la API, consulte GetServiceQuota
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-aws-default-service-quotas
.
- AWS CLI
-
Para enumerar las cuotas predeterminadas de un servicio
En el siguiente ejemplo de
list-aws-default-service-quotas
, se enumeran los valores predeterminados de las cuotas del servicio especificado.aws service-quotas list-aws-default-service-quotas \ --service-code
xray
Salida:
{ "Quotas": [ { "ServiceCode": "xray", "ServiceName": "AWS X-Ray", "QuotaArn": "arn:aws:servicequotas:us-west-2::xray/L-C6B6F05D", "QuotaCode": "L-C6B6F05D", "QuotaName": "Indexed annotations per trace", "Value": 50.0, "Unit": "None", "Adjustable": false, "GlobalQuota": false }, { "ServiceCode": "xray", "ServiceName": "AWS X-Ray", "QuotaArn": "arn:aws:servicequotas:us-west-2::xray/L-D781C0FD", "QuotaCode": "L-D781C0FD", "QuotaName": "Segment document size", "Value": 64.0, "Unit": "Kilobytes", "Adjustable": false, "GlobalQuota": false }, { "ServiceCode": "xray", "ServiceName": "AWS X-Ray", "QuotaArn": "arn:aws:servicequotas:us-west-2::xray/L-998BFF16", "QuotaCode": "L-998BFF16", "QuotaName": "Trace and service graph retention in days", "Value": 30.0, "Unit": "None", "Adjustable": false, "GlobalQuota": false } ] }
-
Para obtener información sobre la API, consulte ListAwsDefaultServiceQuotas
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-requested-service-quota-change-history-by-quota
.
- AWS CLI
-
Para enumerar sus solicitudes de aumento de cuota
En el siguiente ejemplo de
list-requested-service-quota-change-history-by-quota
, se enumeran las solicitudes de incremento de la cuota especificada.aws service-quotas list-requested-service-quota-change-history-by-quota \ --service-code
ec2
\ --quota-codeL-20F13EBD
Salida:
{ "RequestedQuotas": [ { "Id": "d187537d15254312a9609aa51bbf7624u7W49tPO", "CaseId": "6780195351", "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaCode": "L-20F13EBD", "QuotaName": "Running Dedicated c5n Hosts", "DesiredValue": 2.0, "Status": "CASE_OPENED", "Created": 1580446904.067, "LastUpdated": 1580446953.265, "Requester": "{\"accountId\":\"123456789012\",\"callerArn\":\"arn:aws:iam::123456789012:root\"}", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-20F13EBD", "GlobalQuota": false, "Unit": "None" } ] }
-
Para obtener información sobre la API, consulte ListRequestedServiceQuotaChangeHistoryByQuota
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-requested-service-quota-change-history
.
- AWS CLI
-
Para enumerar sus solicitudes de aumento de cuota
En el siguiente ejemplo de
list-requested-service-quota-change-history
, se enumeran las solicitudes de incremento de cuota del servicio especificado.aws service-quotas list-requested-service-quota-change-history \ --service-code
ec2
Salida:
{ "RequestedQuotas": [ { "Id": "d187537d15254312a9609aa51bbf7624u7W49tPO", "CaseId": "6780195351", "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaCode": "L-20F13EBD", "QuotaName": "Running Dedicated c5n Hosts", "DesiredValue": 2.0, "Status": "CASE_OPENED", "Created": 1580446904.067, "LastUpdated": 1580446953.265, "Requester": "{\"accountId\":\"123456789012\",\"callerArn\":\"arn:aws:iam::123456789012:root\"}", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-20F13EBD", "GlobalQuota": false, "Unit": "None" } ] }
-
Para obtener información sobre la API, consulte ListRequestedServiceQuotaChangeHistory
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-service-quotas
.
- AWS CLI
-
Para enumerar las cuotas de un servicio
En el siguiente ejemplo de
list-service-quotas
, se muestran detalles sobre las cuotas de AWS CloudFormation.aws service-quotas list-service-quotas \ --service-code
cloudformation
Salida:
{ "Quotas": [ { "ServiceCode": "cloudformation", "ServiceName": "AWS CloudFormation", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:cloudformation/L-87D14FB7", "QuotaCode": "L-87D14FB7", "QuotaName": "Output count in CloudFormation template", "Value": 60.0, "Unit": "None", "Adjustable": false, "GlobalQuota": false }, { "ServiceCode": "cloudformation", "ServiceName": "AWS CloudFormation", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:cloudformation/L-0485CB21", "QuotaCode": "L-0485CB21", "QuotaName": "Stack count", "Value": 200.0, "Unit": "None", "Adjustable": true, "GlobalQuota": false } ] }
-
Para obtener información sobre la API, consulte ListServiceQuotas
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar list-services
.
- AWS CLI
-
Para enumerar los servicios disponibles
El siguiente comando muestra los servicios que están disponibles en Service Quotas.
aws service-quotas list-services
Salida:
{ "Services": [ { "ServiceCode": "AWSCloudMap", "ServiceName": "AWS Cloud Map" }, { "ServiceCode": "access-analyzer", "ServiceName": "Access Analyzer" }, { "ServiceCode": "acm", "ServiceName": "AWS Certificate Manager (ACM)" }, ...truncated... { "ServiceCode": "xray", "ServiceName": "AWS X-Ray" } ] }
Puede añadir el parámetro
--query
para filtrar la visualización según la información que le interese. El siguiente ejemplo muestra solo los códigos de servicio.aws service-quotas list-services \ --query
Services[*].ServiceCode
Salida:
[ "AWSCloudMap", "access-analyzer", "acm", "acm-pca", "amplify", "apigateway", "application-autoscaling", ...truncated... "xray" ]
-
Para obtener información sobre la API, consulte ListServices
en la Referencia de comandos de la AWS CLI.
-
En el siguiente ejemplo de código, se muestra cómo utilizar request-service-quota-increase
.
- AWS CLI
-
Para solicitar un aumento de la cuota de servicio
En el siguiente ejemplo de
request-service-quota-increase
, se solicita un incremento de la cuota del servicio especificada.aws service-quotas request-service-quota-increase \ --service-code
ec2
\ --quota-codeL-20F13EBD
\ --desired-value2
Salida:
{ "RequestedQuota": { "Id": "d187537d15254312a9609aa51bbf7624u7W49tPO", "ServiceCode": "ec2", "ServiceName": "Amazon Elastic Compute Cloud (Amazon EC2)", "QuotaCode": "L-20F13EBD", "QuotaName": "Running Dedicated c5n Hosts", "DesiredValue": 2.0, "Status": "PENDING", "Created": 1580446904.067, "Requester": "{\"accountId\":\"123456789012\",\"callerArn\":\"arn:aws:iam::123456789012:root\"}", "QuotaArn": "arn:aws:servicequotas:us-east-2:123456789012:ec2/L-20F13EBD", "GlobalQuota": false, "Unit": "None" } }
-
Para obtener información sobre la API, consulte RequestServiceQuotaIncrease
en la Referencia de comandos de la AWS CLI.
-