Certificate - Add

Service:

Batch Service

API-versie:

2024-07-01.20.0

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=2024-07-01.20.0

Met optionele parameters:

POST {batchUrl}/certificates?timeout={timeout}&api-version=2024-07-01.20.0

URI-parameters

Name	In	Vereist	Type	Description
batchUrl	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. Als de waarde groter is dan 30, wordt in plaats daarvan de standaardwaarde gebruikt.

Aanvraagkoptekst

Media Types: "application/json; odata=minimalmetadata"

Name	Vereist	Type	Description
client-request-id		string uuid	De door 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 clientaanvraag-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 kloktijd van het systeem; stel deze expliciet in als u de REST API rechtstreeks aanroept.

Aanvraagbody

Media Types: "application/json; odata=minimalmetadata"

Name	Vereist	Type	Description
data	True	string	De 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 hex-cijfers (het kan 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		CertificateFormat	De indeling van de certificaatgegevens.
password		string	Het wachtwoord voor toegang tot de persoonlijke sleutel van het certificaat. Dit moet worden weggelaten als de certificaatindeling cer is.

Antwoorden

Name	Type	Description
201 Created		De aanvraag voor de Batch-service is geslaagd. Kopteksten client-request-id: string request-id: string ETag: string Last-Modified: string DataServiceId: string
Other Status Codes	BatchError	De fout van de Batch-service.

Beveiliging

azure_auth

Microsoft Entra OAuth 2.0-verificatiecodestroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Authorization

Type: apiKey
In: header

Voorbeelden

Certificate add

Voorbeeldaanvraag

HTTP

POST account.region.batch.azure.com/certificates?api-version=2024-07-01.20.0



{
  "thumbprintAlgorithm": "sha1",
  "thumbprint": "0123456789abcdef0123456789abcdef01234567",
  "data": "#####...",
  "certificateFormat": "pfx",
  "password": "<ExamplePassword>"
}

Voorbeeldrespons

Statuscode:

201

Definities

Name	Description
BatchError	Er is een foutbericht ontvangen van de Azure Batch-service.
BatchErrorDetail	Een item met aanvullende informatie die is opgenomen in een Azure Batch-foutreactie.
CertificateAddParameter	Een certificaat dat kan worden geïnstalleerd op rekenknooppunten en kan worden gebruikt om bewerkingen op de computer te verifiëren.
CertificateFormat	De indeling van de certificaatgegevens.
ErrorMessage	Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

BatchError

Er is een foutbericht 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	ErrorMessage	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
values	BatchErrorDetail[]	Een verzameling sleutel-waardeparen met aanvullende informatie 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 Waarde aangeeft.
value	string	De aanvullende informatie die is opgenomen in het foutbericht.

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	CertificateFormat	De indeling van de certificaatgegevens.
data	string	De 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. Dit moet worden weggelaten als de certificaatindeling cer is.
thumbprint	string	De X.509-vingerafdruk van het certificaat. Dit is een reeks van maximaal 40 hex-cijfers (het kan 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 X.509-certificaat met base64-codering.
pfx	string	Het certificaat is een PFX-indeling (PKCS#12) met certificaat of certificaatketen.

ErrorMessage

Een foutbericht dat is ontvangen in een Azure Batch-foutreactie.

Name	Type	Description
lang	string	De taalcode van het foutbericht
value	string	De tekst van het bericht.