Todos os produtos
Search
Central de documentação

:SetTopicAttributes

Última atualização: Jul 04, 2026

Modifique um tópico.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários RAM só podem executar essa chamada após receberem as permissões necessárias. A tabela a seguir descreve as informações de autorização desta operação. Para mais informações, consulte Políticas e exemplos de autorização.

Nome

Valor

API

SetTopicAttributes

Action

mns:SetTopicAttributes

Item

acs:mns:$region:$accountid:/topics/$topicName

Requisição

Uma requisição consiste nas seguintes partes:

  • Linha de requisição

    PUT /topics/$TopicName?metaoverride=true HTTP/1.1

  • Parâmetros de URI específicos da operação

    Para modifique os parâmetros de um tópico, especifique metaoverride=true na URI.

  • Cabeçalhos de requisição específicos da operação

    Nenhum.

  • Corpo da requisição

    O corpo da requisição está no formato XML e contém os seguintes parâmetros para modifique o tópico.

    ParâmetroTipoObrigatórioExemploDescrição
    MaximumMessageSizeIntegerNão.65536Tamanho máximo do corpo de uma mensagem enviada ao tópico.

    Valores válidos: 1024 a 65536. Unidade: bytes.

    Valor padrão: 65536.

    LoggingEnabledBooleanNãoTrueDefine se o recurso de gerenciamento de log deve ser ativado. Valores válidos:
    Valores válidos:
    • True: ative o recurso de gerenciamento de log.
    • False: desativa o recurso de gerenciamento de log.

    Valor padrão: False.

    Se você usar o Terraform para gerencie o alicloud_message_service_topic, configure os parâmetros. A tabela a seguir descreve esses parâmetros.

    ParâmetroTipoObrigatórioExemploDescrição
    MaximumMessageSizeIntegerNão.65536Tamanho máximo do corpo de uma mensagem enviada ao tópico.

    Valores válidos: 1024 a 65536. Unidade: bytes.

    Valor padrão: 65536.

    EnableLoggingBooleanNãoTrueDefine se o recurso de gerenciamento de log deve ser ativado.
    Valores válidos:
    • True: ative o recurso de gerenciamento de log.
    • False: desativa o recurso de gerenciamento de log.

    Valor padrão: False.

Mensagem de erro

Uma resposta consiste nas seguintes partes:

  • Código de status HTTP

    HTTP/1.1 204 No Content

  • Cabeçalhos de resposta específicos da operação

    Nenhum.

  • Corpo da resposta

    Nenhum.

Exemplos

Exemplos de requisições

PUT /topics/$TopicName?metaoverride=true HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
x-mns-version: 2015-06-06
Date: Tue, 08 Dec 2015 06:01:00 GMT
Authorization:MNS 15B4D3461F177624206A:SeIRcZk3lKiP7bl19WB9Uz07****

<?xml version="1.0" encoding="utf-8"?>
<Topic xmlns="http://mns.aliyuncs.com/doc/v1/">
    <MaximumMessageSize>65536</MaximumMessageSize>
    <LoggingEnabled>True</LoggingEnabled>
</Topic>    

Exemplos de respostas

HTTP/1.1 204 No Content
x-mns-request-id:5666721CB2B71C9C1600****
x-mns-version: 2015-06-06

Códigos de erro

Código de erro

Mensagem de erro

Código de status HTTP

Descrição

TopicNotExist

The topic you provided does not exist.

404

Erro retornado quando o tópico especificado não existe. Crie um tópico.