Todos os produtos
Search

Este produto

    IoT Platform:PublishThingModel

    Central de documentação

    IoT Platform:PublishThingModel

    Última atualização: Jun 26, 2026

    Publica o modelo da Thing Specification Language (TSL) de um produto.

    Observações de uso

    Se o produto já estiver publicado, chame a operação CancelReleaseProduct para cancelar a publicação antes de executar esta operação.

    Limites de QPS

    É possível chamar esta API até cinco vezes por segundo por conta.

    Nota

    Os usuários do Resource Access Management (RAM) de uma conta Alibaba Cloud compartilham a cota dessa conta.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    Action

    String

    Sim

    PublishThingModel

    A operação a ser executada. Defina o valor como PublishThingModel.

    ProductKey

    String

    Sim

    a1BwAGV****

    O ProductKey do produto.

    Visualize o ProductKey na página Products do console IoT Platform. Também é possível obter o ProductKey chamando a operação QueryProductList.

    IotInstanceId

    String

    Não

    iot_instc_pu**_c-v64*

    O ID da instância. Visualize o ID da instância na aba Overview do console IoT Platform.

    Importante

    • Se a instância tiver um ID, especifique este parâmetro. Caso contrário, a solicitação falhará.

    • Se a página Overview ou o ID da instância não aparecer no console IoT Platform, não especifique este parâmetro.

    Para mais informações sobre instâncias, consulte Overview.

    ResourceGroupId

    String

    Não

    rg-acfm4l5tcwd****

    O ID do grupo de recursos.

    Importante

    O IoT Platform oferece suporte ao gerenciamento de grupos de recursos apenas por instância. O parâmetro ResourceGroupId é inválido. Não especifique este parâmetro.

    ModelVersion

    String

    Não

    v1.0.0

    O número da versão do modelo TSL.

    O número da versão deve ter de 1 a 16 caracteres e pode conter letras, dígitos e pontos (.).

    Description

    String

    Não

    Segunda versão

    A descrição da versão do modelo TSL.

    Além dos parâmetros específicos da operação listados acima, especifique os parâmetros comuns de solicitação ao chamar esta operação. Para mais detalhes sobre os parâmetros comuns, consulte Parâmetros comuns.

    Parâmetros de resposta

    Parâmetro

    Tipo

    Exemplo

    Descrição

    Code

    String

    iot.system.SystemException

    O código de erro retornado se a solicitação falhar. Para mais informações sobre códigos de erro, consulte Códigos de erro.

    ErrorMessage

    String

    A system exception occurred.

    A mensagem de erro retornada se a solicitação falhar.

    RequestId

    String

    E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    O ID da solicitação.

    Success

    Boolean

    true

    Indica se a solicitação foi bem-sucedida. Valores válidos:

    • true

    • false

    Exemplos

    Exemplos de solicitações

    https://iot.cn-shanghai.aliyuncs.com/?Action=PublishThingModel
&ProductKeySource=a1rYuVF****
&ModelVersion=V1.0.0
&<Common request parameters>

    Exemplos de respostas de sucesso

    Formato XML

    <PublishThingModelResponse>
  <RequestId>5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E</RequestId>
  <Success>true</Success>
</PublishThingModelResponse>

    Formato JSON

    {
  "RequestId": "5252CC6E-9E4B-4DB1-B1D8-7EEA190A5B3E",
  "Success": true
}

    Códigos de erro

    Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.