Beispiele für die Verwendung von Service Quotas mit AWS CLI - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung von Service Quotas mit AWS CLI

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie AWS Command Line Interface mit Service Quotas nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie get-aws-default-service-quota verwendet wird.

AWS CLI

So beschreiben Sie ein Standard-Servicekontingent

Im folgenden Beispiel für get-aws-default-service-quota werden Details für das angegebene Kontingent gezeigt.

aws service-quotas get-aws-default-service-quota \
    --service-code ec2 \
    --quota-code L-1216C47A

Ausgabe:

{
    "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"
        }
    }
}

Das folgende Codebeispiel zeigt, wie get-requested-service-quota-change verwendet wird.

AWS CLI

So beschreiben Sie eine Anforderung einer Erhöhung Ihres Servicekontingents

Das folgende Beispiel für get-requested-service-quota-change beschreibt die angegebene Servicekontingent-Anforderung.

aws service-quotas get-requested-service-quota-change \
    --request-id d187537d15254312a9609aa51bbf7624u7W49tPO

Ausgabe:

{
    "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"
    }
}

Das folgende Codebeispiel zeigt, wie get-service-quota verwendet wird.

AWS CLI

So beschreiben Sie ein Servicekontingent

Im folgenden Beispiel für get-service-quota werden Details für das angegebene Servicekontingent angezeigt.

aws service-quotas get-service-quota \
    --service-code ec2 \
    --quota-code L-1216C47A

Ausgabe:

{
    "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"
        }
    }
}

  • API-Details finden Sie unter GetServiceQuota in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-aws-default-service-quotas verwendet wird.

AWS CLI

So listen Sie die Standardkontingente für einen Dienst auf

Im folgenden Beispiel für list-aws-default-service-quotas werden die Standardwerte für die Kontingente für den angegebenen Dienst aufgelistet.

aws service-quotas list-aws-default-service-quotas \
    --service-code xray

Ausgabe:

{
    "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
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-requested-service-quota-change-history-by-quota verwendet wird.

AWS CLI

So listen Sie Ihre Anforderungen zur Kontingenterhöhung auf

Im folgenden Beispiel für list-requested-service-quota-change-history-by-quota werden die Anforderungen zur Kontingenterhöhung für das angegebene Kontingent aufgelistet.

aws service-quotas list-requested-service-quota-change-history-by-quota \
    --service-code ec2 \
    --quota-code L-20F13EBD

Ausgabe:

{
    "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"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-requested-service-quota-change-history verwendet wird.

AWS CLI

So listen Sie Ihre Anforderungen zur Kontingenterhöhung auf

Im folgenden Beispiel für list-requested-service-quota-change-history werden die Anforderungen zur Kontingenterhöhung für den angegebenen Service aufgelistet.

aws service-quotas list-requested-service-quota-change-history \
    --service-code ec2

Ausgabe:

{
    "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"
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-service-quotas verwendet wird.

AWS CLI

So listen Sie die Kontingente für einen Service auf

Im folgenden Beispiel für list-service-quotas werden die Details zu den Kontingenten für AWS-CloudFormation angezeigt.

aws service-quotas list-service-quotas \
    --service-code cloudformation

Ausgabe:

{
    "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
        }
    ]
}

Das folgende Codebeispiel zeigt, wie list-services verwendet wird.

AWS CLI

So listen Sie die verfügbaren Services auf

Der folgende Befehl listet die Services auf, die in Service Quotas verfügbar sind.

aws service-quotas list-services

Ausgabe:

{
    "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"
        }
    ]
}

Sie können den --query-Parameter hinzufügen, um die Anzeige nach den Informationen zu filtern, die Sie interessieren. Im folgenden Beispiel werden ausschließlich die Servicecodes angezeigt.

aws service-quotas list-services \
    --query Services[*].ServiceCode

Ausgabe:

[
    "AWSCloudMap",
    "access-analyzer",
    "acm",
    "acm-pca",
    "amplify",
    "apigateway",
    "application-autoscaling",
        ...truncated...
    "xray"
]

  • API-Details finden Sie unter ListServices in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie request-service-quota-increase verwendet wird.

AWS CLI

So fordern Sie eine Erhöhung Ihrer Service Quota an

Im folgenden Beispiel für request-service-quota-increase wird eine Erhöhung des angegebenen Servicekontingents angefordert.

aws service-quotas request-service-quota-increase \
    --service-code ec2 \
    --quota-code L-20F13EBD \
    --desired-value 2

Ausgabe:

{
    "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"
    }
}