Todos os produtos
Search

Este produto

    Resource Orchestration Service:ListStacks

    Central de documentação

    Resource Orchestration Service:ListStacks

    Última atualização: Jul 04, 2026

    Consulta a lista de stacks.

    Descrição da operação

    Descrição da operação

    Este tópico fornece um exemplo de como consultar a lista de stacks na região da 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:ListStacks

    get

    *Stack

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

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    PageSize

    integer

    Não

    O número de entradas por página quando a paginação é usada.

    Valor máximo: 50.

    Valor padrão: 10.

    10
    ParentStackId

    string

    Não

    O ID da stack pai.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    RegionId

    string

    Sim

    O ID da região da stack. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.

    cn-hangzhou
    PageNumber

    integer

    Não

    O número da página da lista de stacks.

    Valor inicial: 1.

    Valor padrão: 1.

    1
    ShowNestedStack

    boolean

    Não

    Especifica se as stacks aninhadas devem ser listadas. Valores válidos:

    • true

    • false (padrão)

    Nota

    Se ParentStackId for especificado, este valor será definido como true.

    true
    StackId

    string

    Não

    O ID da stack. Se você não precisar de informações detalhadas da stack, poderá especificar este parâmetro em vez de chamar a operação GetStack.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    Status

    array

    Não

    O status da stack.

    CREATE_COMPLETE

    string

    Não

    O status da stack. Valores válidos:

    • CREATE_IN_PROGRESS: A stack está sendo criada.

    • CREATE_FAILED: Falha ao criar a stack.

    • CREATE_COMPLETE: A stack foi criada.

    • UPDATE_IN_PROGRESS: A stack está sendo atualizada.

    • UPDATE_FAILED: Falha ao atualizar a stack.

    • UPDATE_COMPLETE: A stack foi atualizada.

    • DELETE_IN_PROGRESS: A stack está sendo excluída.

    • DELETE_FAILED: Falha ao excluir a stack.

    • CREATE_ROLLBACK_IN_PROGRESS: A stack está sendo revertida após uma falha de criação.

    • CREATE_ROLLBACK_FAILED: Falha ao reverter a stack após uma falha de criação.

    • CREATE_ROLLBACK_COMPLETE: A stack foi revertida após uma falha de criação.

    • ROLLBACK_IN_PROGRESS: A stack está sendo revertida.

    • ROLLBACK_FAILED: Falha ao reverter a stack.

    • ROLLBACK_COMPLETE: A stack foi revertida.

    • CHECK_IN_PROGRESS: A stack está sendo validada.

    • CHECK_FAILED: Falha ao validar a stack.

    • CHECK_COMPLETE: A stack foi validada.

    • REVIEW_IN_PROGRESS: A stack está sendo revisada.

    • IMPORT_CREATE_IN_PROGRESS: A stack está sendo criada por meio de importação de recursos.

    • IMPORT_CREATE_FAILED: Falha ao criar a stack por meio de importação de recursos.

    • IMPORT_CREATE_COMPLETE: A stack foi criada por meio de importação de recursos.

    • IMPORT_CREATE_ROLLBACK_IN_PROGRESS: A stack está sendo revertida após uma falha de criação por meio de importação de recursos.

    • IMPORT_CREATE_ROLLBACK_FAILED: Falha ao reverter a stack após uma falha de criação por meio de importação de recursos.

    • IMPORT_CREATE_ROLLBACK_COMPLETE: A stack foi revertida após uma falha de criação por meio de importação de recursos.

    • IMPORT_UPDATE_IN_PROGRESS: A stack está sendo atualizada por meio de importação de recursos.

    • IMPORT_UPDATE_FAILED: Falha ao atualizar a stack por meio de importação de recursos.

    • IMPORT_UPDATE_COMPLETE: A stack foi atualizada por meio de importação de recursos.

    • IMPORT_UPDATE_ROLLBACK_IN_PROGRESS: A stack está sendo revertida após uma falha de atualização por meio de importação de recursos.

    • IMPORT_UPDATE_ROLLBACK_FAILED: Falha ao reverter a stack após uma falha de atualização por meio de importação de recursos.

    • IMPORT_UPDATE_ROLLBACK_COMPLETE: A stack foi revertida após uma falha de atualização por meio de importação de recursos.

    CREATE_COMPLETE
    StackName

    array

    Não

    O nome da stack.

    MyStack

    string

    Não

    O nome da stack.
    O nome pode ter até 255 caracteres e deve começar com um dígito ou letra. Pode conter dígitos, letras, hifens (-) e sublinhados (_). Asteriscos (*) podem ser usados para correspondência aproximada.

    Valores válidos de N: 1 a 5.

    MyStack
    Tag

    array<object>

    Não

    As tags da stack.

    object

    Não

    Key

    string

    Não

    A chave da tag da stack.
    Valores válidos de N: 1 a 20.

    usage
    Value

    string

    Não

    O valor da tag da stack.
    Valores válidos de N: 1 a 20.

    test
    ResourceGroupId

    string

    Não

    O ID do grupo de recursos.
    Para obter mais informações sobre grupos de recursos, consulte O que é um grupo de recursos?.

    rg-acfmxazb4ph6aiy****
    StackIds

    array

    Não

    A lista de IDs de stacks.

    string

    Não

    O ID da stack. Você pode especificar vários IDs de stacks para consultar os detalhes de várias stacks ao mesmo tempo. Valores válidos de N: 1 a 10.

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    StartTime

    string

    Não

    O início do intervalo de tempo para filtragem por hora de criação. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC+0.

    2023-04-01T15:10:00Z
    EndTime

    string

    Não

    O fim do intervalo de tempo para filtragem por hora de criação. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC+0.

    2023-04-01T15:16:00Z

    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

    TotalCount

    integer

    O número total de stacks.

    2
    PageSize

    integer

    O número de entradas por página nas configurações de paginação.

    Valor máximo: 50.

    Valor padrão: 10.

    10
    RequestId

    string

    O ID da solicitação.

    FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7
    PageNumber

    integer

    O número da página da lista de stacks.

    1
    Stacks

    array<object>

    A lista de stacks.

    array<object>

    Status

    string

    O status da stack.

    CREATE_COMPLETE
    UpdateTime

    string

    A hora em que a stack foi atualizada pela última vez. A hora é exibida em UTC+0 no formato padrão ISO 8601 sem o sufixo Z. Formato: YYYY-MM-DDThh:mm:ss.

    2022-03-10T07:44:36
    DriftDetectionTime

    string

    A hora em que a detecção de desvio bem-sucedida mais recente foi realizada na stack.

    2022-03-10T06:46:36
    StatusReason

    string

    O motivo pelo qual a stack está em seu status atual.

    Stack CREATE completed successfully
    CreateTime

    string

    A hora em que a stack foi criada. A hora é exibida em UTC+0 no formato padrão ISO 8601 sem o sufixo Z. Formato: YYYY-MM-DDThh:mm:ss.

    2022-03-10T06:44:36
    DisableRollback

    boolean

    Indica se a reversão está desativada quando a stack falha ao ser criada. Valores válidos:

    • true: A reversão está desativada.

    • false (padrão): A reversão está ativada.

    false
    Tags

    array<object>

    As tags da stack.

    object

    Key

    string

    The tag key of the stack.

    acs:rm:rgId
    Value

    string

    The tag value of the stack.

    rg-aek2frunvw7****
    StackName

    string

    O nome da stack.

    MyStack
    TimeoutInMinutes

    integer

    O período de tempo limite para a criação da stack. Unidade: minutos. Valores válidos: 10, 20, 60, 120 e 1440.

    Essas informações são geradas com base em logs de chamadas e podem estar incompletas. Verifique as informações.

    60
    RegionId

    string

    O ID da região da stack. Você pode chamar DescribeRegions para consultar a lista de regiões mais recente.

    cn-hangzhou
    ParentStackId

    string

    O ID da stack pai.

    4a6c9851-3b0f-4f5f-b4ca-a14bf692****
    StackId

    string

    O ID da stack.

    67805444-a605-45ee-a57f-83908ff6****
    StackDriftStatus

    string

    O status de desvio da stack na detecção de desvio bem-sucedida mais recente. Valores válidos:

    • DRIFTED: A stack sofreu desvio.

    • NOT_CHECKED: Nenhuma detecção de desvio bem-sucedida foi realizada na stack.

    • IN_SYNC: A stack está sincronizada.

    IN_SYNC
    StackType

    string

    O tipo da stack. Valores válidos:

    • ROS: A stack usa um modelo do ROS.

    • Terraform: A stack usa um modelo do Terraform.

    ROS
    ResourceGroupId

    string

    O ID do grupo de recursos.

    rg-aek2frunvw7****
    ServiceManaged

    boolean

    Indica se a stack é uma stack gerenciada. Valores válidos:

    • true: A stack é uma stack gerenciada.

    • false: A stack não é uma stack gerenciada.

    false
    ServiceName

    string

    O nome do serviço ao qual a stack gerenciada pertence.

    ACVS
    OperationInfo

    object

    As informações suplementares que são retornadas quando ocorre um erro durante uma operação de stack.

    Nota

    Esta propriedade de resposta é retornada apenas em casos específicos e contém pelo menos uma subpropriedade. Por exemplo, ocorre um erro quando outra API de serviço de nuvem é chamada.

    Code

    string

    The error code. Valid values:

    • Forbidden.RAM: Access denied by RAM.

    • InvalidAccountStatus.NotEnoughBalance: Insufficient account balance.

    • OrderError.EIP: EIP order error.

    • QuotaExceeded.Eip: EIP quota exceeded.

    This information is generated based on call logs and may be incomplete. Verify the information.

    DependencyViolation
    Message

    string

    The error message.

    There is still instance(s) in the specified security group.
    RequestId

    string

    The request ID of the API call to another cloud service.

    071D6166-3F6B-5C7B-A1F0-0113FBB643A8
    Action

    string

    The name of the API operation called on another cloud service.

    DeleteSecurityGroup
    ResourceType

    string

    The resource type on which the operation error occurred.

    ALIYUN::ECS::SecurityGroup
    LogicalResourceId

    string

    The logical ID of the resource on which the operation error occurred.

    EcsSecurityGroup
    DeletionProtection

    string

    Indica se a proteção contra exclusão está ativada para a stack. Valores válidos:

    • Enabled: A proteção contra exclusão está ativada.

    • Disabled: A proteção contra exclusão está desativada. Você pode excluir a stack usando o console ou chamando a operação DeleteStack.

    Nota

    O mecanismo de proteção contra exclusão de uma stack aninhada é o mesmo da stack raiz.

    Valores válidos:

    • Enabled :

      Enabled.

    • Disabled :

      Disabled.

    Disabled

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "TotalCount": 2,
  "PageSize": 10,
  "RequestId": "FBAC80B4-9C27-529D-BC9C-4155FA5CD7A7",
  "PageNumber": 1,
  "Stacks": [
    {
      "Status": "CREATE_COMPLETE",
      "UpdateTime": "2022-03-10T07:44:36",
      "DriftDetectionTime": "2022-03-10T06:46:36",
      "StatusReason": "Stack CREATE completed successfully",
      "CreateTime": "2022-03-10T06:44:36",
      "DisableRollback": false,
      "Tags": [
        {
          "Key": "acs:rm:rgId",
          "Value": "rg-aek2frunvw7****"
        }
      ],
      "StackName": "MyStack",
      "TimeoutInMinutes": 60,
      "RegionId": "cn-hangzhou",
      "ParentStackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf692****",
      "StackId": "67805444-a605-45ee-a57f-83908ff6****",
      "StackDriftStatus": "IN_SYNC",
      "StackType": "ROS",
      "ResourceGroupId": "rg-aek2frunvw7****",
      "ServiceManaged": false,
      "ServiceName": "ACVS",
      "OperationInfo": {
        "Code": "DependencyViolation",
        "Message": "There is still instance(s) in the specified security group.",
        "RequestId": "071D6166-3F6B-5C7B-A1F0-0113FBB643A8",
        "Action": "DeleteSecurityGroup",
        "ResourceType": "ALIYUN::ECS::SecurityGroup",
        "LogicalResourceId": "EcsSecurityGroup"
      },
      "DeletionProtection": "Disabled"
    }
  ]
}

    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.