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

Consulta os detalhes de uma operação de grupo de pilhas especificada em uma região do Alibaba Cloud.

Descrição da operação

Este tópico fornece um exemplo para consultar os detalhes de uma operação cujo ID é 6da106ca-1784-4a6f-a7e1-e723863d**** para um grupo de pilhas existente chamado MyStackGroup que usa o modo de permissões autogerenciadas 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:GetStackGroupOperation

get

*StackGroupOperation.

acs:ros:{#regionId}:{#accountId}:stackgroupoperation/{#OperationId}

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Sim	O ID da região do grupo de pilhas. Você pode chamar a operação DescribeRegions para consultar a lista de regiões mais recente.	cn-hangzhou
OperationId	string	Sim	O ID da operação. Você pode chamar a operação ListStackGroupOperations para obter o ID da operação.	6da106ca-1784-4a6f-a7e1-e723863d****

Para obter mais informações sobre os 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.	14A07460-EBE7-47CA-9757-12CC4761D47A
StackGroupOperation	object	Os detalhes da operação do grupo de pilhas.
Status	string	O status da operação. Valores válidos: RUNNING: A operação está em andamento. SUCCEEDED: A operação foi bem-sucedida. FAILED: A operação falhou. STOPPING: A operação está sendo interrompida. STOPPED: A operação foi interrompida.	SUCCEEDED
StackGroupId	string	O ID do grupo de pilhas.	fd0ddef9-9540-4b42-a464-94f77835****
Action	string	A ação da operação. Valores válidos: CREATE: criar UPDATE: atualizar DELETE: excluir DETECT_DRIFT: detecção de desvio	DELETE
CreateTime	string	A hora de início da operação.	2020-01-20T09:22:3
RetainStacks	boolean	Indica se as pilhas devem ser retidas. Ao excluir uma instância de pilha, você pode optar por excluir ou reter a pilha para a qual a instância aponta. Valores válidos: true: Apenas a instância de pilha é excluída e a pilha correspondente é retida. false: Tanto a instância de pilha quanto a pilha correspondente são excluídas. Prossiga com cautela. Nota Este parâmetro é retornado apenas quando você exclui uma instância de pilha.	true
StackGroupName	string	O nome do grupo de pilhas.	MyStackGroup
OperationId	string	O ID da operação do grupo de pilhas.	6da106ca-1784-4a6f-a7e1-e723863d****
OperationDescription	string	A descrição da operação. Nota Este parâmetro é retornado apenas quando você chama a operação CreateStackInstances para criar instâncias de pilha e especifica o parâmetro de solicitação OperationDescription.	Create stack instance in hangzhou
StackGroupDriftDetectionDetail	object	Os detalhes da detecção de desvio. Nota Este parâmetro é retornado apenas quando você executa uma operação de detecção de desvio.
DriftDetectionTime	string	A hora em que a detecção de desvio foi executada. O horário segue o formato YYYY-MM-DDThh:mm:ss.	2020-02-27T07:47:47
TotalStackInstancesCount	integer	O número total de instâncias de pilha.	2
FailedStackInstancesCount	integer	O número de instâncias de pilha para as quais a detecção de desvio falhou.	0
DriftDetectionStatus	string	O status da detecção de desvio. Valores válidos: COMPLETED: A detecção de desvio no grupo de pilhas foi concluída e a detecção de desvio em todas as instâncias de pilha foi bem-sucedida. FAILED: A detecção de desvio no grupo de pilhas foi concluída e o número de instâncias de pilha para as quais a detecção de desvio falhou excede o limite especificado. PARTIAL_SUCCESS: A detecção de desvio no grupo de pilhas foi concluída e a detecção de desvio em algumas instâncias de pilha falhou, mas o número de instâncias com falha não excede o limite. IN_PROGRESS: A detecção de desvio no grupo de pilhas está em andamento. STOPPED: A detecção de desvio no grupo de pilhas foi cancelada pelo usuário.	COMPLETED
StackGroupDriftStatus	string	O status de desvio do grupo de pilhas. Valores válidos: DRIFTED: Pelo menos uma instância de pilha apresentou desvio. NOT_CHECKED: Nenhuma detecção de desvio bem-sucedida foi executada no grupo de pilhas. IN_SYNC: Todas as instâncias de pilha estão sincronizadas.	DRIFTED
InProgressStackInstancesCount	integer	O número de instâncias de pilha para as quais a detecção de desvio está em andamento.	0
InSyncStackInstancesCount	integer	O número de instâncias de pilha que estão sincronizadas.	1
CancelledStackInstancesCount	integer	O número de instâncias de pilha para as quais a detecção de desvio foi cancelada.	0
DriftedStackInstancesCount	integer	O número de instâncias de pilha que apresentaram desvio.	1
OperationPreferences	object	As preferências da operação.
MaxConcurrentCount	integer	O número máximo de contas simultâneas. Este é o número de contas nas quais a implantação de pilhas pode ser executada simultaneamente em cada região. Valores válidos: 1 a 20. Nota Apenas um dos parâmetros MaxConcurrentCount e MaxConcurrentPercentage é retornado.	1
FailureToleranceCount	integer	A contagem de tolerância a falhas. Este é o número de contas nas quais as implantações de pilhas podem falhar em cada região antes que a operação seja interrompida na região. Se a operação for interrompida em uma região, ela não continuará em outras regiões. Valores válidos: 0 a 20. Nota Apenas um dos parâmetros FailureToleranceCount e FailureTolerancePercentage é retornado.	1
MaxConcurrentPercentage	integer	A porcentagem máxima de contas simultâneas. Esta é a porcentagem de contas nas quais as pilhas podem ser implantadas simultaneamente em cada região em relação ao número total de contas. Valores válidos: 1 a 100. Nota Apenas um dos parâmetros MaxConcurrentCount e MaxConcurrentPercentage é retornado.	10
RegionIdsOrder	array	A lista de regiões na ordem de execução da operação.
	string	A lista de regiões na ordem de execução da operação.	["cn-hangzhou","cn-beijing"]
FailureTolerancePercentage	integer	A porcentagem de tolerância a falhas. Esta é a porcentagem de contas nas quais as implantações de pilhas podem falhar em cada região em relação ao número total de contas antes que a operação seja interrompida na região. Valores válidos: 0 a 100. Nota Apenas um dos parâmetros FailureToleranceCount e FailureTolerancePercentage é retornado.	10
EndTime	string	A hora de término da operação.	2020-01-20T09:22:4
ExecutionRoleName	string	O nome da função de execução do RAM assumida pela função de administrador (AliyunROSStackGroupAdministrationRole) quando você cria um grupo de pilhas com permissões autogerenciadas. Se você não especificar este parâmetro, o valor padrão AliyunROSStackGroupExecutionRole será retornado.	AliyunROSStackGroupExecutionRole
AdministrationRoleName	string	O nome da função de administrador do RAM assumida pelo Resource Orchestration Service (ROS) quando você cria um grupo de pilhas com permissões autogerenciadas. Se você não especificar este parâmetro, o valor padrão AliyunROSStackGroupAdministrationRole será retornado.	AliyunROSStackGroupAdministrationRole
DeploymentTargets	object	Os destinos de implantação das instâncias de pilha quando o modo de permissões gerenciadas pelo serviço é usado.
RdFolderIds	array	Os IDs das pastas no diretório de recursos.
	string	Os IDs das pastas no diretório de recursos.	["fd-4PvlVLOL8v"]
AccountIds	array	Os IDs das contas de membro no diretório de recursos. Nota Este parâmetro é retornado apenas quando você chama a operação UpdateStackInstances para atualizar instâncias de pilha e especifica o parâmetro de solicitação AccountIds.
	string	Os IDs das contas de membro no diretório de recursos. Nota Este parâmetro é retornado apenas quando você chama a operação UpdateStackInstances para atualizar instâncias de pilha e especifica o parâmetro de solicitação AccountIds.	["151266687691**","141261387191**"]

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupOperation": {
    "Status": "SUCCEEDED",
    "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
    "Action": "DELETE",
    "CreateTime": "2020-01-20T09:22:3",
    "RetainStacks": true,
    "StackGroupName": "MyStackGroup",
    "OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****",
    "OperationDescription": "Create stack instance in hangzhou",
    "StackGroupDriftDetectionDetail": {
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "TotalStackInstancesCount": 2,
      "FailedStackInstancesCount": 0,
      "DriftDetectionStatus": "COMPLETED",
      "StackGroupDriftStatus": "DRIFTED",
      "InProgressStackInstancesCount": 0,
      "InSyncStackInstancesCount": 1,
      "CancelledStackInstancesCount": 0,
      "DriftedStackInstancesCount": 1
    },
    "OperationPreferences": {
      "MaxConcurrentCount": 1,
      "FailureToleranceCount": 1,
      "MaxConcurrentPercentage": 10,
      "RegionIdsOrder": [
        "[\"cn-hangzhou\",\"cn-beijing\"]"
      ],
      "FailureTolerancePercentage": 10
    },
    "EndTime": "2020-01-20T09:22:4",
    "ExecutionRoleName": "AliyunROSStackGroupExecutionRole",
    "AdministrationRoleName": "AliyunROSStackGroupAdministrationRole",
    "DeploymentTargets": {
      "RdFolderIds": [
        "[\"fd-4PvlVLOL8v\"]"
      ],
      "AccountIds": [
        "[\"151266687691****\",\"141261387191****\"]"
      ]
    }
  }
}

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.