Comment gérer les jetons CNAME et les configurations CNAME en exécutant la commande bucket-cname - Object Storage Service

Remarques d'utilisation

Pour créer un jeton CNAME, vous devez disposer de l'autorisation oss:CreateCnameToken. Pour interroger un jeton CNAME, vous devez disposer de l'autorisation oss:GetCnameToken. Pour ajouter des configurations CNAME, vous devez disposer de l'autorisation oss:PutCname. Pour interroger les configurations CNAME, vous devez disposer de l'autorisation oss:ListCname. Pour supprimer des configurations CNAME, vous devez disposer de l'autorisation oss:DeleteCname. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.
À partir de la version 1.6.16 d'ossutil, utilisez directement ossutil comme nom binaire dans la ligne de commande. Il n'est pas nécessaire de modifier le nom binaire en fonction du système d'exploitation. Pour les versions antérieures à 1.6.16, adaptez le nom binaire au système d'exploitation. Pour plus d'informations, consultez la rubrique Prise en main rapide de l'outil de ligne de commande ossutil.

Créer un jeton CNAME

Remarque

Seules les versions 1.7.13 et ultérieures d'ossutil permettent de créer un jeton CNAME.

Syntaxe de la commande

ossutil bucket-cname --method put --item token oss://bucketname domainname

Le tableau suivant décrit les paramètres ci-dessus.

Paramètre

Description

bucketname

Nom du bucket auquel est mappé le nom de domaine pour lequel vous souhaitez ajouter un enregistrement CNAME.

domainname

Nom de domaine personnalisé.

Exemples

L'exemple de code suivant montre comment créer un jeton CNAME pour mapper le nom de domaine personnalisé example.com au bucket nommé examplebucket :
```
ossutil bucket-cname --method put --item token oss://examplebucket example.com
```
Le résultat suivant s'affiche :
```
<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>4db41c3ad0c4c4b690d4c17fb34e****</Token>
 <ExpireTime>Thu, 26 May 2022 19:14:12 GMT</ExpireTime>
</CnameToken>

0.270654(s) elapsed
```
Une fois le jeton CNAME créé, ajoutez un enregistrement TXT. Pour plus d'informations, consultez la rubrique Accéder à OSS via un nom de domaine personnalisé.

Interroger le jeton CNAME

Syntaxe de la commande

ossutil bucket-cname --method get --item token oss://bucketname  domainname local_xml_file

Exemples

L'exemple de code suivant montre comment interroger et afficher le jeton CNAME :

ossutil bucket-cname --method get --item token oss://examplebucket example.com

Le résultat suivant s'affiche :

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

0.144356(s) elapsed

L'exemple de code suivant montre comment interroger le jeton CNAME et l'enregistrer dans un fichier local :

ossutil bucket-cname --method get --item token oss://examplebucket example.com local.xml

Le fichier local contient le contenu suivant :

<CnameToken>
 <Bucket>examplebucket</Bucket>
 <Cname>example.com</Cname>
 <Token>fbf997e8a2d48cb2177ed25180ee****</Token>
 <ExpireTime>Thu, 26 May 2022 19:53:19 GMT</ExpireTime>
</CnameToken>

Ajouter des configurations CNAME

Important

Avant d'ajouter des configurations CNAME, créez un jeton CNAME. Pour plus d'informations, consultez la rubrique Créer un jeton CNAME.

Syntaxe de la commande

ossutil bucket-cname --method put oss://bucketname domainname

Exemples

L'exemple de code suivant montre comment ajouter des configurations CNAME à un bucket nommé examplebucket :
```
ossutil bucket-cname --method put oss://examplebucket example.com
```
Si le résultat suivant s'affiche, les configurations CNAME ont été ajoutées :
```
0.227834(s) elapsed
```

Interroger les configurations CNAME

Syntaxe de la commande

ossutil bucket-cname --method get oss://bucketname local_xml_file

Exemples

L'exemple de code suivant montre comment interroger et afficher les configurations CNAME d'un bucket nommé examplebucket :

ossutil bucket-cname --method get oss://examplebucket

Si le résultat suivant s'affiche, les configurations CNAME du bucket ont été interrogées. La sortie ci-dessous indique que les noms de domaine example.com et example.org sont mappés au bucket nommé examplebucket et que ces domaines sont activés :

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

0.164039(s) elapsed

L'exemple de code suivant montre comment interroger les configurations CNAME d'un bucket nommé examplebucket et les enregistrer dans un fichier local :

ossutil bucket-cname --method get oss://examplebucket local.xml

Si un certificat SSL est associé, le résultat suivant s'affiche :

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>1506925210***</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2023-02-27T10:38:13.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>false</IsPurgeCdnCache>
    <Certificate>
      <Type>CAS</Type>
      <CertId>927****-cn-hangzhou</CertId>
      <Status>Enabled</Status>
      <CreationDate>Mon, 27 Feb 2023 06:51:34 GMT</CreationDate>
      <Fingerprint>60:AA:C3:2C:D4:70:54:3D:02:DB:B5:AA:E7:0E:E2:B9:0B:5A:C8:CC</Fingerprint>
      <ValidStartDate>Feb 10 00:00:00 2023 GMT</ValidStartDate>
      <ValidEndDate>Feb 10 23:59:59 2024 GMT</ValidEndDate>
    </Certificate>
  </Cname>
</ListCnameResult>

Si aucun certificat SSL n'est associé, le résultat suivant s'affiche :

<?xml version="1.0" encoding="UTF-8"?>
<ListCnameResult>
  <Bucket>examplebucket</Bucket>
  <Owner>148562088256****</Owner>
  <Cname>
    <Domain>example.com</Domain>
    <LastModified>2021-08-26T07:25:12.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
  <Cname>
    <Domain>example.org</Domain>
    <LastModified>2021-08-26T07:25:26.000Z</LastModified>
    <Status>Enabled</Status>
    <IsPurgeCdnCache>true</IsPurgeCdnCache>
  </Cname>
</ListCnameResult>

Ajouter un enregistrement CNAME et associer un certificat SSL

Syntaxe de la commande

ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

Exemples

Spécifiez le fichier de configuration local.

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <CertId>493****-cn-hangzhou</CertId>
      <Certificate>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</Certificate>
      <PrivateKey>-----BEGIN CERTIFICATE----- MIIDhDCCAmwCCQCFs8ixARsyrDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhMC **** -----END CERTIFICATE-----</PrivateKey>
      <PreviousCertId>493****-cn-hangzhou</PreviousCertId>
      <Force>true</Force>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

Ajoutez un enregistrement CNAME aux enregistrements DNS du nom de domaine et associez un certificat SSL au domaine.
```
ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml
```

Dissocier les certificats SSL

Syntaxe de la commande

ossutil bucket-cname --method put --item certificate oss://bucketname local_xml_file

Exemples

Spécifiez le fichier de configuration local.

<?xml version="1.0" encoding="UTF-8"?>
<BucketCnameConfiguration>
  <Cname>
    <Domain>example.com</Domain>
    <CertificateConfiguration>
      <DeleteCertificate>True</DeleteCertificate>
    </CertificateConfiguration>
  </Cname>
</BucketCnameConfiguration>

Dissociez le certificat SSL.

ossutil bucket-cname --method put --item certificate oss://examplebucket local.xml

Supprimer des configurations CNAME

Syntaxe de la commande

ossutil bucket-cname --method delete oss://bucketname domainname

Exemples

L'exemple de code suivant montre comment supprimer les configurations CNAME d'un bucket nommé examplebucket :
```
ossutil bucket-cname --method delete oss://examplebucket example.com
```
Si le résultat suivant s'affiche, les configurations CNAME ont été supprimées :
```
0.227389(s) elapsed
```

Options courantes

Pour accéder à un bucket situé dans une autre région, utilisez l'option -e pour spécifier l'endpoint. Pour accéder à un bucket appartenant à un autre compte Alibaba Cloud, utilisez l'option -i pour l'AccessKey ID et l'option -k pour l'AccessKey Secret.

Par exemple, exécutez la commande suivante pour ajouter des configurations CNAME à un bucket nommé testbucket, situé dans la région Chine (Hangzhou) et appartenant à un autre compte Alibaba Cloud :

ossutil bucket-cname --method put oss://testbucket example.org -e oss-cn-hangzhou.aliyuncs.com -i yourAccessKeyID -k yourAccessKeySecret

Options courantes.