Todos os produtos
Search

Este produto

    Resource Orchestration Service:SetTemplatePermission

    Central de documentação

    Resource Orchestration Service:SetTemplatePermission

    Última atualização: Jul 04, 2026

    Compartilha ou cancela o compartilhamento de um modelo.

    Descrição da operação

    Neste exemplo, o modelo cujo ID é 5ecd1e10-b0e9-4389-a565-e4c15efc**** é compartilhado com uma conta Alibaba Cloud. O ID da conta Alibaba Cloud é 151266687691****.

    Nota

    A conta Alibaba Cloud destinatária (ID: 151266687691****) pode autorizar usuários RAM a usar o modelo compartilhado.

    Experimente agora

    Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

    Testar

    Autorização RAM

    A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

    • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

    • API: A API que você pode chamar para executar a ação.

    • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

    • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

      • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

      • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

    • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

    • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

    Ação

    Nível de acesso

    Tipo de recurso

    Chave de condição

    Ação dependente

    ros:SetTemplatePermission

    update

    *Template

    acs:ros:{#regionId}:{#accountId}:template/{#TemplateId}

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    ShareOption

    string

    Sim

    A opção de compartilhamento.

    Valores válidos:

    • ShareToAccounts: compartilha o modelo com outras contas Alibaba Cloud.

    • CancelSharing: cancela o compartilhamento do modelo.

    ShareToAccounts
    VersionOption

    string

    Não

    A opção de versão para o modelo compartilhado. Este parâmetro entra em vigor somente se você definir ShareOption como ShareToAccounts.

    Valores válidos:

    • AllVersions (padrão): compartilha todas as versões do modelo.

    • Latest: compartilha apenas a versão mais recente do modelo. Quando a versão do modelo é atualizada, o ROS atualiza a versão compartilhada para a versão mais recente.

    • Current: compartilha apenas a versão atual do modelo. Quando a versão do modelo é atualizada, o ROS não atualiza a versão compartilhada.

    • Specified: compartilha apenas a versão especificada do modelo.

    Specified
    TemplateVersion

    string

    Não

    A versão do modelo compartilhado. Este parâmetro entra em vigor somente se você definir ShareOption como ShareToAccounts e definir VersionOption como Specified.

    Valores válidos: v1 a v100.

    v1
    TemplateId

    string

    Sim

    O ID do modelo.

    5ecd1e10-b0e9-4389-a565-e4c15efc****
    AccountIds

    array

    Sim

    As contas Alibaba Cloud com as quais ou das quais você deseja compartilhar ou cancelar o compartilhamento do modelo.
    Valores válidos de N: 1, 2, 3, 4 e 5.

    Nota

    • Este parâmetro não pode ser definido como o ID da conta Alibaba Cloud proprietária do modelo, nem como os usuários RAM dessa conta Alibaba Cloud.

    • Quando ShareOption é definido como CancelSharing, você pode cancelar o compartilhamento do modelo de todas as contas Alibaba Cloud especificadas usando um asterisco (*).

    151266687691****

    string

    Não

    A conta Alibaba Cloud com a qual ou da qual você deseja compartilhar ou cancelar o compartilhamento do modelo.
    Valores válidos de N: 1, 2, 3, 4 e 5.

    Nota

    • Este parâmetro não pode ser definido como o ID da conta Alibaba Cloud proprietária do modelo, nem como os usuários RAM dessa conta Alibaba Cloud.

    • Quando ShareOption é definido como CancelSharing, você pode cancelar o compartilhamento do modelo de todas as contas Alibaba Cloud especificadas usando um asterisco (*).

    100406424347****

    Para mais informações sobre parâmetros de solicitação comuns, consulte Parâmetros comuns.

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    RequestId

    string

    O ID da solicitação.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F

    Exemplos

    Resposta de sucesso

    JSON formato

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

    Códigos de erro

    Consulte Códigos de Erro para uma lista completa.

    Notas de versão

    Consulte Notas de Versão para uma lista completa.