create_proposal ¶

def create_proposal(
    self,
    client_request_token: "capo_managedblockchain.types.client_request_token_string.ClientRequestTokenString",
    network_id: "capo_managedblockchain.types.resource_id_string.ResourceIdString",
    member_id: "capo_managedblockchain.types.resource_id_string.ResourceIdString",
    actions: "capo_managedblockchain.types.proposal_actions.ProposalActions",
    *,
    config_overrides: Optional[ManagedBlockchainClientConfig] = None,
    description: Optional[
        "capo_managedblockchain.types.description_string.DescriptionString"
    ] = None,
    tags: Optional["capo_managedblockchain.types.input_tag_map.InputTagMap"] = None,
) -> "capo_managedblockchain.types.create_proposal_output.CreateProposalOutput":
    """<p>Creates a proposal for a change to the network that other members of the network can vote on, for example, a proposal to add a new member to the network. Any member can create a proposal.</p> <p>Applies only to Hyperledger Fabric.</p>

    Args:
        client_request_token: <p>A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than one time. This identifier is required only if you make a service request directly using an HTTP client. It is generated automatically if you use an Amazon Web Services SDK or the CLI.</p>
        network_id: <p> The unique identifier of the network for which the proposal is made.</p>
        member_id: <p>The unique identifier of the member that is creating the proposal. This identifier is especially useful for identifying the member making the proposal when multiple members exist in a single Amazon Web Services account.</p>
        actions: <p>The type of actions proposed, such as inviting a member or removing a member. The types of <code>Actions</code> in a proposal are mutually exclusive. For example, a proposal with <code>Invitations</code> actions cannot also contain <code>Removals</code> actions.</p>
        description: <p>A description for the proposal that is visible to voting members, for example, "Proposal to add Example Corp. as member."</p>
        tags: <p>Tags to assign to the proposal.</p> <p> Each tag consists of a key and an optional value. You can specify multiple key-value pairs in a single request with an overall maximum of 50 tags allowed per resource.</p> <p>For more information about tags, see <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ethereum-dev/tagging-resources.html">Tagging Resources</a> in the <i>Amazon Managed Blockchain Ethereum Developer Guide</i>, or <a href="https://docs.aws.amazon.com/managed-blockchain/latest/hyperledger-fabric-dev/tagging-resources.html">Tagging Resources</a> in the <i>Amazon Managed Blockchain Hyperledger Fabric Developer Guide</i>.</p>

    Raises:
        capo_managedblockchain.errors.access_denied_exception.AccessDeniedException: <p>You don't have sufficient access to perform this action.</p>
        capo_managedblockchain.errors.internal_service_error_exception.InternalServiceErrorException: <p>The request processing has failed because of an unknown error, exception or failure.</p>
        capo_managedblockchain.errors.invalid_request_exception.InvalidRequestException: <p>The action or operation requested is invalid. Verify that the action is typed correctly.</p>
        capo_managedblockchain.errors.resource_not_found_exception.ResourceNotFoundException: <p>A requested resource doesn't exist. It may have been deleted or referenced incorrectly.</p>
        capo_managedblockchain.errors.resource_not_ready_exception.ResourceNotReadyException: <p>The requested resource exists but isn't in a status that can complete the operation.</p>
        capo_managedblockchain.errors.throttling_exception.ThrottlingException: <p>The request or operation couldn't be performed because a service is throttling requests. The most common source of throttling errors is creating resources that exceed your service limit for this resource type. Request a limit increase or delete unused resources if possible.</p>
        capo_managedblockchain.errors.too_many_tags_exception.TooManyTagsException: <p></p>
        capo_managedblockchain.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_managedblockchain.types.create_proposal_input.CreateProposalInput]",
    ) -> OperationResponse[
        "capo_managedblockchain.types.create_proposal_output.CreateProposalOutput"
    ]:
        import capo_managedblockchain._operations.taiga_web_service.create_proposal

        output, http_response = (
            capo_managedblockchain._operations.taiga_web_service.create_proposal.create_proposal(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateProposal")
    )
    input_: capo_managedblockchain.types.create_proposal_input.CreateProposalInput = {
        "client_request_token": client_request_token,
        "network_id": network_id,
        "member_id": member_id,
        "actions": actions,
    }
    if description is not None:
        input_["description"] = description
    if tags is not None:
        input_["tags"] = tags

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