ObjectStoreApi

Functions

cancelMultipartUploadByKey

  • cancelMultipartUploadByKey(builder: RequestBuilder, params: {</span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Cancels an entire multipart upload operation. You can only cancel a multipart upload before it has been completed.

    summary
    Cancels a multipart upload.

    Parameters

    • params: {</span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • layerId: string
      • multipartToken: string

    Returns Promise<Response>

checkKeyExists

  • checkKeyExists(builder: RequestBuilder, params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Checks if a blob exists for the requested key.

    summary
    Checks if a key exists.

    Parameters

    • params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • key: string
      • layerId: string

    Returns Promise<Response>

completeMultipartUploadByKey

  • completeMultipartUploadByKey(builder: RequestBuilder, params: {</span>body<span class="typedoc-tsd-signature-symbol">?: </span><a href="sdk-for-typescript-modules-olp_sdk_dataservice_api-objectstoreapi" class="typedoc-tsd-signature-type" data-tsd-kind="Namespace">ObjectStoreApi</a><span class="typedoc-tsd-signature-symbol">.</span><a href="sdk-for-typescript-interfaces-olp_sdk_dataservice_api-objectstoreapi-multipartcompleterequest" class="typedoc-tsd-signature-type" data-tsd-kind="Interface">MultipartCompleteRequest</a><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Call this API when all parts have been uploaded.

    summary
    Completes a multipart upload.

    Parameters

    • params: {</span>body<span class="typedoc-tsd-signature-symbol">?: </span><a href="sdk-for-typescript-modules-olp_sdk_dataservice_api-objectstoreapi" class="typedoc-tsd-signature-type" data-tsd-kind="Namespace">ObjectStoreApi</a><span class="typedoc-tsd-signature-symbol">.</span><a href="sdk-for-typescript-interfaces-olp_sdk_dataservice_api-objectstoreapi-multipartcompleterequest" class="typedoc-tsd-signature-type" data-tsd-kind="Interface">MultipartCompleteRequest</a><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}

    Returns Promise<Response>

deleteBlobByKey

  • deleteBlobByKey(builder: RequestBuilder, params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Deletes a data blob.

    summary
    Deletes a data blob.

    Parameters

    • params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • key: string
      • layerId: string

    Returns Promise<Response>

getBlobByKey

  • getBlobByKey(builder: RequestBuilder, params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>range<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Retrieves a blob from storage.

    summary
    Gets a blob.

    Parameters

    • params: {</span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>range<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • key: string
      • layerId: string
      • Optional range?: string

    Returns Promise<Response>

getMultipartUploadStatusByKey

  • getMultipartUploadStatusByKey(builder: RequestBuilder, params: {</span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<MultipartKeyUploadStatus>
  • Gets the status of a multipart upload. The status can be received only when the upload has been completed.

    summary
    Gets the status of a multipart upload.

    Parameters

    • params: {</span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • layerId: string
      • multipartToken: string

    Returns Promise<MultipartKeyUploadStatus>

listKeys

  • listKeys(builder: RequestBuilder, params: {</span>deep<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">"true"</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">"false"</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>limit<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>pageToken<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>parent<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<KeysListResponseObj>
  • List virtual directory-like structure created from keys in the storage where '/' is used as a separator.

    summary
    List keys.

    Parameters

    • params: {</span>deep<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">"true"</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">"false"</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>limit<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>pageToken<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>parent<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • Optional deep?: "true" | "false"
      • layerId: string
      • Optional limit?: number
      • Optional pageToken?: string
      • Optional parent?: string

    Returns Promise<KeysListResponseObj>

putBlobByKey

  • putBlobByKey(builder: RequestBuilder, params: {</span>body<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>contentLength<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>source<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<Response>
  • Persists the data blob up to 192 MB. When the operation completes successfully, there is no guarantee that the data blob will be immediately available, although in most cases, it will be. To check if the data blob is available, use the ´HEAD´ method. The maximum key length is 450 characters.

    summary
    Publishes a data blob or copies an existing blob.

    Parameters

    • params: {</span>body<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>contentLength<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>source<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • Optional body?: string
      • contentLength: number
      • key: string
      • layerId: string
      • Optional source?: string

    Returns Promise<Response>

startMultipartUploadByKey

  • startMultipartUploadByKey(builder: RequestBuilder, params: {</span>body<span class="typedoc-tsd-signature-symbol">: </span><a href="sdk-for-typescript-interfaces-olp_sdk_dataservice_api-objectstoreapi-multipartuploadbykeymetadata" class="typedoc-tsd-signature-type" data-tsd-kind="Interface">MultipartUploadByKeyMetadata</a><span class="typedoc-tsd-signature-symbol">; </span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<MultipartInitResponse>
  • Publishes large data blobs where the data payload needs to be split into multiple parts. The multipart upload start is to be followed by the individual parts upload and completed with a call to complete the upload. The limit of the blob uploaded this way is 50GB. Max key length is 450 characters.

    summary
    Starts a multipart upload.

    Parameters

    • params: {</span>body<span class="typedoc-tsd-signature-symbol">: </span><a href="sdk-for-typescript-interfaces-olp_sdk_dataservice_api-objectstoreapi-multipartuploadbykeymetadata" class="typedoc-tsd-signature-type" data-tsd-kind="Interface">MultipartUploadByKeyMetadata</a><span class="typedoc-tsd-signature-symbol">; </span>key<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}

    Returns Promise<MultipartInitResponse>

uploadPartByKey

  • uploadPartByKey(builder: RequestBuilder, params: {</span>body<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">ArrayBuffer</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">SharedArrayBuffer</span><span class="typedoc-tsd-signature-symbol">; </span>contentLength<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>contentType<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>partNumber<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>range<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>source<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}): Promise<PartId>
  • Upload or copy a single part of a multipart upload or multipart copy for the blob. Every part except the last one must have a minimum 5 MB of data and maximum of 96 MB. The length of every part except the last one must be multiple of 1MB (1024KB). The maximum number of parts is 10,000.

    summary
    Uploads a part or creates a new part from part of an existing blob.

    Parameters

    • params: {</span>body<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">ArrayBuffer</span><span class="typedoc-tsd-signature-symbol"> | </span><span class="typedoc-tsd-signature-type">SharedArrayBuffer</span><span class="typedoc-tsd-signature-symbol">; </span>contentLength<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>contentType<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>layerId<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>multipartToken<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>partNumber<span class="typedoc-tsd-signature-symbol">: </span><span class="typedoc-tsd-signature-type">number</span><span class="typedoc-tsd-signature-symbol">; </span>range<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">; </span>source<span class="typedoc-tsd-signature-symbol">?: </span><span class="typedoc-tsd-signature-type">string</span><span class="typedoc-tsd-signature-symbol">}
      • body: string | ArrayBuffer | SharedArrayBuffer
      • Optional contentLength?: number
      • Optional contentType?: string
      • layerId: string
      • multipartToken: string
      • partNumber: number
      • Optional range?: string
      • Optional source?: string

    Returns Promise<PartId>