Restrições de parâmetros de consulta em modelos do ROS - Resource Orchestration Service: Central de Documentação do Alibaba Cloud

Consulte os valores válidos dos parâmetros definidos em um modelo com base nas restrições de propriedades de recursos.

Informações básicas

AssociationProperty e AssociationPropertyMetadata permitem filtrar parâmetros, mas os resultados podem não atender aos seus requisitos em cenários específicos.

Por exemplo, serviços diferentes aceitam valores distintos de ZoneId. Utilize uma consulta de restrição de parâmetros para obter os valores de ZoneId definidos no seu modelo.

Propriedades compatíveis

Se uma propriedade de recurso for referenciada por um parâmetro por meio da função Ref, chame a operação GetTemplateParameterConstraints para obter o valor da propriedade. A tabela a seguir lista as propriedades e os tipos de recursos compatíveis.
Chame a operação GetFeatureDetails para obter os tipos de recursos cujas propriedades aceitam consultas de restrição de parâmetros.

Nota

O modelo de destino deve conter a seção Parameters.

Tipo de recurso	Propriedade	Descrição
ALIYUN::ADB::DBCluster	ZoneId	Nenhuma.
ALIYUN::ALB::LoadBalancer	ZoneId em ZoneMappings	Nenhuma.
ALIYUN::AMQP::Instance	PeriodUnit Period	Nenhuma.
ALIYUN::ApiGateway::Instance	PricingCycle Duration	Nenhuma.
ALIYUN::CDDC::DedicatedHost	Period UsedTime	Nenhuma.
ALIYUN::CEN::CenBandwidthPackage	PricingCycle Period	Nenhuma.
ALIYUN::ClickHouse::DBCluster	Period ZoneId UsedTime	Nenhuma.
ALIYUN::CloudPhone::InstanceGroup	PeriodUnit Period	Nenhuma.
ALIYUN::CS::AnyCluster	PeriodUnit Period MasterInstanceTypes WorkerZoneIds PodVswitchIds WorkerSystemDiskCategory MasterZoneIds WorkerVSwitchIds KubernetesVersion WorkerInstanceTypes ScalingGroup.SystemDiskCategory em NodePools ScalingGroup.ZoneIds em NodePools ScalingGroup.InstanceTypes em NodePools MasterSystemDiskCategory Category em WorkerDataDisks Category em MasterDataDisks Category em ScalingGroup.DataDisks de NodePools	Nenhuma.
ALIYUN::CS::ClusterNodePool	PeriodUnit em ScalingGroup Period em ScalingGroup InstanceTypes em ScalingGroup ZoneIds em ScalingGroup Category em ScalingGroup.DataDisks SystemDiskCategory em ScalingGroup	Nenhuma.
ALIYUN::CS::KubernetesCluster	MasterInstanceTypes MasterSystemDiskCategory WorkerInstanceTypes WorkerSystemDiskCategory WorkerVSwitchIds PodVswitchIds KubernetesVersion PeriodUnit WorkerZoneIds Period MasterZoneIds ScalingGroup.InstanceTypes em NodePools Category em ScalingGroup.DataDisks de NodePools ScalingGroup.ZoneIds em NodePools ScalingGroup.SystemDiskCategory em NodePools Category em MasterDataDisks Category em WorkerDataDisks	Nenhuma.
ALIYUN::CS::ManagedEdgeKubernetesCluster	WorkerInstanceTypes PeriodUnit Period ZoneIds VSwitchIds WorkerSystemDiskCategory WorkerDataDiskCategory	Nenhuma.
ALIYUN::CS::ManagedKubernetesCluster	WorkerInstanceTypes WorkerSystemDiskCategory VSwitchIds PodVswitchIds KubernetesVersion PeriodUnit Period ZoneIds ScalingGroup.ZoneIds em NodePools ScalingGroup.InstanceTypes em NodePools Category em ScalingGroup.DataDisks de NodePools Category em WorkerDataDisks ScalingGroup.SystemDiskCategory em NodePools	Nenhuma.
ALIYUN::CS::ServerlessKubernetesCluster	PeriodUnit Period KubernetesVersion	Nenhuma.
ALIYUN::DRDS::DrdsInstance	PricingCycle Duration	Nenhuma.
ALIYUN::DTS::SubscriptionInstance	Period UsedTime	Nenhuma.
ALIYUN::DTS::SynchronizationJob	Period UsedTime	Nenhuma.
ALIYUN::ECD::Desktops	PeriodUnit Period	Nenhuma.
ALIYUN::ECS::DedicatedHost	PeriodUnit Period	Nenhuma.
ALIYUN::ECS::Disk	DiskCategory ZoneId	Nenhuma.
ALIYUN::ECS::Instance	ZoneId PeriodUnit InstanceType Period SystemDiskCategory Category em DiskMappings	Nenhuma.
ALIYUN::ECS::InstanceGroup	ZoneId PeriodUnit InstanceType Period SystemDiskCategory Category em DiskMappings	Nenhuma.
ALIYUN::ECS::InstanceGroupClone	PeriodUnit Period SystemDiskCategory Category em DiskMappings PeriodUnit Period InstanceType ZoneId	Nenhuma.
ALIYUN::ECS::PrepayInstance	PeriodUnit Period SystemDiskCategory Category em DiskMappings PeriodUnit Period InstanceType ZoneId	Nenhuma.
ALIYUN::ECS::PrepayInstanceGroupClone	PeriodUnit Period SystemDiskCategory Category em DiskMappings PeriodUnit Period InstanceType ZoneId	Nenhuma.
ALIYUN::ECS::VSwitch	ZoneId Period PeriodType	Nenhuma.
ALIYUN::EHPC::Cluster	PeriodUnit Period EcsOrderManagerInstanceType EcsOrderComputeInstanceType EcsOrderLoginInstanceType SystemDiskType ZoneId	Nenhuma.
ALIYUN::ElasticSearch::Instance	PeriodUnit ZoneId Period Spec em DataNode Spec em MasterNode Spec em KibanaNode	A consulta de especificações é possível apenas por zona.
ALIYUN::EMR::Cluster	DiskType em HostGroup NetType SysDiskType em HostGroup InstanceType em HostGroup ZoneId	Nenhuma.
ALIYUN::Flink::Instance	PricingCycle Duration ZoneId	Nenhuma.
ALIYUN::GA::Accelerator	PricingCycle Duration	Nenhuma.
ALIYUN::GA::BandwidthPackage	PricingCycle Duration	Nenhuma.
ALIYUN::GPDB::DBInstance	ZoneId PeriodUnit Period	Nenhuma.
ALIYUN::GPDB::ElasticDBInstance	ZoneId EngineVersion InstanceSpec DBInstanceCategory SegStorageType	Nenhuma.
ALIYUN::GWS::Instance	PeriodUnit Period	Nenhuma.
ALIYUN::MONGODB::Instance	StorageType DBInstanceClass EngineVersion ZoneId	Nenhuma.
ALIYUN::MONGODB::PrepayInstance	StorageType DBInstanceClass EngineVersion ZoneId	Nenhuma.
ALIYUN::MONGODB::ServerlessInstance	StorageType DBInstanceClass EngineVersion ZoneId	Nenhuma.
ALIYUN::MONGODB::ShardingInstance	StorageType DBInstanceClass EngineVersion ZoneId	Nenhuma.
ALIYUN::NAS::FileSystem	ProtocolType StorageType ZoneId	Nenhuma.
ALIYUN::POLARDB::DBCluster	ZoneId Duration PricingCycle DBNodeClass	Nenhuma.
ALIYUN::PrivateLink::VpcEndpointService	ZoneId em Resource	Nenhuma.
ALIYUN::RDS::DBInstance	ZoneId Period PeriodType EngineVersion Category DBInstanceStorageType DBInstanceClass	Nota Para garantir uma validação completa, especifique ZoneId, DBInstanceStorageType e Category. Para garantir uma validação completa, defina MultiAZ como false. Para garantir uma validação completa, posicione os parâmetros relacionados à propriedade Engine do ApsaraDB RDS antes dos parâmetros relacionados a outras propriedades do ApsaraDB RDS ao usar Metadata para definir a ordem dos parâmetros.
ALIYUN::RDS::DBInstanceClone	PeriodType Period Category EngineVersion PeriodType DBInstanceClass DBInstanceStorageType Period ZoneId	Nota Para garantir uma validação completa, especifique ZoneId, DBInstanceStorageType e Category. Para garantir uma validação completa, defina MultiAZ como false. Para garantir uma validação completa, posicione os parâmetros relacionados à propriedade Engine do ApsaraDB RDS antes dos parâmetros relacionados a outras propriedades do ApsaraDB RDS ao usar Metadata para definir a ordem dos parâmetros.
ALIYUN::RDS::PrepayDBInstance	ZoneId EngineVersion Category DBInstanceStorageType DBInstanceClass Period PeriodType	Nota Para garantir uma validação completa, especifique ZoneId, DBInstanceStorageType e Category. Para garantir uma validação completa, defina MultiAZ como false. Para garantir uma validação completa, posicione os parâmetros relacionados à propriedade Engine do ApsaraDB RDS antes dos parâmetros relacionados a outras propriedades do ApsaraDB RDS ao usar Metadata para definir a ordem dos parâmetros.
ALIYUN::RDS::ReadOnlyDBInstance	PeriodType Period Category DBInstanceClass EngineVersion DBInstanceStorageType ZoneId	Nota Para garantir uma validação completa, especifique ZoneId, DBInstanceStorageType e Category. Para garantir uma validação completa, defina MultiAZ como false. Para garantir uma validação completa, posicione os parâmetros relacionados à propriedade Engine do ApsaraDB RDS antes dos parâmetros relacionados a outras propriedades do ApsaraDB RDS ao usar Metadata para definir a ordem dos parâmetros.
ALIYUN::REDIS::Instance	ZoneId EngineVersion InstanceClass PeriodUnit Period	Nenhuma.
ALIYUN::REDIS::PrepayInstance	ZoneId Period PeriodUnit EngineVersion InstanceClass	Nenhuma.
ALIYUN::SLB::AnyTunnel	PricingCycle Duration MasterZoneId SlaveZoneId	Nenhuma.
ALIYUN::SLB::LoadBalancer	MasterZoneId SlaveZoneId Duration PricingCycle	Nenhuma.
ALIYUN::TSDB::HiTSDBInstance	InstanceClass ZoneId Duration PricingCycle	Nenhuma.
ALIYUN::VPC::EIP	PricingCycle Period	Nenhuma.
ALIYUN::VPC::EIPPro	PricingCycle Period	Nenhuma.
ALIYUN::VPC::NatGateway	ZoneId Duration PricingCycle	Nenhuma.
ALIYUN::VPC::RouterInterface	PricingCycle Period	Nenhuma.

Dependências de parâmetros

Ao criar recursos ECS no ROS usando um modelo, especifique parâmetros como ZoneInfo e InstanceType.

Os tipos de instância ECS compatíveis variam conforme a zona. Um valor específico do parâmetro InstanceType pode ficar indisponível após a definição do parâmetro ZoneInfo.

Para restringir o uso a um valor específico do parâmetro InstanceType, utilize a seção Metadata para configurar a dependência entre InstanceType e ZoneInfo.

Nota

Para mais informações, consulte Metadata.

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ZoneInfo:
    Type: String
  InstanceType:
    Type: String
Resources:
  ECS:
    Type: ALIYUN::ECS::Instance
    Properties:
      ZoneId:
        Ref: ZoneInfo
      InstanceType:
        Ref: InstanceType
      ImageId: ubuntu
Metadata:
  ALIYUN::ROS::Interface:
    ParameterGroups:
      - Parameters:
          - InstanceType
          - ZoneInfo

Configure manualmente restrições de parâmetros para modelos Terraform

Adicione ResourcesForParameterConstraints a ALIYUN::ROS::Interface na seção Metadata ou no arquivo .metadata para configurar as restrições de parâmetros.

Defina os recursos e propriedades relevantes para as restrições de parâmetros. Para mais detalhes sobre a sintaxe de ResourcesForParameterConstraints, consulte Resources.

As seções Mappings, Conditions e Rules em um modelo entram em vigor automaticamente durante as consultas de restrição de parâmetros. Para mais informações, consulte (Opcional) Mappings, (Opcional) Conditions e (Opcional) Rules.

ROSTemplateFormatVersion: '2015-09-01'
Transform: Aliyun::Terraform-v1.1
Workspace:
  .metadata: |-
    {
        "ALIYUN::ROS::Interface": {
            "ResourcesForParameterConstraints": {
                "instance": {
                    "Type": "ALIYUN::ECS::Instance",
                    "Properties": {
                        "ImageId": {
                            "Ref": "image_id"
                        },
                        "InstanceType": {
                            "Ref": "instance_type"
                        },
                        "ZoneId": {
                            "Ref": "zone_id"
                        }
                    }
                }
            },
            "Hidden": [
                "image_id"
            ]
        }
    }
  main.tf: |-
    variable "image_id" {
      type    = string
      default = "ubuntu_18_04_64_20G_alibase_2019****.vhd"
    }

    variable "instance_type" {
      type = string
    }

    variable "zone_id" {
      type = string
    }

    resource "alicloud_vpc" "vpc" {
      cidr_block = "172.16.X.X/16"
    }

    resource "alicloud_security_group" "group" {
      vpc_id = alicloud_vpc.vpc.id
    }

    resource "alicloud_vswitch" "vswitch" {
      vpc_id     = alicloud_vpc.vpc.id
      cidr_block = "172.16.X.X/24"
      zone_id    = var.zone_id
    }

    resource "alicloud_instance" "instance" {
      availability_zone = var.zone_id
      security_groups   = [alicloud_security_group.group.id]
      instance_type     = var.instance_type
      image_id          = var.image_id
      vswitch_id        = alicloud_vswitch.vswitch.id
    }

Este modelo Terraform define quatro recursos. Os parâmetros zone_id e instance_type possuem restrições e estão associados a alicloud_instance.

ResourcesForParameterConstraints define apenas o tipo de recurso ALIYUN::ECS::Instance (correspondente a alicloud_instance), associando-o a image_id, instance_type e zone_id para aplicar restrições a esses parâmetros. O parâmetro image_id permanece oculto.