文档首页 > > API参考> API> Topic操作> 创建Topic

创建Topic

分享
更新时间: 2019/09/12 GMT+08:00

功能介绍

  • 接口名称

    CreateTopic

  • 功能描述

    创建Topic,单用户默认配额为3000。高并发场景下,可能会出现Topic数量超过3000仍创建成功的情况,此为正常现象。

    接口是幂等的,接口调用返回成功时,若已存在同名的Topic,返回的status code为200,否则返回的status code为201。

URI

  • URI格式

    POST /v2/{project_id}/notifications/topics

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    String

    项目ID

    获取项目ID请参考获取项目ID

请求消息

  • 参数说明

    名称

    是否必选

    参数类型

    说明

    name

    String

    创建topic的名字。

    Topic名称只能包含大写字母、小写字母、数字、-和_,且必须由大写字母、小写字母或数字开头,长度为1到255个字符。

    display_name

    String

    Topic的显示名,推送邮件消息时,作为邮件发件人显示。

    显示名的长度为192byte或64个中文。

    默认值为空。

  • 请求样例
    POST https://{SMN_Endpoint}/v2/{project_id}/notifications/topics
    {
        "name": "test_topic_v2",
        "display_name": "testtest"
    }

响应消息

  • 要素说明

    名称

    参数类型

    说明

    request_id

    String

    请求的唯一标识ID

    topic_urn

    String

    Topic的唯一的资源标识,可通过查询Topic列表获取该标识。

  • 响应样例
    {
        "request_id": "6a63a18b8bab40ffb71ebd9cb80d0085",
        "topic_urn": "urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_topic_v2"
    }

返回值

请参考返回值

错误码

请参考错误码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区