create_membership ¶

def create_membership(
    self,
    application_id: "capo_securityagent.types.application_id.ApplicationId",
    agent_space_id: "capo_securityagent.types.agent_space_id.AgentSpaceId",
    membership_id: "capo_securityagent.types.membership_id.MembershipId",
    member_type: "capo_securityagent.types.membership_type.MembershipType",
    *,
    config_overrides: Optional[SecurityAgentClientConfig] = None,
    config: Optional[
        "capo_securityagent.types.membership_config.MembershipConfig"
    ] = None,
) -> "capo_securityagent.types.create_membership_response.CreateMembershipResponse":
    """<p>Creates a new membership, granting a user access to an agent space within an application.</p>

    Args:
        application_id: <p>The unique identifier of the application that contains the agent space.</p>
        agent_space_id: <p>The unique identifier of the agent space to grant access to.</p>
        membership_id: <p>The unique identifier for the membership.</p>
        member_type: <p>The type of member. Currently, only USER is supported.</p>
        config: <p>The configuration for the membership, such as the user role.</p>

    Raises:
        capo_securityagent.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    def _handler(
        req: "OperationRequest[capo_securityagent.types.create_membership_request.CreateMembershipRequest]",
    ) -> OperationResponse[
        "capo_securityagent.types.create_membership_response.CreateMembershipResponse"
    ]:
        import capo_securityagent._operations.security_agent.create_membership

        output, http_response = (
            capo_securityagent._operations.security_agent.create_membership.create_membership(
                req.options, req.input
            )
        )
        return OperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateMembership")
    )
    input_: capo_securityagent.types.create_membership_request.CreateMembershipRequest = {
        "application_id": application_id,
        "agent_space_id": agent_space_id,
        "membership_id": membership_id,
        "member_type": member_type,
    }
    if config is not None:
        input_["config"] = config

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