Console
    Contact Us Start free

    Folder: rename

    Renames a folder within a bucket with hierarchical namespace enabled. For details about how the rename operation works, see Rename folders .

    Required permissions

    The authenticated user must have the following IAM permissions to use this method:

    • storage.folders.rename
      • This permission is needed to rename the source folder.
    • storage.folders.create
      • This permission is needed to create the destination folder.

    Request

    HTTP request

    POST https://storage.googleapis.com/storage/v1/b/ bucket 
/folders/ sourcePath 
/renameTo/folders/ destinationPath

    In addition to standard query parameters , the following parameters apply to this method.

    To see an example of how to include query parameters in a request, see the JSON API Overview page.

    Parameters

    Parameter name
    Value
    Description
    Path parameters
    bucket
    string
    The parent bucket of the folder.
    sourcePath
    string
    The URL-encoded name of the source folder, expressed as a path. For example, src-folder/ , URL-encoded as src-folder%2F .
    destinationPath
    string
    The URL-encoded name of the destination folder, expressed as a path. For example, dest-folder/ , URL-encoded as dest-folder%2F .
    Optional query parameters
    ifMetagenerationMatch
    long
    If set, only rename the folder if the source folder's metageneration matches this value.
    ifMetagenerationNotMatch
    long
    If set, only rename the folder if the source folder's metageneration doesn't match this value.

    Request body

    Do not supply a request body with this method.

    Response

    If successful, this method returns an instance of the long-running operation in the response body:

    {
  "name": " string 
",
  "metadata": { object 
},
  "done": boolean 
,
  // Result can include either an error or response:
  "error": { object 
 (Status) 
},
  "response": { object 
 (Folder) 
}
}
    Property name
    Value
    Description
    name
    string
    The server-assigned name of the operation.
    metadata
    object

    An object of type google.storage.control.v2.RenameFolderMetadata :

    {
    "sourceFolderId": " string 
",
    "destinationFolderId": " string 
",
    "commonMetadata":
      {
        "createTime": " datetime 
",
        "endTime": " datetime 
",
        "updateTime": " datetime 
",
        "type": " string 
",
        "requestedCancellation": boolean 
,
        "progressPercent": integer 
,
      }
  }

    Where:

    • sourceFolderId is the path of the folder you want to rename.
    • destinationFolderId is the new name you want to give the folder.
    • createTime is the time when the operation started.
    • endTime is the time when the operation finished, regardless of whether it succeeded or failed.
    • updateTime is the time when the metadata was last updated.
    • type is the operation type. For rename folder operations, this is always rename-folder .
    • requestedCancellation identifies whether the user has requested cancellation of the operation.
    • progressPercent indicates the operation's progress as a percentage, ranging from 0 (not started) to 100 (completed). The value -1 means the progress is unknown.
    done
    boolean
    If false , indicates that the operation is still in progress, and neither error nor response is set. If true , it indicates that the operation is completed and either error or response is set.
    error
    object
    If the operation fails, this field is returned in the response body and contains the error details. The rename operation fails if any of the child folders exceed either the maximum folder name length limit or maximum folder depth limit. For information about folder name length and folder depth limits, see Considerations .
    If a failure occurs, the folders are reverted to their original state prior to the rename attempt. For information about status and error codes returned by this API, see the reference page .
    response
    object
    If the operation succeeds, an object of type google.storage.control.v2.Folder is returned. 
    {
  "name": " string 
",
  "metageneration": integer 
,
  "createTime": " datetime 
"",
  "updateTime": " datetime 
",
}

    Where:

    • name is the name of the folder resource.
    • metageneration is the metageneration of the folder.
    • createTime is the time when the folder was created.
    • updateTime is the time when the folder was last updated.

    Try it!

    Use the APIs Explorer below to call this method on live data and see the response.
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: