VPCLattice / Client / deregister_targets

deregister_targets#

VPCLattice.Client.deregister_targets(**kwargs)#

Deregisters the specified targets from the specified target group.

Request Syntax

response = client.deregister_targets(
    targetGroupIdentifier='string',
    targets=[
        {
            'id': 'string',
            'port': 123
        },
    ]
)

Parameters:

targetGroupIdentifier (string) –
[REQUIRED]

The ID or Amazon Resource Name (ARN) of the target group.
targets (list) –
[REQUIRED]

The targets to deregister.
- (dict) –
  
  Describes a target.
  - id (string) – [REQUIRED]
    
    The ID of the target. If the target group type is INSTANCE, this is an instance ID. If the target group type is IP, this is an IP address. If the target group type is LAMBDA, this is the ARN of a Lambda function. If the target group type is ALB, this is the ARN of an Application Load Balancer.
  - port (integer) –
    
    The port on which the target is listening. For HTTP, the default is 80. For HTTPS, the default is 443.

Return type:

dict

Returns:

Response Syntax

{
    'successful': [
        {
            'id': 'string',
            'port': 123
        },
    ],
    'unsuccessful': [
        {
            'failureCode': 'string',
            'failureMessage': 'string',
            'id': 'string',
            'port': 123
        },
    ]
}

Response Structure

(dict) –
- successful (list) –
  
  The targets that were successfully deregistered.
  - (dict) –
    
    Describes a target.
    - id (string) –
      
      The ID of the target. If the target group type is INSTANCE, this is an instance ID. If the target group type is IP, this is an IP address. If the target group type is LAMBDA, this is the ARN of a Lambda function. If the target group type is ALB, this is the ARN of an Application Load Balancer.
    - port (integer) –
      
      The port on which the target is listening. For HTTP, the default is 80. For HTTPS, the default is 443.
- unsuccessful (list) –
  
  The targets that the operation couldn’t deregister.
  - (dict) –
    
    Describes a target failure.
    - failureCode (string) –
      
      The failure code.
    - failureMessage (string) –
      
      The failure message.
    - id (string) –
      
      The ID of the target. If the target group type is INSTANCE, this is an instance ID. If the target group type is IP, this is an IP address. If the target group type is LAMBDA, this is the ARN of a Lambda function. If the target group type is ALB, this is the ARN of an Application Load Balancer.
    - port (integer) –
      
      The port on which the target is listening. This parameter doesn’t apply if the target is a Lambda function.

Exceptions

VPCLattice.Client.exceptions.ValidationException
VPCLattice.Client.exceptions.AccessDeniedException
VPCLattice.Client.exceptions.ThrottlingException
VPCLattice.Client.exceptions.ResourceNotFoundException
VPCLattice.Client.exceptions.ConflictException
VPCLattice.Client.exceptions.InternalServerException