Todos los productos
Search
Centro de documentos

:ListTemplateScratches

Última actualización: Sep 04, 2026

Consulta la lista de escenarios.

Este tema proporciona un ejemplo sobre cómo consultar la lista de escenarios. En este ejemplo, se consultan los escenarios creados en la región China (Hangzhou). A continuación se devuelven los siguientes escenarios: gestión de recursos y replicación de recursos.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de muestra de la operación para diferentes SDK.

Parámetros de solicitud

ParámetroTipoObligatorioEjemploDescripción
ActionStringSíListTemplateScratches

La operación que desea realizar. Establezca el valor en ListTemplateScratches.

RegionIdStringSícn-hangzhou

El ID de la región donde se creó el escenario.

Puede llamar a la operación DescribeRegions para consultar la lista de regiones más reciente.

TemplateScratchIdStringNots-7f7a704cf71c49a6****

El ID del escenario.

TemplateScratchTypeStringNoArchitectureReplication

El tipo de escenario. Valores válidos:

  • ResourceImport: gestión de recursos
  • ArchitectureReplication: replicación de recursos
StatusStringNo["GENERATE_COMPLETE"]

El estado del escenario. Valores válidos:

  • GENERATE_IN_PROGRESS: El escenario se está creando.
  • GENERATE_COMPLETE: El escenario se ha creado.
  • GENERATE_FAILED: Error al crear el escenario.
Tags.N.KeyStringSíusage

La clave de la etiqueta N agregada al escenario.

Nota El parámetro Tags es opcional. Si especifica el parámetro Tags, debe especificar el parámetro Tags.N.Key.
Tags.N.ValueStringNotest

El valor de la etiqueta N agregada al escenario.

PageSizeIntegerNo10

El número de entradas que se devolverán en cada página.

Valor máximo: 50.

Valor predeterminado: 10.

PageNumberIntegerNo1

El número de la página que se devolverá.

Las páginas comienzan desde la página 1.

Valor predeterminado: 1.

Para obtener más información sobre los parámetros de solicitud comunes, consulte Parámetros comunes.

Parámetros de respuesta

ParámetroTipoEjemploDescripción
RequestIdStringD1C09606-C58B-558F-9B4E-5BF263D17D09

El ID de la solicitud.

TotalCountInteger2

El número total de escenarios.

PageNumberInteger1

El número de la página devuelta.

PageSizeInteger10

El número de entradas devueltas por página.

TemplateScratchesArray of TemplateScratch

La lista de escenarios.

TemplateScratchIdStringts-48ad85d66cca4620****

El ID del escenario.

TemplateScratchTypeStringResourceImport

El tipo de escenario. Valores válidos:

  • ResourceImport: gestión de recursos
  • ArchitectureReplication: replicación de recursos
StatusStringGENERATE_COMPLETE

El estado del escenario.

StatusReasonStringResource ALIYUN::ECS::VPC vpc-m5eauuq80anx59v28**** could not be found for template scratch.

El motivo por el cual falló la creación del escenario.

Nota Este parámetro se devuelve solo si el parámetro Status está establecido en GENERATE_FAILED.
FailedCodeStringInvalidZoneId

El código de estado del escenario cuya creación falló.

Nota Este parámetro se devuelve solo si el parámetro Status está establecido en GENERATE_FAILED.
PreferenceParametersArray of PreferenceParameter

Los parámetros configurados para el escenario.

ParameterKeyStringDeletionPolicy

El nombre del parámetro.

ParameterValueStringRetain

El valor del parámetro.

DescriptionStringManages the virtual private cloud (VPC) resource.

La descripción del escenario.

SourceResourcesArray of SourceResource

Los recursos de origen.

ResourceIdStringvpc-m5eauuq80anx59v28****

El ID del recurso.

ResourceTypeStringALIYUN::ECS::VPC

El tipo de recurso.

SourceTagObject

La etiqueta de origen.

ResourceTagsMap

Las etiquetas de origen.

ResourceTypeFilterArray of StringALIYUN::ECS::VPC

El filtro para tipos de recursos.

SourceResourceGroupObject

El resource group de origen.

ResourceGroupIdStringrg-acfmzawhxxc****

El ID del resource group de origen.

ResourceTypeFilterArray of StringALIYUN::ECS::VPC

El filtro para tipos de recursos.

LogicalIdStrategyStringLongTypePrefixAndIndexSuffix

La directiva según la cual se genera el ID lógico. Valor predeterminado: LongTypePrefixAndIndexSuffix. Valores válidos:

  • LongTypePrefixAndIndexSuffix: prefijo de tipo largo + sufijo de tipo índice
  • LongTypePrefixAndHashSuffix: prefijo de tipo largo + sufijo de tipo hash
  • ShortTypePrefixAndHashSuffix: prefijo de tipo corto + sufijo de tipo hash
TagsArray of Tags

Las etiquetas del escenario.

KeyStringusage1

La clave de la etiqueta del escenario.

ValueStringtest1

El valor de la etiqueta del escenario.

CreateTimeString2021-12-07T08:06:44

La hora en que se creó el escenario.

La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss. La hora se muestra en UTC.

UpdateTimeString2021-12-07T08:06:44

La hora en que se actualizó el escenario.

La hora sigue el estándar ISO 8601 en formato AAAA-MM-DDThh:mm:ss. La hora se muestra en UTC.

Ejemplos

Solicitudes de muestra

http(s)://[Endpoint]/?Action=ListTemplateScratches
&RegionId=cn-hangzhou
&<Common request parameters>

Respuestas exitosas de muestra

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTemplateScratchesResponse>
    <RequestId>D1C09606-C58B-558F-9B4E-5BF263D17D09</RequestId>
    <TotalCount>2</TotalCount>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TemplateScratches>
        <TemplateScratchId>ts-48ad85d66cca4620****</TemplateScratchId>
        <TemplateScratchType>ResourceImport</TemplateScratchType>
        <Status>GENERATE_COMPLETE</Status>
        <StatusReason>Resource ALIYUN::ECS::VPC vpc-m5eauuq80anx59v28**** could not be found for template scratch.</StatusReason>
        <FailedCode>InvalidZoneId</FailedCode>
        <PreferenceParameters>
            <ParameterKey>DeletionPolicy</ParameterKey>
            <ParameterValue>Retain</ParameterValue>
        </PreferenceParameters>
        <Description> Manages the VPC resource. </Description>
        <SourceResources>
            <ResourceId>vpc-m5eauuq80anx59v28****</ResourceId>
            <ResourceType>ALIYUN::ECS::VPC</ResourceType>
        </SourceResources>
        <SourceTag>
            <ResourceTypeFilter>ALIYUN::ECS::VPC</ResourceTypeFilter>
        </SourceTag>
        <SourceResourceGroup>
            <ResourceGroupId>rg-acfmzawhxxc****</ResourceGroupId>
            <ResourceTypeFilter>ALIYUN::ECS::VPC</ResourceTypeFilter>
        </SourceResourceGroup>
        <LogicalIdStrategy>LongTypePrefixAndIndexSuffix</LogicalIdStrategy>
        <Tags>
            <Key>usage1</Key>
            <Value>test1</Value>
        </Tags>
        <CreateTime>2021-12-07T08:06:44</CreateTime>
        <UpdateTime>2021-12-07T08:06:44</UpdateTime>
    </TemplateScratches>
</ListTemplateScratchesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "D1C09606-C58B-558F-9B4E-5BF263D17D09",
  "TotalCount" : 2,
  "PageNumber" : 1,
  "PageSize" : 10,
  "TemplateScratches" : {
    "TemplateScratchId" : "ts-48ad85d66cca4620****",
    "TemplateScratchType" : "ResourceImport",
    "Status" : "GENERATE_COMPLETE",
    "StatusReason" : "Resource ALIYUN::ECS::VPC vpc-m5eauuq80anx59v28**** could not be found for template scratch.",
    "FailedCode" : "InvalidZoneId",
    "PreferenceParameters" : {
      "ParameterKey" : "DeletionPolicy",
      "ParameterValue" : "Retain"
    },
    "Description" : "Manages the VPC resource",
    "SourceResources" : {
      "ResourceId" : "vpc-m5eauuq80anx59v28****",
      "ResourceType" : "ALIYUN::ECS::VPC"
    },
    "SourceTag" : {
      "ResourceTypeFilter" : "ALIYUN::ECS::VPC"
    },
    "SourceResourceGroup" : {
      "ResourceGroupId" : "rg-acfmzawhxxc****",
      "ResourceTypeFilter" : "ALIYUN::ECS::VPC"
    },
    "LogicalIdStrategy" : "LongTypePrefixAndIndexSuffix",
    "Tags" : {
      "Key" : "usage1",
      "Value" : "test1"
    },
    "CreateTime" : "2021-12-07T08:06:44",
    "UpdateTime" : "2021-12-07T08:06:44"
  }
}

Códigos de error

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.