Exemplos de HTTP e WebSocket API do API Gateway usando AWS CLI - AWS Exemplos de código do SDK
Ações

Há mais exemplos de AWS SDK disponíveis no repositório AWS Doc SDK Examples GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exemplos de HTTP e WebSocket API do API Gateway usando AWS CLI

Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o HTTP e WebSocket a API AWS Command Line Interface com o API Gateway.

Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.

Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.

Tópicos

Ações

O código de exemplo a seguir mostra como usar create-api-mapping.

AWS CLI

Para criar um mapeamento de API para uma API

O exemplo create-api-mapping a seguir mapeia o estágio test de uma API para o caminho /myApi do nome de domínio personalizado regional.example.com.

aws apigatewayv2 create-api-mapping \
    --domain-name regional.example.com \
    --api-mapping-key myApi \
    --api-id a1b2c3d4 \
    --stage test

Saída:

{
    "ApiId": "a1b2c3d4",
    "ApiMappingId": "0qzs2sy7bh",
    "ApiMappingKey": "myApi"
    "Stage": "test"
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateApiMappingem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-api.

AWS CLI

Para criar uma API HTTP

O exemplo create-api a seguir cria uma API HTTP usando a criação rápida. Você pode usar a criação rápida para criar uma API com uma integração AWS Lambda ou HTTP, uma rota abrangente padrão e um estágio padrão configurado para implantar alterações automaticamente. O comando a seguir usa criação rápida para criar uma API HTTP que se integra com uma função do Lambda.

aws apigatewayv2 create-api \
    --name my-http-api \
    --protocol-type HTTP \
    --target arn:aws:lambda:us-west-2:123456789012:function:my-lambda-function

Saída:

{
    "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
    "ApiId": "a1b2c3d4",
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "CreatedDate": "2020-04-08T19:05:45+00:00",
    "Name": "my-http-api",
    "ProtocolType": "HTTP",
    "RouteSelectionExpression": "$request.method $request.path"
}

Para obter mais informações, consulte Desenvolver uma API HTTP no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

Para criar uma WebSocket API

O create-api exemplo a seguir cria uma WebSocket API com o nome especificado.

aws apigatewayv2 create-api \
    --name "myWebSocketApi" \
    --protocol-type WEBSOCKET \
    --route-selection-expression '$request.body.action'

Saída:

{
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "Name": "myWebSocketApi",
    "CreatedDate": "2018-11-15T06:23:51Z",
    "ProtocolType": "WEBSOCKET",
    "RouteSelectionExpression": "'$request.body.action'",
    "ApiId": "aabbccddee"
}

Para obter mais informações, consulte Criar uma WebSocket API no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-authorizer.

AWS CLI

Para criar um autorizador JWT para uma API HTTP

O exemplo create-authorizer a seguir cria um autorizador JWT que usa o Amazon Cognito como um provedor de identidade.

aws apigatewayv2 create-authorizer \
    --name my-jwt-authorizer \
    --api-id a1b2c3d4 \
    --authorizer-type JWT \
    --identity-source '$request.header.Authorization' \
    --jwt-configuration Audience=123456abc,Issuer=https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123

Saída:

{
    "AuthorizerId": "a1b2c3",
    "AuthorizerType": "JWT",
    "IdentitySource": [
        "$request.header.Authorization"
    ],
    "JwtConfiguration": {
        "Audience": [
            "123456abc"
        ],
        "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123"
    },
    "Name": "my-jwt-authorizer"
}

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateAuthorizerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-deployment.

AWS CLI

Para criar uma implantação para uma API

O exemplo create-deployment a seguir cria uma implantação para uma API e a associa ao estágio dev da API.

aws apigatewayv2 create-deployment \
    --api-id a1b2c3d4 \
    --stage-name dev

Saída:

{
    "AutoDeployed": false,
    "CreatedDate": "2020-04-06T23:38:08Z",
    "DeploymentId": "53lz9l",
    "DeploymentStatus": "DEPLOYED"
}

Para obter mais informações, consulte Implantação da API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-domain-name.

AWS CLI

Para criar um nome de domínio personalizado

O exemplo create-domain-name a seguir cria um domínio personalizado regional para uma API.

aws apigatewayv2 create-domain-name \
    --domain-name regional.example.com \
    --domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678

Saída:

{
    "ApiMappingSelectionExpression": "$request.basepath",
    "DomainName": "regional.example.com",
    "DomainNameConfigurations": [
        {
            "ApiGatewayDomainName": "d-id.execute-api.us-west-2.amazonaws.com",
            "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
            "EndpointType": "REGIONAL",
            "HostedZoneId": "123456789111",
            "SecurityPolicy": "TLS_1_2",
            "DomainNameStatus": "AVAILABLE"
        }
    ]
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateDomainNameem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-integration.

AWS CLI

Para criar uma integração WebSocket de API

O create-integration exemplo a seguir cria uma integração simulada para uma WebSocket API.

aws apigatewayv2 create-integration \
    --api-id aabbccddee \
    --passthrough-behavior WHEN_NO_MATCH \
    --timeout-in-millis 29000 \
    --connection-type INTERNET \
    --integration-type MOCK

Saída:

{
    "ConnectionType": "INTERNET",
    "IntegrationId": "0abcdef",
    "IntegrationResponseSelectionExpression": "${integration.response.statuscode}",
    "IntegrationType": "MOCK",
    "PassthroughBehavior": "WHEN_NO_MATCH",
    "PayloadFormatVersion": "1.0",
    "TimeoutInMillis": 29000
}

Para obter mais informações, consulte Configurar uma solicitação de integração de WebSocket API no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

Para criar uma integração da API HTTP

O create-integration exemplo a seguir cria uma integração AWS Lambda para uma API HTTP.

aws apigatewayv2 create-integration \
    --api-id a1b2c3d4 \
    --integration-type AWS_PROXY \
    --integration-uri arn:aws:lambda:us-west-2:123456789012:function:my-function \
    --payload-format-version 2.0

Saída:

{
    "ConnectionType": "INTERNET",
    "IntegrationId": "0abcdef",
    "IntegrationMethod": "POST",
    "IntegrationType": "AWS_PROXY",
    "IntegrationUri": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
    "PayloadFormatVersion": "2.0",
    "TimeoutInMillis": 30000
}

Para obter mais informações, consulte Configuração de integrações para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateIntegrationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-route.

AWS CLI

Para criar uma rota $default para uma API WebSocket ou HTTP

O create-route exemplo a seguir cria uma $default rota para uma API WebSocket ou HTTP.

aws apigatewayv2 create-route \
    --api-id aabbccddee \
    --route-key '$default'

Saída:

{
    "ApiKeyRequired": false,
    "AuthorizationType": "NONE",
    "RouteKey": "$default",
    "RouteId": "1122334"
}

Para obter mais informações, consulte Como trabalhar com rotas para WebSocket APIs no Guia do desenvolvedor do Amazon API Gateway

Para criar uma rota para uma API HTTP

O exemplo create-route a seguir cria uma rota chamada signup que aceita solicitações POST.

aws apigatewayv2 create-route \
    --api-id aabbccddee \
    --route-key 'POST /signup'

Saída:

{
    "ApiKeyRequired": false,
    "AuthorizationType": "NONE",
    "RouteKey": "POST /signup",
    "RouteId": "1122334"
}

Para obter mais informações, consulte Como trabalhar com rotas para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway

  • Para obter detalhes da API, consulte CreateRouteem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-routing-rule.

AWS CLI

Como criar uma regra de roteamento

O exemplo create-routing-rule a seguir cria uma regra de roteamento com uma prioridade de 50.

aws apigatewayv2 create-routing-rule \
    --domain-name 'regional.example.com' \
    --priority 50 \
    --conditions '[ \
        { \
            "MatchBasePaths": { \
                "AnyOf": [ \
                    "PetStoreShopper" \
                ] \
            } \
        } \
    ]' \
    --actions '[ \
        { \
            "InvokeApi": { \
                "ApiId": "abcd1234", \
                "Stage": "prod" \
            } \
        } \
    ]'

Saída:

{
    "Actions": [
        {
            "InvokeApi": {
                "ApiId": "abcd1234",
                "Stage": "prod",
                "StripBasePath": false
            }
        }
    ],
    "Conditions": [
        {
            "MatchBasePaths": {
                "AnyOf": [
                    "PetStoreShopper"
                ]
            }
        }
    ],
    "Priority": 50,
    "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111",
    "RoutingRuleId": "aaa111"
}

Para obter mais informações, consulte Regras de roteamento para conectar os estágios da API a um nome de domínio personalizado para REST APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateRoutingRuleem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-stage.

AWS CLI

Para criar um estágio

O exemplo create-stage a seguir cria um estágio chamado dev para uma API.

aws apigatewayv2 create-stage \
    --api-id a1b2c3d4 \
    --stage-name dev

Saída:

{
    "CreatedDate": "2020-04-06T23:23:46Z",
    "DefaultRouteSettings": {
        "DetailedMetricsEnabled": false
    },
    "LastUpdatedDate": "2020-04-06T23:23:46Z",
    "RouteSettings": {},
    "StageName": "dev",
    "StageVariables": {},
    "Tags": {}
}

Para obter mais informações, consulte Como trabalhar com estágios para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateStageem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar create-vpc-link.

AWS CLI

Para criar um link da VPC para uma API HTTP

O create-vpc-link exemplo a seguir cria um link de VPC para HTTP. APIs

aws apigatewayv2 create-vpc-link \
    --name MyVpcLink \
    --subnet-ids subnet-aaaa subnet-bbbb \
    --security-group-ids sg1234 sg5678

Saída:

{
    "CreatedDate": "2020-04-07T00:11:46Z",
    "Name": "MyVpcLink",
    "SecurityGroupIds": [
        "sg1234",
        "sg5678"
    ],
    "SubnetIds": [
        "subnet-aaaa",
        "subnet-bbbb"
    ],
    "Tags": {},
    "VpcLinkId": "abcd123",
    "VpcLinkStatus": "PENDING",
    "VpcLinkStatusMessage": "VPC link is provisioning ENIs",
    "VpcLinkVersion": "V2"
}

Para obter mais informações, consulte Como trabalhar com links de VPC para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte CreateVpcLinkem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-access-log-settings.

AWS CLI

Para desativar o registro em log de acesso para uma API

O exemplo delete-access-log-settings a seguir exclui as configurações do registro em log de acesso do estágio $default de uma API. Para desabilitar o registro de acesso em log de um estágio, exclua as configurações do log de acesso.

aws apigatewayv2 delete-access-log-settings \
    --api-id a1b2c3d4 \
    --stage-name '$default'

Este comando não produz saída.

Para obter mais informações, consulte Configurar o registros em log para uma API HTTP no Guia do desenvolvedor do Amazon API Gateway.

O código de exemplo a seguir mostra como usar delete-api-mapping.

AWS CLI

Para excluir um mapeamento de API

O exemplo delete-api-mapping a seguir exclui um mapeamento de API do nome de domínio personalizado api.example.com.

aws apigatewayv2 delete-api-mapping \
    --api-mapping-id a1b2c3 \
    --domain-name api.example.com

Este comando não produz saída.

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteApiMappingem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-api.

AWS CLI

Como excluir uma API

O exemplo delete-api a seguir exclui uma API.

aws apigatewayv2 delete-api \
    --api-id a1b2c3d4

Este comando não produz saída.

Para obter mais informações, consulte Trabalhando com HTTP APIs e Trabalhando com WebSocket APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-authorizer.

AWS CLI

Para excluir um autorizador

O exemplo delete-authorizer a seguir exclui um autorizador.

aws apigatewayv2 delete-authorizer \
    --api-id a1b2c3d4 \
    --authorizer-id a1b2c3

Este comando não produz saída.

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteAuthorizerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-cors-configuration.

AWS CLI

Para excluir a configuração CORS de uma API HTTP

O exemplo delete-cors-configuration a seguir desabilita o CORS para uma API HTTP excluindo sua configuração de CORS.

aws apigatewayv2 delete-cors-configuration \
    --api-id a1b2c3d4

Este comando não produz saída.

Para obter mais informações, consulte Configurar o CORS para uma API HTTP no Guia do desenvolvedor do Amazon API Gateway.

O código de exemplo a seguir mostra como usar delete-deployment.

AWS CLI

Para excluir uma implantação

O exemplo delete-deployment a seguir exclui uma implantação de uma API.

aws apigatewayv2 delete-deployment \
    --api-id a1b2c3d4 \
    --deployment-id a1b2c3

Este comando não produz saída.

Para obter mais informações, consulte Implantação da API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-domain-name.

AWS CLI

Para excluir um nome de domínio personalizado

O exemplo delete-domain-name a seguir exclui um nome de domínio personalizado.

aws apigatewayv2 delete-domain-name \
    --domain-name api.example.com

Este comando não produz saída.

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteDomainNameem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-integration.

AWS CLI

Para excluir uma integração

O exemplo delete-integration a seguir exclui uma integração de API.

aws apigatewayv2 delete-integration \
    --api-id a1b2c3d4 \
    --integration-id a1b2c3

Este comando não produz saída.

Para obter mais informações, consulte Configuração de integrações para HTTP APIs e Configuração de integrações de WebSocket API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteIntegrationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-route-settings.

AWS CLI

Para excluir as configurações de rota

O exemplo delete-route-settings a seguir exclui as configurações de rota para a rota especificada.

aws apigatewayv2 delete-route-settings \
    --api-id a1b2c3d4 \
    --stage-name dev \
    --route-key 'GET /pets'

Este comando não produz saída.

Para obter mais informações, consulte Como trabalhar com rotas para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

O código de exemplo a seguir mostra como usar delete-route.

AWS CLI

Para excluir uma rota

O exemplo delete-route a seguir exclui uma rota da API.

aws apigatewayv2 delete-route \
    --api-id a1b2c3d4 \
    --route-id a1b2c3

Este comando não produz saída.

Para obter mais informações, consulte Como trabalhar com rotas para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteRouteem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-routing-rule.

AWS CLI

Como excluir uma regra de roteamento

O exemplo delete-routing-rule a seguir exclui uma regra de roteamento para um nome de domínio personalizado.

aws apigatewayv2 delete-routing-rule \
    --domain-name 'regional.example.com' \
    --routing-rule-id aaa111

Este comando não produz saída.

Para obter mais informações, consulte Regras de roteamento para conectar os estágios da API a um nome de domínio personalizado para REST APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteRoutingRuleem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-stage.

AWS CLI

Para excluir uma estágio

O exemplo delete-stage a seguir exclui o estágio test de uma API.

aws apigatewayv2 delete-stage \
    --api-id a1b2c3d4 \
    --stage-name test

Este comando não produz saída.

Para obter mais informações, consulte Como trabalhar com estágios para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteStageem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar delete-vpc-link.

AWS CLI

Para excluir um link da VPC para uma API HTTP

O exemplo delete-vpc-link a seguir exclui um link da VPC.

aws apigatewayv2 delete-vpc-link \
    --vpc-link-id abcd123

Este comando não produz saída.

Para obter mais informações, consulte Como trabalhar com links de VPC para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte DeleteVpcLinkem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar export-api.

AWS CLI

Para exportar uma definição do OpenAPI de uma API HTTP

O exemplo export-api a seguir exporta uma definição do OpenAPI 3.0 de um estágio de API chamado prod para um arquivo YAML denominado stage-definition.yaml. O arquivo de definição exportado inclui extensões do API Gateway por padrão.

aws apigatewayv2 export-api \
    --api-id a1b2c3d4 \
    --output-type YAML \
    --specification OAS30 \
    --stage-name prod \
    stage-definition.yaml

Este comando não produz saída.

Para obter mais informações, consulte Exportar uma API HTTP do API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte ExportApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-api-mapping.

AWS CLI

Para obter informações sobre um mapeamento de API para um nome de domínio personalizado

O exemplo get-api-mapping a seguir exibe informações sobre um mapeamento de API para o nome de domínio personalizado api.example.com.

aws apigatewayv2 get-api-mapping \
    --api-mapping-id a1b2c3 \
    --domain-name api.example.com

Saída:

{
    "ApiId": "a1b2c3d4",
    "ApiMappingId": "a1b2c3d5",
    "ApiMappingKey": "myTestApi"
    "Stage": "test"
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetApiMappingem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-api-mappings.

AWS CLI

Para obter mapeamentos de API para um nome de domínio personalizado

O exemplo get-api-mappings a seguir exibe uma lista de todos os mapeamentos de API para o nome de domínio personalizado api.example.com.

aws apigatewayv2 get-api-mappings \
    --domain-name api.example.com

Saída:

{
    "Items": [
        {
            "ApiId": "a1b2c3d4",
            "ApiMappingId": "a1b2c3d5",
            "ApiMappingKey": "myTestApi"
            "Stage": "test"
        },
        {
            "ApiId": "a5b6c7d8",
            "ApiMappingId": "a1b2c3d6",
            "ApiMappingKey": "myDevApi"
            "Stage": "dev"
        },
    ]
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetApiMappingsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-api.

AWS CLI

Para recuperar informações sobre uma API

O exemplo get-api a seguir exibe informações sobre uma API.

aws apigatewayv2 get-api \
    --api-id a1b2c3d4

Saída:

{
    "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
    "ApiId": "a1b2c3d4",
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "CreatedDate": "2020-03-28T00:32:37Z",
    "Name": "my-api",
    "ProtocolType": "HTTP",
    "RouteSelectionExpression": "$request.method $request.path",
    "Tags": {
        "department": "finance"
    }
}

  • Para obter detalhes da API, consulte GetApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-apis.

AWS CLI

Para recuperar uma lista de APIs

O get-apis exemplo a seguir lista todos APIs os do usuário atual.

aws apigatewayv2 get-apis

Saída:

{
    "Items": [
        {
            "ApiEndpoint": "wss://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
            "ApiId": "a1b2c3d4",
            "ApiKeySelectionExpression": "$request.header.x-api-key",
            "CreatedDate": "2020-04-07T20:21:59Z",
            "Name": "my-websocket-api",
            "ProtocolType": "WEBSOCKET",
            "RouteSelectionExpression": "$request.body.message",
            "Tags": {}
        },
        {
            "ApiEndpoint": "https://a1b2c3d5.execute-api.us-west-2.amazonaws.com",
            "ApiId": "a1b2c3d5",
            "ApiKeySelectionExpression": "$request.header.x-api-key",
            "CreatedDate": "2020-04-07T20:23:50Z",
            "Name": "my-http-api",
            "ProtocolType": "HTTP",
            "RouteSelectionExpression": "$request.method $request.path",
            "Tags": {}
        }
    ]
}

Para obter mais informações, consulte Trabalhando com HTTP APIs e Trabalhando com WebSocket APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetApisem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-authorizer.

AWS CLI

Para recuperar informações sobre um autorizador

O exemplo get-authorizer a seguir exibe informações detalhadas sobre um autorizador.

aws apigatewayv2 get-authorizer \
    --api-id a1b2c3d4 \
    --authorizer-id a1b2c3

Saída:

{
    "AuthorizerId": "a1b2c3",
    "AuthorizerType": "JWT",
    "IdentitySource": [
        "$request.header.Authorization"
    ],
    "JwtConfiguration": {
        "Audience": [
            "123456abc"
        ],
        "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123"
    },
    "Name": "my-jwt-authorizer"
}

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetAuthorizerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-authorizers.

AWS CLI

Para recuperar uma lista de autorizadores de uma API

O exemplo get-authorizers a seguir exibe uma lista de todos os autorizadores de uma API.

aws apigatewayv2 get-authorizers \
    --api-id a1b2c3d4

Saída:

{
    "Items": [
        {
            "AuthorizerId": "a1b2c3",
            "AuthorizerType": "JWT",
            "IdentitySource": [
                "$request.header.Authorization"
            ],
            "JwtConfiguration": {
                "Audience": [
                    "123456abc"
                ],
                "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123"
            },
            "Name": "my-jwt-authorizer"
        },
        {
            "AuthorizerId": "a1b2c4",
            "AuthorizerType": "JWT",
            "IdentitySource": [
                "$request.header.Authorization"
            ],
            "JwtConfiguration": {
                "Audience": [
                    "6789abcde"
                ],
                "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc234"
            },
            "Name": "new-jwt-authorizer"
        }
    ]
}

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetAuthorizersem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-deployment.

AWS CLI

Para recuperar informações sobre uma implantação

O exemplo get-deployment a seguir exibe informações sobre uma implantação.

aws apigatewayv2 get-deployment \
    --api-id a1b2c3d4 \
    --deployment-id abcdef

Saída:

{
    "AutoDeployed": true,
    "CreatedDate": "2020-04-07T23:58:40Z",
    "DeploymentId": "abcdef",
    "DeploymentStatus": "DEPLOYED",
    "Description": "Automatic deployment triggered by changes to the Api configuration"
}

Para obter mais informações, consulte Implantação da API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-deployments.

AWS CLI

Para recuperar uma lista de implantações

O exemplo get-deployments a seguir exibe uma lista de todas as implantações de uma API.

aws apigatewayv2 get-deployments \
    --api-id a1b2c3d4

Saída:

{
    "Items": [
        {
            "AutoDeployed": true,
            "CreatedDate": "2020-04-07T23:58:40Z",
            "DeploymentId": "abcdef",
            "DeploymentStatus": "DEPLOYED",
            "Description": "Automatic deployment triggered by changes to the Api configuration"
        },
        {
            "AutoDeployed": true,
            "CreatedDate": "2020-04-06T00:33:00Z",
            "DeploymentId": "bcdefg",
            "DeploymentStatus": "DEPLOYED",
            "Description": "Automatic deployment triggered by changes to the Api configuration"
        }
    ]
}

Para obter mais informações, consulte Implantação da API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetDeploymentsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-domain-name.

AWS CLI

Para recuperar informações sobre um nome de domínio personalizado

O exemplo get-domain-name a seguir exibe informações sobre um nome de domínio personalizado.

aws apigatewayv2 get-domain-name \
    --domain-name api.example.com

Saída:

{
    "ApiMappingSelectionExpression": "$request.basepath",
    "DomainName": "api.example.com",
    "DomainNameConfigurations": [
        {
            "ApiGatewayDomainName": "d-1234.execute-api.us-west-2.amazonaws.com",
            "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
            "EndpointType": "REGIONAL",
            "HostedZoneId": "123456789111",
            "SecurityPolicy": "TLS_1_2",
            "DomainNameStatus": "AVAILABLE"
        }
    ],
    "Tags": {}
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetDomainNameem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-domain-names.

AWS CLI

Para recuperar uma lista de nomes de domínio personalizados

O exemplo get-domain-names a seguir exibe uma lista de todos os nomes de domínio personalizados do usuário atual.

aws apigatewayv2 get-domain-names

Saída:

{
    "Items": [
        {
            "ApiMappingSelectionExpression": "$request.basepath",
            "DomainName": "api.example.com",
            "DomainNameConfigurations": [
                {
                    "ApiGatewayDomainName": "d-1234.execute-api.us-west-2.amazonaws.com",
                    "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
                    "EndpointType": "REGIONAL",
                    "HostedZoneId": "123456789111",
                    "SecurityPolicy": "TLS_1_2",
                    "DomainNameStatus": "AVAILABLE"
                }
            ]
        },
        {
            "ApiMappingSelectionExpression": "$request.basepath",
            "DomainName": "newApi.example.com",
            "DomainNameConfigurations": [
                {
                    "ApiGatewayDomainName": "d-5678.execute-api.us-west-2.amazonaws.com",
                    "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
                    "EndpointType": "REGIONAL",
                    "HostedZoneId": "123456789222",
                    "SecurityPolicy": "TLS_1_2",
                    "DomainNameStatus": "AVAILABLE"
                }
            ]
        }
    ]
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetDomainNamesem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-integration.

AWS CLI

Para recuperar informações sobre uma integração

O exemplo get-integration a seguir mostra informações sobre uma integração.

aws apigatewayv2 get-integration \
    --api-id a1b2c3d4 \
    --integration-id a1b2c3

Saída:

{
    "ApiGatewayManaged": true,
    "ConnectionType": "INTERNET",
    "IntegrationId": "a1b2c3",
    "IntegrationMethod": "POST",
    "IntegrationType": "AWS_PROXY",
    "IntegrationUri": "arn:aws:lambda:us-west-2:12356789012:function:hello12",
    "PayloadFormatVersion": "2.0",
    "TimeoutInMillis": 30000
}

Para obter mais informações, consulte Configuração de integrações para HTTP APIs e Configuração de integrações de WebSocket API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetIntegrationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-integrations.

AWS CLI

Para recuperar uma lista de integrações

O exemplo get-integrations a seguir exibe uma lista de todas as integrações de uma API.

aws apigatewayv2 get-integrations \
    --api-id a1b2c3d4

Saída:

{
    "Items": [
        {
            "ApiGatewayManaged": true,
            "ConnectionType": "INTERNET",
            "IntegrationId": "a1b2c3",
            "IntegrationMethod": "POST",
            "IntegrationType": "AWS_PROXY",
            "IntegrationUri": "arn:aws:lambda:us-west-2:123456789012:function:my-function",
            "PayloadFormatVersion": "2.0",
            "TimeoutInMillis": 30000
        },
        {
            "ConnectionType": "INTERNET",
            "IntegrationId": "a1b2c4",
            "IntegrationMethod": "ANY",
            "IntegrationType": "HTTP_PROXY",
            "IntegrationUri": "https://www.example.com",
            "PayloadFormatVersion": "1.0",
            "TimeoutInMillis": 30000
        }
    ]
}

Para obter mais informações, consulte Configuração de integrações para HTTP APIs e Configuração de integrações de WebSocket API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetIntegrationsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-route.

AWS CLI

Para recuperar informações sobre uma rota

O exemplo get-route a seguir exibe informações sobre uma rota.

aws apigatewayv2 get-route \
    --api-id a1b2c3d4 \
    --route-id 72jz1wk

Saída:

{
    "ApiKeyRequired": false,
    "AuthorizationType": "NONE",
    "RouteId": "72jz1wk",
    "RouteKey": "ANY /pets",
    "Target": "integrations/a1b2c3"
}

Para obter mais informações, consulte Como trabalhar com rotas para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway

  • Para obter detalhes da API, consulte GetRouteem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-routes.

AWS CLI

Para recuperar uma lista de rotas

O exemplo get-routes a seguir exibe uma lista de todas as rotas de uma API.

aws apigatewayv2 get-routes \
    --api-id a1b2c3d4

Saída:

{
    "Items": [
        {
            "ApiKeyRequired": false,
            "AuthorizationType": "NONE",
            "RouteId": "72jz1wk",
            "RouteKey": "ANY /admin",
            "Target": "integrations/a1b2c3"
        },
        {
            "ApiGatewayManaged": true,
            "ApiKeyRequired": false,
            "AuthorizationType": "NONE",
            "RouteId": "go65gqi",
            "RouteKey": "$default",
            "Target": "integrations/a1b2c4"
        }
    ]
}

Para obter mais informações, consulte Como trabalhar com rotas para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway

  • Para obter detalhes da API, consulte GetRoutesem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-routing-rule.

AWS CLI

Como obter uma regra de roteamento

O exemplo get-routing-rule a seguir obtém uma regra de roteamento para um nome de domínio.

aws apigatewayv2 get-routing-rule \
    --domain-name 'regional.example.com' \
    --routing-rule-id aaa111

Saída:

{
    "Actions": [
        {
            "InvokeApi": {
                "ApiId": "abcd1234",
                "Stage": "prod",
                "StripBasePath": false
            }
        }
    ],
    "Conditions": [
        {
            "MatchBasePaths": {
                "AnyOf": [
                    "PetStoreShopper"
                ]
            }
        }
    ],
    "Priority": 50,
    "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111",
    "RoutingRuleId": "aaa111"
}

Para obter mais informações, consulte Regras de roteamento para conectar os estágios da API a um nome de domínio personalizado para REST APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetRoutingRuleem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-stage.

AWS CLI

Para recuperar informações sobre um estágio

O exemplo get-stage a seguir mostra informações sobre o estágio prod de uma API.

aws apigatewayv2 get-stage \
    --api-id a1b2c3d4 \
    --stage-name prod

Saída:

{
    "CreatedDate": "2020-04-08T00:36:05Z",
    "DefaultRouteSettings": {
        "DetailedMetricsEnabled": false
    },
    "DeploymentId": "x1zwyv",
    "LastUpdatedDate": "2020-04-08T00:36:13Z",
    "RouteSettings": {},
    "StageName": "prod",
    "StageVariables": {
        "function": "my-prod-function"
    },
    "Tags": {}
}

Para obter mais informações, consulte Como trabalhar com estágios para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetStageem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-stages.

AWS CLI

Para recuperar uma lista de estágios

O exemplo get-stages a seguir lista todos os estágios de uma API.

aws apigatewayv2 get-stages \
    --api-id a1b2c3d4

Saída:

{
    "Items": [
        {
            "ApiGatewayManaged": true,
            "AutoDeploy": true,
            "CreatedDate": "2020-04-08T00:08:44Z",
            "DefaultRouteSettings": {
                "DetailedMetricsEnabled": false
            },
            "DeploymentId": "dty748",
            "LastDeploymentStatusMessage": "Successfully deployed stage with deployment ID 'dty748'",
            "LastUpdatedDate": "2020-04-08T00:09:49Z",
            "RouteSettings": {},
            "StageName": "$default",
            "StageVariables": {},
            "Tags": {}
        },
        {
            "AutoDeploy": true,
            "CreatedDate": "2020-04-08T00:35:06Z",
            "DefaultRouteSettings": {
                "DetailedMetricsEnabled": false
            },
            "LastUpdatedDate": "2020-04-08T00:35:48Z",
            "RouteSettings": {},
            "StageName": "dev",
            "StageVariables": {
                "function": "my-dev-function"
            },
            "Tags": {}
        },
        {
            "CreatedDate": "2020-04-08T00:36:05Z",
            "DefaultRouteSettings": {
                "DetailedMetricsEnabled": false
            },
            "DeploymentId": "x1zwyv",
            "LastUpdatedDate": "2020-04-08T00:36:13Z",
            "RouteSettings": {},
            "StageName": "prod",
            "StageVariables": {
                "function": "my-prod-function"
            },
            "Tags": {}
        }
    ]
}

Para obter mais informações, consulte Como trabalhar com estágios para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetStagesem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-tags.

AWS CLI

Para recuperar uma lista de tags de um recurso

O exemplo get-tags a seguir lista todas as tags de uma API.

aws apigatewayv2 get-tags \
    --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4

Saída:

{
    "Tags": {
        "owner": "dev-team",
        "environment": "prod"
    }
}

Para obter mais informações, consulte Marcar recursos do API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetTagsem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-vpc-link.

AWS CLI

Para recuperar informações sobre um link da VPC

O exemplo get-vpc-link a seguir exibe informações sobre um link da VPC.

aws apigatewayv2 get-vpc-link \
    --vpc-link-id abcd123

Saída:

{
    "CreatedDate": "2020-04-07T00:27:47Z",
    "Name": "MyVpcLink",
    "SecurityGroupIds": [
        "sg1234",
        "sg5678"
    ],
    "SubnetIds": [
        "subnet-aaaa",
        "subnet-bbbb"
    ],
    "Tags": {},
    "VpcLinkId": "abcd123",
    "VpcLinkStatus": "AVAILABLE",
    "VpcLinkStatusMessage": "VPC link is ready to route traffic",
    "VpcLinkVersion": "V2"
}

Para obter mais informações, consulte Como trabalhar com links de VPC para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetVpcLinkem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar get-vpc-links.

AWS CLI

Para recuperar uma lista de links da VPC

O exemplo get-vpc-links a seguir exibe uma lista de todos os links da VPC do usuário atual.

aws apigatewayv2 get-vpc-links

Saída:

{
    "Items": [
        {
            "CreatedDate": "2020-04-07T00:27:47Z",
            "Name": "MyVpcLink",
            "SecurityGroupIds": [
                "sg1234",
                "sg5678"
            ],
            "SubnetIds": [
                "subnet-aaaa",
                "subnet-bbbb"
            ],
            "Tags": {},
            "VpcLinkId": "abcd123",
            "VpcLinkStatus": "AVAILABLE",
            "VpcLinkStatusMessage": "VPC link is ready to route traffic",
            "VpcLinkVersion": "V2"
        }
        {
            "CreatedDate": "2020-04-07T00:27:47Z",
            "Name": "MyOtherVpcLink",
            "SecurityGroupIds": [
                "sg1234",
                "sg5678"
            ],
            "SubnetIds": [
                "subnet-aaaa",
                "subnet-bbbb"
            ],
            "Tags": {},
            "VpcLinkId": "abcd456",
            "VpcLinkStatus": "AVAILABLE",
            "VpcLinkStatusMessage": "VPC link is ready to route traffic",
            "VpcLinkVersion": "V2"
        }
    ]
}

Para obter mais informações, consulte Como trabalhar com links de VPC para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte GetVpcLinksem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar import-api.

AWS CLI

Para importar uma API HTTP

O exemplo import-api a seguir cria uma API HTTP a partir de um arquivo de definição da OpenAPI 3.0 denominado api-definition.yaml.

aws apigatewayv2 import-api \
    --body file://api-definition.yaml

Conteúdo de api-definition.yaml:

openapi: 3.0.1
info:
    title: My Lambda API
    version: v1.0
paths:
    /hello:
        x-amazon-apigateway-any-method:
            x-amazon-apigateway-integration:
                payloadFormatVersion: 2.0
                type: aws_proxy
                httpMethod: POST
                uri: arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:hello/invocations
                connectionType: INTERNET

Saída:

{
    "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
    "ApiId": "a1b2c3d4",
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "CreatedDate": "2020-04-08T17:19:38+00:00",
    "Name": "My Lambda API",
    "ProtocolType": "HTTP",
    "RouteSelectionExpression": "$request.method $request.path",
    "Tags": {},
    "Version": "v1.0"
}

Para obter mais informações, consulte Como trabalhar com as definições da OpenAPI para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte ImportApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar list-routing-rules.

AWS CLI

Como listar regras de roteamento

O exemplo list-routing-rules a seguir lista as regras de roteamento para um nome de domínio.

aws apigatewayv2 list-routing-rules \
    --domain-name 'regional.example.com'

Saída:

{
    "RoutingRules": [
        {
            "Actions": [
                {
                    "InvokeApi": {
                        "ApiId": "abcd1234",
                        "Stage": "prod",
                        "StripBasePath": false
                    }
                }
            ],
            "Conditions": [
                {
                    "MatchBasePaths": {
                        "AnyOf": [
                            "PetStoreShopper"
                        ]
                    }
                }
            ],
            "Priority": 150,
            "RoutingRuleArn": "arn:aws:apigateway:us-east-1:123456789012:/domainnames/regional.example.com/routingrules/aaa111",
            "RoutingRuleId": "aaa111"
        }
    ]
}

Para obter mais informações, consulte Regras de roteamento para conectar os estágios da API a um nome de domínio personalizado para REST APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte ListRoutingRulesem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar put-routing-rule.

AWS CLI

Como atualizar uma regra de roteamento

O exemplo put-routing-rule a seguir atualiza a prioridade de uma regra de roteamento.

aws apigatewayv2 put-routing-rule \
    --domain-name 'regional.example.com' \
    --priority 150 \
    --conditions '[ \
        { \
            "MatchBasePaths": { \
                "AnyOf": [ \
                    "PetStoreShopper" \
                ] \
            } \
        } \
    ]' \
    --actions '[ \
        { \
            "InvokeApi": { \
                "ApiId": "abcd1234", \
                "Stage": "prod" \
            } \
        } \
    ]'

Saída:

{
    "Actions": [
        {
            "InvokeApi": {
                "ApiId": "abcd1234",
                "Stage": "prod",
                "StripBasePath": false
            }
        }
    ],
    "Conditions": [
        {
            "MatchBasePaths": {
                "AnyOf": [
                    "PetStoreShopper"
                ]
            }
        }
    ],
    "Priority": 150,
    "RoutingRuleArn": "arn:aws:apigateway:us-east-2:123456789012:/domainnames/regional.example.com/routingrules/aaa111",
    "RoutingRuleId": "aaa111"
}

Para obter mais informações, consulte Regras de roteamento para conectar os estágios da API a um nome de domínio personalizado para REST APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte PutRoutingRuleem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar reimport-api.

AWS CLI

Para reimportar uma API HTTP

O exemplo reimport-api a seguir atualiza uma API HTTP existente para usar a definição da OpenAPI 3.0 especificada em api-definition.yaml.

aws apigatewayv2 reimport-api \
    --body file://api-definition.yaml \
    --api-id a1b2c3d4

Conteúdo de api-definition.yaml:

openapi: 3.0.1
info:
    title: My Lambda API
    version: v1.0
paths:
    /hello:
        x-amazon-apigateway-any-method:
            x-amazon-apigateway-integration:
                payloadFormatVersion: 2.0
                type: aws_proxy
                httpMethod: POST
                uri: arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:12356789012:function:hello/invocations
                connectionType: INTERNET

Saída:

{
    "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
    "ApiId": "a1b2c3d4",
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "CreatedDate": "2020-04-08T17:19:38+00:00",
    "Name": "My Lambda API",
    "ProtocolType": "HTTP",
    "RouteSelectionExpression": "$request.method $request.path",
    "Tags": {},
    "Version": "v1.0"
}

Para obter mais informações, consulte Como trabalhar com as definições da OpenAPI para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte ReimportApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar tag-resource.

AWS CLI

Como marcar um recurso

O exemplo tag-resource a seguir adiciona uma tag com o nome de chave Department e um valor de Accounting à API especificada.

aws apigatewayv2 tag-resource \
    --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4 \
    --tags Department=Accounting

Este comando não produz saída.

Para obter mais informações, consulte Marcar recursos do API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte TagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar untag-resource.

AWS CLI

Como remover as tags de um recurso

O exemplo untag-resource a seguir remove as tags com os nomes das chaves Project e Owner da API especificada.

aws apigatewayv2 untag-resource \
    --resource-arn arn:aws:apigateway:us-west-2::/apis/a1b2c3d4 \
    --tag-keys Project Owner

Este comando não produz saída.

Para obter mais informações, consulte Marcar recursos do API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UntagResourceem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-api-mapping.

AWS CLI

Para criar um mapeamento de API

O exemplo update-api-mapping a seguir altera um mapeamento de API de um nome de domínio personalizado. Como resultado, a URL base usando o nome de domínio personalizado para a API e estágio especificados se torna https://api.example.com/dev.

aws apigatewayv2 update-api-mapping \
    --api-id a1b2c3d4 \
    --stage dev \
    --domain-name api.example.com \
    --api-mapping-id 0qzs2sy7bh \
    --api-mapping-key dev

Saída:

{
    "ApiId": "a1b2c3d4",
    "ApiMappingId": "0qzs2sy7bh",
    "ApiMappingKey": "dev"
    "Stage": "dev"
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateApiMappingem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-api.

AWS CLI

Para habilitar o CORS para uma API HTTP

O exemplo update-api a seguir atualiza a configuração CORS da API especificada para permitir solicitações de https://www.example.com.

aws apigatewayv2 update-api \
    --api-id a1b2c3d4 \
    --cors-configuration AllowOrigins=https://www.example.com

Saída:

{
    "ApiEndpoint": "https://a1b2c3d4.execute-api.us-west-2.amazonaws.com",
    "ApiId": "a1b2c3d4",
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "CorsConfiguration": {
        "AllowCredentials": false,
        "AllowHeaders": [
            "header1",
            "header2"
        ],
        "AllowMethods": [
            "GET",
            "OPTIONS"
        ],
        "AllowOrigins": [
            "https://www.example.com"
        ]
    },
    "CreatedDate": "2020-04-08T18:39:37+00:00",
    "Name": "my-http-api",
    "ProtocolType": "HTTP",
    "RouteSelectionExpression": "$request.method $request.path",
    "Tags": {},
    "Version": "v1.0"
}

Para obter mais informações, consulte Configurar o CORS para uma API HTTP no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateApiem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-authorizer.

AWS CLI

Para atualizar um autorizador

O exemplo update-authorizer a seguir altera a fonte de identidade de um autorizador do JWT para um cabeçalho chamado Authorization.

aws apigatewayv2 update-authorizer \
    --api-id a1b2c3d4 \
    --authorizer-id a1b2c3 \
    --identity-source '$request.header.Authorization'

Saída:

{
    "AuthorizerId": "a1b2c3",
    "AuthorizerType": "JWT",
    "IdentitySource": [
        "$request.header.Authorization"
    ],
    "JwtConfiguration": {
        "Audience": [
            "123456abc"
        ],
        "Issuer": "https://cognito-idp.us-west-2.amazonaws.com/us-west-2_abc123"
    },
    "Name": "my-jwt-authorizer"
}

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateAuthorizerem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-deployment.

AWS CLI

Para alterar a descrição de uma implantação

O exemplo update-deployment a seguir atualiza a descrição de uma implantação.

aws apigatewayv2 update-deployment \
    --api-id a1b2c3d4 \
    --deployment-id abcdef \
    --description 'Manual deployment to fix integration test failures.'

Saída:

{
    "AutoDeployed": false,
    "CreatedDate": "2020-02-05T16:21:48+00:00",
    "DeploymentId": "abcdef",
    "DeploymentStatus": "DEPLOYED",
    "Description": "Manual deployment to fix integration test failures."
}

Para obter mais informações, consulte Desenvolver uma API HTTP no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateDeploymentem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-domain-name.

AWS CLI

Para atualizar um nome de domínio personalizado

O exemplo update-domain-name a seguir especifica um novo certificado ACM para o nome de domínio personalizado api.example.com.

aws apigatewayv2 update-domain-name \
    --domain-name api.example.com \
    --domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678

Saída:

{
    "ApiMappingSelectionExpression": "$request.basepath",
    "DomainName": "regional.example.com",
    "DomainNameConfigurations": [
        {
            "ApiGatewayDomainName": "d-id.execute-api.us-west-2.amazonaws.com",
            "CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
            "EndpointType": "REGIONAL",
            "HostedZoneId": "123456789111",
            "SecurityPolicy": "TLS_1_2",
            "DomainNameStatus": "AVAILABLE"
        }
    ]
}

Para obter mais informações, consulte Configurar um nome de domínio personalizado regional no API Gateway no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateDomainNameem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-integration.

AWS CLI

Para atualizar uma integração com o Lambda

O update-integration exemplo a seguir atualiza uma integração existente do AWS Lambda para usar a função Lambda especificada.

aws apigatewayv2 update-integration \
    --api-id a1b2c3d4 \
    --integration-id a1b2c3 \
    --integration-uri arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:my-new-function/invocations

Saída:

{
    "ConnectionType": "INTERNET",
    "IntegrationId": "a1b2c3",
    "IntegrationMethod": "POST",
    "IntegrationType": "AWS_PROXY",
    "IntegrationUri": "arn:aws:apigateway:us-west-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-west-2:123456789012:function:my-new-function/invocations",
    "PayloadFormatVersion": "2.0",
    "TimeoutInMillis": 5000
}

Para obter mais informações, consulte Configuração de integrações para HTTP APIs e Configuração de integrações de WebSocket API no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateIntegrationem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-route.

AWS CLI

Exemplo 1: atualizar a integração de uma rota

O exemplo update-route a seguir atualiza a integração de uma rota especificada.

aws apigatewayv2 update-route \
    --api-id a1b2c3d4 \
    --route-id a1b2c3 \
    --target integrations/a1b2c6

Saída:

{
    "ApiKeyRequired": false,
    "AuthorizationType": "NONE",
    "RouteId": "a1b2c3",
    "RouteKey": "ANY /pets",
    "Target": "integrations/a1b2c6"
}

Exemplo 2: adicionar um autorizador a uma rota

O exemplo update-route a seguir atualiza uma rota para usar um autorizador JWT.

aws apigatewayv2 update-route \
    --api-id a1b2c3d4  \
    --route-id a1b2c3  \
    --authorization-type JWT \
    --authorizer-id a1b2c5 \
    --authorization-scopes user.id user.email

Saída:

{
    "ApiKeyRequired": false,
    "AuthorizationScopes": [
        "user.id",
        "user.email"
    ],
    "AuthorizationType": "JWT",
    "AuthorizerId": "a1b2c5",
    "OperationName": "GET HTTP",
    "RequestParameters": {},
    "RouteId": "a1b2c3",
    "RouteKey": "GET /pets",
    "Target": "integrations/a1b2c6"
}

Para obter mais informações, consulte Controle do acesso ao HTTP APIs com autorizadores JWT no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateRouteem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-stage.

AWS CLI

Como configurar o controle de utilização personalizado

O exemplo update-stage a seguir configura o controle de utilização personalizado para o estágio especificado e a rota de uma API.

aws apigatewayv2 update-stage \
    --api-id a1b2c3d4 \
    --stage-name dev \
    --route-settings '{"GET /pets":{"ThrottlingBurstLimit":100,"ThrottlingRateLimit":2000}}'

Saída:

{
    "CreatedDate": "2020-04-05T16:21:16+00:00",
    "DefaultRouteSettings": {
        "DetailedMetricsEnabled": false
    },
    "DeploymentId": "shktxb",
    "LastUpdatedDate": "2020-04-08T22:23:17+00:00",
    "RouteSettings": {
        "GET /pets": {
            "ThrottlingBurstLimit": 100,
            "ThrottlingRateLimit": 2000.0
        }
    },
    "StageName": "dev",
    "StageVariables": {},
    "Tags": {}
}

Para obter mais informações, consulte Proteger sua API HTTP no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateStageem Referência de AWS CLI Comandos.

O código de exemplo a seguir mostra como usar update-vpc-link.

AWS CLI

Para atualizar um link da VPC

O exemplo update-vpc-link a seguir atualiza o nome de um link da VPC. Depois de criar um link de VPC, você não pode alterar seus grupos de segurança ou sub-redes.

aws apigatewayv2 update-vpc-link \
    --vpc-link-id abcd123 \
    --name MyUpdatedVpcLink

Saída:

{
    "CreatedDate": "2020-04-07T00:27:47Z",
    "Name": "MyUpdatedVpcLink",
    "SecurityGroupIds": [
        "sg1234",
        "sg5678"
    ],
    "SubnetIds": [
        "subnet-aaaa",
        "subnet-bbbb"
    ],
    "Tags": {},
    "VpcLinkId": "abcd123",
    "VpcLinkStatus": "AVAILABLE",
    "VpcLinkStatusMessage": "VPC link is ready to route traffic",
    "VpcLinkVersion": "V2"
}

Para obter mais informações, consulte Como trabalhar com links de VPC para HTTP APIs no Guia do desenvolvedor do Amazon API Gateway.

  • Para obter detalhes da API, consulte UpdateVpcLinkem Referência de AWS CLI Comandos.