EC2 / Client / delete_secondary_network

delete_secondary_network¶

EC2.Client.delete_secondary_network(**kwargs)¶

Deletes a secondary network. You must delete all secondary subnets in the secondary network before you can delete the secondary network.

Request Syntax

response = client.delete_secondary_network(
    ClientToken='string',
    DryRun=True|False,
    SecondaryNetworkId='string'
)

Parameters:

ClientToken (string) –
Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see Ensure Idempotency.

This field is autopopulated if not provided.
DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
SecondaryNetworkId (string) –
[REQUIRED]

The ID of the secondary network.

Return type:

dict

Returns:

Response Syntax

{
    'SecondaryNetwork': {
        'SecondaryNetworkId': 'string',
        'SecondaryNetworkArn': 'string',
        'OwnerId': 'string',
        'Type': 'rdma',
        'State': 'create-in-progress'|'create-complete'|'create-failed'|'delete-in-progress'|'delete-complete'|'delete-failed',
        'StateReason': 'string',
        'Ipv4CidrBlockAssociations': [
            {
                'AssociationId': 'string',
                'CidrBlock': 'string',
                'State': 'associating'|'associated'|'association-failed'|'disassociating'|'disassociated'|'disassociation-failed',
                'StateReason': 'string'
            },
        ],
        'Tags': [
            {
                'Key': 'string',
                'Value': 'string'
            },
        ]
    },
    'ClientToken': 'string'
}

Response Structure

(dict) –
- SecondaryNetwork (dict) –
  
  Information about the secondary network.
  - SecondaryNetworkId (string) –
    
    The ID of the secondary network.
  - SecondaryNetworkArn (string) –
    
    The Amazon Resource Name (ARN) of the secondary network.
  - OwnerId (string) –
    
    The ID of the Amazon Web Services account that owns the secondary network.
  - Type (string) –
    
    The type of the secondary network.
  - State (string) –
    
    The state of the secondary network.
  - StateReason (string) –
    
    The reason for the current state of the secondary network.
  - Ipv4CidrBlockAssociations (list) –
    
    Information about the IPv4 CIDR blocks associated with the secondary network.
    - (dict) –
      
      Describes an IPv4 CIDR block associated with a secondary network.
      - AssociationId (string) –
        
        The association ID for the IPv4 CIDR block.
      - CidrBlock (string) –
        
        The IPv4 CIDR block.
      - State (string) –
        
        The state of the CIDR block association.
      - StateReason (string) –
        
        The reason for the current state of the CIDR block association.
  - Tags (list) –
    
    The tags assigned to the secondary network.
    - (dict) –
      
      Describes a tag.
      - Key (string) –
        
        The key of the tag.
        
        Constraints: Tag keys are case-sensitive and accept a maximum of 127 Unicode characters. May not begin with aws:.
      - Value (string) –
        
        The value of the tag.
        
        Constraints: Tag values are case-sensitive and accept a maximum of 256 Unicode characters.
- ClientToken (string) –
  
  Unique, case-sensitive identifier to ensure the idempotency of the request. Only returned if a client token was provided in the request.