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

Detecta riscos de operação relacionados a stacks e retorna as permissões ausentes e as causas dos riscos.

Descrição da operação

A operação ListStackOperationRisks é adequada para os seguintes cenários:

Você deseja detectar altos riscos que podem surgir nos recursos ao excluir uma stack que contém esses recursos e consultar a causa de cada risco em um recurso.
Ao criar uma stack, a criação pode falhar. Nesse caso, você pode chamar esta operação para verificar quais tipos de permissões necessárias para criar stacks estão ausentes.

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

get

*stack

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
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
StackId	string	Não	O ID da stack.	4a6c9851-3b0f-4f5f-b4ca-a14bf691****
OperationType	string	Não	O tipo da operação da qual você deseja detectar riscos. Valores válidos: DeleteStack: detecta altos riscos que podem surgir nos recursos ao excluir uma stack. CreateStack: detecta as permissões ausentes quando há falha ao criar uma stack.	DeleteStack
ClientToken	string	Não	O token de cliente usado para garantir a idempotência da solicitação. Você pode usar o cliente para gerar o token, mas deve garantir que o token seja exclusivo entre diferentes solicitações. O token pode ter até 64 caracteres e pode conter letras, dígitos, hifens (-) e sublinhados (_). Para mais informações, consulte Como garantir a idempotência.	123e4567-e89b-12d3-a456-42665544****
RamRoleName	string	Não	O nome da função RAM. Se você especificar uma função RAM, o ROS cria stacks com base nas permissões concedidas à função RAM e usa as credenciais da função RAM para chamar as operações de API dos serviços da Alibaba Cloud. Se você não especificar uma função RAM, o ROS cria stacks com base nas permissões da sua conta Alibaba Cloud. O nome da função RAM pode ter até 64 bytes.	test-role
RetainAllResources	boolean	Não	Especifica se todos os recursos na stack devem ser retidos. Valores válidos: true false (padrão) Nota Este parâmetro só entra em vigor se você definir OperationType como DeleteStack.	false
RetainResources	array	Não	A lista de recursos a serem retidos. Nota Este parâmetro só entra em vigor se você definir OperationType como DeleteStack.	WebServer
	string	Não	O recurso que você deseja reter.	instance
TemplateBody	string	Não	A estrutura que contém o corpo do modelo. O corpo do modelo deve ter de 1 a 524.288 bytes. Se o comprimento do corpo do modelo exceder o limite superior, recomendamos que você adicione parâmetros ao corpo da solicitação HTTP POST para evitar falhas de solicitação causadas por URLs excessivamente longas. Nota Você deve e pode especificar apenas um dos seguintes parâmetros: TemplateBody, TemplateURL, TemplateId e TemplateScratchId.	{"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 Object Storage Service (OSS), como oss://ros/stack-policy/demo e oss://ros/stack-policy/demo?RegionId=cn-hangzhou. O corpo do modelo pode ter até 524.288 bytes. Se você não especificar RegionId na URL, o ID da região da stack será usado. Nota Você deve especificar um entre TemplateBody, TemplateURL, TemplateId e TemplateScratchId.	oss://ros-template/demo
TemplateId	string	Não	O ID do modelo. Este parâmetro se aplica a modelos compartilhados e privados. Nota Você deve especificar um entre TemplateBody, TemplateURL, TemplateId e TemplateScratchId.	5ecd1e10-b0e9-4389-a565-e4c15efc****
TemplateVersion	string	Não	A versão do modelo. Nota Este parâmetro só entra em vigor se você especificar TemplateId.	v1

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	72108E7A-E874-4A5E-B22C-A61E94AD12CD
RiskResources	array<object>	Os recursos que estão em risco.
	object
LogicalResourceId	string	O ID lógico do recurso. O ID lógico é o nome do recurso definido no modelo.	MySG
PhysicalResourceId	string	O ID físico do recurso. O ID físico é o ID real do recurso.	sg-bp1dpioafqphedg9****
RequestId	string	O ID da solicitação quando a detecção de risco falha. Nota Este parâmetro não é retornado se a detecção de risco for bem-sucedida.	DF4296CF-F45F-4845-A72B-BE617601DB25
ResourceType	string	O tipo do recurso.	ALIYUN::ECS::SecurityGroup
Code	string	O código de erro retornado quando a detecção de risco falha. Nota Este parâmetro não é retornado se a detecção de risco for bem-sucedida.	NoPermission
Message	string	A mensagem de erro retornada quando a detecção de risco falha. Nota Este parâmetro não é retornado se a detecção de risco for bem-sucedida.	You are not authorized to complete this action.
RiskType	string	O tipo do risco. Valores válidos: Referenced: O recurso é referenciado por outros recursos. MaybeReferenced: O recurso pode ser referenciado por outros recursos. AdditionalRiskCheckRequired: Uma detecção de risco adicional é necessária para uma stack aninhada. OperationIgnored: A operação não entra em vigor para o recurso.	Referenced
Reason	string	A causa do risco.	There are some ECS instances (i-bp18el96s4wq635e****) depending on the security group.
MissingPolicyActions	array	As operações para as quais as permissões não são concedidas à conta Alibaba Cloud do chamador.
	string	A operação para a qual as permissões não são concedidas à conta Alibaba Cloud do chamador.	["ecs:DescribeInstance", "ros:CreateStack"]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "72108E7A-E874-4A5E-B22C-A61E94AD12CD",
  "RiskResources": [
    {
      "LogicalResourceId": "MySG",
      "PhysicalResourceId": "sg-bp1dpioafqphedg9****",
      "RequestId": "DF4296CF-F45F-4845-A72B-BE617601DB25",
      "ResourceType": "ALIYUN::ECS::SecurityGroup",
      "Code": "NoPermission",
      "Message": "You are not authorized to complete this action.",
      "RiskType": "Referenced",
      "Reason": "There are some ECS instances (i-bp18el96s4wq635e****) depending on the security group."
    }
  ],
  "MissingPolicyActions": [
    "[\"ecs:DescribeInstance\", \"ros:CreateStack\"]"
  ]
}

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.