Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::ROS::StackInstance

Última atualização: Jun 27, 2026

Consulta os detalhes de uma instância de stack associada a um grupo de stacks.

Sintaxe

{
  "Type": "DATASOURCE::ROS::StackInstance",
  "Properties": {
    "StackInstanceAccountId": String,
    "StackGroupName": String,
    "StackInstanceRegionId": String,
    "OutputOption": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

StackInstanceAccountId

String

Sim

Sim

ID da conta à qual a instância de stack pertence.

Nenhuma.

StackGroupName

String

Sim

Sim

Nome do grupo de stacks.

Nenhuma.

StackInstanceRegionId

String

Sim

Sim

ID da região da instância de stack.

Nenhuma.

OutputOption

String

Não

Sim

Define se as saídas da stack serão retornadas.

Nenhuma.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos de source de dados ao atualizar a stack.

Valores válidos:

  • Never (padrão): não atualiza os recursos de source de dados ao atualizar a stack.

  • Always: atualiza os recursos de source de dados ao atualizar a stack.

Valores de retorno

Fn::GetAtt

  • Status: estado da stack.

  • AccountId: ID da conta à qual a stack pertence.

  • StatusReason: motivo do estado.

  • ParameterOverrides: substituições de parâmetros aplicadas à instância de stack.

  • StackGroupName: nome do grupo de stacks.

  • Outputs: saídas da stack.

  • RdFolderId: ID da pasta do diretório de recursos.

  • DriftDetectionTime: horário da última detecção de desvio bem-sucedida.

  • StackGroupId: ID do grupo de stacks.

  • RegionId: ID da região da stack.

  • StackDriftStatus: status de desvio da stack na última detecção bem-sucedida.

  • StackId: ID da stack.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  OutputOption:
    Description:
      en: Whether to return the Outputs parameter resource stack output list.
    Required: false
    Type: String
  StackGroupName:
    Description:
      en: 'Resource stack group name. Names are unique within a single region.

        The length must not exceed 255 characters, must start with a number or an
        English letter, and can contain numbers, English letters, dashes (-) and underscores
        (_)'
    Required: true
    Type: String
  StackInstanceAccountId:
    Description:
      en: "The target account ID to which the resource stack belongs. \nIn the self-service\
        \ management permission mode, the account is an Alibaba Cloud account.\nIn\
        \ service management permission mode, this account is a member account of\
        \ the resource directory."
    Required: true
    Type: String
  StackInstanceRegionId:
    Description:
      en: The region to which the resource stack belongs.
    Required: true
    Type: String
Resources:
  ExtensionDataSource:
    Properties:
      OutputOption:
        Ref: OutputOption
      StackGroupName:
        Ref: StackGroupName
      StackInstanceAccountId:
        Ref: StackInstanceAccountId
      StackInstanceRegionId:
        Ref: StackInstanceRegionId
    Type: DATASOURCE::ROS::StackInstance
Outputs:
  AccountId:
    Description: The account id of the stack.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - AccountId
  DriftDetectionTime:
    Description: The time when the resource stack group last successfully completed
      deviation detection.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - DriftDetectionTime
  Outputs:
    Description: The outputs of the stack instance
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Outputs
  ParameterOverrides:
    Description: Override parameter list.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - ParameterOverrides
  RdFolderId:
    Description: The resource folder ID of the resource directory.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - RdFolderId
  RegionId:
    Description: The region id of the stack.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - RegionId
  StackDriftStatus:
    Description: The status of the last successful deviation detection of the resource
      stack group.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StackDriftStatus
  StackGroupId:
    Description: The resource stack group ID.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StackGroupId
  StackGroupName:
    Description: The resource stack group name
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StackGroupName
  StackId:
    Description: The stack id of stack instance.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StackId
  Status:
    Description: Resource stack status.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Status
  StatusReason:
    Description: Status reason description.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StatusReason
                        
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "StackInstanceAccountId": {
      "Type": "String",
      "Description": {
        "en": "The target account ID to which the resource stack belongs. \nIn the self-service management permission mode, the account is an Alibaba Cloud account.\nIn service management permission mode, this account is a member account of the resource directory."
      },
      "Required": true
    },
    "StackGroupName": {
      "Type": "String",
      "Description": {
        "en": "Resource stack group name. Names are unique within a single region.\nThe length must not exceed 255 characters, must start with a number or an English letter, and can contain numbers, English letters, dashes (-) and underscores (_)"
      },
      "Required": true
    },
    "StackInstanceRegionId": {
      "Type": "String",
      "Description": {
        "en": "The region to which the resource stack belongs."
      },
      "Required": true
    },
    "OutputOption": {
      "Type": "String",
      "Description": {
        "en": "Whether to return the Outputs parameter resource stack output list."
      },
      "Required": false
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::ROS::StackInstance",
      "Properties": {
        "StackInstanceAccountId": {
          "Ref": "StackInstanceAccountId"
        },
        "StackGroupName": {
          "Ref": "StackGroupName"
        },
        "StackInstanceRegionId": {
          "Ref": "StackInstanceRegionId"
        },
        "OutputOption": {
          "Ref": "OutputOption"
        }
      }
    }
  },
  "Outputs": {
    "Status": {
      "Description": "Resource stack status.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Status"
        ]
      }
    },
    "AccountId": {
      "Description": "The account id of the stack.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "AccountId"
        ]
      }
    },
    "StatusReason": {
      "Description": "Status reason description.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StatusReason"
        ]
      }
    },
    "ParameterOverrides": {
      "Description": "Override parameter list.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ParameterOverrides"
        ]
      }
    },
    "StackGroupName": {
      "Description": "The resource stack group name",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StackGroupName"
        ]
      }
    },
    "Outputs": {
      "Description": "The outputs of the stack instance",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Outputs"
        ]
      }
    },
    "RdFolderId": {
      "Description": "The resource folder ID of the resource directory.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "RdFolderId"
        ]
      }
    },
    "DriftDetectionTime": {
      "Description": "The time when the resource stack group last successfully completed deviation detection.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DriftDetectionTime"
        ]
      }
    },
    "StackGroupId": {
      "Description": "The resource stack group ID.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StackGroupId"
        ]
      }
    },
    "RegionId": {
      "Description": "The region id of the stack.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "RegionId"
        ]
      }
    },
    "StackDriftStatus": {
      "Description": "The status of the last successful deviation detection of the resource stack group.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StackDriftStatus"
        ]
      }
    },
    "StackId": {
      "Description": "The stack id of stack instance.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StackId"
        ]
      }
    }
  }
}