Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::OSS::Bucket

Última atualização: Jun 27, 2026

Consulta informações sobre um bucket do Object Storage Service (OSS).

Sintaxe

{
  "Type": "DATASOURCE::OSS::Bucket",
  "Properties": {
    "BucketName": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

BucketName

String

Sim

Sim

Nome do bucket.

Nenhuma.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos da source de dados durante atualizações da pilha.

Valores válidos:

  • Never (padrão): não atualiza os recursos da source de dados durante as atualizações da pilha.

  • Always: atualiza os recursos da source de dados durante as atualizações da pilha.

Valores de retorno

Fn::GetAtt

  • Owner: informações do proprietário do bucket.

  • ExtranetEndpoint: endpoint público para acesso ao bucket pela Internet.

  • StorageClass: classe de armazenamento do bucket.

  • CreateTime: hora de criação do bucket.

  • IntranetEndpoint: endpoint interno para acesso ao bucket a partir de instâncias ECS na mesma região.

  • Name: nome do bucket.

  • Location: data center do bucket.

Exemplos

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  BucketName:
    Description:
      en: 'Bucket name. The naming conventions for buckets are as follows:

        Only lowercase letters, numbers, and dashes (-) can be included.

        Must start and end with lowercase letters or numbers.

        The length must be between 3 and 63 characters.'
    Required: true
    Type: String
Resources:
  ExtensionDataSource:
    Properties:
      BucketName:
        Ref: BucketName
    Type: DATASOURCE::OSS::Bucket
Outputs:
  CreateTime:
    Description: The creation time of the Bucket.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - CreateTime
  ExtranetEndpoint:
    Description: The domain name of the Bucket.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - ExtranetEndpoint
  IntranetEndpoint:
    Description: The intranet domain name of the ECS instance that accesses the Bucket
      in the same region.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - IntranetEndpoint
  Location:
    Description: The region where the Bucket is located.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Location
  Name:
    Description: Bucket name.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Name
  Owner:
    Description: Container for storing Bucket owner information.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - Owner
  StorageClass:
    Description: The storage type of the Bucket.
    Value:
      Fn::GetAtt:
      - ExtensionDataSource
      - StorageClass
                        
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "BucketName": {
      "Type": "String",
      "Description": {
        "en": "Bucket name. The naming conventions for buckets are as follows:\nOnly lowercase letters, numbers, and dashes (-) can be included.\nMust start and end with lowercase letters or numbers.\nThe length must be between 3 and 63 characters."
      },
      "Required": true
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::OSS::Bucket",
      "Properties": {
        "BucketName": {
          "Ref": "BucketName"
        }
      }
    }
  },
  "Outputs": {
    "Owner": {
      "Description": "Container for storing Bucket owner information.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Owner"
        ]
      }
    },
    "ExtranetEndpoint": {
      "Description": "The domain name of the Bucket.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ExtranetEndpoint"
        ]
      }
    },
    "StorageClass": {
      "Description": "The storage type of the Bucket.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "StorageClass"
        ]
      }
    },
    "CreateTime": {
      "Description": "The creation time of the Bucket.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "CreateTime"
        ]
      }
    },
    "IntranetEndpoint": {
      "Description": "The intranet domain name of the ECS instance that accesses the Bucket in the same region.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "IntranetEndpoint"
        ]
      }
    },
    "Name": {
      "Description": "Bucket name.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Name"
        ]
      }
    },
    "Location": {
      "Description": "The region where the Bucket is located.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Location"
        ]
      }
    }
  }
}