全部产品
Search
文档中心

资源编排:OSS资源

更新时间:Mar 16, 2026

AssociationProperty取值

说明

对应的AssociationPropertyMetadata

ALIYUN::OSS::Bucket::BucketName

OSS存储空间名称。

RegionId:地域ID(默认为资源栈所属地域)。

示例如下:

  • 示例代码

    JSON示例:

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "RegionId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::RegionId"
        },
        "BucketName": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::OSS::Bucket::BucketName",
          "AssociationPropertyMetadata": {
            "RegionId": "${RegionId}"
          }
        }
      }
    }

    YAML示例:

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      RegionId:
        Type: String
        AssociationProperty: ALIYUN::ECS::RegionId
      BucketName:
        Type: String
        AssociationProperty: ALIYUN::OSS::Bucket::BucketName
        AssociationPropertyMetadata:
          RegionId: ${RegionId}
  • 示例说明

    示例中通过指定参数BucketName的AssociationProperty属性为ALIYUN::OSS::Bucket::BucketName,AssociationPropertyMetadata属性为RegionId,获取当前地域下的OSS存储空间。

ALIYUN::OSS::Bucket::Object

OSS存储对象。

  • RegionId:地域ID(默认为资源栈所属地域)。

  • ObjectType:Object的存储类型。

  • ValueType:Object值的类型。

示例如下:

  • 示例代码

    JSON示例:

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "RegionId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::RegionId"
        },
        "BucketObject": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::NLB::Zone::ZoneId",
          "AssociationPropertyMetadata": {
            "RegionId": "${RegionId}"
          }
        }
      }
    }

    YAML示例:

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      RegionId:
        Type: String
        AssociationProperty: ALIYUN::ECS::RegionId
      BucketObject:
        Type: String
        AssociationProperty: ALIYUN::NLB::Zone::ZoneId
        AssociationPropertyMetadata:
          RegionId: ${RegionId}
  • 示例说明

    示例中通过指定参数BucketObject的AssociationProperty属性为ALIYUN::OSS::Bucket::Object,AssociationPropertyMetadata属性为RegionId,获取当前可用地域下OSS存储对象。

ALIYUN::OSS::Object::ObjectName

OSS对象名称。

  • RegionId:地域ID(默认为资源栈所属地域)。

  • BucketName:存储空间名称。

  • ValueType:返回地址类型。

    • 默认值为OSSUrl,即返回完整的地址,例如:oss://beijing-test-delete/test.xml

    • 设置为任何其他值,则只返回object的名称,例如test.xml

示例如下:

  • 示例代码

    JSON示例:

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "RegionId": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::ECS::RegionId"
        },
        "BucketName": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::OSS::Bucket::BucketName",
          "AssociationPropertyMetadata": {
            "RegionId": "${RegionId}"
          }
        },
        "ObjectName": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::OSS::Object::ObjectName",
          "AssociationPropertyMetadata": {
            "RegionId": "${RegionId}",
            "BucketName": "${BucketName}",
            "ValueType": "OSSUrl"
          }
        }
      }
    }

    YAML示例:

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      RegionId:
        Type: String
        AssociationProperty: ALIYUN::ECS::RegionId
      BucketName:
        Type: String
        AssociationProperty: ALIYUN::OSS::Bucket::BucketName
        AssociationPropertyMetadata:
          RegionId: ${RegionId}
      ObjectName:
        Type: String
        AssociationProperty: ALIYUN::OSS::Object::ObjectName
        AssociationPropertyMetadata:
          RegionId: ${RegionId}
          BucketName: ${BucketName}
          ValueType: OSSUrl
  • 示例说明

    示例中通过指定参数ObjectName的AssociationProperty属性为ALIYUN::OSS::Object::ObjectName,AssociationPropertyMetadata属性为RegionId、BucketName,获取当前地域下的OSS对象。

UploadFilesToUserBucket

OSS上传文件组件。

  • Mode: 组件的形式。取值:

    • normal

    • dragger(默认值)

  • RegionId: Bucket所在地域,默认为当前环境地域。确保和指定的Bucket保持一致。

  • BucketName: Bucket的名称。

  • Multiple: 一次上传多个文件,取值:

    • true

  • Directory:支持上传文件夹,取值:

    • true

  • ValueType:返回值类型,默认OSS Url。

  • ObjectNamePrefix: 支持指定上传文件的路径

  • AddSuffix: 是否给上传的文件名称附加时间戳后缀,取值:

    • true

  • SuffixFormat: 时间戳后缀格式,示例:YYYY-MM-DD。

示例如下:

  • 示例代码

    JSON示例:

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "BucketName": {
          "Type": "String",
          "AssociationProperty": "ALIYUN::OSS::Bucket::BucketName",
          "AssociationPropertyMetadata": {
            "RegionId": "${RegionId}"
          }
        },
        "UploadFilesToUserBucket": {
          "Type": "String",
          "AssociationProperty": "UploadFilesToUserBucket",
          "AssociationPropertyMetadata": {
            "Mode": "dragger",
            "BucketName": "${BucketName}",
            "Multiple": true,
            "Directory": true,
            "ValueType": "OSS Url",
            "AddSuffix": true,
            "SuffixFormat": "YYYY-MM-DD"
          }
        }
      }
    }

    YAML示例:

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      RegionId:
        Type: String
        AssociatiROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      BucketName:
        Type: String
        AssociationProperty: ALIYUN::OSS::Bucket::BucketName
        AssociationPropertyMetadata:
          RegionId: ${RegionId}
      UploadFilesToUserBucket:
        Type: String
        AssociationProperty: UploadFilesToUserBucket
        AssociationPropertyMetadata:
          Mode: dragger
          BucketName: ${BucketName}
          Multiple: true
          Directory: true
          ValueType: OSS Url
          AddSuffix: true
          SuffixFormat: YYYY-MM-DD
  • 示例说明

    示例中通过指定参数BucketName的AssociationProperty属性为ALIYUN::OSS::Bucket::BucketName,AssociationPropertyMetadata属性为RegionId、BucketName,获取当前地域下的OSS对象。UploadFilesToUserBucket属性为UploadFilesToUserBucket,AssociationPropertyMetadata属性为BucketName,上传文件到指定的Bucket中。