CopyThingModel - IoT Platform: Central de Documentação do Alibaba Cloud

Copia um modelo de Thing Specification Language (TSL) de um produto de origem para um produto de destino.

Observações de uso

Se o produto de destino estiver publicado, chame a operação CancelReleaseProduct para cancelar a publicação antes de copiar o modelo TSL do produto de origem.
As categorias do produto de origem e do produto de destino devem ser idênticas. O parâmetro CategoryKey indica a categoria do produto. Para visualizar o parâmetro CategoryKey de um produto, chame a operação QueryProduct.
Especifique a versão do modelo TSL a copiar por meio do parâmetro SourceModelVersion na solicitação. Caso contrário, a operação CopyThingModel falhará.

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. Recomendamos usar o OpenAPI Explorer para facilitar o processo. A ferramenta também gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	CopyThingModel	A operação a executar. Defina o valor como CopyThingModel.
SourceProductKey	String	Sim	a1BwAGV****	O ProductKey do produto de origem. Visualize o ProductKey na página Products do console IoT Platform. Também é possível obter o ProductKey chamando a operação QueryProductList.
TargetProductKey	String	Sim	a1BwwG0****	O ProductKey do produto de destino. Visualize o ProductKey na página Products do console IoT Platform. Alternativamente, obtenha 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. A ausência deste parâmetro causará falha na solicitação. Caso a aba Overview ou o ID da instância não apareçam no console IoT Platform, não é necessário especificar este parâmetro. Para mais informações sobre instâncias, consulte Visão geral.
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.
SourceModelVersion	String	Não	V1.0.0	A versão do modelo TSL a copiar. Chame a operação ListThingModelVersion para visualizar as versões do modelo TSL de um produto.

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 informações sobre parâmetros comuns de solicitação, 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=CopyThingModel
&ProductKeySource=a1rYuVF****
&ProductKeyTarget=a1bPo9p****
&SourceModelVersion=v1.0.0
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<CopyThingModelResponse>
  <RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
  <Success>true</Success>
</CopyThingModelResponse>

Formato JSON

{
  "RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
  "Success": true
}

Códigos de erro

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