Type Definitions

bucket

Type:
  • Object
Properties
NameTypeDescription
Namestring

The name of the bucket

Datedate

the bucket was created

gateway

Type:
  • Object
Properties
NameTypeDescription
namestring

Name for the gateway

domainstring

Custom Domain for the gateway

enabledboolean

Whether the gateway is enabled or not

privatestring

Whether the gateway is scoped to users content

created_atdate

Date the gateway was created

updated_atdate

Date the gateway was last updated

gatewayOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
domainboolean<optional>

Optional Domain to allow for using a Custom Domain

enabledstring<optional>

Optional Toggle to use for enabling the gateway

privateboolean<optional>

Optional Boolean determining if gateway is Public or Private

name

Type:
  • Object
Properties
NameTypeDescription
labelstring

Descriptive label for the Key

network_keystring

IPNS Key CID

cidstring

Value that name Publishes

sequencenumber

Version Number for the name

enabledboolean

Whether the name is being Published or not

published_atdate

Date the name was last published to the DHT

created_atdate

Date the name was created

updated_atdate

Date the name was last updated

nameOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
enabledboolean<optional>

Whether the name is enabled or not.

objectManagerOptions

Optional settings for the constructor.

Optional settings for the constructor.

Type:
  • Object
Properties
NameTypeAttributesDescription
bucketstring<optional>

Default bucket to use.

gatewayobjectDownloadOptions<optional>

Default gateway to use.

maxConcurrentUploadsnumber<optional>

The maximum number of concurrent uploads.

objectDownloadOptions

Optional settings for downloading objects

.

Optional settings for downloading objects

Type:
  • Object
Properties
NameTypeAttributesDefaultDescription
endpointstring

Default gateway to use.

tokenstring<optional>

Token for the default gateway.

timeoutnumber<optional>
60000

Timeout for the default gateway

objectOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
bucketstring<optional>

The bucket to pin the IPFS CID into.

objectHeadResult

Type:
  • Object
Properties
NameTypeAttributesDescription
cidstring

The CID of the uploaded object

downloadfunction

Convenience function to download the object via S3 or the selected gateway

entriesarray.<Object><optional>

If a directory then returns an array of the containing objects

Properties
NameTypeDescription
cidstring

The CID of the uploaded object

pathstring

The path of the object

listObjectsResult

Type:
  • Object
Properties
NameTypeDescription
IsTruncatedboolean

Indicates if more results exist on the server

NextContinuationTokenstring

ContinuationToken used to paginate list requests

ContentsArray.<Object>

List of Keys stored in the S3 Bucket

Properties
NameTypeDescription
Keystring

Key of the Object

LastModifiedstring

Date Last Modified of the Object

CIDstring

CID of the Object

ETagstring

ETag of the Object

Sizenumber

Size in Bytes of the Object

StorageClassstring

Class of Storage of the Object

downloadfunction

Convenience function to download the item using the S3 gateway

listObjectOptions

Type:
  • Object
Properties
NameTypeAttributesDefaultDescription
Bucketstring<optional>

The name of the bucket. If not provided, the default bucket will be used.

ContinuationTokenstring<optional>
null

Continues listing from this objects name.

Delimiterstring<optional>
null

Character used to group keys

MaxKeysnumber<optional>
1000

The maximum number of objects to retrieve. Defaults to 1000.

copyObjectOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
sourceBucketstring<optional>

The source bucket from where the object is to be copied.

destinationKeystring<optional>

The key of the object in the destination bucket. By default, it is the same as the sourceKey.

pinManagerOptions

Optional settings for the constructor.

Optional settings for the constructor.

Type:
  • Object
Properties
NameTypeAttributesDescription
bucketstring<optional>

Default bucket to use.

gatewaypinDownloadOptions<optional>

Default gateway to use.

pinDownloadOptions

Optional settings for downloading pins

.

Optional settings for downloading pins

Type:
  • Object
Properties
NameTypeAttributesDefaultDescription
endpointstring

Default gateway to use.

tokenstring<optional>

Token for the default gateway.

timeoutnumber<optional>
60000

Timeout for the default gateway

pinStatus

Type:
  • Object
Properties
NameTypeAttributesDescription
requestidstring

Globally unique identifier of the pin request; can be used to check the status of ongoing pinning, or pin removal

statusstring

Status a pin object can have at a pinning service. ("queued","pinning","pinned","failed")

createdstring

Immutable timestamp indicating when a pin request entered a pinning service; can be used for filtering results and pagination

pinObject

Pin object

Properties
NameTypeDescription
cidstring

Content Identifier (CID) pinned recursively

namestring

Name for pinned data; can be used for lookups later

originsArray.<string>

Optional list of multiaddrs known to provide the data

metaObject

Optional metadata for pin object

delegatesArray.<string>

List of multiaddrs designated by pinning service that will receive the pin data

infoobject<optional>

Optional info for PinStatus response

downloadfunction

Convenience function to download pin

pinOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
bucketstring<optional>

The bucket to pin the IPFS CID into.

listPinOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
cidArray.<string><optional>

Return pin objects responsible for pinning the specified CID(s); be aware that using longer hash functions introduces further constraints on the number of CIDs that will fit under the limit of 2000 characters per URL in browser contexts

namestring<optional>

Return pin objects with specified name (by default a case-sensitive, exact match)

matchstring<optional>

Customize the text matching strategy applied when the name filter is present; exact (the default) is a case-sensitive exact match, partial matches anywhere in the name, iexact and ipartial are case-insensitive versions of the exact and partial strategies

statusArray.<string><optional>

Return pin objects for pins with the specified status (when missing, service defaults to pinned only)

beforestring<optional>

Return results created (queued) before provided timestamp

afterstring<optional>

Return results created (queued) after provided timestamp

limitnumber<optional>

Max records to return

metaObject<optional>

Return pin objects that match specified metadata keys passed as a string representation of a JSON object; when implementing a client library, make sure the parameter is URL-encoded to ensure safe transport

listPinResults

Type:
  • Object
Properties
NameTypeDescription
countnumber

Total number of pin objects that exist for passed query filters

ArrayArray.<pinStatus>

of PinStatus results

replacePinOptions

Type:
  • Object
Properties
NameTypeAttributesDescription
metadataObject<optional>

Optional metadata to set on pin during replacement

namestring<optional>

Optional name for pin to set during replacement