get_ipam_address_history

EC2.Client.get_ipam_address_history(**kwargs)

Retrieve historical information about a CIDR within an IPAM scope. For more information, see View the history of IP addresses in the Amazon VPC IPAM User Guide .

See also: AWS API Documentation

Request Syntax

response = client.get_ipam_address_history(
    DryRun=True|False,
    Cidr='string',
    IpamScopeId='string',
    VpcId='string',
    StartTime=datetime(2015, 1, 1),
    EndTime=datetime(2015, 1, 1),
    MaxResults=123,
    NextToken='string'
)
Parameters
  • DryRun (boolean) -- A check for 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 .
  • Cidr (string) --

    [REQUIRED]

    The CIDR you want the history of. The CIDR can be an IPv4 or IPv6 IP address range. If you enter a /16 IPv4 CIDR, you will get records that match it exactly. You will not get records for any subnets within the /16 CIDR.

  • IpamScopeId (string) --

    [REQUIRED]

    The ID of the IPAM scope that the CIDR is in.

  • VpcId (string) -- The ID of the VPC you want your history records filtered by.
  • StartTime (datetime) -- The start of the time period for which you are looking for history. If you omit this option, it will default to the value of EndTime.
  • EndTime (datetime) -- The end of the time period for which you are looking for history. If you omit this option, it will default to the current time.
  • MaxResults (integer) -- The maximum number of historical results you would like returned per page. Defaults to 100.
  • NextToken (string) -- The token for the next page of results.
Return type

dict

Returns

Response Syntax

{
    'HistoryRecords': [
        {
            'ResourceOwnerId': 'string',
            'ResourceRegion': 'string',
            'ResourceType': 'eip'|'vpc'|'subnet'|'network-interface'|'instance',
            'ResourceId': 'string',
            'ResourceCidr': 'string',
            'ResourceName': 'string',
            'ResourceComplianceStatus': 'compliant'|'noncompliant'|'unmanaged'|'ignored',
            'ResourceOverlapStatus': 'overlapping'|'nonoverlapping'|'ignored',
            'VpcId': 'string',
            'SampledStartTime': datetime(2015, 1, 1),
            'SampledEndTime': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • HistoryRecords (list) --

      A historical record for a CIDR within an IPAM scope. If the CIDR is associated with an EC2 instance, you will see an object in the response for the instance and one for the network interface.

      • (dict) --

        The historical record of a CIDR within an IPAM scope. For more information, see View the history of IP addresses in the Amazon VPC IPAM User Guide .

        • ResourceOwnerId (string) --

          The ID of the resource owner.

        • ResourceRegion (string) --

          The Amazon Web Services Region of the resource.

        • ResourceType (string) --

          The type of the resource.

        • ResourceId (string) --

          The ID of the resource.

        • ResourceCidr (string) --

          The CIDR of the resource.

        • ResourceName (string) --

          The name of the resource.

        • ResourceComplianceStatus (string) --

          The compliance status of a resource. For more information on compliance statuses, see Monitor CIDR usage by resource in the Amazon VPC IPAM User Guide .

        • ResourceOverlapStatus (string) --

          The overlap status of an IPAM resource. The overlap status tells you if the CIDR for a resource overlaps with another CIDR in the scope. For more information on overlap statuses, see Monitor CIDR usage by resource in the Amazon VPC IPAM User Guide .

        • VpcId (string) --

          The VPC ID of the resource.

        • SampledStartTime (datetime) --

          Sampled start time of the resource-to-CIDR association within the IPAM scope. Changes are picked up in periodic snapshots, so the start time may have occurred before this specific time.

        • SampledEndTime (datetime) --

          Sampled end time of the resource-to-CIDR association within the IPAM scope. Changes are picked up in periodic snapshots, so the end time may have occurred before this specific time.

    • NextToken (string) --

      The token to use to retrieve the next page of results. This value is null when there are no more results to return.