![]() |
Spectra Logic |
1-800-833-1132 : 1-303-449-6400 |
GET http[s]://{datapathDNSname}/_rest_/object[?bucket_id={string}][&full_details][&include_physical_placement][&last_page][&latest=TRUE|FALSE][&name={string}][&page_length={32‑bit integer}][&page_offset={32‑bit integer}][&page_start_marker={string}][&type=DATA|FOLDER][&version={64‑bit integer}]
name a
§
§ <Blobs> (only if include_physical_placement is included)
<Object
Bucket="{string}"
Id="{string}"
InCache="TRUE|FALSE"
Latest="TRUE|FALSE"
Length="{64‑bit integer}"
Name="{string}"
Offset="{64‑bit integer}"
Version="{64‑bit integer}"><PhysicalPlacement>(only if full_details is included)
<AzureTargets>
<AzureTarget>
<AccountKey>{string}</AccountKey><AccountName>{string}</AccountName><AutoVerifyFrequencyInDays>
{integer}<CloudBucketPrefix>
{string}
</CloudBucketPrefix>
<CloudBucketSuffix>
{string}
</CloudBucketSuffix>
<DefaultReadPreference>
MINIMUM_LATENCY|AFTER_ONLINE_POOL|
AFTER_NEARLINE_POOL|
AFTER_NON_EJECTABLE_TAPE|LAST_RESORT|NEVER
</DefaultReadPreference><Https>TRUE|FALSE</Https>
<Id>{string}</Id><LastFullyVerified/>
<Name>{string}</Name>
<PermitGoingOutOfSync>
TRUE|FALSE
</PermitGoingOutOfSync><Quiesced>NO|PENDING|YES</Quiesced>
<State>ONLINE|OFFLINE|LIMITED_ACCESS</State>
</AzureTarget>
...
</AzureTargets>
<Ds3Targets>
<Ds3Target>
<AccessControlReplication>
NONE|USERS
</AccessControlReplication>
<AdminAuthId>{string}</AdminAuthId>
<AdminSecretKey>{string}</AdminSecretKey>
<DataPathEndPoint>{string}</DataPathEndPoint>
<DataPathHttps>TRUE|FALSE</DataPathHttps>
<DataPathPort>{16-bit integer}</DataPathPort>
<DataPathProxy>{string}</DataPathProxy>
<DataPathVerifyCertificate>
TRUE|FALSE
</DataPathVerifyCertificate>
<DefaultReadPreference>
MINIMUM_LATENCY|AFTER_ONLINE_POOL
|AFTER_NEARLINE_POOL
|AFTER_NON_EJECTABLE_TAPE|LAST_RESORT
|NEVER
</DefaultReadPreference>
<Id>{string}</Id>
<Name>{string}</Name>
<PermitGoingOutOfSync>
TRUE|FALSE
</PermitGoingOutOfSync>
<Quiesced>NO|PENDING|YES</Quiesced><ReplicatedUserDefaultDataPolicy>
{string}
</ReplicatedUserDefaultDataPolicy>
<State>ONLINE|OFFLINE</State>
</Ds3Target><Pools>
<Pool>
<AssignedToStorageDomain>
TRUE|FALSE
</AssignedToStorageDomain>
<AvailableCapacity>
{64‑bit integer}
</AvailableCapacity>
<BucketId>{string}</BucketId>
<Guid>{string}</Guid>
<Health>OK|DEGRADED</Health>
<Id>{string}</Id><LastAccessed>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastAccessed>
<LastModified>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastModified><LastVerified>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastVerified>
<Mountpoint>/{string}</Mountpoint>
<Name>{string}</Name>
<PartitionId>{string}</PartitionId>
<PoweredOn>TRUE|FALSE</PoweredOn>
<Quiesced>NO|PENDING|YES</Quiesced>
<ReservedCapacity>
{64‑bit integer}
</ReservedCapacity>
<State>
NORMAL|FOREIGN|IMPORT_IN_PROGRESS|
IMPORT_PENDING|LOST
</State>
<StorageDomainId>{string}</StorageDomainId><TotalCapacity>
{64‑bit integer}
</TotalCapacity>
<Type>NEARLINE|ONLINE</Type>
<UsedCapacity>{64‑bit integer}</UsedCapacity>
</Pool><S3Targets>
<S3Target>
<AccessKey>{string}</AccessKey>
<AutoVerifyFrequencyInDays>
{integer}
</AutoVerifyFrequencyInDays><DataPathEndPoint>{string}</DataPathEndPoint><Id>{string}</Id><Name>{string}</Name>{64-bit integer}<ProxyDomain>{string}</ProxyDomain><ProxyHost>{string}</ProxyHost><ProxyPassword>{string}</ProxyPassword><ProxyPort>{64-bit integer}</ProxyPort><ProxyUsername>{string}</ProxyUsername><Region>{string}</Region><SecretKey>{string}</SecretKey>{64-bit integer}<Tapes>
<Tape>
<AssignedToStorageDomain>
TRUE|FALSE
</AssignedToStorageDomain>
<AvailableRawCapacity>
{64‑bit integer}
</AvailableRawCapacity>
<BarCode>{string}</BarCode><BucketId>{string}</BucketId>
<DescriptionForIdentification>
{string}
</DescriptionForIdentification>
<EjectDate>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</EjectDate>
<EjectLabel>{string}</EjectLabel>
<EjectLocation>{string}</EjectLocation>
<EjectPending>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</EjectPending>
<FullOfData>TRUE|FALSE</FullOfData>
<Id>{string}</Id>
<LastAccessed>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastAccessed>
<LastCheckpoint>{string}</LastCheckpoint>
<LastModified>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastModified>
<LastVerified>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</LastVerified><PartiallyVerifiedEndOfTape>
{YYYY-MM-DDThh:mm:ss.xxxZ}
</PartiallyVerifiedEndOfTape>
<PartitionId>{string}</PartitionId><SerialNumber>{string}</SerialNumber><StorageDomainId>{string}</StorageDomainId><TotalRawCapacity>
{64‑bit integer}
</TotalRawCapacity>
<Type>
FORBIDDEN|LTO5|LTO6|LTO7|LTO8|LTOM8
|LTO_CLEANING_TAPE|TS_JC|TS_JY|TS_JK|TS_JD
|TS_JZ|TS_JL|TS_CLEANING_TAPE|UNKNOWN
</Type>
<VerifyPending>
CRITICAL|URGENT|HIGH|NORMAL|LOW|BACKGROUND
</VerifyPending>
<WriteProtected>TRUE|FALSE</WriteProtected>
</Tape>
</Tapes>
</PhysicalPlacement>
</Object>
...
</Blobs><BlobsBeingPersisted>{string}</BlobsBeingPersisted>
(only if include_physical_placement is included)
<BlobsDegraded>{64‑bit integer}</BlobsDegraded>
(only if include_physical_placement is included)
<BlobsInCache>{64‑bit integer}</BlobsInCache>
(only if include_physical_placement is included)
<BlobsTotal>{64‑bit integer}</BlobsTotal>
(only if include_physical_placement is included)
<BucketId>{string}</BucketId>
<CreationDate>{YYYY-MM-DDThh:mm:ss.xxxZ}</CreationDate><ETag>{string}</ETag> (only if full_details is included)
<Id>{string}</Id>
<Latest>TRUE|FALSE</Latest>
<Name>{string}</Name>
<Owner>{string}</Owner>
(only if full_details is included)
<Size>{string}</Size> (only if full_details is included)
<Type>DATA|FOLDER</Type>
<Version>{64‑bit integer}</Version>
</Object or S3Object>
...
</Data>
Values: MINIMUM_LATENCY, AFTER_ONLINE_POOL, AFTER_NEARLINE_POOL, AFTER_NON_EJECTABLE_TAPE, LAST_RESORT, NEVER. See read_preference. Values: TRUE, FALSE. The date and time the target was last fully verified in the format YYYY-MM-DDThh:mm:ss.xxxZ. NONE — No access control is replicated.USERS — The source BlackPearl system replicates its users and passwords to the target system. The S3 secret key for the account matching the given AdminAuthId. Whether the data path certificate is verified. When DataPathVerifyCertificate and DataPathHttps are both TRUE, the source BlackPearl system fully validates the target system’s certificate. If the certificate is not trusted or problematic in anyway, it is not honored.
Values: TRUE, FALSE Values: MINIMUM_LATENCY, AFTER_ONLINE_POOL, AFTER_NEARLINE_POOL, AFTER_NON_EJECTABLE_TAPE, LAST_RESORT, NEVER. See read_preference. Whether a target is allowed to be out of sync with the source. By default, if the data policy specifies that the BlackPearl system must replicate local actions, actions that the system cannot replicate fail. You can temporarily set this parameter to TRUE in order to operate in full capacity locally while one or more targets is down for a prolonged period of time. The last date and time the object was modified in the format YYYY-MM-DDThh:mm:ss.xxxZ. The last date and time the checksum of the data was verified in the format YYYY-MM-DDThh:mm:ss.xxxZ. Values: MINIMUM_LATENCY, AFTER_ONLINE_POOL, AFTER_NEARLINE_POOL, AFTER_NON_EJECTABLE_TAPE, LAST_RESORT, NEVER. See read_preference. Values: TRUE, FALSE. The date and time data on the target was last fully verified in the format YYYY-MM-DDThh:mm:ss.xxxZ. The world region where the Amazon S3 target is physically located. Values: US_EAST_1, US_WEST_1, US_WEST_2, EU_WEST_1, EU_CENTRAL_1, AP_SOUTH_1, AP_SOUTHEAST_1, AP_SOUTHEAST_2, AP_NORTHEAST_1, AP_NORTHEAST_2, SA_EAST_1, CN_NORTH_1, GOV_CLOUD The date and time that the BlackPearl system discovered that the tape was ejected, in the format YYYY-MM-DDThh:mm:ss.xxxZ. If the parameter is empty, the tape has not been ejected. The date and time that the tape was put in the queue to be ejected in the format YYYY-MM-DDThh:mm:ss.xxxZ. If the parameter is empty, the tape has not been queued to be ejected or the eject has started and is no longer cancelable. The last date and time the tape was loaded into a tape drive in the format YYYY-MM-DDThh:mm:ss.xxxZ. The last date and time the object was modified in the format YYYY-MM-DDThh:mm:ss.xxxZ. The last date and time the checksum of the data was verified in the format YYYY-MM-DDThh:mm:ss.xxxZ.
§ TRUE — The foreign tape was imported when WriteProtected was TRUE, preventing the tape from being claimed by the current BlackPearl system.
§ FALSE — The tape was imported successfully. The tape format and generation of the tape cartridge.
Values: LTO5, LTO6, LTO7, LTO8, LTOM8, LTO_CLEANING_TAPE, TS_JC, TS_JY, TS_JK, TS_JD, TS_JZ, TS_JL, TS_CLEANING_TAPE, UNKNOWN, FORBIDDEN The priority for the verify requested, or null if a verify has not been requested. The priority determines the resources assigned and the processing order.
Values: CRITICAL, URGENT, HIGH, NORMAL, LOW, BACKGROUND The date and time the bucket was created in the format YYYY-MM-DDThh:mm:ss.xxxZ. GET http://blackpearl-hostname/_rest_/object?full_details HTTP/1.1