Method: acmeChallengeSets.rotateChallenges

दिए गए डोमेन नेम के लिए, ACME चैलेंज को रोटेट करें. डिफ़ॉल्ट रूप से, 30 दिन से ज़्यादा पुरानी चुनौतियां हटा दी जाती हैं. डोमेन नाम को पुनीकोड में दिया जाना चाहिए.

एचटीटीपी अनुरोध

POST https://acmedns.googleapis.com/v1/acmeChallengeSets/{rootDomain}:rotateChallenges

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
rootDomain

string

ज़रूरी है. SLD + टीएलडी डोमेन नेम को अपडेट करना है. उदाहरण के लिए, यह "google.com" के तहत किसी भी FQDN के लिए "google.com" होगा. इसमें "subdomain.google.com" की चुनौतियां शामिल हैं. यह यूनिकोड या पुनीकोड हो सकता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:

जेएसओएन के काेड में दिखाना
{
  "accessToken": string,
  "recordsToAdd": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "recordsToRemove": [
    {
      object (AcmeTxtRecord)
    }
  ],
  "keepExpiredRecords": boolean
}
फ़ील्ड
accessToken

string (bytes format)

ज़रूरी है. ACME डीएनएस ऐक्सेस टोकन. यह एक Base64 टोकन सीक्रेट है, जो Google Domains वेबसाइट से लिया जाता है. यह डोमेन के लिए ACME TXT रिकॉर्ड अपडेट को अनुमति देता है.

Base64-एन्कोड की गई स्ट्रिंग.

recordsToAdd[]

object (AcmeTxtRecord)

ACME TXT रिकॉर्ड जोड़ने के लिए चुनौतियां. एक ही FQDN पर कई चुनौतियों का समर्थन करता है.

recordsToRemove[]

object (AcmeTxtRecord)

ACME TXT रिकॉर्ड निकालने के लिए चुनौतियां.

keepExpiredRecords

boolean

पिछले अनुरोधों के लिए इस्तेमाल किए गए 30 दिनों से ज़्यादा पुराने रिकॉर्ड रखें.

जवाब का मुख्य भाग

कामयाब रहने पर, जवाब के मुख्य हिस्से में AcmeChallengeSet का एक इंस्टेंस शामिल किया जाता है.