Skip to content
GET /unified/cloud-infrastructure/object_stores/{id}

Path Parameters

idstring
required·

The ID of the resource.

Example: 23423523

Query Parameters

Refer Specifying query parameters in Truto APIs

Show Truto-specific parameters
integrated_account_idstring · uuid
required·

The ID of the integrated account to use for the request.

Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d
truto_response_formatstring

The format of the response.

  • unified returns the response with unified mappings applied.
  • raw returns the unprocessed, raw response from the remote API.
  • normalized applies the unified mappings and returns the data in a normalized format.
  • stream returns the response as a stream, which is ideal for transmitting large datasets, files, or binary data. Using streaming mode helps to efficiently handle large payloads or real-time data flows without requiring the entire data to be buffered in memory.
  • debug returns the final unified result alongside raw remote fetch information. The response is an envelope containing result (identical to unified mode output) and debug (with requestUrl, requestOptions, data, responseHeaders, and for list operations: nextCursor, isLooping, isEmptyResult, resultCount). When the upstream body exceeds 1 MiB, data is replaced by { truto_truncated: true, truto_max_bytes, truto_excerpt }. debug is null for static responses or when truto_skip_api_call=true.

Defaults to unified.

Example: unified
Possible values:
unifiedrawnormalizedstreamdebug
truto_ignore_remote_databoolean

Excludes the remote_data attribute from the response.

truto_exclude_fieldsstring[]

Array of fields to exclude from the response.

Example: truto_exclude_fields[]=id&truto_exclude_fields[]=name
remote_queryRecord<string, any>

Query parameters to pass to the underlying API without any transformations. Refer this guide to see how to structure the query parameters.

Example: remote_query[foo]=bar

Response Body

idstring
required·

Truto's stable unified identifier for this object. Opaque; use provider_id to address the object in the provider's own console or API.

1 supported
Amazon Web Services
supported
access_logging_enabledboolean

Whether access logging is on. On AWS an unlogged bucket returns an empty document rather than an error, read as false.

1 supported
Amazon Web Services
supported
accountstring

The account, subscription or project this object belongs to.

References: Accounts → id
1 supported
Amazon Web Services
supported
acl_grants_anyoneboolean

Whether an ACL grants access to a public group, tracked separately from policy_grants_anyone since the two can differ.

1 supported
Amazon Web Services
supported
acl_grants_authenticated_usersboolean

Whether an ACL grants access to any authenticated account on the provider (not anonymous — requests must be signed, but any account on the provider qualifies).

1 supported
Amazon Web Services
supported
anonymous_access_allowedboolean

Whether the store is effectively reachable without credentials. Computed from the provider's effective access rules, not a single flag.

1 supported
Amazon Web Services
supported
collected_atstring · date-time

When Truto actually read this object from the provider, in UTC ISO 8601 with the offset present — not the request time, and not a provider timestamp.

1 supported
Amazon Web Services
supported
created_atstring

When the object was created at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.

1 supported
Amazon Web Services
supported
effective_public_access_blockobject

The per-flag effective block configuration, combining account-level and store-level settings.

1 supported
Amazon Web Services
supported
block_public_aclsboolean

AWS BlockPublicAcls. Rejects new public ACLs on the store and its objects.

block_public_policyboolean

AWS BlockPublicPolicy. Rejects a store policy that would grant public access.

ignore_public_aclsboolean

AWS IgnorePublicAcls. Ignores any public ACL already present.

restrict_public_bucketsboolean

AWS RestrictPublicBuckets. Limits access under a public policy to principals in this account and AWS services.

encryption_algorithmstring

The provider's own algorithm string, verbatim.

1 supported
Amazon Web Services
supported
encryption_keyobject

The key protecting the store, where a customer-managed one is configured.

References: ManagedKeys → id
1 supported
Amazon Web Services
supported
idstring

The target's id.

encryption_key_typestring

Who manages the encryption key. On AWS every bucket now gets default provider-side encryption, so 'none' is effectively obsolete; what matters is whether the key is customer_managed.

Possible values:
provider_managedprovider_ownedcustomer_managedcustomer_suppliednoneunknown
1 supported
Amazon Web Services
supported
lifecycle_rulesobject[]

Lifecycle rules configured on the store.

1 supported
Amazon Web Services
supported
expiration_daysinteger

Days after which matching objects expire.

idstring

The provider's own rule id.

prefixstring

Object key prefix the rule applies to, if scoped.

statusstring

Whether the rule is enabled.

locationstring

Where the store's data physically sits.

1 supported
Amazon Web Services
supported
min_tls_versionstring

Minimum TLS version accepted. AWS has no bucket-level setting — only a per-action policy condition, so requirements can vary by action. Null with not_supported_by_provider there.

1 supported
Amazon Web Services
supported
namestring

The bucket or container name.

1 supported
Amazon Web Services
supported
native_typestring

The provider's own type string, unmodified — for example 'AWS::S3::Bucket', 'aws_iam_role', 'Microsoft.Sql/servers'. Used for display and drill-down.

1 supported
Amazon Web Services
supported
object_lock_enabledboolean

Whether write-once retention is enabled on the store.

1 supported
Amazon Web Services
supported
policy_grants_anyoneboolean

Whether the bucket policy grants access to anyone (distinct from account-level toggles, which can disagree). On AWS, cross-account access often can't read the policy body itself, so this may be marked permission_denied.

1 supported
Amazon Web Services
supported
providerstring

Which cloud this object was read from.

Possible values:
awsazuregcp
1 supported
Amazon Web Services
supported
provider_idstring

The provider's own identifier. S3 returns an ARN only for directory buckets; for general-purpose buckets this is the canonical arn:<partition>:s3:::<name>, which is how AWS itself addresses the bucket.

1 supported
Amazon Web Services
supported
public_access_blockedboolean

Whether public access is comprehensively blocked. True only when all four effective block-public-access flags are set (the more restrictive of account- and bucket-level config); a missing configuration counts as all-false.

1 supported
Amazon Web Services
supported
regionstring

Where the object is located. 'global' denotes genuinely global resources (e.g. IAM, GCP VPC networks) rather than a guessed region. A substituted region (when none is derivable) is flagged in unreadable_fields.

1 supported
Amazon Web Services
supported
remote_dataRecord<string, any>

Raw data returned from the remote API call.

replication_enabledboolean

Whether any replication rule is configured and enabled.

1 supported
Amazon Web Services
supported
replication_targetsstring[]

Destination stores this store replicates to, as provider references. The destination region is not returned by the provider.

1 supported
Amazon Web Services
supported
retention_lockedboolean

Whether the retention period cannot be shortened or removed. On AWS this maps to a COMPLIANCE-mode default rule, which only governs future objects, not what's already stored.

1 supported
Amazon Web Services
supported
retention_policy_daysinteger

Default retention period applied to objects, in days.

1 supported
Amazon Web Services
supported
store_idstring

The provider's own identifier for the store.

1 supported
Amazon Web Services
supported
tagsobject

Key-value pairs exactly as the customer set them: no case folding, key/value normalization, or merging of separate provider concepts. An empty object means no tags; tags that could not be read appear in unreadable_fields instead.

1 supported
Amazon Web Services
supported
unreadable_fieldsobject[]

Fields on this object that could not be read, and why. An empty array means everything was read. Use this to tell a real value from a missing one.

1 supported
Amazon Web Services
supported
detailstring

Explanation of the reason, where one adds anything.

fieldstring

The property on this resource that could not be read.

reasonstring

Why the field could not be read. available_on_get: Not read on list to keep the list fast; call GET for this resource's id to get it.

Possible values:
not_supported_by_providernot_configuredpermission_deniednot_collectedcollection_errorpartially_collectedavailable_on_get
updated_atstring

When the object was last modified at the provider, in UTC ISO 8601. Null when the provider does not record one - see unreadable_fields.

1 supported
Amazon Web Services
supported
versioning_enabledboolean

Whether object versioning is on. On AWS, a bucket that never had versioning enabled returns no status field, read as false rather than unknown.

1 supported
Amazon Web Services
supported
truto unified cloud-infrastructure objectstores '<resource_id>' \
  -m get \
  -a '<integrated_account_id>' \
  -o json
import Truto from '@truto/truto-ts-sdk';

const truto = new Truto({
  token: '<your_api_token>',
});

const result = await truto.unifiedApi.get(
  'cloud-infrastructure',
  'objectstores',
  '<resource_id>',
  { integrated_account_id: '<integrated_account_id>' }
);

console.log(result);
import asyncio
from truto_python_sdk import TrutoApi

truto_api = TrutoApi(token="<your_api_token>")

async def main():
    result = await truto_api.unified_api.get(
        "cloud-infrastructure",
        "objectstores",
        "<resource_id>",
        {"integrated_account_id": "<integrated_account_id>"}
    )
    print(result)

asyncio.run(main())
curl -X GET 'https://api.truto.one/unified/cloud-infrastructure/object_stores/{id}?integrated_account_id=<integrated_account_id>' \
  -H 'Authorization: Bearer <your_api_token>' \
  -H 'Content-Type: application/json'
const integratedAccountId = '<integrated_account_id>';

const response = await fetch(`https://api.truto.one/unified/cloud-infrastructure/object_stores/{id}?integrated_account_id=${integratedAccountId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <your_api_token>',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);
import requests

url = "https://api.truto.one/unified/cloud-infrastructure/object_stores/{id}"
headers = {
    "Authorization": "Bearer <your_api_token>",
    "Content-Type": "application/json",
}
params = {
    "integrated_account_id": "<integrated_account_id>"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())