create_channel_namespace async ¶

async def create_channel_namespace(
    self,
    api_id: "capo_appsync.types.string.String",
    name: "capo_appsync.types.namespace.Namespace",
    *,
    config_overrides: Optional[AsyncAppSyncClientConfig] = None,
    subscribe_auth_modes: Optional[
        "capo_appsync.types.auth_modes.AuthModes"
    ] = None,
    publish_auth_modes: Optional["capo_appsync.types.auth_modes.AuthModes"] = None,
    code_handlers: Optional["capo_appsync.types.code.Code"] = None,
    tags: Optional["capo_appsync.types.tag_map.TagMap"] = None,
    handler_configs: Optional[
        "capo_appsync.types.handler_configs.HandlerConfigs"
    ] = None,
) -> "capo_appsync.types.create_channel_namespace_response.CreateChannelNamespaceResponse":
    """<p>Creates a <code>ChannelNamespace</code> for an <code>Api</code>.</p>

    Args:
        api_id: <p>The <code>Api</code> ID.</p>
        name: <p>The name of the <code>ChannelNamespace</code>. This name must be unique within the <code>Api</code> </p>
        subscribe_auth_modes: <p>The authorization mode to use for subscribing to messages on the channel namespace. This configuration overrides the default <code>Api</code> authorization configuration.</p>
        publish_auth_modes: <p>The authorization mode to use for publishing messages on the channel namespace. This configuration overrides the default <code>Api</code> authorization configuration.</p>
        code_handlers: <p>The event handler functions that run custom business logic to process published events and subscribe requests.</p>
        handler_configs: <p>The configuration for the <code>OnPublish</code> and <code>OnSubscribe</code> handlers.</p>

    Raises:
        capo_appsync.errors.bad_request_exception.BadRequestException: <p>The request is not well formed. For example, a value is invalid or a required field is missing. Check the field values, and then try again.</p>
        capo_appsync.errors.concurrent_modification_exception.ConcurrentModificationException: <p>Another modification is in progress at this time and it must complete before you can make your change.</p>
        capo_appsync.errors.conflict_exception.ConflictException: <p>A conflict with a previous successful update is detected. This typically occurs when the previous update did not have time to propagate before the next update was made. A retry (with appropriate backoff logic) is the recommended response to this exception.</p>
        capo_appsync.errors.internal_failure_exception.InternalFailureException: <p>An internal AppSync error occurred. Try your request again.</p>
        capo_appsync.errors.not_found_exception.NotFoundException: <p>The resource specified in the request was not found. Check the resource, and then try again.</p>
        capo_appsync.errors.service_quota_exceeded_exception.ServiceQuotaExceededException: <p>The operation exceeded the service quota for this resource.</p>
        capo_appsync.errors.unauthorized_exception.UnauthorizedException: <p>You aren't authorized to perform this operation.</p>
        capo_appsync.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_appsync.types.create_channel_namespace_request.CreateChannelNamespaceRequest]",
    ) -> AsyncOperationResponse[
        "capo_appsync.types.create_channel_namespace_response.CreateChannelNamespaceResponse"
    ]:
        import capo_appsync._operations.aws_deepdish_control_plane_service.create_channel_namespace

        (
            output,
            http_response,
        ) = await capo_appsync._operations.aws_deepdish_control_plane_service.create_channel_namespace.async_create_channel_namespace(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("CreateChannelNamespace")
    )
    input_: capo_appsync.types.create_channel_namespace_request.CreateChannelNamespaceRequest = {
        "api_id": api_id,
        "name": name,
    }
    if subscribe_auth_modes is not None:
        input_["subscribe_auth_modes"] = subscribe_auth_modes
    if publish_auth_modes is not None:
        input_["publish_auth_modes"] = publish_auth_modes
    if code_handlers is not None:
        input_["code_handlers"] = code_handlers
    if tags is not None:
        input_["tags"] = tags
    if handler_configs is not None:
        input_["handler_configs"] = handler_configs

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output