Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

ListNetworkConnectorVersions

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.

Request Syntax


GET /2026-04-04/network-connectors/Identifier/versions?Marker=Marker&MaxItems=MaxItems&State=State HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

Identifier

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.

Length Constraints: Minimum length of 1. Maximum length of 140.

Required: Yes

Marker

The pagination token from a previous ListNetworkConnectorVersions response. Use this value to retrieve the next page of results.

MaxItems

The maximum number of versions to return per page. Valid range: 1 to 100.

Valid Range: Minimum value of 1. Maximum value of 100.

State

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

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "NetworkConnectorVersions": [ 
      { 
         "Arn": "string",
         "Id": "string",
         "LastModified": "string",
         "Name": "string",
         "State": "string",
         "StateReason": "string",
         "StateReasonCode": "string",
         "Version": number,
         "VersionArn": "string"
      }
   ],
   "NextMarker": "string"
}

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

NetworkConnectorVersions

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

Type: Array of NetworkConnectorVersionSummary objects

Array Members: Minimum number of 0 items. Maximum number of 100 items.

NextMarker

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

Type: String

Errors

For information about the errors that are common to all actions, see Common Error Types.

InvalidParameterValueException

One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.

Type: The exception type.

HTTP Status Code: 400

ResourceNotFoundException

The specified network connector does not exist. Verify the identifier (ID, name, or ARN) and Region.

Type: The exception type.

HTTP Status Code: 404

ServiceException

An internal service error occurred. Retry the request with exponential backoff.

Type: The exception type.

HTTP Status Code: 500

TooManyRequestsException

The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.

Reason: The reason for the throttling.
retryAfterSeconds: The number of seconds to wait before retrying the request.
Type: The exception type.

HTTP Status Code: 429