create_traffic_policy_version ¶

create_traffic_policy_version(
    id: TrafficPolicyId,
    document: TrafficPolicyDocument,
    *,
    config_overrides: Optional[Route53ClientConfig] = None,
    comment: Optional[TrafficPolicyComment] = None,
) -> CreateTrafficPolicyVersionResponse

Creates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic policy.

Parameters:

id (TrafficPolicyId) –

The ID of the traffic policy for which you want to create a new version.
document (TrafficPolicyDocument) –

The definition of this version of the traffic policy, in JSON format. You specified the JSON in the CreateTrafficPolicyVersion request. For more information about the JSON format, see CreateTrafficPolicy.
comment (Optional[TrafficPolicyComment], default: None ) –

The comment that you specified in the CreateTrafficPolicyVersion request, if any.

Raises:

ConcurrentModification –

Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request.
InvalidInput –

The input is not valid.
InvalidTrafficPolicyDocument –

The format of the traffic policy document that you specified in the Document element is not valid.
NoSuchTrafficPolicy –

No traffic policy exists with the specified ID.
TooManyTrafficPolicyVersionsForCurrentPolicy –

This traffic policy version can't be created because you've reached the limit of 1000 on the number of versions that you can create for the current traffic policy.

To create more traffic policy versions, you can use GetTrafficPolicy to get the traffic policy document for a specified traffic policy version, and then use CreateTrafficPolicy to create a new traffic policy using the traffic policy document.
UnknownServiceError –

The service returned an error code this client does not model.

Source code in docs_src/capo_route_53/_services/route53.py

def create_traffic_policy_version(
    self,
    id: "capo_route_53.types.traffic_policy_id.TrafficPolicyId",
    document: "capo_route_53.types.traffic_policy_document.TrafficPolicyDocument",
    *,
    config_overrides: Optional[Route53ClientConfig] = None,
    comment: Optional[
        "capo_route_53.types.traffic_policy_comment.TrafficPolicyComment"
    ] = None,
) -> "capo_route_53.types.create_traffic_policy_version_response.CreateTrafficPolicyVersionResponse":
    """<p>Creates a new version of an existing traffic policy. When you create a new version of a traffic policy, you specify the ID of the traffic policy that you want to update and a JSON-formatted document that describes the new version. You use traffic policies to create multiple DNS resource record sets for one domain name (such as example.com) or one subdomain name (such as www.example.com). You can create a maximum of 1000 versions of a traffic policy. If you reach the limit and need to create another version, you'll need to start a new traffic policy.</p>

    Args:
        id: <p>The ID of the traffic policy for which you want to create a new version.</p>
        document: <p>The definition of this version of the traffic policy, in JSON format. You specified the JSON in the <code>CreateTrafficPolicyVersion</code> request. For more information about the JSON format, see <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicy.html">CreateTrafficPolicy</a>.</p>
        comment: <p>The comment that you specified in the <code>CreateTrafficPolicyVersion</code> request, if any.</p>

    Raises:
        capo_route_53.errors.concurrent_modification.ConcurrentModification: <p>Another user submitted a request to create, update, or delete the object at the same time that you did. Retry the request. </p>
        capo_route_53.errors.invalid_input.InvalidInput: <p>The input is not valid.</p>
        capo_route_53.errors.invalid_traffic_policy_document.InvalidTrafficPolicyDocument: <p>The format of the traffic policy document that you specified in the <code>Document</code> element is not valid.</p>
        capo_route_53.errors.no_such_traffic_policy.NoSuchTrafficPolicy: <p>No traffic policy exists with the specified ID.</p>
        capo_route_53.errors.too_many_traffic_policy_versions_for_current_policy.TooManyTrafficPolicyVersionsForCurrentPolicy: <p>This traffic policy version can't be created because you've reached the limit of 1000 on the number of versions that you can create for the current traffic policy.</p> <p>To create more traffic policy versions, you can use <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_GetTrafficPolicy.html">GetTrafficPolicy</a> to get the traffic policy document for a specified traffic policy version, and then use <a href="https://docs.aws.amazon.com/Route53/latest/APIReference/API_CreateTrafficPolicy.html">CreateTrafficPolicy</a> to create a new traffic policy using the traffic policy document.</p>
        capo_route_53.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_route_53.types.create_traffic_policy_version_request.CreateTrafficPolicyVersionRequest]",
    ) -> OperationResponse[
        "capo_route_53.types.create_traffic_policy_version_response.CreateTrafficPolicyVersionResponse"
    ]:
        import capo_route_53._operations.aws_dns_v20130401.create_traffic_policy_version

        output, http_response = (
            capo_route_53._operations.aws_dns_v20130401.create_traffic_policy_version.create_traffic_policy_version(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateTrafficPolicyVersion")
    )
    input_: capo_route_53.types.create_traffic_policy_version_request.CreateTrafficPolicyVersionRequest = {
        "id": id,
        "document": document,
    }
    if comment is not None:
        input_["comment"] = comment

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