Obtaining the Custom Domain Names of a Bucket¶
Function¶
This API obtains the custom domain name of a bucket.
Restrictions¶
To obtain the custom domain name for a bucket, you must be the bucket owner or have the required permission (obs:bucket:GetBucketCustomDomainConfiguration in IAM or GetBucketCustomDomainConfiguration in a bucket policy).
Method¶
func (obsClient ObsClient) GetBucketCustomDomain(bucketName string) (output *GetBucketCustomDomainOuput, err error)
Request Parameters¶
Parameter | Type | Mandatory (Yes/No) | Description |
|---|---|---|---|
bucketName | string | Yes | Explanation: Bucket name Restrictions:
Default value: None |
Responses¶
Parameter | Type | Description |
|---|---|---|
output | Explanation: Returned results. For details, see Table 3. | |
err | error | Explanation: Error messages returned by the API |
Parameter | Type | Description |
|---|---|---|
StatusCode | int | Explanation: HTTP status code Value range: A status code is a group of digits that can be 2xx (indicating successes) or 4xx or 5xx (indicating errors). It indicates the status of a response. Default value: None |
RequestId | string | Explanation: Request ID returned by the OBS server Default value: None |
ResponseHeaders | map[string][]string | Explanation: HTTP response headers Default value: None |
Domains | []Domain | Explanation: Domain information. For details, see Table 4. |
Parameter | Type | Description |
|---|---|---|
DomainName | string | Explanation: User-defined domain name Restrictions: The value must comply with the domain name rules. Default value: The value can be up to 256 bytes. Default value: None |
CreateTime | string | Explanation: Time when the custom domain name was created For example: 2019-03-13T10:22:05.912Z
|
Code Examples¶
This example returns the custom domain name of bucket examplebucket.
package main
import (
"fmt"
"os"
"obs-sdk-go/obs"
)
func main() {
//Obtain an AK/SK pair using environment variables or import an AK/SK pair in other ways. Using hard coding may result in leakage.
//Obtain an AK/SK pair on the management console.
ak := os.Getenv("AccessKeyID")
sk := os.Getenv("SecretAccessKey")
// (Optional) If you use a temporary AK/SK pair and a security token to access OBS, you are advised not to use hard coding to reduce leakage risks. You can obtain an AK/SK pair using environment variables or import an AK/SK pair in other ways.
securityToken := os.Getenv("SecurityToken")
// Enter the endpoint of the region where the bucket locates.
endPoint := "https://your-endpoint"
// Create an obsClient instance.
// If you use a temporary AK/SK pair and a security token to access OBS, use the obs.WithSecurityToken method to specify a security token when creating an instance.
obsClient, err := obs.New(ak, sk, endPoint, obs.WithSecurityToken(securityToken))
if err != nil {
fmt.Printf("Create obsClient error, errMsg: %s", err.Error())
}
// Specify a bucket name.
bucketname := "examplebucket"
// Obtain the custom domain name of the bucket.
output, err := obsClient.GetBucketCustomDomain(bucketname)
if err == nil {
fmt.Printf("Get bucket(%s)'s customdomain successful!\n", bucketname)
fmt.Printf("RequestId:%s\n", output.RequestId)
return
}
fmt.Printf("Get bucket(%s)'s customdomain fail!\n", bucketname)
if obsError, ok := err.(obs.ObsError); ok {
fmt.Println("An ObsError was found, which means your request sent to OBS was rejected with an error response.")
fmt.Println(obsError.Error())
} else {
fmt.Println("An Exception was found, which means the client encountered an internal problem when attempting to communicate with OBS, for example, the client was unable to access the network.")
fmt.Println(err)
}
}