doc-exports/docs/smn/api-ref/smn_api_51003.html
Zaoxu, Li 152a7d9381 SMN API DOC
Reviewed-by: Bobkova, Natalia <natalia.bobkova@t-systems.com>
Co-authored-by: Zaoxu, Li <lizaoxu@huawei.com>
Co-committed-by: Zaoxu, Li <lizaoxu@huawei.com>
2024-06-20 15:01:38 +00:00

6.5 KiB

Deleting a Topic

Description

  • API name

    DeleteTopic

  • Function

    Delete a topic and its subscribers. If a topic is deleted, a pending message will fail to deliver to the topic subscribers.

URI

  • URI format

    DELETE /v2/{project_id}/notifications/topics/{topic_urn}

  • Parameter description

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Project ID

    See Obtaining a Project ID.

    topic_urn

    Yes

    String

    Unique resource ID of a topic. You can obtain it by referring to Querying Topics.

Request

Example request
DELETE https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId:f96188c7ccaf4ffba0c9aa149ab2bd57:test_topic_v2

Response

  • Parameter description

    Parameter

    Type

    Description

    request_id

    String

    Request ID, which is unique

  • Example response
    { 
         "request_id": "5fcba32bd2814ea39431829c22bda94b"
    }

Returned Value

See Returned Value.

Error Codes

See Error Codes.