ALIYUN::OSS::BucketLogging

更新时间:
复制为 MD 格式

ALIYUN::OSS::BucketLogging类型用于为存储空间(Bucket)开启日志转存功能。

语法

{
  "Type": "ALIYUN::OSS::BucketLogging",
  "Properties": {
    "Bucket": String,
    "TargetBucket": String,
    "LoggingRole": String,
    "TargetPrefix": String
  }
}

属性

属性名称

类型

必须

允许更新

描述

约束

Bucket

String

存储桶的名称。

TargetBucket

String

存储访问日志的存储桶。

LoggingRole

String

用于存储桶日志记录的授权角色。

TargetPrefix

String

保存日志对象的前缀。

此元素可以为空。

返回值

Fn::GetAtt

  • TargetPrefix:保存日志对象的前缀,此元素可以为空。

  • LoggingRole:用于存储桶日志记录的授权角色。

  • TargetBucket:存储访问日志的存储桶。

示例

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  LoggingRole:
    Type: String
    Description:
      en: Authorization role used for bucket logging.
    Default: Null
    Required: false
  TargetPrefix:
    Type: String
    Description:
      en: The prefix of the saved log objects. This element can be left empty.
    Default: Null
    Required: false
  Bucket:
    Type: String
    Description:
      en: The name of the bucket.
    Required: true
  TargetBucket:
    Type: String
    Description:
      en: The bucket that stores access logs.
    Required: true
Resources:
  ExtensionResource:
    Type: ALIYUN::OSS::BucketLogging
    Properties:
      LoggingRole:
        Ref: LoggingRole
      TargetPrefix:
        Ref: TargetPrefix
      Bucket:
        Ref: Bucket
      TargetBucket:
        Ref: TargetBucket
Outputs:
  TargetPrefix:
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - TargetPrefix
    Description: The prefix of the saved log objects. This element can be left empty.
  LoggingRole:
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - LoggingRole
    Description: Authorization role used for bucket logging.
  TargetBucket:
    Value:
      Fn::GetAtt:
        - ExtensionResource
        - TargetBucket
    Description: The bucket that stores access logs.
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "LoggingRole": {
      "Type": "String",
      "Description": {
        "en": "Authorization role used for bucket logging."
      },
      "Default": null,
      "Required": false
    },
    "TargetPrefix": {
      "Type": "String",
      "Description": {
        "en": "The prefix of the saved log objects. This element can be left empty."
      },
      "Default": null,
      "Required": false
    },
    "Bucket": {
      "Type": "String",
      "Description": {
        "en": "The name of the bucket."
      },
      "Required": true
    },
    "TargetBucket": {
      "Type": "String",
      "Description": {
        "en": "The bucket that stores access logs."
      },
      "Required": true
    }
  },
  "Resources": {
    "ExtensionResource": {
      "Type": "ALIYUN::OSS::BucketLogging",
      "Properties": {
        "LoggingRole": {
          "Ref": "LoggingRole"
        },
        "TargetPrefix": {
          "Ref": "TargetPrefix"
        },
        "Bucket": {
          "Ref": "Bucket"
        },
        "TargetBucket": {
          "Ref": "TargetBucket"
        }
      }
    }
  },
  "Outputs": {
    "TargetPrefix": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "TargetPrefix"
        ]
      },
      "Description": "The prefix of the saved log objects. This element can be left empty."
    },
    "LoggingRole": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "LoggingRole"
        ]
      },
      "Description": "Authorization role used for bucket logging."
    },
    "TargetBucket": {
      "Value": {
        "Fn::GetAtt": [
          "ExtensionResource",
          "TargetBucket"
        ]
      },
      "Description": "The bucket that stores access logs."
    }
  }
}