SetTemplatePermission - : Central de Documentação do Alibaba Cloud

Neste exemplo, o modelo com ID 5ecd1e10-b0e9-4389-a565-e4c15efc**** é compartilhado com a conta Alibaba Cloud de ID 151266687691****.

Nota

A conta pode autorizar um usuário RAM a usar o modelo compartilhado.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta 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	SetTemplatePermission	Operação a ser executada. Defina o valor como SetTemplatePermission.
AccountIds.N	RepeatList	Sim	151266687691****	Lista de uma ou mais contas Alibaba Cloud com as quais deseja compartilhar ou cancelar o compartilhamento do modelo. Valores válidos de N: 1 a 5. Nota Não defina este parâmetro como o ID da conta Alibaba Cloud proprietária do modelo nem como os usuários RAM dessa conta. Se o parâmetro ShareOption estiver definido como CancelSharing, use o asterisco (*) para cancelar o compartilhamento do modelo com todas as contas Alibaba Cloud especificadas.
ShareOption	String	Sim	ShareToAccounts	Opção de compartilhamento. Valores válidos: ShareToAccounts: compartilha o modelo com outras contas Alibaba Cloud. CancelSharing: cancela o compartilhamento do modelo.
TemplateId	String	Sim	5ecd1e10-b0e9-4389-a565-e4c15efc****	ID do modelo.
VersionOption	String	Não	Specified	Opção de versão para compartilhamento do modelo. Este parâmetro entra em vigor quando ShareOption está definido como ShareToAccounts. Valor padrão: AllVersions. Valores válidos: AllVersions: compartilha todas as versões do modelo. Latest: compartilha apenas a versão mais recente do modelo. Se houver atualização, a conta de destino receberá a versão mais recente. Current: compartilha apenas a versão atual do modelo. A conta de destino mantém a versão atual mesmo após atualizações. Specified: compartilha apenas uma versão específica do modelo.
TemplateVersion	String	Não	v1	Versão do modelo a ser compartilhada. Este parâmetro entra em vigor quando ShareOption está definido como ShareToAccounts e VersionOption como Specified. Valores válidos: v1 a v100.

Para obter mais informações sobre parâmetros comuns, consulte Parâmetros comuns.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	B288A0BE-D927-4888-B0F7-B35EF84B6E6F	ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ros.aliyuncs.com/? Action=SetTemplatePermission
&AccountIds.1=151266687691****
&ShareOption=ShareToAccounts
&TemplateId=5ecd1e10-b0e9-4389-a565-e4c15efc****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<SetTemplatePermissionResponse>
      <RequestId>B288A0BE-D927-4888-B0F7-B35EF84B6E6F</RequestId>
</SetTemplatePermissionResponse>

Formato JSON

{
    "RequestId":"B288A0BE-D927-4888-B0F7-B35EF84B6E6F"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	TemplateBeingProcessed	Template { ID } is being processed, retry later.	Mensagem de erro retornada porque o modelo especificado tem uma ação em andamento. Tente novamente mais tarde. ID indica o ID do modelo.
404	TemplateNotFound	The Tempalte ({ ID }) could not be found.	Mensagem de erro retornada porque o modelo especificado não existe. ID indica o ID do modelo.
404	TemplateNotFound	The Template { ID } with version { version } could not be found.	Mensagem de erro retornada porque o modelo ou a versão especificada não existe. ID indica o ID do modelo e version indica a versão do modelo.