edit-icon download-icon

GetBucketWebsite

最終更新日: Aug 01, 2018

GetBucketWebsite 操作を使用すると、バケットの静的 Web サイトホスティングステータスを表示できます。

リクエスト構文

  1. GET /?website HTTP/1.1
  2. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  3. Date: GMT Date
  4. Authorization: SignatureValue

レスポンスの要素

名前 説明
ErrorDocument Container Key 要素のコンテナー。
親: WebsiteConfiguration
IndexDocument Container Suffix 要素のコンテナー。
親: WebsiteConfiguration
Key String 4XX クラスエラーが発生した場合に使用するオブジェクトのキー名。
親: WebsiteConfiguration.ErrorDocument 条件: ErrorDocument が指定されている場合は必須
Suffix String Web サイトエンドポイントのディレクトリに対するリクエストに追加されるサフィックス (たとえば、サフィックスが index.html である場合に、samplebucket/images/ に対するリクエストを送信すると、キー名が images/index.html であるオブジェクトのデータが返されます)。サフィックスを空にすることはできません。スラッシュを含めることもできません。
親: WebsiteConfiguration.IndexDocument
WebsiteConfiguration Container リクエストのコンテナー。
親: なし

詳細分析

  1. バケットが存在しない場合は、エラー “404 no content” が返されます。エラーコードは NoSuchBucket です。
  2. バケットの静的 Web サイトホスティングステータスを表示できるのはバケットオーナーだけです。他のユーザーが表示しようとすると、エラー 403 Forbidden が返されます。エラーコードは AccessDenied です。
  3. ソースバケットで静的 Web サイトホスティング機能が設定されていない場合は、エラー 404 が返されます。エラーコードは NoSuchWebsiteConfiguration です。

リクエストの例:

  1. Get /?website HTTP/1.1
  2. Host: oss-example.oss-cn-hangzhou.aliyuncs.com
  3. Date: Thu, 13 Sep 2012 07:51:28 GMT
  4. Authorization: OSS qn6qrrqxo2oawuk53otfjbyc: BuG4rRK+zNhH1AcF51NNHD39zXw=

レスポンスの例 (ログルールが既に設定されている場合):

  1. HTTP/1.1 200
  2. x-oss-request-id: 50519080C4689A033D00235F
  3. Date: Thu, 13 Sep 2012 07:51:28 GMT
  4. Connection: close
  5. Content-Length: 218
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <WebsiteConfiguration xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
  9. <IndexDocument>
  10. <Suffix>index.html</Suffix>
  11. </IndexDocument>
  12. <ErrorDocument>
  13. <Key>error.html</Key>
  14. </ErrorDocument>
  15. </WebsiteConfiguration>

レスポンスの例 (LOG ルールが設定されていない場合):

  1. HTTP/1.1 404
  2. x-oss-request-id: 534B371674E88A4D8906008B
  3. Date: Thu, 13 Sep 2012 07:56:46 GMT
  4. Connection: keep-alive
  5. Content-Length: 308
  6. Server: AliyunOSS
  7. <?xml version="1.0" encoding="UTF-8"?>
  8. <Error xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
  9. <Code>NoSuchWebsiteConfiguration</Code>
  10. <Message>The specified bucket does not have a website configuration.</Message>
  11. <BucketName>oss-example</BucketName>
  12. <RequestId>505191BEC4689A033D00236F</RequestId>
  13. <HostId>oss-example.oss-cn-hangzhou.aliyuncs.com</HostId>
  14. </Error>