client.storage_hosts.post

A method of the Storage Hosts endpoint.

post(provider: str, bucket: str, name: str, *, s3_options: dict = None) → Response

Create a new storage host

API URL: POST /storage_hosts

import civis
client = civis.APIClient()
response = client.storage_hosts.post(...)

Parameters:

providerstr

The storage provider.One of: s3.

bucketstr

The bucket for this storage host.

namestr

The human readable name for the storage host.

s3_optionsdict, optional

• regionstr

  The region for this storage host (ex. “us-east-1”)

Returns:

civis.Response

• idint

  The ID of the storage host.

• ownercivis.Response

  • idint

    The ID of this user.

  • namestr

    This user’s name.

  • usernamestr

    This user’s username.

  • initialsstr

    This user’s initials.

  • onlinebool

    Whether this user is online.

• namestr

  The human readable name for the storage host.

• providerstr

  The storage provider.One of: s3.

• bucketstr

  The bucket for this storage host.

• s3_optionscivis.Response

  • regionstr

    The region for this storage host (ex. “us-east-1”)