36 KiB
36 KiB
garage_admin_sdk.BucketApi
All URIs are relative to http://localhost:3903/v0
| Method | HTTP request | Description |
|---|---|---|
| allow_bucket_key | POST /bucket/allow | Allow key |
| create_bucket | POST /bucket | Create a bucket |
| delete_bucket | DELETE /bucket?id={bucket_id} | Delete a bucket |
| delete_bucket_global_alias | DELETE /bucket/alias/global | Delete a global alias |
| delete_bucket_local_alias | DELETE /bucket/alias/local | Delete a local alias |
| deny_bucket_key | POST /bucket/deny | Deny key |
| find_bucket_info | GET /bucket?globalAlias={alias} | Find a bucket |
| get_bucket_info | GET /bucket?id={bucket_id} | Get a bucket |
| list_buckets | GET /bucket | List all buckets |
| put_bucket_global_alias | PUT /bucket/alias/global | Add a global alias |
| put_bucket_local_alias | PUT /bucket/alias/local | Add a local alias |
| update_bucket | PUT /bucket?id={bucket_id} | Update a bucket |
allow_bucket_key
BucketInfo allow_bucket_key(allow_bucket_key_request)
Allow key
⚠️ DISCLAIMER: Garage's developers are aware that this endpoint has an unconventional semantic. Be extra careful when implementing it, its behavior is not obvious. Allows a key to do read/write/owner operations on a bucket. Flags in permissions which have the value true will be activated. Other flags will remain unchanged (ie. they will keep their internal value). For example, if you set read to true, the key will be allowed to read the bucket. If you set it to false, the key will keeps its previous read permission. If you want to disallow read for the key, check the DenyBucketKey operation.
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from garage_admin_sdk.model.allow_bucket_key_request import AllowBucketKeyRequest
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
allow_bucket_key_request = AllowBucketKeyRequest(
bucket_id="e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b",
access_key_id="GK31c2f218a2e44f485b94239e",
permissions=AllowBucketKeyRequestPermissions(
read=True,
write=True,
owner=True,
),
) # AllowBucketKeyRequest | Aliases to put on the new bucket
# example passing only required values which don't have defaults set
try:
# Allow key
api_response = api_instance.allow_bucket_key(allow_bucket_key_request)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->allow_bucket_key: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| allow_bucket_key_request | AllowBucketKeyRequest | Aliases to put on the new bucket |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
create_bucket
BucketInfo create_bucket(create_bucket_request)
Create a bucket
Creates a new bucket, either with a global alias, a local one, or no alias at all. Technically, you can also specify both globalAlias and localAlias and that would create two aliases.
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from garage_admin_sdk.model.create_bucket_request import CreateBucketRequest
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
create_bucket_request = CreateBucketRequest(
global_alias="my_documents",
local_alias=CreateBucketRequestLocalAlias(
access_key_id="access_key_id_example",
alias="alias_example",
allow=CreateBucketRequestLocalAliasAllow(
read=True,
write=True,
owner=True,
),
),
) # CreateBucketRequest | Aliases to put on the new bucket
# example passing only required values which don't have defaults set
try:
# Create a bucket
api_response = api_instance.create_bucket(create_bucket_request)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->create_bucket: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| create_bucket_request | CreateBucketRequest | Aliases to put on the new bucket |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | The payload is not formatted correctly | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_bucket
delete_bucket(bucket_id)
Delete a bucket
Delete a bucket.Deletes a storage bucket. A bucket cannot be deleted if it is not empty. Warning: this will delete all aliases associated with the bucket!
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
bucket_id = "b4018dc61b27ccb5c64ec1b24f53454bbbd180697c758c4d47a22a8921864a87" # str | The exact bucket identifier, a 32 bytes hexadecimal string
# example passing only required values which don't have defaults set
try:
# Delete a bucket
api_instance.delete_bucket(bucket_id)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->delete_bucket: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| bucket_id | str | The exact bucket identifier, a 32 bytes hexadecimal string |
Return type
void (empty response body)
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: Not defined
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bucket is not empty | - |
| 404 | Bucket not found | - |
| 204 | Bucket has been deleted | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_bucket_global_alias
BucketInfo delete_bucket_global_alias(id, alias)
Delete a global alias
Delete a global alias from the target bucket
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
id = "e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b" # str |
alias = "my_documents" # str |
# example passing only required values which don't have defaults set
try:
# Delete a global alias
api_response = api_instance.delete_bucket_global_alias(id, alias)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->delete_bucket_global_alias: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | str | ||
| alias | str |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
delete_bucket_local_alias
BucketInfo delete_bucket_local_alias(id, access_key_id, alias)
Delete a local alias
Delete a local alias, bound to specified account, from the target bucket
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
id = "e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b" # str |
access_key_id = "GK31c2f218a2e44f485b94239e" # str |
alias = "my_documents" # str |
# example passing only required values which don't have defaults set
try:
# Delete a local alias
api_response = api_instance.delete_bucket_local_alias(id, access_key_id, alias)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->delete_bucket_local_alias: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | str | ||
| access_key_id | str | ||
| alias | str |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
deny_bucket_key
BucketInfo deny_bucket_key(allow_bucket_key_request)
Deny key
⚠️ DISCLAIMER: Garage's developers are aware that this endpoint has an unconventional semantic. Be extra careful when implementing it, its behavior is not obvious. Denies a key from doing read/write/owner operations on a bucket. Flags in permissions which have the value true will be deactivated. Other flags will remain unchanged. For example, if you set read to true, the key will be denied from reading. If you set read to false, the key will keep its previous permissions. If you want the key to have the reading permission, check the AllowBucketKey operation.
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from garage_admin_sdk.model.allow_bucket_key_request import AllowBucketKeyRequest
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
allow_bucket_key_request = AllowBucketKeyRequest(
bucket_id="e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b",
access_key_id="GK31c2f218a2e44f485b94239e",
permissions=AllowBucketKeyRequestPermissions(
read=True,
write=True,
owner=True,
),
) # AllowBucketKeyRequest | Aliases to put on the new bucket
# example passing only required values which don't have defaults set
try:
# Deny key
api_response = api_instance.deny_bucket_key(allow_bucket_key_request)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->deny_bucket_key: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| allow_bucket_key_request | AllowBucketKeyRequest | Aliases to put on the new bucket |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
find_bucket_info
BucketInfo find_bucket_info(alias)
Find a bucket
Find a bucket by its global alias
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
alias = "my_documents" # str | The exact global alias of one of the existing buckets
# example passing only required values which don't have defaults set
try:
# Find a bucket
api_response = api_instance.find_bucket_info(alias)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->find_bucket_info: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| alias | str | The exact global alias of one of the existing buckets |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
get_bucket_info
BucketInfo get_bucket_info(bucket_id)
Get a bucket
Given a bucket identifier, get its information. It includes its aliases, its web configuration, keys that have some permissions on it, some statistics (number of objects, size), number of dangling multipart uploads, and its quotas (if any).
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
bucket_id = "b4018dc61b27ccb5c64ec1b24f53454bbbd180697c758c4d47a22a8921864a87" # str | The exact bucket identifier, a 32 bytes hexadecimal string
# example passing only required values which don't have defaults set
try:
# Get a bucket
api_response = api_instance.get_bucket_info(bucket_id)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->get_bucket_info: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| bucket_id | str | The exact bucket identifier, a 32 bytes hexadecimal string |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
list_buckets
[ListBuckets200ResponseInner] list_buckets()
List all buckets
List all the buckets on the cluster with their UUID and their global and local aliases.
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.list_buckets200_response_inner import ListBuckets200ResponseInner
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
# example, this endpoint has no required or optional parameters
try:
# List all buckets
api_response = api_instance.list_buckets()
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->list_buckets: %s\n" % e)
Parameters
This endpoint does not need any parameter.
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 200 | Returns the UUID of the bucket and all its aliases | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
put_bucket_global_alias
BucketInfo put_bucket_global_alias(id, alias)
Add a global alias
Add a global alias to the target bucket
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
id = "e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b" # str |
alias = "my_documents" # str |
# example passing only required values which don't have defaults set
try:
# Add a global alias
api_response = api_instance.put_bucket_global_alias(id, alias)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->put_bucket_global_alias: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | str | ||
| alias | str |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
put_bucket_local_alias
BucketInfo put_bucket_local_alias(id, access_key_id, alias)
Add a local alias
Add a local alias, bound to specified account, to the target bucket
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
id = "e6a14cd6a27f48684579ec6b381c078ab11697e6bc8513b72b2f5307e25fff9b" # str |
access_key_id = "GK31c2f218a2e44f485b94239e" # str |
alias = "my_documents" # str |
# example passing only required values which don't have defaults set
try:
# Add a local alias
api_response = api_instance.put_bucket_local_alias(id, access_key_id, alias)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->put_bucket_local_alias: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| id | str | ||
| access_key_id | str | ||
| alias | str |
Return type
Authorization
HTTP request headers
- Content-Type: Not defined
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your request body | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]
update_bucket
BucketInfo update_bucket(bucket_id, update_bucket_request)
Update a bucket
All fields (websiteAccess and quotas) are optionnal. If they are present, the corresponding modifications are applied to the bucket, otherwise nothing is changed. In websiteAccess: if enabled is true, indexDocument must be specified. The field errorDocument is optional, if no error document is set a generic error message is displayed when errors happen. Conversely, if enabled is false, neither indexDocument nor errorDocument must be specified. In quotas: new values of maxSize and maxObjects must both be specified, or set to null to remove the quotas. An absent value will be considered the same as a null. It is not possible to change only one of the two quotas.
Example
- Bearer Authentication (bearerAuth):
import time
import garage_admin_sdk
from garage_admin_sdk.api import bucket_api
from garage_admin_sdk.model.bucket_info import BucketInfo
from garage_admin_sdk.model.update_bucket_request import UpdateBucketRequest
from pprint import pprint
# Defining the host is optional and defaults to http://localhost:3903/v0
# See configuration.py for a list of all supported configuration parameters.
configuration = garage_admin_sdk.Configuration(
host = "http://localhost:3903/v0"
)
# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.
# Configure Bearer authorization: bearerAuth
configuration = garage_admin_sdk.Configuration(
access_token = 'YOUR_BEARER_TOKEN'
)
# Enter a context with an instance of the API client
with garage_admin_sdk.ApiClient(configuration) as api_client:
# Create an instance of the API class
api_instance = bucket_api.BucketApi(api_client)
bucket_id = "b4018dc61b27ccb5c64ec1b24f53454bbbd180697c758c4d47a22a8921864a87" # str | The exact bucket identifier, a 32 bytes hexadecimal string
update_bucket_request = UpdateBucketRequest(
website_access=UpdateBucketRequestWebsiteAccess(
enabled=True,
index_document="index.html",
error_document="error/400.html",
),
quotas=UpdateBucketRequestQuotas(
max_size=19029801,
max_objects=1,
),
) # UpdateBucketRequest | Requested changes on the bucket. Both root fields are optionals.
# example passing only required values which don't have defaults set
try:
# Update a bucket
api_response = api_instance.update_bucket(bucket_id, update_bucket_request)
pprint(api_response)
except garage_admin_sdk.ApiException as e:
print("Exception when calling BucketApi->update_bucket: %s\n" % e)
Parameters
| Name | Type | Description | Notes |
|---|---|---|---|
| bucket_id | str | The exact bucket identifier, a 32 bytes hexadecimal string | |
| update_bucket_request | UpdateBucketRequest | Requested changes on the bucket. Both root fields are optionals. |
Return type
Authorization
HTTP request headers
- Content-Type: application/json
- Accept: application/json
HTTP response details
| Status code | Description | Response headers |
|---|---|---|
| 500 | The server can not handle your request. Check your connectivity with the rest of the cluster. | - |
| 400 | Bad request, check your body. | - |
| 404 | Bucket not found | - |
| 200 | Returns exhaustive information about the bucket | - |
[Back to top] [Back to API list] [Back to Model list] [Back to README]