com.amazonaws.services.vpclattice.AmazonVPCLattice Maven / Gradle / Ivy
Show all versions of aws-java-sdk-vpclattice Show documentation
/*
* Copyright 2019-2024 Amazon.com, Inc. or its affiliates. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with
* the License. A copy of the License is located at
*
* http://aws.amazon.com/apache2.0
*
* or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
* CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions
* and limitations under the License.
*/
package com.amazonaws.services.vpclattice;
import javax.annotation.Generated;
import com.amazonaws.*;
import com.amazonaws.regions.*;
import com.amazonaws.services.vpclattice.model.*;
/**
* Interface for accessing Amazon VPC Lattice.
*
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
* {@link com.amazonaws.services.vpclattice.AbstractAmazonVPCLattice} instead.
*
*
*
* Amazon VPC Lattice is a fully managed application networking service that you use to connect, secure, and monitor all
* of your services across multiple accounts and virtual private clouds (VPCs). Amazon VPC Lattice interconnects your
* microservices and legacy services within a logical boundary, so that you can discover and manage them more
* efficiently. For more information, see the Amazon VPC
* Lattice User Guide
*
*/
@Generated("com.amazonaws:aws-java-sdk-code-generator")
public interface AmazonVPCLattice {
/**
* The region metadata service name for computing region endpoints. You can use this value to retrieve metadata
* (such as supported regions) of the service.
*
* @see RegionUtils#getRegionsForService(String)
*/
String ENDPOINT_PREFIX = "vpc-lattice";
/**
*
* Updates the listener rules in a batch. You can use this operation to change the priority of listener rules. This
* can be useful when bulk updating or swapping rule priority.
*
*
* Required permissions: vpc-lattice:UpdateRule
*
*
* For more information, see How Amazon VPC
* Lattice works with IAM in the Amazon VPC Lattice User Guide.
*
*
* @param batchUpdateRuleRequest
* @return Result of the BatchUpdateRule operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.BatchUpdateRule
* @see AWS
* API Documentation
*/
BatchUpdateRuleResult batchUpdateRule(BatchUpdateRuleRequest batchUpdateRuleRequest);
/**
*
* Enables access logs to be sent to Amazon CloudWatch, Amazon S3, and Amazon Kinesis Data Firehose. The service
* network owner can use the access logs to audit the services in the network. The service network owner can only
* see access logs from clients and services that are associated with their service network. Access log entries
* represent traffic originated from VPCs associated with that network. For more information, see Access logs in the
* Amazon VPC Lattice User Guide.
*
*
* @param createAccessLogSubscriptionRequest
* @return Result of the CreateAccessLogSubscription operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateAccessLogSubscription
* @see AWS API Documentation
*/
CreateAccessLogSubscriptionResult createAccessLogSubscription(CreateAccessLogSubscriptionRequest createAccessLogSubscriptionRequest);
/**
*
* Creates a listener for a service. Before you start using your Amazon VPC Lattice service, you must add one or
* more listeners. A listener is a process that checks for connection requests to your services. For more
* information, see Listeners in the
* Amazon VPC Lattice User Guide.
*
*
* @param createListenerRequest
* @return Result of the CreateListener operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateListener
* @see AWS API
* Documentation
*/
CreateListenerResult createListener(CreateListenerRequest createListenerRequest);
/**
*
* Creates a listener rule. Each listener has a default rule for checking connection requests, but you can define
* additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. For more
* information, see Listener rules in the
* Amazon VPC Lattice User Guide.
*
*
* @param createRuleRequest
* @return Result of the CreateRule operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateRule
* @see AWS API
* Documentation
*/
CreateRuleResult createRule(CreateRuleRequest createRuleRequest);
/**
*
* Creates a service. A service is any software application that can run on instances containers, or serverless
* functions within an account or virtual private cloud (VPC).
*
*
* For more information, see Services
* in the Amazon VPC Lattice User Guide.
*
*
* @param createServiceRequest
* @return Result of the CreateService operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateService
* @see AWS API
* Documentation
*/
CreateServiceResult createService(CreateServiceRequest createServiceRequest);
/**
*
* Creates a service network. A service network is a logical boundary for a collection of services. You can
* associate services and VPCs with a service network.
*
*
* For more information, see Service networks in the
* Amazon VPC Lattice User Guide.
*
*
* @param createServiceNetworkRequest
* @return Result of the CreateServiceNetwork operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateServiceNetwork
* @see AWS API Documentation
*/
CreateServiceNetworkResult createServiceNetwork(CreateServiceNetworkRequest createServiceNetworkRequest);
/**
*
* Associates a service with a service network. For more information, see Manage service associations in the Amazon VPC Lattice User Guide.
*
*
* You can't use this operation if the service and service network are already associated or if there is a
* disassociation or deletion in progress. If the association fails, you can retry the operation by deleting the
* association and recreating it.
*
*
* You cannot associate a service and service network that are shared with a caller. The caller must own either the
* service or the service network.
*
*
* As a result of this operation, the association is created in the service network account and the association
* owner account.
*
*
* @param createServiceNetworkServiceAssociationRequest
* @return Result of the CreateServiceNetworkServiceAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateServiceNetworkServiceAssociation
* @see AWS API Documentation
*/
CreateServiceNetworkServiceAssociationResult createServiceNetworkServiceAssociation(
CreateServiceNetworkServiceAssociationRequest createServiceNetworkServiceAssociationRequest);
/**
*
* Associates a VPC with a service network. When you associate a VPC with the service network, it enables all the
* resources within that VPC to be clients and communicate with other services in the service network. For more
* information, see Manage VPC associations in the Amazon VPC Lattice User Guide.
*
*
* You can't use this operation if there is a disassociation in progress. If the association fails, retry by
* deleting the association and recreating it.
*
*
* As a result of this operation, the association gets created in the service network account and the VPC owner
* account.
*
*
* If you add a security group to the service network and VPC association, the association must continue to always
* have at least one security group. You can add or edit security groups at any time. However, to remove all
* security groups, you must first delete the association and recreate it without security groups.
*
*
* @param createServiceNetworkVpcAssociationRequest
* @return Result of the CreateServiceNetworkVpcAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateServiceNetworkVpcAssociation
* @see AWS API Documentation
*/
CreateServiceNetworkVpcAssociationResult createServiceNetworkVpcAssociation(
CreateServiceNetworkVpcAssociationRequest createServiceNetworkVpcAssociationRequest);
/**
*
* Creates a target group. A target group is a collection of targets, or compute resources, that run your
* application or service. A target group can only be used by a single service.
*
*
* For more information, see Target
* groups in the Amazon VPC Lattice User Guide.
*
*
* @param createTargetGroupRequest
* @return Result of the CreateTargetGroup operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.CreateTargetGroup
* @see AWS
* API Documentation
*/
CreateTargetGroupResult createTargetGroup(CreateTargetGroupRequest createTargetGroupRequest);
/**
*
* Deletes the specified access log subscription.
*
*
* @param deleteAccessLogSubscriptionRequest
* @return Result of the DeleteAccessLogSubscription operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteAccessLogSubscription
* @see AWS API Documentation
*/
DeleteAccessLogSubscriptionResult deleteAccessLogSubscription(DeleteAccessLogSubscriptionRequest deleteAccessLogSubscriptionRequest);
/**
*
* Deletes the specified auth policy. If an auth is set to AWS_IAM and the auth policy is deleted, all
* requests are denied. If you are trying to remove the auth policy completely, you must set the auth type to
* NONE. If auth is enabled on the resource, but no auth policy is set, all requests are denied.
*
*
* @param deleteAuthPolicyRequest
* @return Result of the DeleteAuthPolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteAuthPolicy
* @see AWS
* API Documentation
*/
DeleteAuthPolicyResult deleteAuthPolicy(DeleteAuthPolicyRequest deleteAuthPolicyRequest);
/**
*
* Deletes the specified listener.
*
*
* @param deleteListenerRequest
* @return Result of the DeleteListener operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteListener
* @see AWS API
* Documentation
*/
DeleteListenerResult deleteListener(DeleteListenerRequest deleteListenerRequest);
/**
*
* Deletes the specified resource policy.
*
*
* @param deleteResourcePolicyRequest
* @return Result of the DeleteResourcePolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteResourcePolicy
* @see AWS API Documentation
*/
DeleteResourcePolicyResult deleteResourcePolicy(DeleteResourcePolicyRequest deleteResourcePolicyRequest);
/**
*
* Deletes a listener rule. Each listener has a default rule for checking connection requests, but you can define
* additional rules. Each rule consists of a priority, one or more actions, and one or more conditions. You can
* delete additional listener rules, but you cannot delete the default rule.
*
*
* For more information, see Listener rules in the
* Amazon VPC Lattice User Guide.
*
*
* @param deleteRuleRequest
* @return Result of the DeleteRule operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteRule
* @see AWS API
* Documentation
*/
DeleteRuleResult deleteRule(DeleteRuleRequest deleteRuleRequest);
/**
*
* Deletes a service. A service can't be deleted if it's associated with a service network. If you delete a service,
* all resources related to the service, such as the resource policy, auth policy, listeners, listener rules, and
* access log subscriptions, are also deleted. For more information, see Delete a service in the
* Amazon VPC Lattice User Guide.
*
*
* @param deleteServiceRequest
* @return Result of the DeleteService operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteService
* @see AWS API
* Documentation
*/
DeleteServiceResult deleteService(DeleteServiceRequest deleteServiceRequest);
/**
*
* Deletes a service network. You can only delete the service network if there is no service or VPC associated with
* it. If you delete a service network, all resources related to the service network, such as the resource policy,
* auth policy, and access log subscriptions, are also deleted. For more information, see Delete a
* service network in the Amazon VPC Lattice User Guide.
*
*
* @param deleteServiceNetworkRequest
* @return Result of the DeleteServiceNetwork operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteServiceNetwork
* @see AWS API Documentation
*/
DeleteServiceNetworkResult deleteServiceNetwork(DeleteServiceNetworkRequest deleteServiceNetworkRequest);
/**
*
* Deletes the association between a specified service and the specific service network. This operation fails if an
* association is still in progress.
*
*
* @param deleteServiceNetworkServiceAssociationRequest
* @return Result of the DeleteServiceNetworkServiceAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteServiceNetworkServiceAssociation
* @see AWS API Documentation
*/
DeleteServiceNetworkServiceAssociationResult deleteServiceNetworkServiceAssociation(
DeleteServiceNetworkServiceAssociationRequest deleteServiceNetworkServiceAssociationRequest);
/**
*
* Disassociates the VPC from the service network. You can't disassociate the VPC if there is a create or update
* association in progress.
*
*
* @param deleteServiceNetworkVpcAssociationRequest
* @return Result of the DeleteServiceNetworkVpcAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteServiceNetworkVpcAssociation
* @see AWS API Documentation
*/
DeleteServiceNetworkVpcAssociationResult deleteServiceNetworkVpcAssociation(
DeleteServiceNetworkVpcAssociationRequest deleteServiceNetworkVpcAssociationRequest);
/**
*
* Deletes a target group. You can't delete a target group if it is used in a listener rule or if the target group
* creation is in progress.
*
*
* @param deleteTargetGroupRequest
* @return Result of the DeleteTargetGroup operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeleteTargetGroup
* @see AWS
* API Documentation
*/
DeleteTargetGroupResult deleteTargetGroup(DeleteTargetGroupRequest deleteTargetGroupRequest);
/**
*
* Deregisters the specified targets from the specified target group.
*
*
* @param deregisterTargetsRequest
* @return Result of the DeregisterTargets operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.DeregisterTargets
* @see AWS
* API Documentation
*/
DeregisterTargetsResult deregisterTargets(DeregisterTargetsRequest deregisterTargetsRequest);
/**
*
* Retrieves information about the specified access log subscription.
*
*
* @param getAccessLogSubscriptionRequest
* @return Result of the GetAccessLogSubscription operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetAccessLogSubscription
* @see AWS API Documentation
*/
GetAccessLogSubscriptionResult getAccessLogSubscription(GetAccessLogSubscriptionRequest getAccessLogSubscriptionRequest);
/**
*
* Retrieves information about the auth policy for the specified service or service network.
*
*
* @param getAuthPolicyRequest
* @return Result of the GetAuthPolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetAuthPolicy
* @see AWS API
* Documentation
*/
GetAuthPolicyResult getAuthPolicy(GetAuthPolicyRequest getAuthPolicyRequest);
/**
*
* Retrieves information about the specified listener for the specified service.
*
*
* @param getListenerRequest
* @return Result of the GetListener operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetListener
* @see AWS API
* Documentation
*/
GetListenerResult getListener(GetListenerRequest getListenerRequest);
/**
*
* Retrieves information about the resource policy. The resource policy is an IAM policy created on behalf of the
* resource owner when they share a resource.
*
*
* @param getResourcePolicyRequest
* @return Result of the GetResourcePolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetResourcePolicy
* @see AWS
* API Documentation
*/
GetResourcePolicyResult getResourcePolicy(GetResourcePolicyRequest getResourcePolicyRequest);
/**
*
* Retrieves information about listener rules. You can also retrieve information about the default listener rule.
* For more information, see Listener rules in the
* Amazon VPC Lattice User Guide.
*
*
* @param getRuleRequest
* @return Result of the GetRule operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetRule
* @see AWS API
* Documentation
*/
GetRuleResult getRule(GetRuleRequest getRuleRequest);
/**
*
* Retrieves information about the specified service.
*
*
* @param getServiceRequest
* @return Result of the GetService operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetService
* @see AWS API
* Documentation
*/
GetServiceResult getService(GetServiceRequest getServiceRequest);
/**
*
* Retrieves information about the specified service network.
*
*
* @param getServiceNetworkRequest
* @return Result of the GetServiceNetwork operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetServiceNetwork
* @see AWS
* API Documentation
*/
GetServiceNetworkResult getServiceNetwork(GetServiceNetworkRequest getServiceNetworkRequest);
/**
*
* Retrieves information about the specified association between a service network and a service.
*
*
* @param getServiceNetworkServiceAssociationRequest
* @return Result of the GetServiceNetworkServiceAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetServiceNetworkServiceAssociation
* @see AWS API Documentation
*/
GetServiceNetworkServiceAssociationResult getServiceNetworkServiceAssociation(
GetServiceNetworkServiceAssociationRequest getServiceNetworkServiceAssociationRequest);
/**
*
* Retrieves information about the association between a service network and a VPC.
*
*
* @param getServiceNetworkVpcAssociationRequest
* @return Result of the GetServiceNetworkVpcAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetServiceNetworkVpcAssociation
* @see AWS API Documentation
*/
GetServiceNetworkVpcAssociationResult getServiceNetworkVpcAssociation(GetServiceNetworkVpcAssociationRequest getServiceNetworkVpcAssociationRequest);
/**
*
* Retrieves information about the specified target group.
*
*
* @param getTargetGroupRequest
* @return Result of the GetTargetGroup operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.GetTargetGroup
* @see AWS API
* Documentation
*/
GetTargetGroupResult getTargetGroup(GetTargetGroupRequest getTargetGroupRequest);
/**
*
* Lists all access log subscriptions for the specified service network or service.
*
*
* @param listAccessLogSubscriptionsRequest
* @return Result of the ListAccessLogSubscriptions operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListAccessLogSubscriptions
* @see AWS API Documentation
*/
ListAccessLogSubscriptionsResult listAccessLogSubscriptions(ListAccessLogSubscriptionsRequest listAccessLogSubscriptionsRequest);
/**
*
* Lists the listeners for the specified service.
*
*
* @param listListenersRequest
* @return Result of the ListListeners operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListListeners
* @see AWS API
* Documentation
*/
ListListenersResult listListeners(ListListenersRequest listListenersRequest);
/**
*
* Lists the rules for the listener.
*
*
* @param listRulesRequest
* @return Result of the ListRules operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListRules
* @see AWS API
* Documentation
*/
ListRulesResult listRules(ListRulesRequest listRulesRequest);
/**
*
* Lists the associations between the service network and the service. You can filter the list either by service or
* service network. You must provide either the service network identifier or the service identifier.
*
*
* Every association in Amazon VPC Lattice is given a unique Amazon Resource Name (ARN), such as when a service
* network is associated with a VPC or when a service is associated with a service network. If the association is
* for a resource that is shared with another account, the association includes the local account ID as the prefix
* in the ARN for each account the resource is shared with.
*
*
* @param listServiceNetworkServiceAssociationsRequest
* @return Result of the ListServiceNetworkServiceAssociations operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListServiceNetworkServiceAssociations
* @see AWS API Documentation
*/
ListServiceNetworkServiceAssociationsResult listServiceNetworkServiceAssociations(
ListServiceNetworkServiceAssociationsRequest listServiceNetworkServiceAssociationsRequest);
/**
*
* Lists the service network and VPC associations. You can filter the list either by VPC or service network. You
* must provide either the service network identifier or the VPC identifier.
*
*
* @param listServiceNetworkVpcAssociationsRequest
* @return Result of the ListServiceNetworkVpcAssociations operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListServiceNetworkVpcAssociations
* @see AWS API Documentation
*/
ListServiceNetworkVpcAssociationsResult listServiceNetworkVpcAssociations(ListServiceNetworkVpcAssociationsRequest listServiceNetworkVpcAssociationsRequest);
/**
*
* Lists the service networks owned by the caller account or shared with the caller account. Also includes the
* account ID in the ARN to show which account owns the service network.
*
*
* @param listServiceNetworksRequest
* @return Result of the ListServiceNetworks operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListServiceNetworks
* @see AWS API Documentation
*/
ListServiceNetworksResult listServiceNetworks(ListServiceNetworksRequest listServiceNetworksRequest);
/**
*
* Lists the services owned by the caller account or shared with the caller account.
*
*
* @param listServicesRequest
* @return Result of the ListServices operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListServices
* @see AWS API
* Documentation
*/
ListServicesResult listServices(ListServicesRequest listServicesRequest);
/**
*
* Lists the tags for the specified resource.
*
*
* @param listTagsForResourceRequest
* @return Result of the ListTagsForResource operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListTagsForResource
* @see AWS API Documentation
*/
ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest);
/**
*
* Lists your target groups. You can narrow your search by using the filters below in your request.
*
*
* @param listTargetGroupsRequest
* @return Result of the ListTargetGroups operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListTargetGroups
* @see AWS
* API Documentation
*/
ListTargetGroupsResult listTargetGroups(ListTargetGroupsRequest listTargetGroupsRequest);
/**
*
* Lists the targets for the target group. By default, all targets are included. You can use this API to check the
* health status of targets. You can also filter the results by target.
*
*
* @param listTargetsRequest
* @return Result of the ListTargets operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.ListTargets
* @see AWS API
* Documentation
*/
ListTargetsResult listTargets(ListTargetsRequest listTargetsRequest);
/**
*
* Creates or updates the auth policy. The policy string in JSON must not contain newlines or blank lines.
*
*
* For more information, see Auth
* policies in the Amazon VPC Lattice User Guide.
*
*
* @param putAuthPolicyRequest
* @return Result of the PutAuthPolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.PutAuthPolicy
* @see AWS API
* Documentation
*/
PutAuthPolicyResult putAuthPolicy(PutAuthPolicyRequest putAuthPolicyRequest);
/**
*
* Attaches a resource-based permission policy to a service or service network. The policy must contain the same
* actions and condition statements as the Amazon Web Services Resource Access Manager permission for sharing
* services and service networks.
*
*
* @param putResourcePolicyRequest
* @return Result of the PutResourcePolicy operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.PutResourcePolicy
* @see AWS
* API Documentation
*/
PutResourcePolicyResult putResourcePolicy(PutResourcePolicyRequest putResourcePolicyRequest);
/**
*
* Registers the targets with the target group. If it's a Lambda target, you can only have one target in a target
* group.
*
*
* @param registerTargetsRequest
* @return Result of the RegisterTargets operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws ServiceQuotaExceededException
* The request would cause a service quota to be exceeded.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.RegisterTargets
* @see AWS
* API Documentation
*/
RegisterTargetsResult registerTargets(RegisterTargetsRequest registerTargetsRequest);
/**
*
* Adds the specified tags to the specified resource.
*
*
* @param tagResourceRequest
* @return Result of the TagResource operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.TagResource
* @see AWS API
* Documentation
*/
TagResourceResult tagResource(TagResourceRequest tagResourceRequest);
/**
*
* Removes the specified tags from the specified resource.
*
*
* @param untagResourceRequest
* @return Result of the UntagResource operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UntagResource
* @see AWS API
* Documentation
*/
UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest);
/**
*
* Updates the specified access log subscription.
*
*
* @param updateAccessLogSubscriptionRequest
* @return Result of the UpdateAccessLogSubscription operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateAccessLogSubscription
* @see AWS API Documentation
*/
UpdateAccessLogSubscriptionResult updateAccessLogSubscription(UpdateAccessLogSubscriptionRequest updateAccessLogSubscriptionRequest);
/**
*
* Updates the specified listener for the specified service.
*
*
* @param updateListenerRequest
* @return Result of the UpdateListener operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateListener
* @see AWS API
* Documentation
*/
UpdateListenerResult updateListener(UpdateListenerRequest updateListenerRequest);
/**
*
* Updates a rule for the listener. You can't modify a default listener rule. To modify a default listener rule, use
* UpdateListener.
*
*
* @param updateRuleRequest
* @return Result of the UpdateRule operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateRule
* @see AWS API
* Documentation
*/
UpdateRuleResult updateRule(UpdateRuleRequest updateRuleRequest);
/**
*
* Updates the specified service.
*
*
* @param updateServiceRequest
* @return Result of the UpdateService operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateService
* @see AWS API
* Documentation
*/
UpdateServiceResult updateService(UpdateServiceRequest updateServiceRequest);
/**
*
* Updates the specified service network.
*
*
* @param updateServiceNetworkRequest
* @return Result of the UpdateServiceNetwork operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateServiceNetwork
* @see AWS API Documentation
*/
UpdateServiceNetworkResult updateServiceNetwork(UpdateServiceNetworkRequest updateServiceNetworkRequest);
/**
*
* Updates the service network and VPC association. If you add a security group to the service network and VPC
* association, the association must continue to always have at least one security group. You can add or edit
* security groups at any time. However, to remove all security groups, you must first delete the association and
* recreate it without security groups.
*
*
* @param updateServiceNetworkVpcAssociationRequest
* @return Result of the UpdateServiceNetworkVpcAssociation operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateServiceNetworkVpcAssociation
* @see AWS API Documentation
*/
UpdateServiceNetworkVpcAssociationResult updateServiceNetworkVpcAssociation(
UpdateServiceNetworkVpcAssociationRequest updateServiceNetworkVpcAssociationRequest);
/**
*
* Updates the specified target group.
*
*
* @param updateTargetGroupRequest
* @return Result of the UpdateTargetGroup operation returned by the service.
* @throws ValidationException
* The input does not satisfy the constraints specified by an Amazon Web Services service.
* @throws AccessDeniedException
* The user does not have sufficient access to perform this action.
* @throws ThrottlingException
* The limit on the number of requests per second was exceeded.
* @throws ResourceNotFoundException
* The request references a resource that does not exist.
* @throws ConflictException
* The request conflicts with the current state of the resource. Updating or deleting a resource can cause
* an inconsistent state.
* @throws InternalServerException
* An unexpected error occurred while processing the request.
* @sample AmazonVPCLattice.UpdateTargetGroup
* @see AWS
* API Documentation
*/
UpdateTargetGroupResult updateTargetGroup(UpdateTargetGroupRequest updateTargetGroupRequest);
/**
* Shuts down this client object, releasing any resources that might be held open. This is an optional method, and
* callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client
* has been shutdown, it should not be used to make any more requests.
*/
void shutdown();
/**
* Returns additional metadata for a previously executed successful request, typically used for debugging issues
* where a service isn't acting as expected. This data isn't considered part of the result data returned by an
* operation, so it's available through this separate, diagnostic interface.
*
* Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic
* information for an executed request, you should use this method to retrieve it as soon as possible after
* executing a request.
*
* @param request
* The originally executed request.
*
* @return The response metadata for the specified request, or null if none is available.
*/
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request);
}