Todos os produtos
Search
Central de documentação

Resource Orchestration Service:ALIYUN::OSS::Directory

Última atualização: Jun 27, 2026

Crie um diretório em um bucket do OSS especificado.

Sintaxe

{
  "Type": "ALIYUN::OSS::Directory",
  "Properties": {
    "BucketName": String,
    "DeletionForce": Boolean,
    "DirectoryName": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatória

Editável

Descrição

Restrição

BucketName

String

Sim

Não

Nome do bucket.

Nenhuma.

DeletionForce

Boolean

Não

Sim

Especifique se os objetos relacionados no diretório serão excluídos forçosamente.

Valores válidos:

  • true

  • false (padrão)

DirectoryName

String

Sim

Não

Nome do diretório.

Convenções de nomenclatura:

  • O nome do diretório deve usar caracteres UTF-8 e não pode conter emoticons.

  • Barras (/) separam vários caminhos. Use barras (/) para criar subdiretórios rapidamente. O nome do subdiretório não pode começar com barra (/) ou barra invertida (\), nem conter barras consecutivas (/).

  • Não é permitido usar dois pontos consecutivos (..) como nome de subdiretório.

  • O nome do diretório deve ter entre 1 e 254 caracteres.

Valores de retorno

Fn::GetAtt

  • BucketName: o nome do bucket.

  • DirectoryName: o nome do diretório.

Exemplos

  • YAML formato

    ROSTemplateFormatVersion: '2015-09-01'
    Parameters:
      BucketName:
        Description:
          en: bucket name.
        Type: String
        Default: ros-doc-***
      DeletionForce:
        Default: false
        Description:
          en: Whether force delete the relative objects in the directory. Default value
            is false.
        Type: Boolean
      DirectoryName:
        AllowedPattern: '[^\/\\](?!//)(.*){1,254}$'
        Description:
          en: Directory name
        Type: String
        Default: test
    Resources:
      Directory:
        Properties:
          BucketName:
            Ref: BucketName
          DeletionForce:
            Ref: DeletionForce
          DirectoryName:
            Ref: DirectoryName
        Type: ALIYUN::OSS::Directory
    Outputs:
      BucketName:
        Description: The name of Bucket
        Value:
          Fn::GetAtt:
          - Directory
          - BucketName
      DirectoryName:
        Description: The name of Directory
        Value:
          Fn::GetAtt:
          - Directory
          - DirectoryName
                            
  • JSON formato

    {
      "ROSTemplateFormatVersion": "2015-09-01",
      "Parameters": {
        "BucketName": {
          "Description": {
            "en": "bucket name."
          },
          "Type": "String",
          "Default": "ros-doc-***"
        },
        "DeletionForce": {
          "Default": false,
          "Description": {
            "en": "Whether force delete the relative objects in the directory. Default value is false."
          },
          "Type": "Boolean"
        },
        "DirectoryName": {
          "AllowedPattern": "[^\\/\\\\](?!//)(.*){1,254}$",
          "Description": {
            "en": "Directory name"
          },
          "Type": "String",
          "Default": "test"
        }
      },
      "Resources": {
        "Directory": {
          "Properties": {
            "BucketName": {
              "Ref": "BucketName"
            },
            "DeletionForce": {
              "Ref": "DeletionForce"
            },
            "DirectoryName": {
              "Ref": "DirectoryName"
            }
          },
          "Type": "ALIYUN::OSS::Directory"
        }
      },
      "Outputs": {
        "BucketName": {
          "Description": "The name of Bucket",
          "Value": {
            "Fn::GetAtt": [
              "Directory",
              "BucketName"
            ]
          }
        },
        "DirectoryName": {
          "Description": "The name of Directory",
          "Value": {
            "Fn::GetAtt": [
              "Directory",
              "DirectoryName"
            ]
          }
        }
      }
    }