Updated on 2024-05-16 GMT+08:00

OBS

The OBS connector is used to connect to Huawei Cloud Object Storage Service (OBS).

OBS provides massive, secure, highly reliable, and low-cost object-based cloud storage capabilities.

Creating an OBS Connection

  1. Log in to the new ROMA Connect console.
  2. In the navigation pane on the left, choose Connector. On the page displayed, click New Connection.
  3. Select the OBS connector.
  4. In the dialog box displayed, configure the connector and click OK.

    Parameter

    Description

    Name

    Enter the connector instance name.

    App Key

    Access key ID (AK) of the current account. Obtain the AK by referring to Access Keys. If an AK/SK pair has been generated, find the downloaded AK/SK file (such as credentials.csv).

    App Secret

    Secret access key (SK) of the current account. Obtain the SK by referring to Access Keys. If an AK/SK pair has been generated, find the downloaded AK/SK file (such as credentials.csv).

    Description

    Enter the description of the connector to identify it.

Action

  • Downloading an object
  • Deleting an object
  • Listing buckets
  • Creating a bucket
  • Deleting a bucket
  • Obtaining bucket metadata
  • Listing objects in a bucket
  • Deleting objects in batches from a bucket
  • Uploading an object

Configuration Parameters

Table 1 Action parameters

Parameter

Description

Actions with the Parameter

Connection Type

Select a connection mode.

  • Region ID
  • Endpoint

All

Region ID

Select a region ID.

All

Endpoint

Endpoint

All

Bucket Name

OBS bucket name.

Downloading, deleting, or uploading an object, creating or deleting a bucket, obtaining bucket metadata, and deleting objects in batches from a bucket

Object Name

Enter an object name. Example: 123.png. Only TXT, CSV, PNG, JPG, and JPEG files are supported. Unlike file system, OBS does not have files or folders. The slash (/) in an object name simulates the folder path. Object name (key) of test/123.jpg is test/123.jpg. In this case, set this parameter to test/123.jpg.

Downloading, deleting, or uploading an object

Character Set

UTF-8 or GBK (for downloaded files containing Chinese characters)

Downloading an object

Bucket Type

Specify the bucket type. Default: OBJECT

  • OBJECT
  • POXIS

Listing buckets

Bucket Location

Whether to query the bucket location.

Yes

No (default)

Listing buckets

Region

Where to create the bucket in. Mandatory unless the endpoint is obs.myhuaweicloud.com. Default for endpoint obs.myhuaweicloud.com without specified region: CN North-Beijing1 (cn-north-1).

Creating a bucket

CORS Origin

Origin (usually a domain name) specified by the cross-origin pre-request. Separate origins with line breaks. Each origin can contain one wildcard character (*) at most.

Obtaining bucket metadata

HTTP Request Header

HTTP headers in the cross-domain request. CORS requests must match the allowed headers.

Obtaining bucket metadata

Object Name Prefix

Objects to list must contain this prefix.

Listing objects in a bucket

Start Position

Where the object listing begins, in lexicographical order.

Listing objects in a bucket

Max.

The upper limit for objects in the response. Range: 1–1000. If the input value is greater than 1,000, only 1,000 objects are returned.

Listing objects in a bucket

Delimiter

For grouping object names. If an object name contains the set delimiter, the string from the first character to the first delimiter in the object name (excluding any prefix) is taken as a group under commonPrefix.

Listing objects in a bucket

Coding Type

Encoding method to apply to some elements in the response. For delimiter, marker, prefix, nextMarker, and key containing control characters not supported by the XML 1.0 standard, set encodingType to encode the response delimiter, marker, prefix (including the prefix in commonPrefixes), nextMarker, or key.

Listing objects in a bucket

Response Mode

Response mode for deleting objects in batches.

No (default): The response includes the deletion result of each requested object.

Yes: The response includes only results of objects failed to be deleted.

Deleting objects in batches from a bucket

Basic Type

Basic type of the object. Text (default): TXT or CSV. Image: PNG, JPG, or JPEG.

Uploading an object

Content

Mandatory for a text object. The system generates an object based on the content and object name.

Uploading an object

Base64 Code

Mandatory for a binary object. The system generates an object based on the Base64 code and object name.

Uploading an object