Certificate - Add
Hiermee voegt u een certificaat toe aan het opgegeven account.
Waarschuwing: deze bewerking is afgeschaft en wordt na februari 2024 verwijderd. Gebruik in plaats daarvan de Azure KeyVault-extensie .
POST {batchUrl}/certificates?api-version=2023-11-01.18.0
POST {batchUrl}/certificates?timeout={timeout}&api-version=2023-11-01.18.0
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
batch
|
path | True |
string |
De basis-URL voor alle Azure Batch serviceaanvragen. |
api-version
|
query | True |
string |
Client-API-versie. |
timeout
|
query |
integer int32 |
De maximale tijd die de server kan besteden aan het verwerken van de aanvraag, in seconden. De standaardwaarde is 30 seconden. |
Aanvraagkoptekst
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
client-request-id |
string uuid |
De aanroeper gegenereerde aanvraagidentiteit, in de vorm van een GUID zonder decoratie, zoals accolades, bijvoorbeeld 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0. |
|
return-client-request-id |
boolean |
Of de server de client-request-id in het antwoord moet retourneren. |
|
ocp-date |
string date-time-rfc1123 |
Het tijdstip waarop de aanvraag is uitgegeven. Clientbibliotheken stellen dit doorgaans in op de huidige systeemkloktijd; stel dit expliciet in als u de REST API rechtstreeks aanroept. |
Aanvraagbody
Media Types: "application/json; odata=minimalmetadata"
Name | Vereist | Type | Description |
---|---|---|---|
data | True |
string |
De met base64 gecodeerde inhoud van het certificaat. De maximale grootte is 10 kB. |
thumbprint | True |
string |
De X.509-vingerafdruk van het certificaat. Dit is een reeks van maximaal 40 hexadecimale cijfers (deze kunnen spaties bevatten, maar deze worden verwijderd). |
thumbprintAlgorithm | True |
string |
Het algoritme dat wordt gebruikt om de vingerafdruk af te leiden. Dit moet sha1 zijn. |
certificateFormat |
De indeling van de certificaatgegevens. |
||
password |
string |
Het wachtwoord voor toegang tot de persoonlijke sleutel van het certificaat. |
Antwoorden
Name | Type | Description |
---|---|---|
201 Created |
De aanvraag voor de Batch-service is geslaagd. Headers
|
|
Other Status Codes |
De fout van de Batch-service. |
Beveiliging
azure_auth
Microsoft Entra OAuth 2.0-verificatiecodestroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Authorization
Type:
apiKey
In:
header
Voorbeelden
Certificate add
Sample Request
POST account.region.batch.azure.com/certificates?api-version=2023-11-01.18.0
{
"thumbprintAlgorithm": "sha1",
"thumbprint": "0123456789abcdef0123456789abcdef01234567",
"data": "#####...",
"certificateFormat": "pfx",
"password": "<ExamplePassword>"
}
Sample Response
Definities
Name | Description |
---|---|
Batch |
Een foutbericht dat is ontvangen van de Azure Batch-service. |
Batch |
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie. |
Certificate |
Een certificaat dat kan worden geïnstalleerd op rekenknooppunten en kan worden gebruikt om bewerkingen op de computer te verifiëren. |
Certificate |
De indeling van de certificaatgegevens. |
Error |
Een foutbericht ontvangen in een Azure Batch antwoord. |
BatchError
Een foutbericht dat is ontvangen van de Azure Batch-service.
Name | Type | Description |
---|---|---|
code |
string |
Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt. |
message |
Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface. |
|
values |
Een verzameling sleutel-waardeparen met aanvullende details over de fout. |
BatchErrorDetail
Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
Name | Type | Description |
---|---|---|
key |
string |
Een id die de betekenis van de eigenschap Value aangeeft. |
value |
string |
De aanvullende informatie die is opgenomen in de foutreactie. |
CertificateAddParameter
Een certificaat dat kan worden geïnstalleerd op rekenknooppunten en kan worden gebruikt om bewerkingen op de computer te verifiëren.
Name | Type | Description |
---|---|---|
certificateFormat |
De indeling van de certificaatgegevens. |
|
data |
string |
De met base64 gecodeerde inhoud van het certificaat. De maximale grootte is 10 kB. |
password |
string |
Het wachtwoord voor toegang tot de persoonlijke sleutel van het certificaat. |
thumbprint |
string |
De X.509-vingerafdruk van het certificaat. Dit is een reeks van maximaal 40 hexadecimale cijfers (deze kunnen spaties bevatten, maar deze worden verwijderd). |
thumbprintAlgorithm |
string |
Het algoritme dat wordt gebruikt om de vingerafdruk af te leiden. Dit moet sha1 zijn. |
CertificateFormat
De indeling van de certificaatgegevens.
Name | Type | Description |
---|---|---|
cer |
string |
Het certificaat is een met base64 gecodeerd X.509-certificaat. |
pfx |
string |
Het certificaat is een CERTIFICAAT of certificaatketen met PFX-indeling (PKCS#12). |
ErrorMessage
Een foutbericht ontvangen in een Azure Batch antwoord.
Name | Type | Description |
---|---|---|
lang |
string |
De taalcode van het foutbericht |
value |
string |
De tekst van het bericht. |