दिए गए डोमेन नेम के लिए, ACME चैलेंज को रोटेट करें. डिफ़ॉल्ट रूप से, 30 दिन से ज़्यादा पुरानी चुनौतियां हटा दी जाती हैं. डोमेन नाम को पुनीकोड में दिया जाना चाहिए.
एचटीटीपी अनुरोध
POST https://acmedns.googleapis.com/v1/acmeChallengeSets/{rootDomain}:rotateChallenges
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ पैरामीटर
पैरामीटर | |
---|---|
rootDomain |
ज़रूरी है. SLD + टीएलडी डोमेन नेम को अपडेट करना है. उदाहरण के लिए, यह "google.com" के तहत किसी भी FQDN के लिए "google.com" होगा. इसमें "subdomain.google.com" की चुनौतियां शामिल हैं. यह यूनिकोड या पुनीकोड हो सकता है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में नीचे दिए गए स्ट्रक्चर का डेटा शामिल है:
जेएसओएन के काेड में दिखाना |
---|
{ "accessToken": string, "recordsToAdd": [ { object ( |
फ़ील्ड | |
---|---|
accessToken |
ज़रूरी है. ACME डीएनएस ऐक्सेस टोकन. यह एक Base64 टोकन सीक्रेट है, जो Google Domains वेबसाइट से लिया जाता है. यह डोमेन के लिए ACME TXT रिकॉर्ड अपडेट को अनुमति देता है. Base64-एन्कोड की गई स्ट्रिंग. |
recordsToAdd[] |
ACME TXT रिकॉर्ड जोड़ने के लिए चुनौतियां. एक ही FQDN पर कई चुनौतियों का समर्थन करता है. |
recordsToRemove[] |
ACME TXT रिकॉर्ड निकालने के लिए चुनौतियां. |
keepExpiredRecords |
पिछले अनुरोधों के लिए इस्तेमाल किए गए 30 दिनों से ज़्यादा पुराने रिकॉर्ड रखें. |
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में AcmeChallengeSet
का एक इंस्टेंस शामिल किया जाता है.