Skip to content

retry_build

retry_build(
    *,
    config_overrides: Optional[CodeBuildClientConfig] = None,
    id: Optional[NonEmptyString] = None,
    idempotency_token: Optional[String] = None,
) -> RetryBuildOutput

Restarts a build.

Parameters:

  • id (Optional[NonEmptyString], default: None ) –

    Specifies the identifier of the build to restart.

  • idempotency_token (Optional[String], default: None ) –

    A unique, case sensitive identifier you provide to ensure the idempotency of the RetryBuild request. The token is included in the RetryBuild request and is valid for five minutes. If you repeat the RetryBuild request with the same token, but change a parameter, CodeBuild returns a parameter mismatch error.

Raises:

Source code in docs_src/capo_codebuild/_services/code_build.py
def retry_build(
    self,
    *,
    config_overrides: Optional[CodeBuildClientConfig] = None,
    id: Optional["capo_codebuild.types.non_empty_string.NonEmptyString"] = None,
    idempotency_token: Optional["capo_codebuild.types.string.String"] = None,
) -> "capo_codebuild.types.retry_build_output.RetryBuildOutput":
    """<p>Restarts a build.</p>

    Args:
        id: <p>Specifies the identifier of the build to restart.</p>
        idempotency_token: <p>A unique, case sensitive identifier you provide to ensure the idempotency of the <code>RetryBuild</code> request. The token is included in the <code>RetryBuild</code> request and is valid for five minutes. If you repeat the <code>RetryBuild</code> request with the same token, but change a parameter, CodeBuild returns a parameter mismatch error.</p>

    Raises:
        capo_codebuild.errors.account_limit_exceeded_exception.AccountLimitExceededException: <p>An Amazon Web Services service limit was exceeded for the calling Amazon Web Services account.</p>
        capo_codebuild.errors.invalid_input_exception.InvalidInputException: <p>The input value that was provided is not valid.</p>
        capo_codebuild.errors.resource_not_found_exception.ResourceNotFoundException: <p>The specified Amazon Web Services resource cannot be found.</p>
        capo_codebuild.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_codebuild.types.retry_build_input.RetryBuildInput]",
    ) -> OperationResponse[
        "capo_codebuild.types.retry_build_output.RetryBuildOutput"
    ]:
        import capo_codebuild._operations.code_build_20161006.retry_build

        output, http_response = (
            capo_codebuild._operations.code_build_20161006.retry_build.retry_build(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("RetryBuild")
    )
    input_: capo_codebuild.types.retry_build_input.RetryBuildInput = {}
    if id is not None:
        input_["id"] = id
    if idempotency_token is not None:
        input_["idempotency_token"] = idempotency_token

    response = execute_pipeline(
        OperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    response.response.close()
    return response.output