ContinueCreateStack - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Continua a criação de uma stack após a falha na criação da stack.

Descrição da operação

Este tópico fornece um exemplo de como retomar a criação de uma stack com falha com o ID 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** na região China (Hangzhou).

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:ContinueCreateStack

update

*stack.

acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

Template.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
StackId	string	Sim	O ID da stack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
RegionId	string	Sim	O ID da região da stack. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
RamRoleName	string	Não	O nome da função do Resource Access Management (RAM). O Resource Orchestration Service (ROS) assume essa função para criar a stack e usa as credenciais da função para chamar operações de API em nome do usuário. O ROS sempre usa essa função para operações subsequentes na stack. Desde que você tenha permissões para executar operações na stack, o ROS usa essa função mesmo que você não tenha permissões para assumir a função. Isso garante que as permissões mínimas sejam concedidas à função. Se você não especificar este parâmetro, o ROS usará a função que foi associada anteriormente à stack. Se nenhuma função estiver disponível, o ROS usará credenciais temporárias geradas a partir das suas credenciais de usuário. O nome da função RAM pode ter até 64 bytes de comprimento.	test-role
Mode	string	Não	O modo para continuar a criação da stack. Valores válidos: Recreate (padrão): Você só precisa continuar criando os quatro tipos de recursos a seguir. Outros recursos não precisam ser criados: Recursos que falharam ao serem criados. Recursos especificados para recriação (RecreatingResources.N). Recursos que dependem dos recursos especificados para recriação (RecreatingResources.N). Recursos que não foram criados. Nota Os parâmetros RecreatingResources.N, TemplateBody, TemplateURL e Parameters têm efeito apenas neste modo. Ignore: Ignora e descarta todos os recursos que falharam ao serem criados e os recursos que não foram criados, e marca diretamente a stack como bem-sucedida. O conteúdo do modelo é alterado. Nota Este modo está disponível apenas para stacks do ROS.	Recreate
TemplateBody	string	Não	A estrutura do modelo. O corpo do modelo deve ter de 1 a 524.288 bytes de comprimento. Se o comprimento do corpo do modelo exceder o limite superior, recomendamos que você use o método HTTP POST e passe o parâmetro no corpo da solicitação para evitar falhas de solicitação causadas por URLs excessivamente longas. Os seguintes limites se aplicam aos modelos do ROS: Você pode modificar apenas as seções Description, Metadata, Resources, Outputs e Rules do modelo. Você não pode adicionar ou excluir seções, que são os elementos de primeiro nível do conteúdo do modelo. A seção Resources do modelo tem os seguintes limites: Para recursos que não devem ser recriados, você não pode excluí-los nem modificar o conteúdo de seu modelo. Para recursos que devem ser recriados, você pode excluí-los ou modificar o conteúdo de seu modelo. Você pode adicionar novos recursos. Nota Este parâmetro tem efeito apenas quando Mode é definido como Recreate. Você pode especificar apenas um dos parâmetros TemplateBody, TemplateURL e TemplateId. Se nenhum desses parâmetros for especificado, o modelo original será usado.	{"ROSTemplateFormatVersion": "2015-09-01"}
TemplateURL	string	Não	A URL do arquivo que contém o corpo do modelo. A URL deve apontar para um modelo localizado em um servidor web HTTP ou HTTPS ou em um bucket do Alibaba Cloud Object Storage Service (OSS), como oss://ros/template/demo e oss://ros/template/demo?RegionId=cn-hangzhou. O modelo pode ter até 524.288 bytes de comprimento. Se a região do bucket do OSS não for especificada, a região do bucket do OSS será a mesma do valor do parâmetro RegionId. Nota Este parâmetro tem efeito apenas quando Mode é definido como Recreate. Os limites do modelo são os mesmos de TemplateBody. Você pode especificar apenas um dos parâmetros TemplateBody, TemplateURL e TemplateId. Se nenhum desses parâmetros for especificado, o modelo original será usado.	oss://ros-template/demo
DryRun	boolean	Não	Especifica se deve realizar apenas uma pré-verificação da solicitação. Valores válidos: true: realiza uma pré-verificação sem executar a operação real. false (padrão): executa a operação real e continua a criar a stack.	false
TemplateId	string	Não	O ID do modelo. Modelos compartilhados e modelos privados são suportados. Nota Este parâmetro tem efeito apenas quando Mode é definido como Recreate. Os limites do modelo são os mesmos de TemplateBody. Você pode especificar apenas um dos parâmetros TemplateBody, TemplateURL e TemplateId. Se nenhum desses parâmetros for especificado, o modelo original será usado.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Não	A versão do modelo. Este parâmetro tem efeito apenas quando TemplateId é especificado.	v1
RecreatingResources	array	Não	Os recursos que falharam ao serem criados serão recriados. Você pode especificar uma lista de recursos adicionais a serem recriados. O ROS recriará todos os recursos que dependem desses recursos. Nota Este parâmetro está disponível apenas para stacks do ROS.	WebServer
	string	Não	Os recursos que falharam ao serem criados serão recriados. Você pode especificar uma lista de recursos adicionais a serem recriados. O ROS recriará todos os recursos que dependem desses recursos. Nota Este parâmetro está disponível apenas para stacks do ROS.	WebServer
Parameters	array<object>	Não	Os parâmetros do modelo a serem substituídos.
	object	Não
ParameterKey	string	Sim	O nome do parâmetro do modelo a ser substituído. Se você não especificar o nome e o valor de um parâmetro específico, o ROS usará o valor da criação anterior. Valor máximo de N: 200. Nota Este parâmetro tem efeito apenas quando Mode é definido como Recreate.	Amount
ParameterValue	string	Sim	O valor do parâmetro do modelo a ser substituído. Valor máximo de N: 200. Para stacks do ROS, os parâmetros do modelo substituídos têm os seguintes limites: A substituição não pode fazer com que o valor de qualquer condição na seção Conditions do modelo mude de true para false ou de false para true. Os parâmetros substituídos não podem ser referenciados por recursos que não devem ser recriados. Nota Este parâmetro tem efeito apenas quando Mode é definido como Recreate.	12
Parallelism	integer	Não	O número máximo de recursos simultâneos. Valor padrão: vazio. Você pode inserir um número inteiro maior ou igual a 0. Nota Se você definir este parâmetro como um número inteiro maior que 0, o número inteiro especificado será usado. Se você definir este parâmetro como 0, nenhum limite será aplicado às stacks do ROS, e o valor padrão do Terraform (geralmente 10) será usado para stacks do Terraform. Se você não especificar este parâmetro, o valor da operação anterior será usado. Se nenhum valor foi especificado na operação anterior, nenhum limite será aplicado às stacks do ROS, e o valor padrão do Terraform (geralmente 10) será usado para stacks do Terraform. Se você especificar este parâmetro, ele será associado à stack e afetará as operações subsequentes na stack.	1
RecreatingOptions	array	Não	As opções de recriação.
	string	Não	As opções de recriação. Este parâmetro tem efeito quando Mode é definido como Recreate. Valores válidos: TryToFixSignalFailureByRerunEcsCommand: tenta corrigir falhas de sinal existentes. Quando um recurso ALIYUN::ROS::WaitCondition falha ao ser criado, o ROS encontra os recursos ALIYUN::ECS::RunCommand e ALIYUN::ECS::Invocation associados e criados com sucesso, e recria esses recursos e os recursos que dependem deles. Nota Esta opção tem efeito apenas para stacks do ROS. IgnoreExistingSignalFailure: ignora falhas de sinal existentes. Se um recurso ALIYUN::ROS::WaitCondition falhou ao ser criado anteriormente, ele é diretamente marcado como criado com sucesso durante o novo processo de criação. Nota Esta opção tem efeito apenas para stacks do ROS. AutoRecreatingResources: recria automaticamente recursos cujo conteúdo do modelo ou parâmetros referenciados foram alterados, incluindo os recursos que dependem deles. Esta opção simplifica a configuração do parâmetro RecreatingResources.N, mas pode causar recriação inesperada de recursos. Nota Esta opção tem efeito apenas para stacks do ROS. CreateNewPrepaidInstance: ao continuar a criação de instâncias, se um recurso que falhou ao ser criado ou foi criado com sucesso, mas está especificado para ser recriado, for do tipo assinatura, o ROS cria uma nova instância. Nota Esta opção tem efeito apenas para stacks do ROS. Se uma instância antiga tiver sido criada, ela não será excluída porque instâncias de assinatura não podem ser excluídas. Por padrão (quando CreateNewPrepaidInstance não está definido), neste cenário, se uma instância antiga tiver sido criada, o ROS tentará reutilizar a instância criada. A reutilização tem certos limites, e as propriedades do recurso geralmente não podem ser modificadas ou apenas algumas propriedades podem ser modificadas.	CreateNewPrepaidInstance

Para obter 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-B35EF84B6E6
StackId	string	O ID da stack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
DryRunResult	object	O resultado da pré-verificação.
ParametersAllowedToBeModified	array	Os parâmetros que podem ser modificados.
	string	Os parâmetros que podem ser modificados. A modificação desses parâmetros não causa erros de pré-verificação. Nota Este parâmetro é retornado apenas quando DryRun é definido como true. O resultado está relacionado a Mode, Template*, RecreatingResources.N e RecreatingOptions.N.	description
ParametersConditionallyAllowedToBeModified	array	Os parâmetros que podem ser modificados condicionalmente.
	string	Os parâmetros que podem ser modificados condicionalmente. Se a modificação de um parâmetro causa um erro de pré-verificação depende do valor do parâmetro. Nota Este parâmetro é retornado apenas quando DryRun é definido como true. O resultado está relacionado a Mode, Template*, RecreatingResources.N e RecreatingOptions.N.	name
ParametersNotAllowedToBeModified	array	Os parâmetros que não podem ser modificados.
	string	Os parâmetros que não podem ser modificados. A modificação desses parâmetros causa definitivamente erros de pré-verificação. Nota Este parâmetro é retornado apenas quando DryRun é definido como true. O resultado está relacionado a Mode, Template*, RecreatingResources.N e RecreatingOptions.N.	cidr

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****",
  "DryRunResult": {
    "ParametersAllowedToBeModified": [
      "description"
    ],
    "ParametersConditionallyAllowedToBeModified": [
      "name"
    ],
    "ParametersNotAllowedToBeModified": [
      "cidr"
    ]
  }
}

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.