LambdaCore / Client / list_network_connector_versions

list_network_connector_versions

LambdaCore.Client.list_network_connector_versions(**kwargs)

Returns a paginated list of the versions of a network connector. Each configuration update creates a new immutable version; this operation lists those versions for the connector you specify. You can optionally filter results by version state. Use the Marker parameter from a previous response to retrieve the next page of results.

Each item in the response includes the version-qualified ARN, version number, current state, and last modified timestamp for that version. To retrieve the current (latest) configuration of the connector, use GetNetworkConnector; to inspect a specific version, call GetNetworkConnector with a version-qualified identifier.

See also: AWS API Documentation

Request Syntax

response = client.list_network_connector_versions(
    Identifier='string',
    State='PENDING'|'ACTIVE'|'INACTIVE'|'FAILED'|'DELETING'|'DELETE_FAILED',
    Marker='string',
    MaxItems=123
)
Parameters:

  • Identifier (string) –

    [REQUIRED]

    The identifier of the network connector whose versions you want to list. You can specify the connector ID, name, or full ARN. Specify an unqualified identifier — this operation lists all versions of the connector, not a specific version.

  • State (string) – Optional filter to return only versions in the specified state (for example, ACTIVE or FAILED).

  • Marker (string) – The pagination token from a previous ListNetworkConnectorVersions response. Use this value to retrieve the next page of results.

  • MaxItems (integer) – The maximum number of versions to return per page. Valid range: 1 to 100.

Return type:

dict

Returns:

Response Syntax

{
    'NetworkConnectorVersions': [
        {
            'Arn': 'string',
            'VersionArn': 'string',
            'Name': 'string',
            'Id': 'string',
            'Version': 123,
            'State': 'PENDING'|'ACTIVE'|'INACTIVE'|'FAILED'|'DELETING'|'DELETE_FAILED',
            'StateReason': 'string',
            'StateReasonCode': 'DisallowedByVpcEncryptionControl'|'Ec2RequestLimitExceeded'|'InsufficientRolePermissions'|'InternalError'|'InvalidSecurityGroup'|'InvalidSubnet'|'SecurityGroupsPerInterfaceLimitExceeded'|'SubnetOutOfIPAddresses',
            'LastModified': datetime(2015, 1, 1)
        },
    ],
    'NextMarker': 'string'
}

Response Structure

  • (dict) –

    • NetworkConnectorVersions (list) –

      A list of connector version summaries for the current page of results.

      • (dict) –

        Summary information about a single version of a network connector returned by ListNetworkConnectorVersions. Each configuration update creates a new immutable version; this shape describes one such version. To retrieve the full configuration of a version, call GetNetworkConnector with a version-qualified identifier.

        • Arn (string) –

          The unqualified ARN of the network connector that this version belongs to.

        • VersionArn (string) –

          The qualified ARN of this connector version, including the immutable version suffix.

        • Name (string) –

          The name of the network connector.

        • Id (string) –

          The unique identifier of the network connector.

        • Version (integer) –

          The version number of this connector version.

        • State (string) –

          The current state of this connector version.

        • StateReason (string) –

          A human-readable explanation of the current state, populated when the state is FAILED.

        • StateReasonCode (string) –

          A machine-readable code indicating the reason for the current state. Use this for programmatic error handling.

        • LastModified (datetime) –

          The date and time when this connector version was last modified.

    • NextMarker (string) –

      The pagination token to include in a subsequent request to retrieve the next page. This value is null when there are no more results.

Exceptions