Skip to main content

Réinitialiser la clé API

Réinitialiser la clé API UAC.

Prérequis

Vous avez obtenu l'AccessKey d'un compte Alibaba Cloud ou d'un utilisateur RAM, et l'identité s'est vu accorder les autorisations RAM nécessaires pour appeler cette opération. Nous vous recommandons de définir l'AccessKey comme variables d'environnement ALIBABA_CLOUD_ACCESS_KEY_ID et ALIBABA_CLOUD_ACCESS_KEY_SECRET plutôt que de le coder en dur.

Description de la requête

  • Méthode HTTP : POST
  • URL de la requête

    Région

    Point de terminaison

    Singapour

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-key-rotations

  • Authentification Cette opération est une opération OpenAPI Alibaba Cloud qui utilise des signatures basées sur AccessKey (l'algorithme ACS3-HMAC-SHA256). Le schéma Authorization: Bearer {API_KEY} n'est pas pris en charge. Une requête doit comporter les en-têtes communs x-acs-action: RotateTokenPlanKey, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce et Authorization. Nous vous recommandons d'appeler cette opération avec un SDK Alibaba Cloud ou OpenAPI Explorer afin de ne pas avoir à calculer la signature vous-même.
Seule la valeur de la clé API change. L'ID de la clé API reste inchangé.

Paramètres de la requête

Tous les paramètres sont transmis dans la chaîne de requête.

Paramètre

Type

Obligatoire

Description

ApiKeyId

string

Oui

ID de clé API

Paramètres de réponse

Paramètre

Type

Description

Success

boolean

Indique si l'appel API a réussi :
true : succès
false : échec

Code

string

Code d'état de la réponse.

Message

string

Message de réponse.

Data

object

Données métier.

ApiKeyId

string

ID de clé API (généré par le système).

SourceId

string

ID source retourné par BaiLian.

PlainApiKey

string

Nouvelle clé API en texte brut renvoyée par BaiLian (renvoyée une seule fois lors de la réinitialisation)

MaskedApiKey

string

Nouveau masked_api_key renvoyé par BaiLian (tel que sk_***cdef)

ResetAt

string

Heure de réinitialisation

Exemple de requête

Cette opération utilise les signatures OpenAPI d'Alibaba Cloud. Dans l'exemple suivant, ${SIGNATURE} doit être calculé avec l'algorithme ACS3-HMAC-SHA256, et x-acs-date ainsi que x-acs-signature-nonce doivent être remplacés par des valeurs réelles.
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/api-key-rotations?ApiKeyId=ak_123456" \
    --header "x-acs-action: RotateTokenPlanKey" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: ${SIGNATURE_NONCE}" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

Exemple de réponse

{
  "Success": true,
  "Data": {
    "ApiKeyId": "ak_123456",
    "SourceId": "123456",
    "PlainApiKey": "sk-ws.abc123456",
    "MaskedApiKey": "sk_***6",
    "ResetAt": "2025-07-18T03:19:17Z"
  }
}

Codes d'erreur

Si l'appel échoue, un message d'erreur est renvoyé. Pour plus de codes d'erreur et de solutions, consultez Codes d'erreur.