tencent cloud

PrevNext

masukan

cari berdasarkan kata kunci

Recent Pages

Dokumentasi
Cloud Object Storage
    Dokumentasi
    Download PDF

    HEAD Bucket

    Terakhir diperbarui:2024-03-28 18:08:33
    Unduh PDF

      Feature Description

      This API (HEAD Bucket) is used to verify whether a bucket exists and whether you have permission to access it.
      If the bucket exists and you have permission to read it, HTTP status code 200 will be returned.
      If you do not have permission to read the bucket, HTTP status code 403 will be returned.
      If the bucket does not exist, HTTP status code 404 will be returned.
      

      Request

      Sample request

      HEAD / HTTP/1.1
      Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
      Date: GMT Date
      Authorization: Auth String
      Note:
      Host: <BucketName-APPID>.cos.<Region>.myqcloud.com, where <BucketName-APPID> is the bucket name followed by the APPID, such as examplebucket-1250000000 (see Bucket Overview > Basic Information and Bucket Overview > Bucket Naming Conventions), and <Region> is a COS region (see Regions and Access Endpoints).
      Authorization: Auth String (See Request Signature for details.)

      Request parameters

      This API has no request parameter.

      Request headers

      This API only uses Common Request Headers.

      Request body

      This API does not have a request body.

      Response

      Response headers

      In addition to common response headers, this API also returns the following response headers. For more information about common response headers, see Common Response Headers.
      Name
      Description
      Type
      x-cos-bucket-az-type
      AZ type of the bucket. This header is returned only for MAZ buckets. Fixed to MAZ.
      Enum
      x-cos-bucket-region
      Bucket region, such as ap-beijing, ap-hongkong, and eu-frankfurt. For the enumerated values, see Regions and Access Endpoints.
      Enum

      Response body

      The response body of this API is empty.

      Error codes

      This API returns common error responses and error codes. For more information, see Error Codes.

      Samples

      Sample 1: OAZ bucket

      Request

      HEAD / HTTP/1.1
      Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
      Date: Tue, 28 May 2019 03:16:12 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1559013372;1559020572&q-key-time=1559013372;1559020572&q-header-list=date;host&q-url-param-list=&q-signature=9085930afacf1e8a0ade2697b69353b27901****
      Connection: close

      Response

      HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 0
      Connection: close
      Date: Tue, 28 May 2019 03:16:12 GMT
      Server: tencent-cos
      x-cos-bucket-region: ap-beijing
      x-cos-request-id: NWNlY2E3ZmNfZjhjMDBiMDlfMTBjOWRfZDcz****

      Sample 2: MAZ bucket

      Request

      HEAD / HTTP/1.1
      Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
      Date: Thu, 04 Jun 2020 06:43:03 GMT
      Authorization: q-sign-algorithm=sha1&q-ak=AKID8A0fBVtYFrNm02oY1g1JQQF0c3JO****&q-sign-time=1591252983;1591260183&q-key-time=1591252983;1591260183&q-header-list=date;host&q-url-param-list=&q-signature=aa996608fe79d122ed9667d9db3caa262ed6****
      Connection: close

      Response

      HTTP/1.1 200 OK
      Content-Type: application/xml
      Content-Length: 0
      Connection: close
      Date: Thu, 04 Jun 2020 06:43:03 GMT
      Server: tencent-cos
      x-cos-bucket-az-type: MAZ
      x-cos-bucket-region: ap-beijing
      x-cos-request-id: NWVkODk3ZjdfZjI4NWQ2NF9hODhkXzRhNmQ0****
      
      Hubungi Kami

      Hubungi tim penjualan atau penasihat bisnis kami untuk membantu bisnis Anda.

      Hubungi Kami
      Dukungan Teknis

      Buka tiket jika Anda mencari bantuan lebih lanjut. Tiket kami tersedia 7x24.

      Kirim Tiket
      Dukungan Telepon 7x24
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Kebijakan PrivasiLegalKebijakan Cookie