バケットは、Object Storage Service (OSS) でオブジェクトを格納するために使用されるコンテナーです。OSS 内のすべてのオブジェクトはバケットに格納されます。このトピックでは、バケットの情報をクエリする方法について説明します。
注意事項
このトピックのサンプルコードを実行する前に、カスタムドメイン名や Security Token Service (STS) などを使用して OSSClient インスタンスを作成する必要があります。詳細については、「初期化」をご参照ください。
説明OSSClient インスタンスを初期化する際に、バケットが存在するリージョンに対応するエンドポイントを指定してください。
例
次のサンプルコードは、examplebucket という名前のバケットのリージョン、作成日時、ACL などの情報をクエリする方法の例を示しています。
OSSGetBucketInfoRequest *request = [OSSGetBucketInfoRequest new];
// バケット名を指定します。例: examplebucket。
request.bucketName = @"examplebucket";
// バケットの情報をクエリします。
OSSTask * getBucketInfoTask = [client getBucketInfo:request];
[getBucketInfoTask continueWithBlock:^id(OSSTask *task) {
if (!task.error) {
OSSGetBucketInfoResult *result = task.result;
NSLog(@"Creation time: %@", result.creationDate);
NSLog(@"Region: %@", result. Location);
NSLog(@"Storage class: %@", result.storageClass);
NSLog(@"Owner: %@", result.owner.userName);
NSLog(@"ACL: %@", result.acl.grant);
} else {
NSLog(@"get bucket info failed, error: %@", task.error);
}
return nil;
}];
// 同期ブロッキングを実装して、タスクが完了するのを待ちます。
// [getBucketInfoTask waitUntilFinished];関連ドキュメント
バケットの情報をクエリするために使用される完全なサンプルコードについては、GitHub をご参照ください。
バケットの情報をクエリするために呼び出すことができる API 操作の詳細については、「GetBucketInfo」をご参照ください。
OSSClient インスタンスを初期化する方法の詳細については、「初期化」をご参照ください。