Retrieves the current configuration, state, and metadata of a network connector. The Identifier parameter accepts the connector ID, name, or full ARN. Use this operation to poll connector state after creation or update, or to inspect the current VPC configuration and any failure reasons.
The response includes the full connector configuration, current state, and — if the connector has been updated — the LastUpdateStatus and LastUpdateStatusReasonCode fields that indicate whether the most recent update succeeded or failed.
Parameters:
-
identifier
(NetworkConnectorIdentifier)
–
The identifier of the network connector to retrieve. You can specify the connector ID, name, or ARN. Provide an unqualified ARN (or an ID or name) to retrieve the connector's latest version, or a version-qualified ARN — one that includes the immutable version suffix — to retrieve a specific historical version.
Raises:
-
InvalidParameterValueException
–
One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.
-
ResourceNotFoundException
–
The specified network connector does not exist. Verify the identifier (ID, name, or ARN) and Region.
-
ServiceException
–
An internal service error occurred. Retry the request with exponential backoff.
-
TooManyRequestsException
–
The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.
-
UnknownServiceError
–
The service returned an error code this client does not model.
Source code in docs_src/capo_lambda_core/_services/lambda_core.py
| def get_network_connector(
self,
identifier: "capo_lambda_core.types.network_connector_identifier.NetworkConnectorIdentifier",
*,
config_overrides: Optional[LambdaCoreClientConfig] = None,
) -> "capo_lambda_core.types.get_network_connector_response.GetNetworkConnectorResponse":
"""<p>Retrieves the current configuration, state, and metadata of a network connector. The <code>Identifier</code> parameter accepts the connector ID, name, or full ARN. Use this operation to poll connector state after creation or update, or to inspect the current VPC configuration and any failure reasons.</p> <p>The response includes the full connector configuration, current state, and — if the connector has been updated — the <code>LastUpdateStatus</code> and <code>LastUpdateStatusReasonCode</code> fields that indicate whether the most recent update succeeded or failed.</p>
Args:
identifier: <p>The identifier of the network connector to retrieve. You can specify the connector ID, name, or ARN. Provide an unqualified ARN (or an ID or name) to retrieve the connector's latest version, or a version-qualified ARN — one that includes the immutable version suffix — to retrieve a specific historical version.</p>
Raises:
capo_lambda_core.errors.invalid_parameter_value_exception.InvalidParameterValueException: <p>One of the parameters in the request is not valid. Check the error message for details about which parameter failed validation.</p>
capo_lambda_core.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified network connector does not exist. Verify the identifier (ID, name, or ARN) and Region.</p>
capo_lambda_core.errors.service_exception.ServiceException: <p>An internal service error occurred. Retry the request with exponential backoff.</p>
capo_lambda_core.errors.too_many_requests_exception.TooManyRequestsException: <p>The request was throttled due to exceeding the allowed request rate. Retry the request after a brief wait using exponential backoff.</p>
capo_lambda_core.errors.UnknownServiceError: The service returned an error code this client does not model.
"""
def _handler(
req: "OperationRequest[capo_lambda_core.types.get_network_connector_request.GetNetworkConnectorRequest]",
) -> OperationResponse[
"capo_lambda_core.types.get_network_connector_response.GetNetworkConnectorResponse"
]:
import capo_lambda_core._operations.lambda_core_api_service.get_network_connector
output, http_response = (
capo_lambda_core._operations.lambda_core_api_service.get_network_connector.get_network_connector(
req.options, req.input
)
)
return OperationResponse(output=output, response=http_response)
interceptors_, options_ = self.operation_options(
config_overrides, OperationLogging("GetNetworkConnector")
)
input_: capo_lambda_core.types.get_network_connector_request.GetNetworkConnectorRequest = {
"identifier": identifier
}
response = execute_pipeline(
OperationRequest(input=input_, options=options_),
handler=_handler,
interceptors=list(interceptors_),
)
response.response.close()
return response.output
|