Tous les produits
Search
Centre de documentation

Object Storage Service:Mapper des noms de domaine personnalisés avec le SDK OSS pour Python 2.0

Dernière mise à jour :Sep 24, 2026

Après avoir chargé des objets dans un bucket, Object Storage Service (OSS) génère automatiquement des URL contenant le point de terminaison public du bucket. Utilisez ces URL pour accéder aux objets. Pour y accéder via un nom de domaine personnalisé, ajoutez un enregistrement CNAME afin de mapper ce nom de domaine au bucket hébergeant les objets.

Remarques sur l'utilisation

  • Le code d'exemple de cette rubrique utilise l'ID de région cn-hangzhou de la région Chine (Hangzhou). Par défaut, l'accès aux ressources d'un bucket s'effectue via un point de terminaison public. Pour accéder aux ressources du bucket depuis d'autres services Alibaba Cloud situés dans la même région, utilisez un point de terminaison interne. Pour plus d'informations sur les régions et les points de terminaison OSS, consultez Régions et points de terminaison.

Exemples

Créer un jeton CNAME

L'exemple de code suivant montre comment créer un jeton CNAME :

import argparse
import alibabacloud_oss_v2 as oss

# Create a command line parameter parser and describe the purpose of the script. The example describes how to create a CNAME token.
parser = argparse.ArgumentParser(description="create cname token sample")

# Specify the command line parameters, including the region, bucket name, endpoint, and custom domain name.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--domain', help='The custom domain name.', required=True)

def main():
    # Parse the command line parameters to obtain the values entered by the user.
    args = parser.parse_args()

    # Obtain the access credentials from environment variables for identity authentication.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK to create a configuration object and specify the credential provider.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Specify the region attribute of the configuration object based on the command line parameters provided by the user.
    cfg.region = args.region

    # If a custom endpoint is provided, modify the endpoint parameter in the configuration object.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS.
    client = oss.Client(cfg)

    # Send a request to create a CNAME token for the bucket.
    result = client.create_cname_token(oss.CreateCnameTokenRequest(
            bucket=args.bucket, # The name of the bucket.
            bucket_cname_configuration=oss.BucketCnameConfiguration(
                cname=oss.Cname(
                    domain=args.domain, # The custom domain name.
                ),
            ),
    ))

    # Display the status code of the operation result and other relevant information to check the request status and CNAME token details.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' cname: {result.cname_token.cname if hasattr(result.cname_token, "cname") else "Not set"},'
          f' token: {result.cname_token.token if hasattr(result.cname_token, "token") else "Not set"},'
          f' expire time: {result.cname_token.expire_time.strftime("%Y-%m-%dT%H:%M:%S.000Z") if hasattr(result.cname_token, "expire_time") else "Not set"},'
          f' bucket: {result.cname_token.bucket if hasattr(result.cname_token, "bucket") else "Not set"},'
          )

# Call the main function to start the processing logic when the script is directly run.
if __name__ == "__main__":
    main() # Specify the entry points in the functions of the script. The control program flow starts here.

Interroger un jeton CNAME

L'exemple de code suivant montre comment interroger un jeton CNAME :

import argparse
import alibabacloud_oss_v2 as oss

# Create a command line parameter parser and describe the purpose of the script. The example describes how to query a CNAME token.
parser = argparse.ArgumentParser(description="get cname token sample")

# Specify the command line parameters, including the region, bucket name, endpoint, and CNAME record.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--cname', help='The name of the CNAME record that is mapped to the bucket.', required=True)

def main():
    # Parse the command line parameters to obtain the values entered by the user.
    args = parser.parse_args()

    # Obtain the access credentials from environment variables for identity authentication.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK to create a configuration object and specify the credential provider.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Specify the region attribute of the configuration object based on the command line parameters provided by the user.
    cfg.region = args.region

    # If a custom endpoint is provided, modify the endpoint parameter in the configuration object.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS.
    client = oss.Client(cfg)

    # Send a request to query the CNAME token of the bucket and the CNAME record.
    result = client.get_cname_token(oss.GetCnameTokenRequest(
            bucket=args.bucket, # The name of the bucket.
            cname=args.cname, # The name of the CNAME record for the custom domain name.
    ))

    # Display the status code of the operation result and other relevant information to check the request status and CNAME token details.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' cname: {result.cname_token.cname if hasattr(result.cname_token, "cname") else "Not set"},'
          f' token: {result.cname_token.token if hasattr(result.cname_token, "token") else "Not set"},'
          f' expire time: {result.cname_token.expire_time.strftime("%Y-%m-%dT%H:%M:%S.000Z") if hasattr(result.cname_token, "expire_time") else "Not set"},'
          f' bucket: {result.cname_token.bucket if hasattr(result.cname_token, "bucket") else "Not set"},'
          )

# Call the main function to start the processing logic when the script is directly run.
if __name__ == "__main__":
    main() # Specify the entry points in the functions of the script. The control program flow starts here.

Ajouter un enregistrement CNAME

L'exemple de code suivant montre comment ajouter un enregistrement CNAME pour mapper un domaine personnalisé à un bucket.

import argparse
import alibabacloud_oss_v2 as oss

# Create a command line parameter parser and describe the purpose of the script. The example describes how to add a CNAME record used to map a custom domain to a bucket.
parser = argparse.ArgumentParser(description="put cname sample")

# Specify the command line parameters, including the region, bucket name, endpoint, and custom domain name.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--domain', help='The custom domain name.', required=True)

def main():
    # Parse the command line parameters to obtain the values entered by the user.
    args = parser.parse_args()

    # Obtain the access credentials from environment variables for identity authentication.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK to create a configuration object and specify the credential provider.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Specify the region attribute of the configuration object based on the command line parameters provided by the user.
    cfg.region = args.region

    # If a custom endpoint is provided, modify the endpoint parameter in the configuration object.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS.
    client = oss.Client(cfg)

    # Specify the SSL certificate parameters and associate the SSL certificate with the custom domain name.
    cert_id='493****-cn-hangzhou ' # The ID of the SSL certificate.
    certificate = '''-----BEGIN CERTIFICATE-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC
**** -----END CERTIFICATE-----''' # The content of the SSL certificate.
    private_key = '''-----BEGIN CERTIFICATE-----
MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC
**** -----END CERTIFICATE-----''' # The content of the private key.
    previous_cert_id='493****-cn-hangzhou ' # The ID of the original SSL certificate.
    force = True # Forcibly overwrite the original SSL certificate.

    # Send a request to add a CNAME record used to map a custom domain to a bucket and associate the SSL certificate with the custom domain name.
    result = client.put_cname(oss.PutCnameRequest(
            bucket=args.bucket, # The name of the bucket.
            bucket_cname_configuration=oss.BucketCnameConfiguration(
                cname=oss.Cname(
                    domain=args.domain, # The custom domain name.
                    certificate_configuration=oss.CertificateConfiguration(
                        certificate=certificate, # The content of the SSL certificate.
                        private_key=private_key, # The content of the private key.
                        previous_cert_id=previous_cert_id, # The ID of the original SSL certificate.
                        force=force,  # Forcibly overwrite the original SSL certificate.
                        cert_id=cert_id, # The ID of the new SSL certificate.
                    ),
                ),
            ),
    ))

    # Display the status code of the operation result and request ID to check the request status.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          )

    """
    # Optional. If you want to delete the SSL certificate, please delete the description for the following code.
    result = client.put_cname(oss.PutCnameRequest(
            bucket=args.bucket,
            bucket_cname_configuration=oss.BucketCnameConfiguration(
                cname=oss.Cname(
                    domain=args.domain,
                    certificate_configuration=oss.CertificateConfiguration(
                        delete_certificate=True, # Delete the SSL certificate.
                    ),
                ),
            ),
    ))
    """

# Call the main function to start the processing logic when the script is directly run.
if __name__ == "__main__":
    main() # Specify the entry points in functions of the script. The control program flow starts here.

Répertorier les enregistrements CNAME

L'exemple de code suivant montre comment répertorier les enregistrements CNAME d'un bucket :

import argparse
import alibabacloud_oss_v2 as oss

# Create a command line parameter parser and describe the purpose of the script. The example describes how to list the CNAME records of a bucket.
parser = argparse.ArgumentParser(description="list cname sample")

# Specify the command line parameters, including the region, bucket name, and endpoint. The endpoint parameter is optional.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')

def main():
    # Parse the command line parameters to obtain the values entered by the user.
    args = parser.parse_args()

    # Obtain the access credentials from environment variables for identity authentication.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK to create a configuration object and specify the credential provider.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Specify the region attribute of the configuration object based on the command line parameters provided by the user.
    cfg.region = args.region

    # If a custom endpoint is provided, modify the endpoint parameter in the configuration object.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS.
    client = oss.Client(cfg)

    # Send a request to list the CNAME records of the bucket.
    result = client.list_cname(oss.ListCnameRequest(
            bucket=args.bucket, # The name of the bucket.
    ))

    # Display the status code of the operation result, the request ID, and other relevant information to check the request status and CNAME records.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          f' bucket: {result. Bucket},' # The name of the bucket.
          f' owner: {result.owner},' # The owner of the bucket.
          )

    # If CNAME records exist, traverse and display the details of each CNAME record.
    if result.cnames:
        for r in result.cnames:
            # Display the domain name, last modified time, status, and SSL certificate information (if any) of the CNAME record.
            certificate_info = (f"fingerprint: {r.certificate.fingerprint}, "
                                f"valid start date: {r.certificate.valid_start_date}, "
                                f"valid end date: {r.certificate.valid_end_date}, "
                                f"type: {r.certificate.type}, "
                                f"cert id: {r.certificate.cert_id}, "
                                f"status: {r.certificate.status}, "
                                f"creation date: {r.certificate.creation_date}") if r.certificate else "No certificate"
            print(f'domain: {r.domain}, '
                  f'last modified: {r.last_modified}, '
                  f'status: {r.status}, '
                  f'certificate: {certificate_info}'
                  )

# Call the main function to start the processing logic when the script is directly run.
if __name__ == "__main__":
    main() # Specify the entry points in the functions of the script. The control program flow starts here.

Supprimer un enregistrement CNAME

L'exemple de code suivant montre comment supprimer un enregistrement CNAME utilisé pour mapper un domaine personnalisé à un bucket :

import argparse
import alibabacloud_oss_v2 as oss

# Create a command line parameter parser and describe the purpose of the script. The example describes how to delete a CNAME record used to map a custom domain to a bucket.
parser = argparse.ArgumentParser(description="delete cname sample")

# Specify the command line parameters, including the region, bucket name, endpoint, and custom domain name.
parser.add_argument('--region', help='The region in which the bucket is located.', required=True)
parser.add_argument('--bucket', help='The name of the bucket.', required=True)
parser.add_argument('--endpoint', help='The domain names that other services can use to access OSS')
parser.add_argument('--domain', help='The custom domain name.', required=True)

def main():
    # Parse the command line parameters to obtain the values entered by the user.
    args = parser.parse_args()

    # Obtain the access credentials from environment variables for identity authentication.
    credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()

    # Use the default configurations of the SDK to create a configuration object and specify the credential provider.
    cfg = oss.config.load_default()
    cfg.credentials_provider = credentials_provider

    # Specify the region attribute of the configuration object based on the command line parameters provided by the user.
    cfg.region = args.region

    # If a custom endpoint is provided, modify the endpoint parameter in the configuration object.
    if args.endpoint is not None:
        cfg.endpoint = args.endpoint

    # Use the preceding configurations to initialize the OSSClient instance and allow the instance to interact with OSS.
    client = oss.Client(cfg)

    # Send a request to delete the CNAME record.
    result = client.delete_cname(oss.DeleteCnameRequest(
            bucket=args.bucket, # The name of the bucket.
            bucket_cname_configuration=oss.BucketCnameConfiguration(
                cname=oss.Cname(
                    domain=args.domain, # The custom domain name.
                ),
            ),
    ))

    # Display the status code of the operation result and request ID to check the request status.
    print(f'status code: {result.status_code},'
          f' request id: {result.request_id},'
          )

# Call the main function to start the processing logic when the script is directly run.
if __name__ == "__main__":
    main() # Specify the entry points in the functions of the script. The control program flow starts here.

Références

  • Pour obtenir le code d'exemple complet permettant de créer un jeton CNAME pour la vérification de la propriété du domaine, consultez create_cname_token.py.

  • Pour obtenir le code d'exemple complet permettant d'interroger un jeton CNAME, consultez get_cname_token.py.

  • Pour obtenir le code d'exemple complet permettant d'ajouter un enregistrement CNAME, consultez put_cname.py.

  • Pour obtenir le code d'exemple complet permettant de répertorier les enregistrements CNAME, consultez list_cname.py.

  • Pour obtenir le code d'exemple complet permettant de supprimer un enregistrement CNAME, consultez delete_cname.py.