Todos os produtos
Search

Este produto

    Resource Orchestration Service:GetStackResource

    Central de documentação

    Resource Orchestration Service:GetStackResource

    Última atualização: Oct 12, 2026

    Consulta um recurso em uma pilha.

    Descrição da operação

    Este tópico fornece um exemplo que mostra como consultar os detalhes de um recurso chamado WebServer em uma pilha cujo ID é 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** 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:GetStackResource

    get

    *stack.

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

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    StackId

    string

    Sim

    O ID da pilha.

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

    string

    Não

    Garante a idempotência da solicitação. O valor é gerado pelo cliente e deve ser globalmente exclusivo. O valor 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****
    RegionId

    string

    Sim

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

    cn-hangzhou
    ShowResourceAttributes

    boolean

    Não

    Especifica se os atributos do recurso devem ser consultados. Valores válidos:

    • true: Consulta os atributos do recurso.

    • false: Não consulta os atributos do recurso.

    true
    LogicalResourceId

    string

    Sim

    O ID lógico do recurso, que é o nome do recurso no modelo.

    WebServer
    ResourceAttributes

    array

    Não

    Especifica a lista de atributos de saída do recurso a serem consultados.

    Nota

    O valor máximo de N é 20.

    string

    Não

    Especifica o nome do atributo de saída do recurso a ser consultado.

    Nota

    O valor máximo de N é 20.

    InstanceId

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

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    Status

    string

    O status do recurso. Valores válidos:

    • CREATE_COMPLETE

    • CREATE_FAILED

    • CREATE_IN_PROGRESS

    • UPDATE_IN_PROGRESS

    • UPDATE_FAILED

    • UPDATE_COMPLETE

    • DELETE_IN_PROGRESS

    • DELETE_FAILED

    • CHECK_IN_PROGRESS

    • CHECK_FAILED

    • CHECK_COMPLETE

    • IMPORT_IN_PROGRESS

    • IMPORT_FAILED

    • IMPORT_COMPLETE

    CREATE_COMPLETE
    Description

    string

    A descrição do recurso.

    no description
    RequestId

    string

    O ID da solicitação.

    B288A0BE-D927-4888-B0F7-B35EF84B6E6
    StatusReason

    string

    O motivo do status do recurso.

    state changed
    PhysicalResourceId

    string

    O ID físico do recurso, que é o ID real do recurso.

    d04af923-e6b7-4272-aeaa-47ec9777****
    CreateTime

    string

    A hora de criação. A hora é exibida em UTC sem o sufixo Z e segue o padrão ISO 8601 no formato AAAA-MM-DDThh:mm:ss.

    2019-08-01T06:01:23
    Metadata

    object

    Os metadados.

    {"key": "value"}
    ResourceType

    string

    O tipo de recurso.

    ALIYUN::ROS::WaitConditionHandle
    ResourceAttributes

    array<object>

    A lista de atributos do recurso.

    object

    A lista de atributos do recurso.

    [{"ResourceAttributeKey": "CurlCli","ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\\&resource=WaitConditionHandle\\&expire=156468****\\&signature=991d910a901a89db6580d74233119960c004****"}]
    LogicalResourceId

    string

    O ID lógico do recurso, que é o nome do recurso no modelo.

    WebServer
    ResourceDriftStatus

    string

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

    • DELETED: O recurso difere de sua configuração de modelo esperada porque o recurso foi excluído.

    • MODIFIED: O recurso difere de sua configuração de modelo esperada.

    • NOT_CHECKED: O Resource Orchestration Service (ROS) não verificou se o recurso difere de sua configuração de modelo esperada.

    • IN_SYNC: A configuração atual do recurso corresponde à sua configuração de modelo esperada.

    IN_SYNC
    UpdateTime

    string

    A hora de atualização. A hora é exibida em UTC sem o sufixo Z e segue o padrão ISO 8601 no formato AAAA-MM-DDThh:mm:ss.

    2019-08-01T06:01:29
    DriftDetectionTime

    string

    A hora em que o recurso foi verificado na detecção de desvio bem-sucedida mais recente da pilha. A hora segue o formato AAAA-MM-DDThh:mm:ss.

    2020-02-27T07:47:47
    StackName

    string

    O nome da pilha. O nome pode ter até 255 caracteres e pode conter dígitos, letras, hifens (-) e sublinhados (_). Deve começar com um dígito ou uma letra.

    test-describe-resource
    StackId

    string

    O ID da pilha.

    efdf5c10-96a5-4fd7-ab89-68e7baa2****
    ModuleInfo

    object

    As informações sobre o módulo do qual o recurso se origina. Este parâmetro é retornado apenas quando o recurso se origina de um módulo.

    LogicalIdHierarchy

    string

    A lista concatenada de IDs lógicos de um ou mais módulos que contêm o recurso. Os módulos são listados a partir do módulo mais externo e separados por barras (/).

    No exemplo a seguir, o recurso é criado a partir do moduleB, que está aninhado no módulo pai moduleA.

    moduleA/moduleB

    moduleA/moduleB

    TypeHierarchy

    string

    A lista concatenada de tipos de um ou mais módulos que contêm o recurso. Os tipos de módulo são listados a partir do módulo mais externo e separados por barras (/).

    No exemplo a seguir, o recurso é criado a partir de um módulo do tipo MODULE::ROS::Child::Example, que está aninhado em um módulo pai do tipo MODULE::ROS::Parent::Example.

    MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example

    MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Status": "CREATE_COMPLETE",
  "Description": "no description",
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StatusReason": "state changed",
  "PhysicalResourceId": "d04af923-e6b7-4272-aeaa-47ec9777****",
  "CreateTime": "2019-08-01T06:01:23",
  "Metadata": {
    "key": "value"
  },
  "ResourceType": "ALIYUN::ROS::WaitConditionHandle",
  "ResourceAttributes": [
    [
      {
        "ResourceAttributeKey": "CurlCli",
        "ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\\&resource=WaitConditionHandle\\&expire=156468****\\&signature=991d910a901a89db6580d74233119960c004****"
      }
    ]
  ],
  "LogicalResourceId": "WebServer",
  "ResourceDriftStatus": "IN_SYNC",
  "UpdateTime": "2019-08-01T06:01:29",
  "DriftDetectionTime": "2020-02-27T07:47:47",
  "StackName": "test-describe-resource",
  "StackId": "efdf5c10-96a5-4fd7-ab89-68e7baa2****",
  "ModuleInfo": {
    "LogicalIdHierarchy": "moduleA/moduleB\n",
    "TypeHierarchy": "MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example"
  }
}

    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.